🚀 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.

✔️ 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")
💡 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
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