AeroViz

Aerosol Data Processing and Visualization Toolkit for Atmospheric Research

Python PyPI Pytest Documentation License

AeroViz is a Python toolkit for reading, processing, and visualizing aerosol measurement data. It supports 18+ atmospheric instruments with built-in quality control, data processing, and publication-ready visualizations.

Installation

pip install AeroViz

Pre-built for Linux, macOS, and Windows — no compiler needed.

Quick Start

from AeroViz import RawDataReader

df = RawDataReader(
    instrument='AE33',
    path='/path/to/data',
    start='2024-01-01',  # optional — omit to read the files' full coverage
    end='2024-12-31',    # optional
    mean_freq='1h',      # optional — '1h' resamples to hourly; omit for native resolution
    qc=True,             # apply quality control
)
print(df[['eBC', 'AAE']].describe())

# Or read everything the files contain, at native resolution:
df_all = RawDataReader('AE33', '/path/to/data')
print(df_all.attrs['coverage_start'], '→', df_all.attrs['coverage_end'])

[!IMPORTANT] Behaviour change: mean_freq no longer defaults to '1h' — the default is now no resampling (native resolution). Pass mean_freq='1h' (or '30min', '1D') for averaging. start / end are also optional now.

Supported Instruments

Category Instruments
Black carbon / absorption AE33, AE43, BC1054, MA350
Particle sizers SMPS, APS, GRIMM
Mass concentration TEOM, BAM1020
Optical NEPH, Aurora
Chemical composition Xact, OCEC, IGAC, Q-ACSM

See the instrument reference for output columns and per-instrument notes.

Usage

RawDataReader returns a pandas DataFrame. Key options:

  • start / end — optional date range (omit for the files' full coverage)
  • mean_freq — resample frequency, e.g. '1h' (omit for native resolution)
  • qc — quality control (on by default; flags rows via QC_Flag and reports rates)
  • fill_missing — pad to the requested range (default) or clamp to coverage
  • size_range — diameter filter for SMPS / APS

Result metadata — coverage, QC rates, native frequency and more — is attached to df.attrs. The RawDataReader guide has the full parameter list, QC flags, and df.attrs reference.

Data Processing & Visualization

from AeroViz import reconstruct_mass, improve, mie, merge_psd, voc_potentials, plot
from AeroViz.plot import timeseries_interactive
  • Top-level processing functions — each takes a DataFrame (or a few) and returns a DataFrame/dict: reconstruct_mass & volume_ri/kappa (chemistry), improve/mie/retrieve_ri (optical), merge_psd/psd_stats (size distribution), voc_potentials (OFP, SOAP). They are grouped under the chemistry, optical, size, voc namespaces too.
  • plot — publication-ready matplotlib figures (timeseries, diurnal_pattern, scatter, meteorology.wind_rose, …).
  • timeseries_interactive(df) — quick interactive Plotly viewer; click the legend to toggle columns, or save='out.html' for a standalone file.

DataProcess(...) is deprecated (it still works but emits a DeprecationWarning); use the top-level functions above.

See the user guide for details.

Documentation

Contributing

Contributions are welcome! See CONTRIBUTING.md for the development setup and release workflow, and GitHub Issues for bug reports and feature requests.

License

MIT License - see LICENSE for details.

Citation

If you use AeroViz in your research, please cite:

AeroViz: Aerosol Data Processing and Visualization Toolkit
https://github.com/Alex870521/AeroViz

Contributors

Alex870521 yrr-Su Masbear

Project links

Data verified by PyPI on Aug 11, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.4.8)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for alex870521 from gravatar.com alex870521

Credits

Author: Alex Chan

GitHub Statistics

Data verified by PyPI on Aug 11, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.10

Provides Extra

test dev docs

Tags

