Skip to content

User Guide

Welcome to AeroViz! This guide will help you get started quickly.

Installation

Using pip

pip install AeroViz

Install from Source

git clone https://github.com/alex870521/AeroViz.git
cd AeroViz
pip install -e .

Dependencies

AeroViz requires Python 3.10+ and the following main dependencies:

  • numpy, pandas, scipy
  • matplotlib
  • xarray (optional, for NetCDF)

Quick Start

1. Reading Data

from datetime import datetime
from pathlib import Path
from AeroViz import RawDataReader

# Read AE33 black carbon data
data = RawDataReader(
    instrument='AE33',
    path=Path('/path/to/data'),
    start=datetime(2024, 1, 1),
    end=datetime(2024, 12, 31),
    mean_freq='1h'
)

# View data
print(data.head())
print(data.columns)

2. Data Processing

from AeroViz.dataProcess import DataProcess

# Size distribution processing
dp = DataProcess('SizeDistr', Path('./output'))
result = dp.basic(df_pnsd)

# Chemical composition processing
dp = DataProcess('Chemistry', Path('./output'))
result = dp.reconstruction_basic(df_chem)

3. Visualization

from AeroViz import plot

# Time series plot
plot.time_series(data, 'BC')

# Scatter plot
plot.scatter(data, 'BC', 'PM25')

Core Concepts

RawDataReader

A unified data reading interface supporting multiple aerosol instruments:

Category Instruments
Black Carbon AE33, AE43, BC1054, MA350
Scattering NEPH, Aurora
Size Distribution SMPS, APS, GRIMM
Chemical IGAC, OCEC, Xact, VOC
Mass TEOM, BAM1020

See RawDataReader Tutorial

DataProcess

The data processing engine includes four modules:

Module Function
SizeDistr Size distribution processing, merging, conversion
Chemistry Mass reconstruction, ion balance, kappa calculation
Optical Mie calculation, IMPROVE, RI retrieval
VOC OFP, SOAP calculation

See DataProcess Tutorial

Plot

The visualization module provides various chart types:

  • Basic charts: scatter, bar, box, violin, pie
  • Time analysis: time series, diurnal, seasonal
  • Advanced charts: polar, wind rose, contour

See Visualization Tutorial

Examples

Example Description
Size Distribution Analysis SMPS-APS merging, distribution conversion, statistical calculation
Optical Closure Analysis Mie calculation, IMPROVE, refractive index retrieval
Chemical Composition Analysis Mass reconstruction, ion balance, kappa calculation
VOC Analysis OFP, SOAP calculation

Next Steps