# Varunayan
<p align="center">
<img src="https://raw.githubusercontent.com/saketlab/varunayan/main/docs/_static/varunayan_logo.png" alt="Varunayan Logo" width="200"/>
</p>
A Python package for downloading and processing ERA5 climate data.
## Installation
Install the latest release from PyPI:
```bash
pip install varunayan
```
For development, clone the repository and install it locally:
```bash
pip install -e .
```
## Quick Start
Quickly extract ERA5 processed data with the help of *varunayan* from the command line:
1. either by providing a GeoJSON file to define the area of interest
```bash
varunayan geojson --request-id "request_name" --variables "var1,var2,etc." --start "yyyy-mm-dd" --end "yyyy-mm-dd" --geojson "your_file.geojson" --dataset-type "dataset_type" --pressure-levels "pressure_level_1,pressure_level_2,etc." --freq "frequency" --res "resolution"
```
2. or by providing a bounding box to define the area of interest
```bash
varunayan bbox --request-id "request_name" --variables "var1,var2,etc." --start "yyyy-mm-dd" --end "yyyy-mm-dd" --north "north_bound" --south "south_bound" --east "east_bound" --west "west_bound" --dataset-type "dataset_type" --pressure-levels "pressure_level_1,pressure_level_2,etc." --freq "frequency" --res "resolution"
```
3. or by providing coordinates of the location
```bash
varunayan point --request-id "request_name" --variables "var1,var2,etc." --start "yyyy-mm-dd" --end "yyyy-mm-dd" --lat "latitude" --lon "longitude" --dataset-type "dataset_type" --pressure-levels "pressure_level_1,pressure_level_2,etc." --freq "frequency"
```
The arguments dataset-type (single by default), pressure-levels (empty by default), freq (hourly by default) and res (0.25 by default) are optional.
Example command for extracting pressure-level data for a bounding box
```bash
varunayan bbox --request-id "test" --variables "temperature,relative_humidity" --start "2024-01-1" --end "2024-01-15" --north 30 --south 20 --east 80 --west 70 --dataset-type pressure --pressure-levels "1000,900" --freq daily --res 0.25
```
## Documentation
Please visit our [documentation page](http://saketlab.github.io/varunayan) for detailed documentation.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "varunayan",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "Atharva Jagtap <atharvajagtap1108@gmail.com>, Saket Choudhary <saketc@iitb.ac.in>",
"keywords": "atmospheric-science, climate, era5, geospatial, netcdf, weather",
"author": null,
"author_email": "Atharva Jagtap <atharvajagtap1108@gmail.com>, Saket Choudhary <saketc@iitb.ac.in>",
"download_url": "https://files.pythonhosted.org/packages/cb/80/7f24650042cb1cd00e2ecea9068ecb33a514d6636bdd3bfe1428db2bae48/varunayan-0.1.1.tar.gz",
"platform": null,
"description": "# Varunayan\n\n<p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/saketlab/varunayan/main/docs/_static/varunayan_logo.png\" alt=\"Varunayan Logo\" width=\"200\"/>\n</p>\n\nA Python package for downloading and processing ERA5 climate data.\n\n## Installation\n\nInstall the latest release from PyPI:\n\n```bash\npip install varunayan\n```\n\nFor development, clone the repository and install it locally:\n\n```bash\npip install -e .\n```\n\n## Quick Start\n\n\nQuickly extract ERA5 processed data with the help of *varunayan* from the command line:\n\n\n1. either by providing a GeoJSON file to define the area of interest\n```bash\nvarunayan geojson --request-id \"request_name\" --variables \"var1,var2,etc.\" --start \"yyyy-mm-dd\" --end \"yyyy-mm-dd\" --geojson \"your_file.geojson\" --dataset-type \"dataset_type\" --pressure-levels \"pressure_level_1,pressure_level_2,etc.\" --freq \"frequency\" --res \"resolution\"\n```\n\n2. or by providing a bounding box to define the area of interest\n```bash\nvarunayan bbox --request-id \"request_name\" --variables \"var1,var2,etc.\" --start \"yyyy-mm-dd\" --end \"yyyy-mm-dd\" --north \"north_bound\" --south \"south_bound\" --east \"east_bound\" --west \"west_bound\" --dataset-type \"dataset_type\" --pressure-levels \"pressure_level_1,pressure_level_2,etc.\" --freq \"frequency\" --res \"resolution\"\n```\n\n3. or by providing coordinates of the location\n```bash\nvarunayan point --request-id \"request_name\" --variables \"var1,var2,etc.\" --start \"yyyy-mm-dd\" --end \"yyyy-mm-dd\" --lat \"latitude\" --lon \"longitude\" --dataset-type \"dataset_type\" --pressure-levels \"pressure_level_1,pressure_level_2,etc.\" --freq \"frequency\"\n```\n\nThe arguments dataset-type (single by default), pressure-levels (empty by default), freq (hourly by default) and res (0.25 by default) are optional.\n\nExample command for extracting pressure-level data for a bounding box\n```bash\nvarunayan bbox --request-id \"test\" --variables \"temperature,relative_humidity\" --start \"2024-01-1\" --end \"2024-01-15\" --north 30 --south 20 --east 80 --west 70 --dataset-type pressure --pressure-levels \"1000,900\" --freq daily --res 0.25\n```\n\n## Documentation\n\nPlease visit our [documentation page](http://saketlab.github.io/varunayan) for detailed documentation.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. \n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Analysis-ready climate data downloader and processor for custom regions",
"version": "0.1.1",
"project_urls": {
"Documentation": "https://saketlab.github.io/varunayan",
"Homepage": "https://github.com/saketlab/varunayan",
"Issues": "https://github.com/saketlab/varunayan/issues",
"Repository": "https://github.com/saketlab/varunayan"
},
"split_keywords": [
"atmospheric-science",
" climate",
" era5",
" geospatial",
" netcdf",
" weather"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "656368804538d317c766bb94cd9bec710c0d5327914d3cef55bd15eddaae43c6",
"md5": "4b9ecac8dfe4b829325dc7007fa5c536",
"sha256": "94792425e6756cd838a1aa271e12e0b81e8bfcc73605762de01b6e9304d49216"
},
"downloads": -1,
"filename": "varunayan-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4b9ecac8dfe4b829325dc7007fa5c536",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 46201,
"upload_time": "2025-10-15T07:33:48",
"upload_time_iso_8601": "2025-10-15T07:33:48.271150Z",
"url": "https://files.pythonhosted.org/packages/65/63/68804538d317c766bb94cd9bec710c0d5327914d3cef55bd15eddaae43c6/varunayan-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "cb807f24650042cb1cd00e2ecea9068ecb33a514d6636bdd3bfe1428db2bae48",
"md5": "2a32dc13d2a724e779d543bc1fa23bb7",
"sha256": "dfaf8cb2f4a8425f6b0511f7d1d97c49c7be72d1ffd0f2b3611d90090a5a25f7"
},
"downloads": -1,
"filename": "varunayan-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "2a32dc13d2a724e779d543bc1fa23bb7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 4845470,
"upload_time": "2025-10-15T07:33:51",
"upload_time_iso_8601": "2025-10-15T07:33:51.336011Z",
"url": "https://files.pythonhosted.org/packages/cb/80/7f24650042cb1cd00e2ecea9068ecb33a514d6636bdd3bfe1428db2bae48/varunayan-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-15 07:33:51",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "saketlab",
"github_project": "varunayan",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "pytest",
"specs": [
[
">=",
"7.0.0"
]
]
},
{
"name": "pytest-cov",
"specs": [
[
">=",
"4.0.0"
]
]
},
{
"name": "black",
"specs": [
[
">=",
"22.0.0"
]
]
},
{
"name": "flake8",
"specs": [
[
">=",
"6.0.0"
]
]
},
{
"name": "mypy",
"specs": [
[
">=",
"1.0.0"
]
]
},
{
"name": "sphinx",
"specs": [
[
">=",
"6.0.0"
]
]
},
{
"name": "sphinx-rtd-theme",
"specs": [
[
">=",
"1.0.0"
]
]
}
],
"lcname": "varunayan"
}
JSON