aerosol atmospheric-science air-quality data-processing visualization PM2.5 PM10 black-carbon particle-size-distribution optical-properties SMPS APS aethalometer nephelometer TEOM XRF OC-EC environmental-monitoring research quality-control

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aeroviz-0.4.2.tar.gz (9.4 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

aeroviz-0.4.2-cp314-cp314-win_amd64.whl (4.6 MB view details)

Uploaded CPython 3.14Windows x86-64

aeroviz-0.4.2-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (4.0 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

aeroviz-0.4.2-cp314-cp314-macosx_14_0_arm64.whl (3.6 MB view details)

Uploaded CPython 3.14macOS 14.0+ ARM64

aeroviz-0.4.2-cp313-cp313-win_amd64.whl (4.5 MB view details)

Uploaded CPython 3.13Windows x86-64

aeroviz-0.4.2-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (4.0 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

aeroviz-0.4.2-cp313-cp313-macosx_14_0_arm64.whl (3.6 MB view details)

Uploaded CPython 3.13macOS 14.0+ ARM64

aeroviz-0.4.2-cp312-cp312-win_amd64.whl (4.5 MB view details)

Uploaded CPython 3.12Windows x86-64

aeroviz-0.4.2-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (4.0 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

aeroviz-0.4.2-cp312-cp312-macosx_14_0_arm64.whl (3.6 MB view details)

Uploaded CPython 3.12macOS 14.0+ ARM64

aeroviz-0.4.2-cp311-cp311-win_amd64.whl (4.5 MB view details)

Uploaded CPython 3.11Windows x86-64

aeroviz-0.4.2-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (4.0 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

aeroviz-0.4.2-cp311-cp311-macosx_14_0_arm64.whl (3.6 MB view details)

Uploaded CPython 3.11macOS 14.0+ ARM64

aeroviz-0.4.2-cp310-cp310-win_amd64.whl (4.5 MB view details)

Uploaded CPython 3.10Windows x86-64

aeroviz-0.4.2-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (4.0 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

aeroviz-0.4.2-cp310-cp310-macosx_14_0_arm64.whl (3.6 MB view details)

Uploaded CPython 3.10macOS 14.0+ ARM64

File details

Details for the file aeroviz-0.4.2.tar.gz.

File metadata

  • Download URL: aeroviz-0.4.2.tar.gz
  • Upload date:
  • Size: 9.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aeroviz-0.4.2.tar.gz
Algorithm Hash digest
SHA256 ebbd09c9fee807a5d4e5a07fd19dda21c7223d2e2c36f591318b2635949724b7
MD5 155f9c621f3a787df8b2b7e4fd446e43
BLAKE2b-256 8ba92b8cfd24ab6f4356fdf5495fab2a03cb4285d44ff2b480c0e8b2ce3f09cf

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeroviz-0.4.2.tar.gz:

Publisher: wheels.yml on Alex870521/AeroViz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aeroviz-0.4.2-cp314-cp314-win_amd64.whl.

File metadata

  • Download URL: aeroviz-0.4.2-cp314-cp314-win_amd64.whl
  • Upload date:
  • Size: 4.6 MB
  • Tags: CPython 3.14, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aeroviz-0.4.2-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 e1821b3a746dab3513a85ba9af2b5cfff3a408c8f2a75e50bcd41cccffe8840f
MD5 9e439576bcaa994aab161c42a7877880
BLAKE2b-256 0b67baf170e77a3104524933ad1e0f68c3052c3fa795bae856a0e095112ce30d

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeroviz-0.4.2-cp314-cp314-win_amd64.whl:

Publisher: wheels.yml on Alex870521/AeroViz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aeroviz-0.4.2-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for aeroviz-0.4.2-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 3d5d30ae982d3a8fbfbd3037212999120c601c0c2da2df02da4537dea6d5bb38
MD5 f8b553a6bed6ea4d8785b197c894874a
BLAKE2b-256 99ce20fcd5eec538f1f1a3fe1414f08ab1e35408520b4dc2a51a960b07493230

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeroviz-0.4.2-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: wheels.yml on Alex870521/AeroViz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aeroviz-0.4.2-cp314-cp314-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for aeroviz-0.4.2-cp314-cp314-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 9dd221dba3f65f0f2425bacd306a813d4c7f883fc0f0bbbdef384a9ec441449f
MD5 2cc59cca8ed95e16bd87dda10bb7a6df
BLAKE2b-256 6d92099cb23bdb1a0d2167216aa311085380c80c174392c365eed94844a9737d

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeroviz-0.4.2-cp314-cp314-macosx_14_0_arm64.whl:

Publisher: wheels.yml on Alex870521/AeroViz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aeroviz-0.4.2-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: aeroviz-0.4.2-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 4.5 MB
  • Tags: CPython 3.13, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aeroviz-0.4.2-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 415a9eff1eb984d1ed2fe1299ca9bfa134b9b996d201387bd0997fb78acfeb8a
MD5 5eef2979b6de3ca9ef339c5f7fb50657
BLAKE2b-256 7361207bc01de06029e67857e614e3d62a1b68bafe4dd1cee3171996b305f0f3

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeroviz-0.4.2-cp313-cp313-win_amd64.whl:

Publisher: wheels.yml on Alex870521/AeroViz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aeroviz-0.4.2-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for aeroviz-0.4.2-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 b3c2585d7b6595b33d2ce74ee7abbd2b3b9a55022a6e6ceeb27c0dd8dc7740dd
MD5 a7b776ce3dfbe6f3207eae74b0ee17a1
BLAKE2b-256 4267113048589910afe31e78106f2d760745f45340a1e23b3b7470229378617b

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeroviz-0.4.2-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: wheels.yml on Alex870521/AeroViz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aeroviz-0.4.2-cp313-cp313-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for aeroviz-0.4.2-cp313-cp313-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 d2d639ec5b7940acf914d452ac71549a148932c610e85b5600123374853d367d
MD5 5752335af20c7d9a97751eeee348bd76
BLAKE2b-256 3c4d8ed519a2bf6b1bc809bdc71eb59191be3a6d0631c4a75346f95f9db7828d

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeroviz-0.4.2-cp313-cp313-macosx_14_0_arm64.whl:

Publisher: wheels.yml on Alex870521/AeroViz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aeroviz-0.4.2-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: aeroviz-0.4.2-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 4.5 MB
  • Tags: CPython 3.12, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aeroviz-0.4.2-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 eab4273af54581c4e776f46972ef94f2b703b62f2bb2c7f68724358965be91f7
MD5 83b139837ab33e119eb7ec4b66960809
BLAKE2b-256 28563cc4fdadd4d3e5bfc85518f8f84fd3c9fca0a45307973d07ba916b951389

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeroviz-0.4.2-cp312-cp312-win_amd64.whl:

Publisher: wheels.yml on Alex870521/AeroViz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aeroviz-0.4.2-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for aeroviz-0.4.2-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 bf8d5d8c381cc8f72138059bf991e60da1842a2af8695082e7c3af96ebef615a
MD5 02e31698d7f1cc50c417ebdb1c9b3b4c
BLAKE2b-256 3537d4506006bb236c5cfaf039032c056639c0b1921ecc0584fb257acc83d214

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeroviz-0.4.2-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: wheels.yml on Alex870521/AeroViz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aeroviz-0.4.2-cp312-cp312-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for aeroviz-0.4.2-cp312-cp312-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 44b3599411a6171f210e9b90193e18d04af2e8b02aa87bdd002e87c78002f7f8
MD5 a1825e42aded8262a2f6469ae5cc75e9
BLAKE2b-256 5e7ce6862f4d9a125ce08542ba81d90d948b7997d9bfe82b2e8f3103cc004229

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeroviz-0.4.2-cp312-cp312-macosx_14_0_arm64.whl:

Publisher: wheels.yml on Alex870521/AeroViz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aeroviz-0.4.2-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: aeroviz-0.4.2-cp311-cp311-win_amd64.whl
  • Upload date:
  • Size: 4.5 MB
  • Tags: CPython 3.11, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aeroviz-0.4.2-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 fe4ec8d3124ade3950c7e660f47fa8470e24064848329a0b8d06e2cc06165571
MD5 4d3f80757071789adc947c1d1e222981
BLAKE2b-256 907cdf608e333a8c8f55184e1fe39d48fc42c429780bac51b7feda85f3a29783

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeroviz-0.4.2-cp311-cp311-win_amd64.whl:

Publisher: wheels.yml on Alex870521/AeroViz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aeroviz-0.4.2-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for aeroviz-0.4.2-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 c9a9af68a42b2a36f04c05350c9d5c203d45ae77e486a558322546cc6b147cb4
MD5 f3a36defbff9793b7afbd978bb48c46b
BLAKE2b-256 bdcff4a6d21b4a16fa7275c38a3359e3b485f300561d230c9405189ac39cf831

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeroviz-0.4.2-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: wheels.yml on Alex870521/AeroViz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aeroviz-0.4.2-cp311-cp311-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for aeroviz-0.4.2-cp311-cp311-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 8fe8521a6cef6bf38be3c01e642b2897ebb2a43a89118945ef177819a344a912
MD5 f49e7fc853719f73880e5c66bf237199
BLAKE2b-256 3b74658be8b40ed53f13c7387a414f8944ad9952b14ea262d31cbd3d2f819a12

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeroviz-0.4.2-cp311-cp311-macosx_14_0_arm64.whl:

Publisher: wheels.yml on Alex870521/AeroViz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aeroviz-0.4.2-cp310-cp310-win_amd64.whl.

File metadata

  • Download URL: aeroviz-0.4.2-cp310-cp310-win_amd64.whl
  • Upload date:
  • Size: 4.5 MB
  • Tags: CPython 3.10, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aeroviz-0.4.2-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 c88f97d6eecbb8402031623b7af6ff8dd34c521194ef2adebb6d99226c9a259f
MD5 021a21b781cf4f520e991f065be05659
BLAKE2b-256 591e6e29535d293830f7cb28e00a377a409432f7aeaa6cf3e565e9749c5fe85e

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeroviz-0.4.2-cp310-cp310-win_amd64.whl:

Publisher: wheels.yml on Alex870521/AeroViz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aeroviz-0.4.2-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for aeroviz-0.4.2-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 2e656520885b8571a9c350c3577c0475476c51c85c4cd4b3bc94d4230238fc1b
MD5 88a88e66c586169a6fafe6c203f20c06
BLAKE2b-256 946e7dd9f31365c72847a176b6c5a68ab033d257fba8cdba473b8d656fa65139

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeroviz-0.4.2-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: wheels.yml on Alex870521/AeroViz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aeroviz-0.4.2-cp310-cp310-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for aeroviz-0.4.2-cp310-cp310-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 39a1617e7c969d3c29fefc0841074d1311c95b02a2de118603ffdb8dd089cc4f
MD5 aa716db05c3064530eeac9944d20eda7
BLAKE2b-256 277c97c0816439a4d1015d4b0db4402bf867ecbe07c857af8b9ff15d14e19562

See more details on using hashes here.

Provenance

The following attestation bundles were made for aeroviz-0.4.2-cp310-cp310-macosx_14_0_arm64.whl:

Publisher: wheels.yml on Alex870521/AeroViz

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.4.8

16 files

0.4.7

16 files

0.4.6

16 files

0.4.5

16 files

0.4.4

16 files

0.4.3

16 files

This release

0.4.2 This release

16 files

0.4.1

16 files

0.4.0

16 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page