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:
objectInclusive 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#
- 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:
request (GPCCRequest)
directory (Path)
- 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]