powersys_cumulative_surplus_RTD {finnishgrid}

Surplus/deficit, cumulative - real time data

Description

Information is based on the real time measurements in Fingrid's power control system.Power deficit/surplus represents the balance between production and consumption in Finland, taking into account imports and exports. It is calculated as the difference between the measured net import/export and the confirmed net exchange program between Finland and the other Nordic countries. The cumulative production deficit/surplus is the hourly energy generated from the difference.Sign convention: production deficit -, surplus +The data is updated every 3 minutes.

Usage

powersys_cumulative_surplus_RTD(
  start_time_utc = NA,
  end_time_utc = NA,
  user_key = NA
)

Arguments

start_time_utc

Start time in UTC. Character array YYYY-MM-ddTHH:mm:ss.sssZ

end_time_utc

End time in UTC. Character array YYYY-MM-ddTHH:mm:ss.sssZ

user_key

Character array holding API-key. Free from https://data.fingrid.fi/en/instructions

Value

A data frame object with time series data having period 3 min and unit type MW.

See Also

https://data.fingrid.fi/en/datasets/186

Examples

## Not run: 
library(finnishgrid)
start = "2024-06-01T00:00:00.000Z"  # UTC
end = "2024-06-03T00:00:00.000Z"    # UTC
key = "MY_SUPER_SECRET"
df <- powersys_cumulative_surplus_RTD(start_time_utc = start,
         end_time_utc = end,
         user_key = key)
summary(df)

## End(Not run)