Dataset
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 useNaN to represent absent values, another common option is bit masking.
Registered datasets
These are “well known” datasets that Tariff Components take as inputs. These you need to provide “from the outside” to the calculation to determine the cost. Note that most calculations only use a subset of these - and for some metering points a dataset may not exist, in which case you can safely skip the dataset.| Name | Resolution | Unit | Description |
|---|---|---|---|
| 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 (prima) subscribed power offtake capacity |
| yearly-additional-firm-subscribed-offtake-capacity | yearly | kW | Additional firm (prima) subscribed power offtake capacity, typically only applicable during the winter period |
| yearly-firm-subscribed-injection-capacity | yearly | kW | Firm (prima) subscribed power injection capacity |
| yearly-conditional-subscribed-offtake-capacity | yearly | kW | Conditional (secunda) subscribed power offtake capacity |
| yearly-conditional-subscribed-injection-capacity | yearly | kW | Conditional (secunda) subscribed power injection capacity |
| hourly-available-conditional-offtake-capacity | hourly | kW | Conditional (secunda) offtake capacity actually available each hour — equals the subscribed level when not curtailed, lower or zero during DSO-initiated curtailment |
| hourly-available-conditional-injection-capacity | hourly | kW | Conditional (secunda) injection capacity actually available each hour — equals the subscribed level when not curtailed, lower or zero during DSO-initiated curtailment |
| quarter-hourly-day-ahead-price-no1 | quarter_hourly | NOK_per_kWh | Day-ahead spot price, zone NO1 |
| quarter-hourly-day-ahead-price-no2 | quarter_hourly | NOK_per_kWh | Day-ahead spot price, zone NO2 |
| quarter-hourly-day-ahead-price-no3 | quarter_hourly | NOK_per_kWh | Day-ahead spot price, zone NO3 |
| quarter-hourly-day-ahead-price-no4 | quarter_hourly | NOK_per_kWh | Day-ahead spot price, zone NO4 |
| quarter-hourly-day-ahead-price-no5 | quarter_hourly | NOK_per_kWh | Day-ahead spot price, zone NO5 |
| 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 |
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 [blocked] 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.
Identifier for this dataset. For registered datasets this is a globally unique slug; for intermediate pipeline results it is a local reference name.
"quarter-hourly-energy-offtake"
"filtered_power"
"weighted_power"
Temporal resolution of the timeseries.
quarter_hourly, hourly, daily, weekly, monthly, yearly Unit of the timeseries.
A, kV, kW, kWh, hours, SEK, NOK, EUR, SEK_per_kWh, SEK_per_kW, NOK_per_kWh, NOK_per_kW, EUR_per_kWh, EUR_per_kW, %