energy_data_retrieval.tabular#

Bounded, explicit imports for preserved source exports, without guessing schemas.

energy_data_retrieval.tabular.read_export(path, *, member=None, sheet=None, skiprows=0, delimiter=',', maximum_bytes=536870912, maximum_rows=2000000)[source]#

Read a selected CSV/XLSX table; ZIP members are never extracted to disk.

Limits apply to source bytes, the selected decompressed member and table rows. XLSX cells use cached values with read-only iteration, never evaluated formulas. Column names, delimiter, sheet and preamble length are explicit source contracts.

Parameters:
  • path (Path)

  • member (str | None)

  • sheet (str | None)

  • skiprows (int)

  • delimiter (str)

  • maximum_bytes (int)

  • maximum_rows (int)

Return type:

DataFrame

energy_data_retrieval.tabular.numeric_values(values, *, decimal='.')[source]#

Keep blank/explicit missing values; reject malformed numbers and infinities.

Parameters:
  • values (Series)

  • decimal (str)

Return type:

Series

energy_data_retrieval.tabular.utc_intervals(values, *, timezone, label)[source]#

Resolve one-hour timestamps without guessing DST folds or nonexistent times.

Parameters:
  • values (Series)

  • timezone (str)

  • label (str)

Return type:

Series

energy_data_retrieval.tabular.identity_mapping(path, columns)[source]#

Load exact source identifiers without fuzzy name joins or numeric coercion.

Parameters:
  • path (Path)

  • columns (tuple[str, ...])

Return type:

DataFrame