energy_data_retrieval.sources.smard.client#

SMARD’s published German solar and wind generation, in quarter-hour MWh.

These chart series are verified Bundesnetzagentur publications originating from ENTSO-E, not independent plant observations. SMARD already converts the upstream average MW to quarter-hour MWh. No additional division or power-to-energy conversion belongs in this parser.

energy_data_retrieval.sources.smard.client.normalize_generation(payload, *, technology, region='DE', maximum_rows=1000000)[source]#

Read one native weekly SMARD quarterhour series as interval MWh.

Epoch millisecond labels identify UTC interval starts and therefore preserve both occurrences of a repeated autumn civil hour. Nulls remain missing and reported zero/negative values are retained. Exact duplicates collapse; conflicting observations for the same interval raise.

Parameters:
  • payload (JSONValue)

  • technology (str)

  • region (str)

  • maximum_rows (int)

Return type:

DataFrame

class energy_data_retrieval.sources.smard.client.SMARDClient(http, maximum_requests=64, maximum_rows=1000000)[source]#

Bases: object

Bounded index and weekly-series retrieval from the public chart downloads.

Parameters:
  • http (HTTPClient)

  • maximum_requests (int)

  • maximum_rows (int)

http: HTTPClient#
maximum_requests: int#
maximum_rows: int#
generation(start, end, *, technologies=('solar', 'wind_onshore', 'wind_offshore'), region='DE')[source]#

Fetch inclusive German civil dates, preserving the source’s MWh values.

Index requests discover actual week boundaries rather than assuming every local week is 168 hours. Each downloaded week is filtered to the requested half-open UTC interval. Solar, onshore and offshore wind are separate non-overlapping series, not a complete national energy mix.

Parameters:
  • start (date)

  • end (date)

  • technologies (Sequence[str])

  • region (str)

Return type:

GenerationResult