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.
Backwards links
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 [7, 2, 3, 1, 5, 7, 6, 4, 8, 5],
last 10 vals [6, 3, 3, 4, 1, 5, 2, 6, 3, 5]
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.
fabrication_impact_repartition_weights
All of this usage pattern's fabrication-phase impact attributes to its single Country, so the country acts as the geographic bucket for device-side fabrication emissions.
Example value: {
Country devices country (2f7384): 1 ,
}
Depends directly on:
through the following calculations:
You can also visit the link to Impact repartition weight’s full calculation graph.
fabrication_impact_repartition_weight_sum
Sum of fabrication impact repartition weights, used as the denominator when normalising into per-container shares.
Example value: 1
Depends directly on:
through the following calculations:
You can also visit the link to Fabrication impact repartition weights sum’s full calculation graph.
fabrication_impact_repartition
Normalised share of fabrication-phase emissions that this object attributes to each container.
Example value: {
Country devices country (2f7384): 1 ,
}
Depends directly on:
through the following calculations:
You can also visit the link to fabrication impact attribution to devices country’s full calculation graph.
usage_impact_repartition_weights
All of this usage pattern's usage-phase impact attributes to its single Country.
Example value: {
Country devices country (2f7384): 1 ,
}
Depends directly on:
through the following calculations:
You can also visit the link to Impact repartition weight’s full calculation graph.
usage_impact_repartition_weight_sum
Sum of usage impact repartition weights, used as the denominator when normalising into per-container shares.
Example value: 1
Depends directly on:
through the following calculations:
You can also visit the link to Usage impact repartition weights sum’s full calculation graph.
usage_impact_repartition
Normalised share of usage-phase emissions that this object attributes to each container.
Example value: {
Country devices country (2f7384): 1 ,
}
Depends directly on:
through the following calculations:
You can also visit the link to usage impact attribution to devices country’s full calculation graph.