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:

For more information and examples, call slp_info().

Period definitions:

Day definitions:

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:

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:

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)


[Package standardlastprofile version 1.0.0 Index]