Skip to content

Scenarios

Structures for working with clearly defined scenarios.

Scenario

num_steps property

Return the number of discrete time steps in this simulated scenario.

__init__(*, load, baseload_sources, flexible_sources, intermittent_sources, storage_units, cross_border=None, grid_losses=0.0)

Parameters:

Name Type Description Default
load Sequence[Power]

Time series of net load for each time step in MW.

required
baseload_sources list[NonDispatchableSource]

List of baseload power sources, e.g. nuclear power plants.

required
flexible_sources list[DispatchableSource]

List of dispatchable (flexible) power sources or peaking power plants, e.g. biomass or natural gas-fuelled power plants. Merit order (order of dispatch) is given by the position of the source in the sequence.

required
intermittent_sources list[tuple[NonDispatchableSource, Sequence[float]]]

List of intermittent (inflexible) power sources, e.g. wind or solar photovoltaic power plants. The second entry in the tuple is a time series of capacity factor for the source in each time step.

required
storage_units list[EnergyStorage]

List of electricity storage units.

required
cross_border Optional[CrossBorderTerminal]

A single cross-border export/import facility.

None
grid_losses float

Losses in the grid (transmission and distribution) as a portion of net load. A number in the interval [0, 1).

0.0

run()

Run the scenario and return time series of statistics on each object in the grid.

Returns:

Type Description
ScenarioRun

Object containing time series of electricity source utilisation, storage utilisation, export/import statistics, etc.

ScenarioRun

__init__(power_sources, storage_units, cross_border=None)

Parameters:

Name Type Description Default
power_sources Sequence[PowerSource]

Sequence of electricity sources in the grid.

required
storage_units Sequence[EnergyStorage]

Sequence of electricity storage units/aggregates in the grid.

required
cross_border Optional[CrossBorderTerminal]

Optional facility for cross-border export/import of electric power.

None

sweep()

Collect statistics from all registered objects.