Skip to contents

🚀 An R package for working with EPA AirData flat files and AQS API! 🚀

Developer: Dr. Nelson Roque | ORCID: https://orcid.org/0000-0003-1184-202X

Source: https://github.com/nelsonroque/tidypollute


Overview

tidypollute is a lightweight R package designed to make working with environmental data easy, tidy, and efficient. Whether you’re a researcher, policymaker, or just an environmental data enthusiast, this package helps you import, clean, and analyze large-scale air pollution datasets with minimal hassle.

Learn more, by reading this package’s Documentation.


🔥 Why use tidypollute?
✔️ Tidy: Designed with the tidyverse in mind for seamless integration.

tidypollute_code
tidypollute_code

✔️ Fast: Optimized dplyr functions for handling big air quality datasets.
✔️ Flexible: Supports both flat files and (soon!) real-time API queries.


📌 Current Features

Read and process EPA AirData flat files
Read EPA AirData metadata
Extract data from the Atmotube Cloud API
Tidy up and filter air pollution data


🛣️🛠 Roadmap: What’s Next?

  • Quick, and simple visualizations from tidy data

  • Integration with real-time API endpoinst (EPA AirData, Atmocube, Purple Air, Plume Flow)

  • Add codebooks for various datasets

  • Generate DOCX/PDF reports from air quality data

  • Merge air quality data with Census demographics

  • Interactive mapping integration with mapview


🚀 Getting Started

Installation

If hosted on GitHub, install with:

devtools::install_github("nelsonroque/tidypollute")

Once on CRAN (coming soon!), install with:

install.packages("tidypollute")

Load the package

library(tidypollute)

💡 Contributions Welcome!

📌 Have ideas? Found a bug? Want to improve the package? Open an issue!.

📜 Code of Conduct - Please be respectful and follow community guidelines.


Acknowledgements

The development of tidypollute was made possible with support from NIA (P01-AG003949) and Dr. Roque’s PSU Start-up funds. Thank you Dr. Charles B Hall, Dr. Dean Hosgood, and Hailey Andrews, for your support and manuscript reads. Thank you Dr. Alexis Santos-Lozada and Dr. Johnny Felt for function name brainstorming. Thank you, Hailey Andrews, for helping brainstorm the name of this package. Thank you, Karishma Christmas, for your documentation support.


🌎 More Resources:
📌 EPA AQS API Docs

📌 EPA Daily Air Quality Reports

📌 EPA AQI Colors

📌 EPA Air Quality Webcams

📌 Census Reference Files

📌 Census GEOIDs


Ready to make sense of air quality data the tidy way? 🌱 Let’s go! 🚀


Anyone want to help with the logo? :) https://www.canva.com/design/DAGfIpmrLEA/Z0-kZNH66JDBZgp0PIlfMw/edit