Skip to content

balances_timeseries.py

view_residual_load_duration_curve(result_path, nc, config)

Evaluate and export duration curve data for the residual load

This function generates a hourly duration curve showing residual load calculated as the load on the respective AC bus (i.e. all withdrawal except electricity transmission and storage) + tranmission losses - electricity from fluctuating renewable sources (e.g. wind, solar). The function delegates to simple_residual_load for data collection and export.

Parameters:

Name Type Description Default
result_path str | pathlib.Path

Path where the evaluation results will be saved.

 required
nc pypsa.NetworkCollection

Dictionary containing PyPSA network objects, typically keyed by year or scenario.

 required
config dict

Configuration dictionary containing view settings including bus_carrier specification, storage_links, chart type, and export parameters.

 required
Source code in evals/views/balances_timeseries.py 
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
def view_residual_load_duration_curve(
    result_path: str | Path,
    nc: NetworkCollection,
    config: dict,
) -> None:
    """
    Evaluate and export duration curve data for the residual load

    This function generates a hourly duration curve showing residual load calculated
    as the load on the respective AC bus (i.e. all withdrawal except electricity
    transmission and storage) + tranmission losses - electricity from fluctuating
    renewable sources (e.g. wind, solar). The function delegates to
    simple_residual_load for data collection and export.

    Parameters
    ----------
    result_path
        Path where the evaluation results will be saved.
    nc
        Dictionary containing PyPSA network objects, typically keyed by year or scenario.
    config
        Configuration dictionary containing view settings including bus_carrier specification,
        storage_links, chart type, and export parameters.

    """
    simple_residual_load(nc, config, result_path, as_duration_curve=True)

view_timeseries_carbon(result_path, nc, config)

Evaluate and export time series data for carbon emissions, capture, and sequestration.

This function generates hourly or sub-hourly time series showing CO2 emissions from combustion processes (power plants, boilers, industry), CO2 capture from direct air capture and carbon capture systems, and CO2 sequestration or storage. The temporal resolution enables analysis of emission patterns, the operation of carbon capture facilities, and the timing of CO2 storage operations. The function delegates to simple_timeseries for data collection and export.

Parameters:

Name Type Description Default
result_path str | pathlib.Path

Path where the evaluation results will be saved.

 required
nc pypsa.NetworkCollection

Dictionary containing PyPSA network objects, typically keyed by year or scenario.

 required
config dict

Configuration dictionary containing view settings including bus_carrier specification, storage_links, chart type, and export parameters.

 required
Notes

Time series data reveals the temporal patterns of CO2 emissions and the operation of carbon management infrastructure. It shows how emissions vary with electricity and heat demand, and how carbon capture facilities operate to manage system-wide emissions constraints.

Source code in evals/views/balances_timeseries.py 
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
def view_timeseries_carbon(
    result_path: str | Path,
    nc: NetworkCollection,
    config: dict,
) -> None:
    """
    Evaluate and export time series data for carbon emissions, capture, and sequestration.

    This function generates hourly or sub-hourly time series showing CO2 emissions from
    combustion processes (power plants, boilers, industry), CO2 capture from direct air
    capture and carbon capture systems, and CO2 sequestration or storage. The temporal
    resolution enables analysis of emission patterns, the operation of carbon capture
    facilities, and the timing of CO2 storage operations. The function delegates to
    simple_timeseries for data collection and export.

    Parameters
    ----------
    result_path
        Path where the evaluation results will be saved.
    nc
        Dictionary containing PyPSA network objects, typically keyed by year or scenario.
    config
        Configuration dictionary containing view settings including bus_carrier specification,
        storage_links, chart type, and export parameters.

    Notes
    -----
    Time series data reveals the temporal patterns of CO2 emissions and the operation
    of carbon management infrastructure. It shows how emissions vary with electricity
    and heat demand, and how carbon capture facilities operate to manage system-wide
    emissions constraints.
    """
    simple_timeseries(nc, config, result_path)

view_timeseries_electricity(result_path, nc, config)

Evaluate and export time series data for electricity supply, demand, and trade.

