# ATMOS-BUD Overview
[](https://www.python.org/downloads/)
[](https://github.com/daniloceano/ATMOS-BUD/releases)
[](https://github.com/daniloceano/ATMOS-BUD)
[](https://github.com/daniloceano/ATMOS-BUD)
ATMOS-BUD is a comprehensive software suite designed for calculating heat, vorticity, and moisture balances within limited areas of the atmosphere. Developed at the Institute of Astronomy, Geophysics, and Atmospheric Sciences of the University of São Paulo, it's a key tool for students and researchers in atmospheric sciences.
### Key Features
- Processes atmospheric model and reanalysis data in NetCDF format.
- Outputs CSV files for spatial averages and a comprehensive NetCDF file for spatial results.
- Supports Fixed Domain, Semi-Lagrangian Domain, and Interactive Domain operational frameworks.
### Quasi-Geostrophic Thermodynamic Equation
```plaintext
∂T/∂t = -Vh · ∇hT - Σω + Q
```
*Where T is temperature, Vh is the horizontal wind vector, Σ is the static stability parameter, ω is the vertical velocity, and Q represents diabatic heating.*
### Quasi-Geostrophic Vorticity Budget Equation
```plaintext
∂ζ/∂t = -Vh · ∇hζ - (ζω/Δp) - βv - ζ∇ · Vh - f∇ · Vh + Tilting Term
```
*Where ζ is vorticity, β is the change in Coriolis parameter with latitude, and f is the Coriolis parameter.*
### Water Budget Equation
```plaintext
∫∂q/∂t dp = -∫Vh · ∇q dp + ∫S dp
```
*Where q is specific humidity, Vh is the horizontal wind vector, and S represents net sources/sinks.*
ATMOS-BUD combines academic rigor with practical application, making it a gateway to understanding atmospheric dynamics for both educational exploration and advanced research.
### Full Documentation
The full documentation for ATMOS-BUD can be found on [Read the Docs](https://atmos-bud.readthedocs.io).
Raw data
{
"_id": null,
"home_page": "https://github.com/daniloceano/ATMOS-BUD",
"name": "atmos-bud",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "atmospheric science, meteorology, budget analysis, ERA5",
"author": "Danilo Couto de Souza",
"author_email": "danilo.oceano@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/52/ff/281dea9b895442675ea119a0e1a8bf1ca9d87f35bb1087fbeaa260c2bc5f/atmos-bud-0.1.5.tar.gz",
"platform": null,
"description": "\n\n# ATMOS-BUD Overview\n\n[](https://www.python.org/downloads/)\n[](https://github.com/daniloceano/ATMOS-BUD/releases)\n[](https://github.com/daniloceano/ATMOS-BUD)\n[](https://github.com/daniloceano/ATMOS-BUD)\n\n\n\nATMOS-BUD is a comprehensive software suite designed for calculating heat, vorticity, and moisture balances within limited areas of the atmosphere. Developed at the Institute of Astronomy, Geophysics, and Atmospheric Sciences of the University of S\u00e3o Paulo, it's a key tool for students and researchers in atmospheric sciences.\n\n### Key Features\n\n- Processes atmospheric model and reanalysis data in NetCDF format.\n- Outputs CSV files for spatial averages and a comprehensive NetCDF file for spatial results.\n- Supports Fixed Domain, Semi-Lagrangian Domain, and Interactive Domain operational frameworks.\n\n### Quasi-Geostrophic Thermodynamic Equation\n\n```plaintext\n\u2202T/\u2202t = -Vh \u00b7 \u2207hT - \u03a3\u03c9 + Q\n```\n*Where T is temperature, Vh is the horizontal wind vector, \u03a3 is the static stability parameter, \u03c9 is the vertical velocity, and Q represents diabatic heating.*\n\n### Quasi-Geostrophic Vorticity Budget Equation\n\n```plaintext\n\u2202\u03b6/\u2202t = -Vh \u00b7 \u2207h\u03b6 - (\u03b6\u03c9/\u0394p) - \u03b2v - \u03b6\u2207 \u00b7 Vh - f\u2207 \u00b7 Vh + Tilting Term\n```\n*Where \u03b6 is vorticity, \u03b2 is the change in Coriolis parameter with latitude, and f is the Coriolis parameter.*\n\n### Water Budget Equation\n\n```plaintext\n\u222b\u2202q/\u2202t dp = -\u222bVh \u00b7 \u2207q dp + \u222bS dp\n```\n*Where q is specific humidity, Vh is the horizontal wind vector, and S represents net sources/sinks.*\n\nATMOS-BUD combines academic rigor with practical application, making it a gateway to understanding atmospheric dynamics for both educational exploration and advanced research.\n\n### Full Documentation\n\nThe full documentation for ATMOS-BUD can be found on [Read the Docs](https://atmos-bud.readthedocs.io).\n",
"bugtrack_url": null,
"license": "GPL-3.0",
"summary": "Program for analyzing the heat, vorticity and humidity budgets of limited regions on the atmosphere.",
"version": "0.1.5",
"project_urls": {
"Documentation": "https://github.com/daniloceano/ATMOS-BUD/docs",
"Homepage": "https://github.com/daniloceano/ATMOS-BUD",
"Source": "https://github.com/daniloceano/ATMOS-BUD",
"Tracker": "https://github.com/daniloceano/ATMOS-BUD/issues"
},
"split_keywords": [
"atmospheric science",
" meteorology",
" budget analysis",
" era5"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fcdf9dc52d19d0ccb734c8218a844cba28ca1b15a1e4e0ba01013674b8456903",
"md5": "d00a382d5a0af8b6aaae4f62f3d936a9",
"sha256": "ddcd5c5cfd9fedcff3de3686d8a8852ee8af3e219817264d33f0a2d82ee20353"
},
"downloads": -1,
"filename": "atmos_bud-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d00a382d5a0af8b6aaae4f62f3d936a9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 15769,
"upload_time": "2025-08-15T15:33:34",
"upload_time_iso_8601": "2025-08-15T15:33:34.552859Z",
"url": "https://files.pythonhosted.org/packages/fc/df/9dc52d19d0ccb734c8218a844cba28ca1b15a1e4e0ba01013674b8456903/atmos_bud-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "52ff281dea9b895442675ea119a0e1a8bf1ca9d87f35bb1087fbeaa260c2bc5f",
"md5": "99282771f0f65bc1d2740dd2d57808d5",
"sha256": "c2c562753c30245e82ee851513d7a6935f1f0d41d7be7e44233af25d88152d7c"
},
"downloads": -1,
"filename": "atmos-bud-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "99282771f0f65bc1d2740dd2d57808d5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 15956,
"upload_time": "2025-08-15T15:33:35",
"upload_time_iso_8601": "2025-08-15T15:33:35.846624Z",
"url": "https://files.pythonhosted.org/packages/52/ff/281dea9b895442675ea119a0e1a8bf1ca9d87f35bb1087fbeaa260c2bc5f/atmos-bud-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-15 15:33:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "daniloceano",
"github_project": "ATMOS-BUD",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "Cartopy",
"specs": [
[
"==",
"0.22.0"
]
]
},
{
"name": "cdsapi",
"specs": [
[
"==",
"0.7.6"
]
]
},
{
"name": "certifi",
"specs": [
[
"==",
"2024.2.2"
]
]
},
{
"name": "cftime",
"specs": [
[
"==",
"1.6.3"
]
]
},
{
"name": "charset-normalizer",
"specs": [
[
"==",
"3.3.2"
]
]
},
{
"name": "click",
"specs": [
[
"==",
"8.1.7"
]
]
},
{
"name": "cloudpickle",
"specs": [
[
"==",
"3.0.0"
]
]
},
{
"name": "cmocean",
"specs": [
[
"==",
"3.1.3"
]
]
},
{
"name": "contourpy",
"specs": [
[
"==",
"1.2.0"
]
]
},
{
"name": "cycler",
"specs": [
[
"==",
"0.12.1"
]
]
},
{
"name": "dask",
"specs": [
[
"==",
"2024.2.0"
]
]
},
{
"name": "exceptiongroup",
"specs": [
[
"==",
"1.3.0"
]
]
},
{
"name": "fonttools",
"specs": [
[
"==",
"4.49.0"
]
]
},
{
"name": "fsspec",
"specs": [
[
"==",
"2024.2.0"
]
]
},
{
"name": "idna",
"specs": [
[
"==",
"3.6"
]
]
},
{
"name": "importlib-metadata",
"specs": [
[
"==",
"7.0.1"
]
]
},
{
"name": "iniconfig",
"specs": [
[
"==",
"2.1.0"
]
]
},
{
"name": "joblib",
"specs": [
[
"==",
"1.3.2"
]
]
},
{
"name": "kiwisolver",
"specs": [
[
"==",
"1.4.5"
]
]
},
{
"name": "locket",
"specs": [
[
"==",
"1.0.0"
]
]
},
{
"name": "lorenz-phase-space",
"specs": [
[
"==",
"1.2.1"
]
]
},
{
"name": "matplotlib",
"specs": [
[
"==",
"3.8.3"
]
]
},
{
"name": "MetPy",
"specs": [
[
"==",
"1.6.1"
]
]
},
{
"name": "netCDF4",
"specs": [
[
"==",
"1.6.5"
]
]
},
{
"name": "numpy",
"specs": [
[
"==",
"1.26.4"
]
]
},
{
"name": "packaging",
"specs": [
[
"==",
"23.2"
]
]
},
{
"name": "pandas",
"specs": [
[
"==",
"2.2.3"
]
]
},
{
"name": "partd",
"specs": [
[
"==",
"1.4.1"
]
]
},
{
"name": "pillow",
"specs": [
[
"==",
"10.2.0"
]
]
},
{
"name": "Pint",
"specs": [
[
"==",
"0.23"
]
]
},
{
"name": "platformdirs",
"specs": [
[
"==",
"4.2.0"
]
]
},
{
"name": "pluggy",
"specs": [
[
"==",
"1.6.0"
]
]
},
{
"name": "pooch",
"specs": [
[
"==",
"1.8.0"
]
]
},
{
"name": "pyarrow",
"specs": [
[
"==",
"15.0.0"
]
]
},
{
"name": "pyparsing",
"specs": [
[
"==",
"3.1.1"
]
]
},
{
"name": "pyproj",
"specs": [
[
"==",
"3.6.1"
]
]
},
{
"name": "pyshp",
"specs": [
[
"==",
"2.3.1"
]
]
},
{
"name": "pytest",
"specs": [
[
"==",
"8.3.5"
]
]
},
{
"name": "python-dateutil",
"specs": [
[
"==",
"2.9.0.post0"
]
]
},
{
"name": "pytz",
"specs": [
[
"==",
"2024.1"
]
]
},
{
"name": "PyYAML",
"specs": [
[
"==",
"6.0.1"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.31.0"
]
]
},
{
"name": "roman-numerals-py",
"specs": [
[
"==",
"3.1.0"
]
]
},
{
"name": "scikit-learn",
"specs": [
[
"==",
"1.4.1.post1"
]
]
},
{
"name": "scipy",
"specs": [
[
"==",
"1.12.0"
]
]
},
{
"name": "shapely",
"specs": [
[
"==",
"2.0.3"
]
]
},
{
"name": "six",
"specs": [
[
"==",
"1.16.0"
]
]
},
{
"name": "snowballstemmer",
"specs": [
[
"==",
"3.0.1"
]
]
},
{
"name": "threadpoolctl",
"specs": [
[
"==",
"3.3.0"
]
]
},
{
"name": "tomli",
"specs": [
[
"==",
"2.2.1"
]
]
},
{
"name": "toolz",
"specs": [
[
"==",
"0.12.1"
]
]
},
{
"name": "tqdm",
"specs": [
[
"==",
"4.66.2"
]
]
},
{
"name": "traitlets",
"specs": [
[
"==",
"5.14.1"
]
]
},
{
"name": "typing_extensions",
"specs": [
[
"==",
"4.9.0"
]
]
},
{
"name": "tzdata",
"specs": [
[
"==",
"2024.1"
]
]
},
{
"name": "urllib3",
"specs": [
[
"==",
"2.2.0"
]
]
},
{
"name": "xarray",
"specs": [
[
"==",
"2025.4.0"
]
]
},
{
"name": "zipp",
"specs": [
[
"==",
"3.17.0"
]
]
},
{
"name": "alabaster",
"specs": [
[
"==",
"0.7.16"
]
]
},
{
"name": "babel",
"specs": [
[
"==",
"2.17.0"
]
]
},
{
"name": "black",
"specs": [
[
"==",
"23.12.1"
]
]
},
{
"name": "docutils",
"specs": [
[
">=",
"0.14"
],
[
"<",
"0.19"
]
]
},
{
"name": "flake8",
"specs": [
[
"==",
"6.0.0"
]
]
},
{
"name": "imagesize",
"specs": [
[
"==",
"1.4.1"
]
]
},
{
"name": "Jinja2",
"specs": [
[
"==",
"3.1.6"
]
]
},
{
"name": "MarkupSafe",
"specs": [
[
"==",
"3.0.2"
]
]
},
{
"name": "Pygments",
"specs": [
[
"==",
"2.19.1"
]
]
},
{
"name": "Sphinx",
"specs": [
[
"==",
"5.0.0"
]
]
},
{
"name": "sphinx-rtd-theme",
"specs": [
[
"==",
"1.3.0"
]
]
},
{
"name": "sphinxcontrib-applehelp",
"specs": [
[
"==",
"2.0.0"
]
]
},
{
"name": "sphinxcontrib-devhelp",
"specs": [
[
"==",
"2.0.0"
]
]
},
{
"name": "sphinxcontrib-htmlhelp",
"specs": [
[
"==",
"2.1.0"
]
]
},
{
"name": "sphinxcontrib-jsmath",
"specs": [
[
"==",
"1.0.1"
]
]
},
{
"name": "sphinxcontrib-qthelp",
"specs": [
[
"==",
"2.0.0"
]
]
},
{
"name": "sphinxcontrib-serializinghtml",
"specs": [
[
"==",
"2.0.0"
]
]
},
{
"name": "twine",
"specs": [
[
"==",
"4.0.2"
]
]
}
],
"lcname": "atmos-bud"
}
