| slp_generate {standardlastprofile} | R Documentation |
Generate a Standard Load Profile
Description
Generate a standard load profile, normalized to an annual consumption of 1,000 kWh.
Usage
slp_generate(profile_id, start_date, end_date, state_code = NULL)
Arguments
profile_id |
load profile identifier, required |
start_date |
start date in ISO 8601 format, required |
end_date |
end date in ISO 8601 format, required |
state_code |
identifier for one of 16 German states, optional |
Details
In regards to the electricity market in Germany, the term "Standard Load Profile" refers to a representative pattern of electricity consumption over a specific period. These profiles can be used to depict the expected electricity consumption for various customer groups, such as households or businesses.
For each distinct combination of profile_id, period, and day, there
are 96 x 1/4 hour measurements of electrical power. Values are normalized so
that they correspond to an annual consumption of 1,000 kWh. That is, summing
up all the quarter-hourly consumption values for one year yields an approximate
total of 1,000 kWh/a; for more information, refer to the 'Examples' section,
or call vignette("algorithm-step-by-step").
In total there are 11 profile_id for three different customer groups:
Households:
H0Commercial:
G0,G1,G2,G3,G4,G5,G6Agriculture:
L0,L1,L2
For more information and examples, call slp_info().
Period definitions:
-
summer: May 15 to September 14 -
winter: November 1 to March 20 -
transition: March 21 to May 14, and September 15 to October 31
Day definitions:
-
workday: Monday to Friday -
saturday: Saturdays; Dec 24th and Dec 31th are considered a Saturdays too if they are not a Sunday -
sunday: Sundays and all public holidays
Note: The package supports public holidays for Germany,
retrieved from the nager.Date API.
Use the optional argument state_code to consider public holidays on a state
level too. Allowed values are listed below:
-
DE-BB: Brandenburg -
DE-BE: Berlin -
DE-BW: Baden-Württemberg -
DE-BY: Bavaria -
DE-HB: Bremen -
DE-HE: Hesse -
DE-HH: Hamburg -
DE-MV: Mecklenburg-Vorpommern -
DE-NI: Lower-Saxony -
DE-NW: North Rhine-Westphalia -
DE-RP: Rhineland-Palatinate -
DE-SH: Schleswig-Holstein -
DE-SL: Saarland -
DE-SN: Saxony -
DE-ST: Saxony-Anhalt -
DE-TH: Thuringia
start_date must be greater or equal to "1990-01-01". This is because public
holidays in Germany would be ambitious before the reunification in 1990
(think of the state of Berlin in 1989 and earlier).
end_date must be smaller or equal to "2073-12-31" because this is last
year supported by the nager.Date API.
Value
A data.frame with four variables:
-
profile_id, character, load profile identifier -
start_time, POSIXct / POSIXlt, start time -
end_time, POSIXct / POSIXlt, end time -
watts, numeric, electric power
Source
https://www.bdew.de/energie/standardlastprofile-strom/
https://www.bdew.de/media/documents/1999_Repraesentative-VDEW-Lastprofile.pdf
https://www.bdew.de/media/documents/2000131_Anwendung-repraesentativen_Lastprofile-Step-by-step.pdf
Examples
start <- "2024-01-01"
end <- "2024-12-31"
# multiple profile IDs are supported
L <- slp_generate(c("L0", "L1", "L2"), start, end)
head(L)
# you can specify one of the 16 ISO 3166-2:DE codes to take into
# account holidays determined at the level of the federal states
berlin <- slp_generate("H0", start, end, state_code = "DE-BE")
# for convenience, the codes can be specified without the prefix "DE-"
identical(berlin, slp_generate("H0", start, end, state_code = "BE"))
# state codes are not case-sensitive
identical(berlin, slp_generate("H0", start, end, state_code = "de-be"))
# consider only nationwide public holidays
H0_2024 <- slp_generate("H0", start, end)
# electric power values are normalized to consumption of ~1,000 kWh/a
sum(H0_2024$watts / 4 / 1000)