Skip to content

UsagePattern

A population of users that performs a UsageJourney, in a given Country, on given Devices, with a given hourly volume of journey starts.

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_journey

The UsageJourney performed by users in this pattern.

An instance of UsageJourney.

devices

Devices that users perform the journey on. Fabrication and energy 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_usage_journey_starts.

An instance of Country.

hourly_usage_journey_starts

Hourly timeseries giving the number of usage journeys that begin in each hour of the modeling period, expressed in the country's local timezone.

Hourly nb of usage journey starts, in hourly timeseries data.

Calculated attributes

utc_hourly_usage_journey_starts

Hourly journey starts converted from the country's local timezone to UTC, so that downstream calculations can be combined across patterns in different timezones.

Example value: 26298 values from 2025-01-01 00:00:00+00:00 to 2028-01-01 18:00:00+00:00 in :
first 10 vals [5, 6, 4, 3, 1, 3, 4, 5, 5, 7],
last 10 vals [4, 2, 9, 4, 4, 9, 1, 1, 4, 8]

Depends directly on:

through the following calculations:

You can also visit the link to Hourly nb of usage journey starts (UTC)’s full calculation graph.