atmospy: air quality data visualization

atmospy is a Python visualization library based on matplotlib and seaborn.

Documentation

Documentation for atmospy can be found here.

Dependencies

Supported Python versions

atmospy supports Python 3.10 and newer.

Mandatory dependencies

• numpy
• pandas
• seaborn
• matplotlib
• scipy

Installation

The latest release can be installed directly from PyPi:

$ pip install atmospy

You can also install pre-releases from GitHub:

$ pip install atmospy --pre

If you would like to install from a specific branch or release, you can do so directly from GitHub:

$ pip install git+https://github.com/dhhagan/atmospy.git@<tag-or-version>

Development

atmospy development takes place on GitHub: https://github.com/dhhagan/atmospy

The project is managed with uv. To set up a development environment, clone the repository and run:

$ uv sync

This creates a virtual environment in .venv and installs atmospy in editable mode along with the test dependencies. To build the documentation locally, include the docs dependency group as well:

$ uv sync --group docs

Testing

Run the test suite with:

$ uv run pytest

By default this runs entirely offline on synthetic data. Tests that download the example datasets are skipped unless you opt in:

$ uv run pytest --run-network

Please submit bugs that you encounter to the issue tracker with a reproducible example that clearly demonstrates the problem.