Model structure

Model structure

The model structure defines the format of the preprocessed data which is ready to be optimized by oemof.

Elements

All busses are defined in oemof_flexmex/results/scenario/01_preprocessed/data/elements/bus.csv.

The preprocessed component data is also stored in oemof_flexmex/results/scenario/01_preprocessed/data/elements

The filenames for the components are of the form

{carrier}-{tech}.csv

(e.g. electricity-demand.csv, gas-bpchp.csv).

The first columns of the component scalars file are similar in all of the files. They contain the following information:

  • region: Region of a component. Modelled regions are defined here

  • name: Unique name ('region-carrier-tech', eg. 'LU-gas-bpchp', 'AT-electricity-airsourcehp')

  • type: Type of oemof.tabular.facade

  • carrier: Energy sector according to carrier (e.g. solar, wind, biomass, coal, lignite, uranium, oil, gas, methane, hydro, waste, electricity, heat).

  • tech: Specification of the technology (e.g. pv, onshore, offshore, battery, demand, curtailment, shortage, transmission, ror, st, ocgt, ccgt, extchp, bpchp)

Following these columns, the attributes for the respective components are defined. The number and kind of attributes varies between components.

Sequences

The input timeseries are combined into a new set of CSV files, with one file per technology. The preprocessed sequences are stored in

results/{scenario name}/01_preprocessed/data/sequences/{technology}_profile.csv

The filenames are of the form

<carrier>-<tech>_<profile>.csv

(e.g. wind-offshore_profile.csv, electricity-demand_profile.csv).

Each sequence file contains the hourly profile of all the regions, organized in rows. They are indexed by a pandas datetimeindex. The column names have the structure {region}-{technology}-profile.

Available components

These components are available in oemof-flexmex.

name

path

description

electricity-demand

component_attrs/electricity-demand.csv

Electricity demand

heat-shortage

component_attrs/heat-shortage.csv

Shortage backup to keep model solvable

electricity-shortage

component_attrs/electricity-shortage.csv

Shortage backup to keep model solvable

electricity-transmission

component_attrs/electricity-transmission.csv

Electrical transmission between regions

solar-pv

component_attrs/solar-pv.csv

Solar pv capacities

wind-offshore

component_attrs/wind-offshore.csv

Offshore wind capacities

wind-onshore

component_attrs/wind-onshore.csv

Onshore wind capacities

electricity-curtailment

component_attrs/electricity-curtailment.csv

Curtailment of non-dispatchable electricity

ch4-gt

component_attrs/ch4-gt.csv

Open cycle gas turbine gas turbine capacities (natural gas driven)

uranium-nuclear-st

component_attrs/uranium-nuclear-st.csv

Nuclear power plant capacities (steam turbine)

ch4-bpchp

component_attrs/ch4-bpchp.csv

Backpressure turbine CHP

ch4-boiler-small

component_attrs/ch4-boiler.csv

Peak load boiler

ch4-boiler-large

component_attrs/ch4-boiler.csv

Peak load boiler

ch4-extchp

component_attrs/ch4-extchp.csv

Extraction turbine CHP

electricity-pth

component_attrs/electricity-pth.csv

Resistive heater (Power-to-Heat)

heat-demand

component_attrs/heat-demand.csv

Heat demand

electricity-h2_cavern

component_attrs/electricity-h2_cavern.csv

Large scale H2 storage

electricity-liion_battery

component_attrs/electricity-liion_battery.csv

Li-ion battery storage

electricity-heatpump-small

component_attrs/electricity-heatpump.csv

Airsource compression heatpump

electricity-heatpump-large

component_attrs/electricity-heatpump.csv

Airsource compression heatpump

heat-storage-small

component_attrs/heat-storage.csv

Small sensible heat storage

heat-storage-large

component_attrs/heat-storage.csv

Large scale sensible heat storage

heat-excess

component_attrs/heat-excess.csv

Heat excess

hydro-reservoir

component_attrs/hydro-reservoir.csv

Hydro reservoir

electricity-bev

component_attrs/electricity-bev.csv

Battery electric vehicle

Component attributes

The component’s attributes are defined in separate csv files contained in oemof-flexmex/model_structure/component_attrs/

Extra parameters

tabular supports handing over extra output_parameters and input_parameters to the components’ classes. These have to be given as dict’s in the corresponding CSV field. If you want to pass more than two parameters:

  1. Enclose the dict with quotes and use double-quotes in it (less readable).

OR

  1. Make the CSV file semicolon-separated and separate the output_parameters and/or input_parameters with commas (better readable).

    More over, all component read_csv() function calls in preprocessing.csv must be adapted to the new separator (sep=';').

    See https://github.com/modex-flexmex/oemo-flex/issues/57 for details.