assetra.contribution

class assetra.contribution.ResourceContributionMetric(energy_system: EnergySystem, simulation: ProbabilisticSimulation, resource_adequacy_metric: type[ResourceAdequacyMetric])[source]

Class responsible for quantifying resource contributions to an energy system

Parameters:

  • energy_system (EnergySystem) – Base system to which resources are added

  • simulation (ProbabilisticSimulation) – Instantiated simulation object whose parameters (i.e. time range and trial size are used throughout the ELCC calculation)

  • resource_adequacy_metric – Class derived from ResourceAdequacyMetric to use throughout the ELCC simulation (e.g. ExpectedUnservedEnergy, LossOfLoadHours)

abstractmethod evaluate(addition: EnergySystem) → float[source]

Return resource contribution of addition to the energy system

Parameters:

  • addition (EnergySystem) – Energy system to add (possibly a single

  • unit)

Returns:

Quantified resource contribution of addition to the energy

system.

Return type:

float

class assetra.contribution.EffectiveLoadCarryingCapability(energy_system: EnergySystem, simulation: ProbabilisticSimulation, resource_adequacy_metric: type[ResourceAdequacyMetric])[source]

Class responsible for quantifying resource contribution to an energy system using the effective load-carrying capability metric:

“[The] amount by which the system’s load can increase when the resource is added to the system while maintaining the same system adequacy.”

https://gridops.epri.com/Adequacy/metrics#Effective_Load_Carrying_Capability_.28ELCC.29

Parameters:

  • energy_system (EnergySystem) – Base system to which resources are added

  • simulation (ProbabilisticSimulation) – Instantiated simulation object whose parameters (i.e. time range and trial size are used throughout the ELCC calculation)

  • resource_adequacy_metric (type[ResourceAdequacyMetric') – Class derived from ResourceAdequacyMetric to use throughout the ELCC simulation (e.g. ExpectedUnservedEnergy, LossOfLoadHours)

property original_net_capacity_matrix: DataArray

Return the net hourly capacity matrix of the base system

property intermediate_net_capacity_matrices: tuple[tuple[float, DataArray]]

Return intermediate net capacity matrices for each step of the ELCC calculation. Each element is a tuple composed of the amount of added constant load and the net hourly capacity matrix corresponding to that step.

evaluate(addition: EnergySystem, additional_demand_resolution_pct: float = 0.01) → float[source]

Return the ELCC of an addition to the energy system.

Parameters:

  • addition (EnergySystem) – Energy system to add (possibly a single unit).

  • additional_demand_resolution_pct (float, optional) – Resolution of added demand to find as percent of added nameplate capacity. Defaults to 0.01 (1%). E.g. for a 100 MW addition, the ELCC will be found within 1 MW.

Returns:

Amount of added constant load in units of power.

Return type:

float