This function generates hourly or sub-hourly time series showing electricity production from various sources (renewables, thermal plants, storage) and consumption across different sectors (industry, transport, heat, electrolysis). It preserves temporal resolution to enable analysis of system operation patterns, peak demand, and renewable generation variability. The function delegates to simple_timeseries for data collection and export.

Parameters:

Name Type Description Default
result_path str | pathlib.Path

Path where the evaluation results will be saved.

 required
nc pypsa.NetworkCollection

Dictionary containing PyPSA network objects, typically keyed by year or scenario.

 required
config dict

Configuration dictionary containing view settings including bus_carrier specification, storage_links, chart type, and export parameters.

 required
Notes

Time series data is useful for analyzing hourly patterns, ramping requirements, storage cycling, and the integration of variable renewable energy sources. Net trade combines foreign and domestic imports/exports into a single saldo value.

Source code in evals/views/balances_timeseries.py 
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
def view_timeseries_electricity(
    result_path: str | Path,
    nc: NetworkCollection,
    config: dict,
) -> None:
    """
    Evaluate and export time series data for electricity supply, demand, and trade.

    This function generates hourly or sub-hourly time series showing electricity production
    from various sources (renewables, thermal plants, storage) and consumption across
    different sectors (industry, transport, heat, electrolysis). It preserves temporal
    resolution to enable analysis of system operation patterns, peak demand, and renewable
    generation variability. The function delegates to simple_timeseries for data collection
    and export.

    Parameters
    ----------
    result_path
        Path where the evaluation results will be saved.
    nc
        Dictionary containing PyPSA network objects, typically keyed by year or scenario.
    config
        Configuration dictionary containing view settings including bus_carrier specification,
        storage_links, chart type, and export parameters.

    Notes
    -----
    Time series data is useful for analyzing hourly patterns, ramping requirements,
    storage cycling, and the integration of variable renewable energy sources.
    Net trade combines foreign and domestic imports/exports into a single saldo value.
    """
    simple_timeseries(nc, config, result_path)

view_timeseries_hydrogen(result_path, nc, config)

Evaluate and export time series data for hydrogen supply, demand, and trade.

This function generates hourly or sub-hourly time series showing hydrogen production from electrolysis, steam methane reforming, and other sources, along with hydrogen consumption in fuel cells, industrial processes, synthetic fuel production, and other applications. The temporal resolution enables analysis of hydrogen system operation, including electrolyzer operation patterns, storage cycling, and the coupling between electricity and hydrogen systems. The function delegates to simple_timeseries for data collection and export.

Parameters:

Name Type Description Default
result_path str | pathlib.Path

Path where the evaluation results will be saved.

 required
nc pypsa.NetworkCollection

Dictionary containing PyPSA network objects, typically keyed by year or scenario.

 required
config dict

Configuration dictionary containing view settings including bus_carrier specification, storage_links, chart type, and export parameters.

 required
Notes

Time series data reveals the coupling between hydrogen and electricity sectors, particularly the role of electrolyzers in providing demand flexibility and the operation of hydrogen storage for seasonal energy shifting.

Source code in evals/views/balances_timeseries.py 
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
def view_timeseries_hydrogen(
    result_path: str | Path,
    nc: NetworkCollection,
    config: dict,
) -> None:
    """
    Evaluate and export time series data for hydrogen supply, demand, and trade.

    This function generates hourly or sub-hourly time series showing hydrogen production
    from electrolysis, steam methane reforming, and other sources, along with hydrogen
    consumption in fuel cells, industrial processes, synthetic fuel production, and other
    applications. The temporal resolution enables analysis of hydrogen system operation,
    including electrolyzer operation patterns, storage cycling, and the coupling between
    electricity and hydrogen systems. The function delegates to simple_timeseries for
    data collection and export.

    Parameters
    ----------
    result_path
        Path where the evaluation results will be saved.
    nc
        Dictionary containing PyPSA network objects, typically keyed by year or scenario.
    config
        Configuration dictionary containing view settings including bus_carrier specification,
        storage_links, chart type, and export parameters.

    Notes
    -----
    Time series data reveals the coupling between hydrogen and electricity sectors,
    particularly the role of electrolyzers in providing demand flexibility and the
    operation of hydrogen storage for seasonal energy shifting.
    """
    simple_timeseries(nc, config, result_path)

