Skip to content

UsagePattern

A population of users that performs weighted UsageJourneys in one shared context.

When to use this class

Use UsagePattern for traffic where each UsageJourney start is independent. Use EdgeUsagePattern for edge devices that run continuously and trigger periodic loads. See web_vs_edge.

Params

name

A human readable description of the object.

usage_journeys

Non-empty mapping from each UsageJourney to its average number of executions per pattern occurrence. Weights must be strictly positive and do not need to sum to one.

devices

Devices that users perform the journey on. Manufacturing and use footprints of each device are weighted by the time the journey occupies on it.

A list of Devices.

network

Network carrying traffic between the user's device and the servers.

An instance of Network.

country

Country where the users are located. Drives device-side electricity carbon intensity and the timezone of UsagePattern.hourly_occurrences.

An instance of Country.

hourly_occurrences

Hourly timeseries giving the number of pattern occurrences in each hour of the modeling period, expressed in the country's local timezone.

Hourly nb of pattern occurrences, in hourly timeseries data.

Calculated attributes

usage_journeys_validation

Validates that the pattern always contains at least one journey.

Example value: no value

Depends directly on:

through the following calculations:

You can also visit the link to no value’s full calculation graph.

utc_hourly_occurrences

Hourly pattern occurrences converted from the country's local timezone to UTC.

Example value: 26298 values from 2025-01-01 00:00:00+00:00 to 2028-01-01 18:00:00+00:00: first=9 , last=4 , mean=5 , min=1 , max=9 , std=2.58

Depends directly on:

through the following calculations:

You can also visit the link to Hourly nb of pattern occurrences (UTC)’s full calculation graph.