# Meteo Utils
This Python repository contains methods that allow the automatic download and processing of ECMWF data relevant for evapotranspiration modelling.
## Installation
With `conda`, you can create a complete environment with all the required librarie typing
```
conda env create -f environment.yml
```
or update a current environment:
```
conda env update -n <environment> -f environment.yml
```
## Requirements
### Registration at the Copernicus climate and atmoshperic data stores
This plugin allows the automatic download and preprocessing of ERA5 meteorological data, provided by ECMWF.
In order to properly work you should first register to get an ECWMF account [here](https://accounts.ecmwf.int/auth/realms/ecmwf/login-actions/registration?client_id=cds&tab_id=uP8OQT6ER-E).
Once registered, follow the next steps to configure the credentials for the processor:
1. Go to your *HOME* or *user* folder.
> In Linux/MacOS this folder is at `/home/your_user_name`. In windows it is usually at `C:\Users\your_user_name`.
2. Login to the [Climate Data Store](https://cds.climate.copernicus.eu/) with your ECMWF username and password,
then type the next URL address [https://cds.climate.copernicus.eu/how-to-api](https://cds.climate.copernicus.eu/how-to-api)
3. Create a blank ASCII file in your *HOME* folder named `.cdsapirc` (please note the dot `.` at the beginning of the string),
and paste the two lines that appear in the black box of the webpage.
> These two lines have the following format:
```
url: https://cds.climate.copernicus.eu/api
key: UID:API-KEY
```
where *UID* and *API-KEY* are your Copernicus Climate Data Store credentials.
4. Login to the [Atmospheric Data Store](https://ads.atmosphere.copernicus.eu/) with your ECMWF username and password,
then type the next URL address [https://ads.atmosphere.copernicus.eu/how-to-api](https://ads.atmosphere.copernicus.eu/how-to-api)
5. Create a blank ASCII file in your *HOME* folder named `.adsapirc` (please note the dot `.` at the beginning of the string),
and paste the two lines that appear in the black box of the webpage.
> These two lines have the following format:
```
url: https://ads.atmosphere.copernicus.eu/api
key: UID:API-KEY
```
where *UID* and *API-KEY* are your Copernicus Atmospheric Climate Data Store credentials.
## Usage
An example for using the package can be found in the script `process_era5.py`
Raw data
{
"_id": null,
"home_page": null,
"name": "meteo-utils",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "SEN-ET, Evapotranspiration, Landsat, Sentinel-3, SLSTR, Copernicus, ERA5, CAMS, ECMWF, Remote Sensing",
"author": null,
"author_email": "H\u00e9ctor Nieto <hector.nieto@csic.es>, Radoslaw Guzinski <rmgu@dhigroup.com>",
"download_url": "https://files.pythonhosted.org/packages/b8/4f/8b23b77edef3cd5c878848eb5a5aa0afc82ddbbab39636776723a7728d94/meteo_utils-2.1.0.tar.gz",
"platform": null,
"description": "# Meteo Utils\nThis Python repository contains methods that allow the automatic download and processing of ECMWF data relevant for evapotranspiration modelling.\n\n## Installation\nWith `conda`, you can create a complete environment with all the required librarie typing\n```\nconda env create -f environment.yml\n```\nor update a current environment:\n```\nconda env update -n <environment> -f environment.yml\n```\n\n## Requirements\n### Registration at the Copernicus climate and atmoshperic data stores\nThis plugin allows the automatic download and preprocessing of ERA5 meteorological data, provided by ECMWF.\nIn order to properly work you should first register to get an ECWMF account [here](https://accounts.ecmwf.int/auth/realms/ecmwf/login-actions/registration?client_id=cds&tab_id=uP8OQT6ER-E).\nOnce registered, follow the next steps to configure the credentials for the processor:\n\n1. Go to your *HOME* or *user* folder. \n > In Linux/MacOS this folder is at `/home/your_user_name`. In windows it is usually at `C:\\Users\\your_user_name`.\n\n2. Login to the [Climate Data Store](https://cds.climate.copernicus.eu/) with your ECMWF username and password, \nthen type the next URL address [https://cds.climate.copernicus.eu/how-to-api](https://cds.climate.copernicus.eu/how-to-api)\n\n3. Create a blank ASCII file in your *HOME* folder named `.cdsapirc` (please note the dot `.` at the beginning of the string),\nand paste the two lines that appear in the black box of the webpage.\n\n\n\n > These two lines have the following format:\n ```\n url: https://cds.climate.copernicus.eu/api\n key: UID:API-KEY\n ```\n where *UID* and *API-KEY* are your Copernicus Climate Data Store credentials.\n\n4. Login to the [Atmospheric Data Store](https://ads.atmosphere.copernicus.eu/) with your ECMWF username and password, \nthen type the next URL address [https://ads.atmosphere.copernicus.eu/how-to-api](https://ads.atmosphere.copernicus.eu/how-to-api)\n\n5. Create a blank ASCII file in your *HOME* folder named `.adsapirc` (please note the dot `.` at the beginning of the string),\nand paste the two lines that appear in the black box of the webpage.\n\n > These two lines have the following format:\n ```\n url: https://ads.atmosphere.copernicus.eu/api\n key: UID:API-KEY\n ```\n where *UID* and *API-KEY* are your Copernicus Atmospheric Climate Data Store credentials.\n\n## Usage\nAn example for using the package can be found in the script `process_era5.py`\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Python methods for the automatic download and processing of ECMWF data relevant for evapotranspiration modelling.",
"version": "2.1.0",
"project_urls": {
"Homepage": "https://github.com/hectornieto/meteo_utils"
},
"split_keywords": [
"sen-et",
" evapotranspiration",
" landsat",
" sentinel-3",
" slstr",
" copernicus",
" era5",
" cams",
" ecmwf",
" remote sensing"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "bab5dd215b88db427a63b533dde9bf2a3f7ab58bc214e970064ab1ae1c855fec",
"md5": "1f62df8b6fe7c2ff8d1a1f1b6db7363f",
"sha256": "3d22878d86d5dd79622cf6b2d560264141e7eee64962f76adcafb3de2d9cbd94"
},
"downloads": -1,
"filename": "meteo_utils-2.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1f62df8b6fe7c2ff8d1a1f1b6db7363f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 40171,
"upload_time": "2025-10-22T08:49:53",
"upload_time_iso_8601": "2025-10-22T08:49:53.327492Z",
"url": "https://files.pythonhosted.org/packages/ba/b5/dd215b88db427a63b533dde9bf2a3f7ab58bc214e970064ab1ae1c855fec/meteo_utils-2.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b84f8b23b77edef3cd5c878848eb5a5aa0afc82ddbbab39636776723a7728d94",
"md5": "7836c7b09b26015c8feee1ffcb0688b6",
"sha256": "e673fa38faaeb28c8d57a9073bbc07688d7b822bad50920a4f9b2ce85a425b44"
},
"downloads": -1,
"filename": "meteo_utils-2.1.0.tar.gz",
"has_sig": false,
"md5_digest": "7836c7b09b26015c8feee1ffcb0688b6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 40335,
"upload_time": "2025-10-22T08:49:54",
"upload_time_iso_8601": "2025-10-22T08:49:54.737155Z",
"url": "https://files.pythonhosted.org/packages/b8/4f/8b23b77edef3cd5c878848eb5a5aa0afc82ddbbab39636776723a7728d94/meteo_utils-2.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-22 08:49:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "hectornieto",
"github_project": "meteo_utils",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "cdsapi",
"specs": []
},
{
"name": "netCDF4",
"specs": []
},
{
"name": "numpy",
"specs": []
},
{
"name": "gdal",
"specs": []
},
{
"name": "osr",
"specs": []
},
{
"name": "scipy",
"specs": []
},
{
"name": "scikit-image",
"specs": []
},
{
"name": "pyyaml",
"specs": []
},
{
"name": "cfgrib",
"specs": []
},
{
"name": "xarray",
"specs": []
},
{
"name": "rioxarray",
"specs": []
},
{
"name": null,
"specs": []
},
{
"name": null,
"specs": []
}
],
"lcname": "meteo-utils"
}
JSON