view_timeseries_methane(result_path, nc, config)

Evaluate and export time series data for methane supply, demand, and trade.

This function generates hourly or sub-hourly time series showing methane (natural gas) supply from production, imports, biogas upgrading, and methanation processes, along with methane consumption in gas boilers, combined heat and power plants, gas turbines, steam methane reforming, and industrial applications. The temporal resolution enables analysis of gas system operation, storage cycling, and the seasonal patterns of gas demand for heating. The function delegates to simple_timeseries for data collection and export.

Parameters:

Name Type Description Default
result_path str | pathlib.Path

Path where the evaluation results will be saved.

 required
nc pypsa.NetworkCollection

Dictionary containing PyPSA network objects, typically keyed by year or scenario.

 required
config dict

Configuration dictionary containing view settings including bus_carrier specification, storage_links, chart type, and export parameters.

 required
Notes

Time series data shows the seasonal nature of gas demand, particularly for heating, and the role of gas storage in balancing supply and demand. It also reveals the transition from fossil natural gas to renewable and synthetic methane sources.

Source code in evals/views/balances_timeseries.py 
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
def view_timeseries_methane(
    result_path: str | Path,
    nc: NetworkCollection,
    config: dict,
) -> None:
    """
    Evaluate and export time series data for methane supply, demand, and trade.

    This function generates hourly or sub-hourly time series showing methane (natural gas)
    supply from production, imports, biogas upgrading, and methanation processes, along
    with methane consumption in gas boilers, combined heat and power plants, gas turbines,
    steam methane reforming, and industrial applications. The temporal resolution enables
    analysis of gas system operation, storage cycling, and the seasonal patterns of gas
    demand for heating. The function delegates to simple_timeseries for data collection
    and export.

    Parameters
    ----------
    result_path
        Path where the evaluation results will be saved.
    nc
        Dictionary containing PyPSA network objects, typically keyed by year or scenario.
    config
        Configuration dictionary containing view settings including bus_carrier specification,
        storage_links, chart type, and export parameters.

    Notes
    -----
    Time series data shows the seasonal nature of gas demand, particularly for heating,
    and the role of gas storage in balancing supply and demand. It also reveals the
    transition from fossil natural gas to renewable and synthetic methane sources.
    """
    simple_timeseries(nc, config, result_path)

view_timeseries_residual_load(result_path, nc, config)

Evaluate and export time series data for the residual load

This function generates hourly time series showing residual load calculated as the load on the respective AC bus (i.e. all withdrawal except electricity transmission and storage) + tranmission losses - electricity from fluctuating renewable sources (e.g. wind, solar). The function delegates to simple_residual_load for data collection and export.

Parameters:

Name Type Description Default
result_path str | pathlib.Path

Path where the evaluation results will be saved.

 required
nc pypsa.NetworkCollection

Dictionary containing PyPSA network objects, typically keyed by year or scenario.

 required
config dict

Configuration dictionary containing view settings including bus_carrier specification, storage_links, chart type, and export parameters.

 required
Source code in evals/views/balances_timeseries.py 
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
def view_timeseries_residual_load(
    result_path: str | Path,
    nc: NetworkCollection,
    config: dict,
) -> None:
    """
    Evaluate and export time series data for the residual load

    This function generates hourly time series showing residual load calculated
    as the load on the respective AC bus (i.e. all withdrawal except electricity
    transmission and storage) + tranmission losses - electricity from fluctuating
    renewable sources (e.g. wind, solar). The function delegates to
    simple_residual_load for data collection and export.

    Parameters
    ----------
    result_path
        Path where the evaluation results will be saved.
    nc
        Dictionary containing PyPSA network objects, typically keyed by year or scenario.
    config
        Configuration dictionary containing view settings including bus_carrier specification,
        storage_links, chart type, and export parameters.

    """
    simple_residual_load(nc, config, result_path)