Skip to main content

A named timeseries with known resolution and unit.

Used both for describing registered datasets (see below) as well as for naming the intermediate results that get created by each step in a function pipeline.

Absent values

All datasets in this API are fixed resolution. For an hourly dataset, there is some "slot" for each hour's value. However, some operations - Select for instance - can remove values from datasets, leaving "holes" or absent values behind. This is used for instance to select only weekends or certain times of year, "clearing" the rest of the dataset.

We leave it up to users of the API to decide how they wish to represent absent values. A common strategy is to use NaN to represent absent values, another common option is bit masking.

Registered datasets

These are datasets that Tariff Components take as inputs.

  • quarter-hourly-energy-offtake (quarter_hourly kWh): Energy consumed (imported) per quarter hour
  • quarter-hourly-energy-injection (quarter_hourly kWh): Energy exported (injected) per quarter hour
  • yearly-firm-subscribed-offtake-capacity (yearly kW): Firm subscribed power offtake capacity
  • quarter-hourly-day-ahead-price-se1 (quarter_hourly SEK_per_kWh): Day-ahead spot price, zone SE1
  • quarter-hourly-day-ahead-price-se2 (quarter_hourly SEK_per_kWh): Day-ahead spot price, zone SE2
  • quarter-hourly-day-ahead-price-se3 (quarter_hourly SEK_per_kWh): Day-ahead spot price, zone SE3
  • quarter-hourly-day-ahead-price-se4 (quarter_hourly SEK_per_kWh): Day-ahead spot price, zone SE4
​
id
string
required

Identifier for this dataset. For registered datasets this is a globally unique slug; for intermediate pipeline results it is a local reference name.

Examples:

"quarter-hourly-energy-offtake"

"filtered_power"

"weighted_power"

​
resolution
enum<string>
required

Temporal resolution of the timeseries.

Available options:
quarter_hourly,
hourly,
daily,
weekly,
monthly,
yearly
​
unit
enum<string>
required

Unit of the timeseries.

Available options:
A,
kV,
kW,
kWh,
hours,
SEK,
NOK,
SEK_per_kWh,
SEK_per_kW,
%