README.md

AeroViz for Aerosol Science Visualization

Key Features

• Data Reading: Supports reading multiple aerosol data formats.
• Data Visualization: Offers various charts and graphs, including time series plots, distribution plots, and correlation matrices.
• Data Processing: Includes multiple data processing tools, such as linear regression and Mie theory calculations.

Installation

pip install AeroViz

For Windows users: Run install_windows.bat

For Linux and Mac users: Run install_unix.bat

Quick Start

from datetime import datetime
from pathlib import Path
from AeroViz import RawDataReader, DataProcess, plot

# Read data from a supported instrument
data = RawDataReader('NEPH', Path('/path/to/data'), start=datetime(2024, 2, 1), end=datetime(2024, 4, 30))

# Create a visualization
plot.timeseries(data, y='scattering_coefficient')

For more detailed usage instructions, please refer to our User Guide.

RawDataReader

RawDataReader supports a wide range of aerosol instruments, including NEPH, SMPS, AE33, and many more. It handles various file types and time resolutions, making data processing efficient and standardized.

For a detailed list of supported instruments, file types, and data columns, please refer to our RawDataReader Usage Guide in the docs folder.

Key Features:

• Supports multiple aerosol instruments
• Applies customizable quality control measures
• Offers flexible data filtering and resampling options
• Enables easy data export to CSV format

Supported Instruments

The AeroViz project currently supports data from the following instruments:

• SMPS (Scanning Mobility Particle Sizer)
• APS (Aerodynamic Particle Sizer)
• GRIMM (GRIMM Aerosol Technik)
• TEOM (Continuous Ambient Particulate Monitor)
• NEPH (Nephelometer)
• Aurora (Nephelometer)
• AE33 (Aethalometer Model 33)
• AE43 (Aethalometer Model 43)
• BC1054 (Black Carbon Monitor 1054)
• MA350 (MicroAeth MA350)
• OCEC (Organic Carbon Elemental Carbon Analyzer)
• IGAC (In-situ Gas and Aerosol Compositions monitor)
• XRF (X-ray Fluorescence Spectrometer)
• VOC (Volatile Organic Compounds Monitor)

Note: We are continuously working to support more instruments. Please check back for updates or contribute to our project on GitHub.

DataProcess

The AeroViz project currently supports the following processing methods:

• Chemistry:
• Optical
• SizeDistr
• VOC

Documentation

For detailed documentation, please refer to the docs folder, which includes:

Documentation	Description
User Guide	Basic usage instructions
Changelog	List of changes

Related Source

• PyMieScatt

• py-smps

• ContainerHandle

Contact

For bug reports and feature requests please visit GitHub Issues.