Skip to content

BAM1020 Beta Attenuation Monitor

The BAM1020 is a beta attenuation monitor used for measuring PM2.5 mass concentrations in ambient air.

AeroViz.rawDataReader.script.BAM1020.Reader 

Reader(path: Path | str, reset: bool | str = False, qc: bool | str = True, **kwargs)

Bases: AbstractReader

BAM1020 (Beta Attenuation Monitor) Data Reader

A specialized reader for BAM1020 data files, which measure PM2.5 mass concentration using beta attenuation technology.

See full documentation at docs/source/instruments/BAM1020.md for detailed information on supported formats and QC procedures.

Attributes

nam class-attribute instance-attribute 

nam = 'BAM1020'

Functions

_raw_reader 

_raw_reader(file)

Read and parse raw BAM1020 data files.

Parameters:

Name Type Description Default
file Path or str

Path to the BAM1020 data file.

 required

Returns:

Type Description
DataFrame

Processed BAM1020 data with datetime index and PM2.5 concentration column.

_QC 

_QC(_df)

Perform quality control on BAM1020 data.

Parameters:

Name Type Description Default
_df DataFrame

Raw BAM1020 data with datetime index and concentration column.

 required

Returns:

Type Description
DataFrame

Quality-controlled BAM1020 data with invalid measurements masked.
Notes

Applies the following QC filters: 1. Value range: Valid PM2.5 concentrations between 0-500 μg/m³ 2. Time-based outlier detection: Uses 1-hour window for IQR-based filtering 3. Complete record requirement: Removes rows with any missing values

Data Format

  • File format: CSV files
  • Sampling frequency: Typically 1 hour
  • File naming pattern: Various formats supported
  • Data columns: PM2.5 mass concentration and related parameters

Measurement Parameters

The BAM1020 provides:

  • PM2.5: Particulate matter mass concentration ≤2.5 μm (μg/m³)
  • Status: Instrument status and error codes
  • Flow: Sample flow rate
  • Temperature: Internal temperature readings
  • Pressure: Atmospheric pressure measurements

Data Processing

Data Reading

  • Reads CSV format files with automatic column detection
  • Handles various timestamp formats
  • Processes instrument status information
  • Validates data integrity

Quality Control

  1. Instrument Status Check:

    • Filters data based on instrument status codes
    • Removes measurements during calibration or maintenance
    • Validates flow rate stability

  2. Value Range Check:

    • Removes negative concentrations
    • Filters extremely high values (>1000 μg/m³)
    • Checks for physically reasonable measurements

  3. Data Completeness:

    • Ensures adequate temporal coverage
    • Validates measurement consistency
    • Handles missing data appropriately

Output Data

The processed data contains:

  • Time index: Measurement timestamp
  • PM2.5: Mass concentration in μg/m³
  • QC flags: Quality control indicators

Notes

  • Beta attenuation technology provides real-time PM2.5 measurements
  • Regular calibration and maintenance are required for accurate results
  • Status codes indicate instrument health and measurement validity
  • Suitable for continuous ambient air quality monitoring