energy_data_retrieval.sources.station.client#

Measured hourly station data with explicit units, identity and interval labels.

class energy_data_retrieval.sources.station.client.StationSchema(station_column: 'str', timestamp_column: 'str', timezone: 'str', timestamp_label: 'str', ghi_column: 'str', ghi_unit: 'str', temperature_column: 'str | None' = None, temperature_unit: 'str' = 'degC', wind_speed_column: 'str | None' = None, wind_speed_unit: 'str' = 'm/s', gust_column: 'str | None' = None, gust_unit: 'str' = 'm/s', gust_statistic: 'str' = 'hourly_maximum', sampling: 'str' = 'hourly_mean', irradiance_kind: 'str' = 'GHI', decimal_separator: 'str' = '.', source_label: 'str' = 'measured-station', sheet: 'str | None' = None, skiprows: 'int' = 0, delimiter: 'str' = ',')[source]#

Bases: object

Parameters:
  • station_column (str)

  • timestamp_column (str)

  • timezone (str)

  • timestamp_label (str)

  • ghi_column (str)

  • ghi_unit (str)

  • temperature_column (str | None)

  • temperature_unit (str)

  • wind_speed_column (str | None)

  • wind_speed_unit (str)

  • gust_column (str | None)

  • gust_unit (str)

  • gust_statistic (str)

  • sampling (str)

  • irradiance_kind (str)

  • decimal_separator (str)

  • source_label (str)

  • sheet (str | None)

  • skiprows (int)

  • delimiter (str)

station_column: str#
timestamp_column: str#
timezone: str#
timestamp_label: str#
ghi_column: str#
ghi_unit: str#
temperature_column: str | None#
temperature_unit: str#
wind_speed_column: str | None#
wind_speed_unit: str#
gust_column: str | None#
gust_unit: str#
gust_statistic: str#
sampling: str#
irradiance_kind: str#
decimal_separator: str#
source_label: str#
sheet: str | None#
skiprows: int#
delimiter: str#
energy_data_retrieval.sources.station.client.normalize_station(frame, mapping, schema)[source]#

Produce hourly weather without interpolation or inferred station suitability.

A station may serve several explicitly mapped sites, but each site may use only one station within this import. No nearest-station selection is guessed. Missing optional observations stay null, and negatives are retained for QA.

Parameters:
Return type:

DataFrame

energy_data_retrieval.sources.station.client.import_station(path, mapping_path, output, schema, *, member=None)[source]#
Parameters:
  • path (Path)

  • mapping_path (Path)

  • output (Path)

  • schema (StationSchema)

  • member (str | None)

Return type:

Artifact