energy_data_retrieval.sources.gpcc.client#

GPCC Monthly v2025 archive plans, bounded retrieval and CF processing.

class energy_data_retrieval.sources.gpcc.client.GPCCRequest(start_year, end_year, resolution=0.5, end_month=12)[source]#

Bases: object

Inclusive years; v2025 uses five-year blocks through 2020, then monthly files.

2021-2024 is one four-year block. A recent requested month may not yet be published (about two months latency); HTTP failures are never treated as zero.

Parameters:
  • start_year (int)

  • end_year (int)

  • resolution (float)

  • end_month (int)

start_year: int#
end_year: int#
resolution: float#
end_month: int#
urls()[source]#
Return type:

tuple[str, …]

property doi: str#
class energy_data_retrieval.sources.gpcc.client.GPCCClient(http)[source]#

Bases: object

Parameters:

http (HTTPClient)

download(request, directory)[source]#

Stream archives sequentially using the shared retry/hash/checkpoint transport.

Parameters:
Return type:

tuple[RequestRecord, …]

energy_data_retrieval.sources.gpcc.client.iter_monthly(paths, *, start_year, end_year, bbox=None, use_infilled=False, maximum_values=20000000)[source]#

Yield monthly totals in mm, retaining NaNs; infilling is explicit opt-in.

Original archives retain all gauge/error diagnostics. These arrays expose only the selected precipitation variable and do not apply undercatch corrections.

Parameters:
  • paths (Sequence[Path])

  • start_year (int)

  • end_year (int)

  • bbox (tuple[float, float, float, float] | None)

  • use_infilled (bool)

  • maximum_values (int)

Return type:

Iterator[DataArray]