Package 'rsinaica'

Title: Download Data from Mexico's Air Quality Information System
Description: Easy-to-use functions for downloading air quality data from the Mexican National Air Quality Information System (SINAICA). Allows you to query pollution and meteorological parameters from more than a hundred monitoring stations located throughout Mexico. See <https://sinaica.inecc.gob.mx> for more information.
Authors: Diego Valle-Jones [aut, cre]
Maintainer: Diego Valle-Jones <[email protected]>
License: MIT + file LICENSE
Version: 1.1.0
Built: 2024-11-16 02:48:13 UTC
Source: https://github.com/diegovalle/rsinaica

Help Index


Valid air quality parameters

Description

Valid air quality parameters

Format

A data frame with 55 rows and 2 variables:

param_code

Abbreviation of the air quality parameter

param_name

Name of the air quality parameter

Source

SINAICA

Examples

head(params_sinaica)

Get air quality data from a single measuring station

Description

Download data from a single station by specifying a parameter and a date range

Usage

sinaica_station_data(
  station_id,
  parameter,
  start_date,
  end_date,
  type = "Crude",
  remove_extremes = FALSE
)

Arguments

station_id

the numeric code corresponding to each station. See stations_sinaica for a list of stations and their ids.

parameter

type of parameter to download

  • BEN - Benceno

  • CH4" - Metano

  • CN - Carbono negro

  • CO - Monóxido de carbono

  • CO2 - Dióxido de carbono

  • DV - Dirección del viento

  • H2S - Acido Sulfhídrico

  • HCNM - Hidrocarburos no metánicos

  • HCT - Hidrocarburos Totales

  • HR - Humedad relativa

  • HRI - Humedad relativa interior

  • IUV - Índice de radiación ultravioleta

  • NO - Óxido nítrico

  • NO2 - Dióxido de nitrógeno

  • NOx - Óxidos de nitrógeno

  • O3 - Ozono

  • PB - Presión Barométrica

  • PM10 - Partículas menores a 10 micras

  • PM2.5 - Partículas menores a 2.5 micras

  • PP - Precipitación pluvial

  • PST - Partículas Suspendidas totales

  • RS - Radiación solar

  • SO2 - Dióxido de azufre

  • TMP - Temperatura

  • TMPI - Temperatura interior

  • UVA - Radiación ultravioleta A

  • VV - Radiación ultravioleta B

  • XIL - Xileno

start_date

start of range in YYYY-MM-DD format

end_date

end of range from which to download data in YYYY-MM-DD format

type

The type of data to download. One of the following:

  • Crude - Crude data that has not been validated

  • Validated - data which has undergone a validation process during which it was cleaned, verified, and validated

  • Manual - Manually collected data that is sent to an external lab for analysis (may no be collected daily). Mostly used for suspend particles collected by pushing air through a filter which is later sent to a lab to be weighted

remove_extremes

whether to remove extreme values. For O3 all values above .2 are set to NA, for PM10 those above 600, for PM2.5 above 175, for NO2 above .21, for SO2 above .2, and for CO above 15. This is done so that the values match exactly those of the SINAICA website, but it is recommended that you use a more complicated statistical procedure to remove outliers.

Value

data.frame with air quality data. Care should be taken when working with hourly data since each station has their own timezone (available in the stations_sinaica data.frame) and some stations reported the timezome in which they are located erroneously.

See Also

Crude data comes from https://sinaica.inecc.gob.mx/data.php, validated data from https://sinaica.inecc.gob.mx/data.php?tipo=V, and manual data from https://sinaica.inecc.gob.mx/data.php?tipo=M

Examples

stations_sinaica[which(stations_sinaica$station_name == "Xalostoc"), 1:5]
df <- sinaica_station_data(271, "O3", "2015-09-11", "2015-09-11", "Crude")
head(df)

Dates supported by a station

Description

Start date and end date of the range for which SINAICA has data for an air quality station

Usage

sinaica_station_dates(station_id, type = "Crude")

Arguments

station_id

the numeric code corresponding to each station. See stations_sinaica for a list of stations and their ids.

type

The type of data to download. One of the following:

  • Crude - Crude data that has not been validated

  • Validated - Validated data (may not be the most up-to-date)

  • Manual - Manual data

Value

a vector containing the date the station started reporting and end reporting date

Examples

## id 271 is Xalostoc. See `stations_sinaica`
df <- sinaica_station_dates(271, "Manual")
head(df)

Parameters supported by a station

Description

List of air quality parameters of a measuring station for which SINAICA has data

Usage

sinaica_station_params(station_id, type = "Crude")

Arguments

station_id

the numeric code corresponding to each station. See stations_sinaica for a list of stations and their ids.

type

The type of data to download. One of the following:

  • Crude - Crude data that has not been validated

  • Validated - Validated data (may not be the most up-to-date)

  • Manual - Manual data

Value

a data.frame with the parameters supported by the station

Examples

## id 271 is Xalostoc. See `stations_sinaica`
df <- sinaica_station_params(271, "Crude")
head(df)

Air quality measuring stations in Mexico

Description

This data set contains all the stations that report to the National Air Quality Information System SINAICA.

Usage

data(stations_sinaica)

Format

A data frame with 341 rows and 26 variables:

station_id

Numeric code of the station

station_name

Name of the station

station_code

Abbreviation of the station

network_id

Numeric code for the network

network_name

Name of the network

network_code

Abbreviation of the network

street

street

ext

exterior number

interior

interior number

colonia

colonia

zip

zip code

state_code

state code

municipio_code

municipio code

year_started

date the station started operations

altitude

altitude in meters

address

address

date_validated

last date the station was validated

date_validated2

second to last date the station was validated

passed_validation

did the station pass validation

video

link to video of the station

lat

latitude

lon

longitude

date_started

date the station started operations

timezone

time zone in which the station is located (may contain errors)

street_view

link to Google Street View

video_interior

link to video of the interior of the station

Source

SINAICA ans Solicitud de Información 1612100005118

Examples

head(stations_sinaica)