README.md

In energyandcleanair/creadeweather: Deweathering of air pollution

creadeweather

Overview

creadeweather is an R package designed to control for the impact of weather on air pollution levels. The package uses machine learning techniques to isolate and remove the effects of weather variables on air pollutant concentration, providing a clearer understanding of the role of emission changes.

See an example application here in the context of COVID-19 lockdowns.

Diagram

%%{init: {'theme': 'neutral'}}%%
graph TD;
    A[AQ measurements from CREA Database] --> C
    B[Download Weather from ERA5, NOAA ISD] --> C[Gradient Boosting Machine]
    C --> E[Upload to CREA Database]
    C --> D[Export Weather-Corrected Measurements]

Installation

You can install the development version of creadeweather from GitHub:

# Install remotes if not already installed
install.packages("remotes")

# Install creadeweather from GitHub
remotes::install_github("energyandcleanair/creadeweather")

Requirements

Ensure you have the following variables set up in your .Renviron file:

CREA_DB_URL=
DIR_ERA5=

Usage

Here is a basic example of how to use creadeweather:

library(creadeweather)

# Define the location, data source, and pollutant
location_id <- rcrea::cities(name="delhi")$id
source <- "cpcb"
poll <- rcrea::NO2

# Perform weather adjustment
results <- creadeweather::deweather(
  poll=poll,
  source=source,
  location_id=location_id,
  output=c("anomaly","trend"),
  upload_results=FALSE
)

License

This project is licensed under the MIT License. See the LICENSE file for details.

Author(s)

Developed by the Centre for Research on Energy and Clean Air (CREA).

Main author: Hubert Thieriot

Contributors: Danny Hartono

See Also

For more on weather adjustment in air quality data, check out rmweather.

energyandcleanair/creadeweather documentation built on Jan. 17, 2025, 8:22 p.m.