download_era5_land#
- class download_era5.download_era5_land(area: str | Path | tuple | GeoDataFrame, variables: str | List[str], start_date: str | datetime, end_date: str | datetime, output_dir: str | Path | None = None, n_parallel: int = 1, keep_chunks: bool = False, force_overwrite: bool = False, output_prefix: str = 'ERA5LAND')[source]#
Download ERA5-Land data with simplified interface.
Parameters#
- areaUnion[str, pathlib.Path, tuple, gpd.GeoDataFrame]
Area specification (bounding box, file path, or GeoDataFrame).
- variablesUnion[str, List[str]]
Variables to download (names, categories, or profiles).
- start_dateUnion[str, datetime]
Start date for download period. Supports partial dates: - ‘2025-04-23’ -> exact date - ‘2025-04’ -> first day of month (2025-04-01) - ‘2025’ -> first day of year (2025-01-01)
- end_dateUnion[str, datetime]
End date for download period. Supports partial dates: - ‘2025-04-23’ -> exact date - ‘2025-04’ -> last day of month (2025-04-30) - ‘2025’ -> last day of year (2025-12-31)
- output_dirOptional[Union[str, pathlib.Path]], default None
Output directory for downloaded files.
- n_parallelint, default 1
Number of parallel download threads.
- keep_chunksbool, default False
Whether to keep intermediate monthly chunk files.
- force_overwritebool, default False
Whether to overwrite existing files.
- output_prefixstr, default ‘ERA5LAND’
Prefix for output filenames.
Returns#
- Dict[str, pathlib.Path]
Dictionary mapping variable names to output file paths.