assetra.metrics

class assetra.metrics.ResourceAdequacyMetric(simulation: ProbabilisticSimulation)[source]

Class responsible for quantifying resource adequacy of a ProbabilisticSimulation object

Parameters:

simulation (ProbabilisticSimulation) – Simulation object to characterize.

abstractmethod evaluate() float[source]

Return resource adequacy of initialized simulation.

Returns:

Evaluated resource adequacy metric.

Return type:

float

class assetra.metrics.ExpectedUnservedEnergy(simulation: ProbabilisticSimulation)[source]

Derived ResourceAdequacyMetric class responsible for calculating expected unserved energy:

“[The] total expected amount of unserved energy … in a given study horizon.”

https://gridops.epri.com/Adequacy/metrics#Magnitude_Metrics

Parameters:

simulation (ProbabilisticSimulation) – Simulation object to characterize.

evaluate() float[source]

Return expected unserved energy

Returns:

EUE in units of energy

Return type:

float

class assetra.metrics.LossOfLoadHours(simulation: ProbabilisticSimulation)[source]

Derived ResourceAdequacyMetric class responsible for calculating loss of load hours:

“[The] expected count of event-hours per study horizon.”

https://gridops.epri.com/Adequacy/metrics#Loss_of_Load_Hours_.28LOLH.29

Parameters:

simulation (ProbabilisticSimulation) – Simulation object to characterize.

evaluate() float[source]

Return loss of load hours

Returns:

LOLH in units of hours

Return type:

float

class assetra.metrics.LossOfLoadDays(simulation: ProbabilisticSimulation)[source]

Derived ResourceAdequacyMetric class responsible for calculating loss of load days:

“[The] expected count of event-days per study horizon.”

https://gridops.epri.com/Adequacy/metrics#Loss_of_Load_Days_.28LOLD.2C_LOLEd.2Fyr.29

Parameters:

simulation (ProbabilisticSimulation) – Simulation object to characterize.

evaluate() float[source]

Return loss of load days

Returns:

LOLD in units of days

Return type:

float

class assetra.metrics.LossOfLoadFrequency(simulation: ProbabilisticSimulation)[source]

Derived ResourceAdequacyMetric class responsible for calculating loss of load frequency:

“[The] expected count of adequacy events per study horizon, with an adequacy event defined as a contiguous set of hours with a shortfall

https://gridops.epri.com/Adequacy/metrics#Loss_of_Load_Events_.28LOLEv.2C_LOLF.29

Parameters:

simulation (ProbabilisticSimulation) – Simulation object to characterize.

evaluate() float[source]

Return loss of load frequency

Returns:

LOLF in units of # of events

Return type:

float