IMPACTS: Intersection of Mobility Patterns and Air Concentration in Transportation Systems

A Python toolkit for working with InMAP/AERMOD Source-Receptor Matrices (ISRM) and converting BEAM emission outputs into pollutant concentrations.

Overview

This package provides utilities to:

• Convert InMAP outputs to NOx-to-NO2 source-receptor relationships
• Map these relationships to ISRM grid cells
• Process BEAM emission data for air quality analysis

Data Sources

The InMAP ISRM (Intervention Source-Receptor Matrix) is downloaded based on configuration, with the default location being:

• S3 Bucket: s3://inmap-model/isrm_v1.2.1.zarr/
• Version: v1.2.1

This ISRM matrix is then combined with the NOx-to-NO2 matrix calculated in-house to produce the final source-receptor relationships for air quality analysis.

Installation #WIP

# Clone the repository
git clone <repository-url>
cd impacts

# Install dependencies with Poetry
poetry install

# Or activate the environment
poetry shell

Project Structure #WIP

isrm-wrapper/
├── src/isrm_wrapper/    # Main package code
├── data/
│   ├── raw/            # Input BEAM emissions and InMAP outputs
│   └── processed/      # Generated concentration outputs
├── tests/              # Unit tests
└── docs/               # Documentation

Requirements #WIP

• Python 3.8+
• Dependencies managed via Poetry (see pyproject.toml)

Contributing #WIP

See CONTRIBUTING.rst for guidelines.

License #WIP

See LICENSE.txt for details.