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.
Plotting lives in an extra: pip install "AeroViz[plot]". Details, building from
source and troubleshooting: Installation.
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'])
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 viaQC_Flagand reports rates)fill_missing— pad to the requested range (default) or clamp to coveragesize_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 thechemistry,optical,size,vocnamespaces 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, orsave='out.html'for a standalone file.
DataProcess(...)is deprecated (it still works but emits aDeprecationWarning); use the top-level functions above.
See the user guide for details.
Documentation
- Full Documentation
- Installation · Getting Started · RawDataReader Usage
- Supported Instruments · Gallery
- Changelog
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 it. The metadata is in CITATION.cff; GitHub's "Cite this repository" button gives APA and BibTeX.
Chan, C.-Y. AeroViz: Aerosol Data Processing and Visualization Toolkit (Version 0.5.0) [Computer software].
https://github.com/Alex870521/AeroViz
1 maintainer
Metadata
1 maintainer
Release files for AeroViz 0.5.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aeroviz-0.5.1.tar.gz | 9.5 MB | With provenance | Details for aeroviz-0.5.1.tar.gz |
Built distributions (wheels)
Total release size: 71.0 MB
Release files / aeroviz-0.5.1.tar.gz
| Download URL | aeroviz-0.5.1.tar.gz |
|---|---|
| Size | 9.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
aa4cb23ca85147ce7bb8f9fc385d33ada4432ab9215930d2041660ed2bcf668b
|
|
BLAKE2b-256 checksum How to use checksums |
4b783849cb9ad21fbc3afa337ca76c3d60276aa5d5e83d5312c4fe02de69822a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logRelease files / aeroviz-0.5.1-cp314-cp314-win_amd64.whl
| Download URL | aeroviz-0.5.1-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 4.5 MB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
ab2f3fa8a4fdd58e79c398ee4a023809f966104ea774a1b2b1e2426fa393c4ce
|
|
BLAKE2b-256 checksum How to use checksums |
f15efcc7e56ed2323b3fad27f6da82eeba0a946d3e5c82eea9a940372b4d2acb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logRelease files / aeroviz-0.5.1-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | aeroviz-0.5.1-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 4.1 MB |
| Tags | CPython 3.14 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
ea315f34eb004d0489f6c6a45bdf5b702dd6ddfa986d44071b5fdbb26d83593b
|
|
BLAKE2b-256 checksum How to use checksums |
7483270738e3fca70808c7c883ca59b4f573b93555c928fa93672ea60c01e8a5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logRelease files / aeroviz-0.5.1-cp314-cp314-macosx_14_0_arm64.whl
| Download URL | aeroviz-0.5.1-cp314-cp314-macosx_14_0_arm64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | CPython 3.14 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
b16aca447700be4e070b389b4a8a07df10f858beeaa3f37c873113d0f12e5eb0
|
|
BLAKE2b-256 checksum How to use checksums |
d953d6e6144f8b0bf147c3c1baee0cfa68038a40ce33400e97f95b8594450c4c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logRelease files / aeroviz-0.5.1-cp313-cp313-win_amd64.whl
| Download URL | aeroviz-0.5.1-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 4.5 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
b907d8e820f4497aa36acce084e153f7875f90d1298bf21d85e83b1c27cbd82d
|
|
BLAKE2b-256 checksum How to use checksums |
7ce412c1aa506f85fc12117a77664064f39958444f3642f1a892e046da7482ab
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logRelease files / aeroviz-0.5.1-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | aeroviz-0.5.1-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 4.1 MB |
| Tags | CPython 3.13 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
fd776f19216ba0249094d7caa96971c8658a097d0eef5b39ea0938f13cdbca68
|
|
BLAKE2b-256 checksum How to use checksums |
f2265f5e7a8cd31d86be29de12a7580f9156aa467deb46e8c0cba9044b80e26a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logRelease files / aeroviz-0.5.1-cp313-cp313-macosx_14_0_arm64.whl
| Download URL | aeroviz-0.5.1-cp313-cp313-macosx_14_0_arm64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | CPython 3.13 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
045226570810c60b013089d44ee480a8509cdf36f6217be0c344bc0327776f4e
|
|
BLAKE2b-256 checksum How to use checksums |
c9d157a3672ef5fe590cb12d4edb3e6d12ee4b4c8a28f9d412c7a570e36ea22a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logRelease files / aeroviz-0.5.1-cp312-cp312-win_amd64.whl
| Download URL | aeroviz-0.5.1-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 4.5 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
8d9180f369b1f3d201c2305abecf26f4172f014dab6c996a90964684ebef8193
|
|
BLAKE2b-256 checksum How to use checksums |
33c8db477ebb5dc5bd5737916830fe1aea0cbca36ccb2868b3ca8c3a28f82555
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logRelease files / aeroviz-0.5.1-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | aeroviz-0.5.1-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 4.1 MB |
| Tags | CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
8e258d0d30ace297550108d8b7d995a94c6a9a272f7afa42c343194effa68333
|
|
BLAKE2b-256 checksum How to use checksums |
f1b5545b55e00c2048c9736b2cf5c79c8704dacb29acd18d4a2dcae8852ac7b4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logRelease files / aeroviz-0.5.1-cp312-cp312-macosx_14_0_arm64.whl
| Download URL | aeroviz-0.5.1-cp312-cp312-macosx_14_0_arm64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | CPython 3.12 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
659db39c2200c5d784f5d75dc18303fdad622364b83884721743c5e4be7e9034
|
|
BLAKE2b-256 checksum How to use checksums |
8605674cae2e755f97e970b52e6ba7b1235f61db3e67cb9d72ffbaa050b7095e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logRelease files / aeroviz-0.5.1-cp311-cp311-win_amd64.whl
| Download URL | aeroviz-0.5.1-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 4.5 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
f39d61e447f6b06a3e0a79e20c0d864aaee3ef19c8341393d3ee7c1b7ad354ff
|
|
BLAKE2b-256 checksum How to use checksums |
2673218675a644edfb277da4aa1b6b05259513121f40cfedad1e03961238271c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logRelease files / aeroviz-0.5.1-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | aeroviz-0.5.1-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 4.1 MB |
| Tags | CPython 3.11 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
b4a63a36ea6ac41b5e8f96161a24976e123981eca7261ed76c2e9fd9f4c59e8e
|
|
BLAKE2b-256 checksum How to use checksums |
c28eeca768e9524d903397bb6ee10d190defc64819d2cdfd577e738bdd2e7c0d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logRelease files / aeroviz-0.5.1-cp311-cp311-macosx_14_0_arm64.whl
| Download URL | aeroviz-0.5.1-cp311-cp311-macosx_14_0_arm64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | CPython 3.11 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
eee6ee362c18bcfc80df0c423d1435b467d718c93826f8414bf2f907ad0218f5
|
|
BLAKE2b-256 checksum How to use checksums |
489321b3026111915aec478b20a7c4db1a4739044109ba04bf8e4d281fdd1a16
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logRelease files / aeroviz-0.5.1-cp310-cp310-win_amd64.whl
| Download URL | aeroviz-0.5.1-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 4.5 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
e0915594a4fcce4314ace867934845f755c379ef6f2db7cee4cb7745f6073079
|
|
BLAKE2b-256 checksum How to use checksums |
93dfd6269811d485c7a5e3a6f466303021bed407fa847f97d4d017980f07cf17
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logRelease files / aeroviz-0.5.1-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | aeroviz-0.5.1-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 4.1 MB |
| Tags | CPython 3.10 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
bdcaefb8c618b56a4684598a4c801561afdd848979c477979e57d68f6e1320a6
|
|
BLAKE2b-256 checksum How to use checksums |
06699f8d6b4dbe4a236b04a71effcb94b9ef9087d72fdb476a1300ef443a573f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logRelease files / aeroviz-0.5.1-cp310-cp310-macosx_14_0_arm64.whl
| Download URL | aeroviz-0.5.1-cp310-cp310-macosx_14_0_arm64.whl |
|---|---|
| Size | 3.7 MB |
| Tags | CPython 3.10 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
5a2ffecf470b0cf55e2570bd899e0991defb8284e0d9b23f7e4dcb684b7205de
|
|
BLAKE2b-256 checksum How to use checksums |
fdc32b78cdbbb4ea7efc747c30c05596cb2a99cafa6d0ce4f0b6778c3950ba78
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logSecurity for AeroViz 0.5.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 16 files in this release have been uploaded with provenance metadata.
Attestation for aeroviz-0.5.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
