ObsAQ: An open-source framework for fast and scalable air pollution data retrieval

Contributors:

v0.0.4: Jinhui Yu, Zhiyi Song, Ke Liu, Jiatian Hu, Zhonghua Zheng (zhonghua.zheng@manchester.ac.uk)

v0.0.0: Haofan Wang, Zhiyi Song, Congbo Song, Zongbo Shi, David Topping, Zhonghua Zheng (zhonghua.zheng@manchester.ac.uk)

Installation

Step 1: create an environment:

$ conda create -n obsaq python=3.12

$ conda activate obsaq

$ conda install -c conda-forge numpy pandas pyreadr requests

Step 2: install using pip:

$ pip install obsaq

(optional) install from source:

$ git clone https://github.com/envdes/obsaq
$ cd obsaq
$ python setup.py install

How to use it?

Python

Please check the tutorial for more information.

Recent Update

This version introduces major improvements in:

• Robust pollutant and time filtering (cross-year supported)
• Improved merging and duplicate-column handling
• Flexible configuration loading
• Cleaner, more reproducible outputs

We recommend upgrading to the latest version.

Data Validation

The downloaded datasets have been cross-checked against the official AURN website data and the original RData sources. Site counts were found to be consistent across sources.

How to ask for help

The GitHub issue tracker is the primary place for bug reports.