https://github.com/daniloceano/atmos-bud

Computes heat, vorticity and water budgets for a limited area in the atmosphere

https://github.com/daniloceano/atmos-bud

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (10.4%) to scientific vocabulary

Keywords

atmospheric-science data-analysis geoscience geospatial-data meteorology thermodynamics
Last synced: 4 months ago · JSON representation

Repository

Computes heat, vorticity and water budgets for a limited area in the atmosphere

Basic Info
  • Host: GitHub
  • Owner: daniloceano
  • License: gpl-3.0
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 137 MB
Statistics
  • Stars: 10
  • Watchers: 1
  • Forks: 4
  • Open Issues: 0
  • Releases: 0
Topics
atmospheric-science data-analysis geoscience geospatial-data meteorology thermodynamics
Created over 3 years ago · Last pushed 5 months ago
Metadata Files
Readme Changelog License

README.md

ATMOS-BUD Overview

Python 3.10+ Version 0.1.1 Test Coverage 62% Tests 114+ Documentation Status License

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.

Owner

  • Name: Danilo Couto de Souza
  • Login: daniloceano
  • Kind: user
  • Location: São Paulo

JOSS Publication

ATMOS-BUD: A Comprehensive Python Tool for Analyzing Heat, Vorticity and Water Budgets on the Atmosphere
Published
October 13, 2025
Volume 10, Issue 114, Page 8452
Authors
Danilo Couto de Souza ORCID
Universidade de São Paulo (USP), Instituto de Astronomia, Geofísica e Ciências Atmosféricas (IAG), São Paulo, Brazil &, Climate Risk Initiative, IRB(re), Rio de Janeiro, Brazil
Pedro Leite Silva da Dias ORCID
Universidade de São Paulo (USP), Instituto de Astronomia, Geofísica e Ciências Atmosféricas (IAG), São Paulo, Brazil &
Ricardo Hallak ORCID
Universidade de São Paulo (USP), Instituto de Astronomia, Geofísica e Ciências Atmosféricas (IAG), São Paulo, Brazil &
Editor
Anjali Sandip ORCID
Tags
atmospheric diagnostics quasi-geostrophic meteorology climate python

GitHub Events

Total
  • Issues event: 7
  • Watch event: 3
  • Delete event: 2
  • Issue comment event: 4
  • Push event: 59
  • Pull request event: 10
  • Fork event: 3
  • Create event: 2
Last Year
  • Issues event: 7
  • Watch event: 3
  • Delete event: 2
  • Issue comment event: 4
  • Push event: 59
  • Pull request event: 10
  • Fork event: 3
  • Create event: 2

Committers

Last synced: 10 months ago

All Time
  • Total Commits: 145
  • Total Committers: 1
  • Avg Commits per committer: 145.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 18
  • Committers: 1
  • Avg Commits per committer: 18.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
daniloceano d****o@g****m 145

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 31 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 3
  • Total maintainers: 1
pypi.org: atmos-bud

Program for analyzing the heat, vorticity and humidity budgets of limited regions on the atmosphere.

  • Versions: 3
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 31 Last month
Rankings
Dependent packages count: 9.0%
Average: 29.7%
Dependent repos count: 50.5%
Maintainers (1)
Last synced: 5 months ago

Dependencies

requirements.txt pypi
  • Cartopy ==0.21.1
  • MetPy ==1.4.1
  • Pillow ==9.4.0
  • Pint ==0.20.1
  • PyQt5-sip ==12.11.0
  • atomicwrites ==1.4.0
  • brotlipy ==0.7.0
  • cmocean ==3.0.3
  • contourpy ==1.0.7
  • cycler ==0.11.0
  • fonttools ==4.39.3
  • inflection ==0.5.1
  • joblib ==1.2.0
  • kiwisolver ==1.4.4
  • matplotlib ==3.7.1
  • mkl-fft ==1.3.1
  • mkl-service ==2.4.0
  • mypy-extensions ==0.4.3
  • pandas ==1.5.3
  • platformdirs ==3.4.0
  • ply ==3.11
  • pooch ==1.7.0
  • pyls-spyder ==0.4.0
  • pyparsing ==3.0.9
  • pyproj ==3.5.0
  • pyshp ==2.3.1
  • python-lsp-jsonrpc ==1.0.0
  • scikit-learn ==1.2.2
  • scipy ==1.10.1
  • shapely ==2.0.1
  • threadpoolctl ==3.1.0
  • webencodings ==0.5.1
  • zict ==2.1.0
docs/requirements.txt pypi
  • sphinx ==7.2.6
.github/workflows/ci.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
setup.py pypi
  • Cartopy ==0.22.0
  • MetPy ==1.6.1
  • cdsapi >=0.6
  • dask ==2024.2.0
  • numpy ==1.26.4
  • pandas ==2.2.3
  • scipy ==1.12.0
  • xarray ==2025.4.0