A systematic framework for high-resolution atmospheric emissions estimation using the
pegaR package.
The PEGA Emissions Inventory project is designed to produce granular, bottom-up atmospheric emissions data. By combining normalized emission factors from the pega package with real-world activity data, we generate comprehensive datasets following IPCC and EMEP/EEA guidelines.
Our core methodology focuses on unit normalization and sector-specific modeling to ensure consistency across the entire inventory.
The repository is organized following the IPCC/NFR reporting hierarchy:
| Directory | Description |
|---|---|
estimation/ |
🧬 Core logic. Hierarchical R scripts for emission calculations. |
post/ |
🛠️ Post-processing scripts for spatial and temporal allocation. |
scripts/ |
🔧 General utility functions and helper scripts. |
docs/ |
📚 Comprehensive project documentation. |
xx.csv |
🗺️ Master mapping file for categories, fuels, and methodologies. |
main.R |
🏁 Main execution entry point. |
- R (>= 4.0.0)
- R Packages:
data.table,pega,ggplot2,sf - Data: Activity data for specific sectors (see Data Collection Guide).
# Install development version of pega if not already present
# devtools::install_github("atmoschem/pega")
# Clone the repository
# git clone https://github.com/youruser/pega_inventory.git| Guide | Description |
|---|---|
| 📋 Data Collection Guide | Essential instructions for collaborators on gathering activity data. |
| 📊 Sector 1.A: Fuel Combustion | Expected units for all Fuel Combustion activities. |
| 💨 Sector 1.B: Fugitive Emissions | Expected units for Fugitive Emissions (Oil, Gas, Coal). |
| 🏭 Sector 2: Industrial Processes | Expected units for Industrial Processes (IPPU). |
| 🏛️ Architecture & Workflow | Detailed breakdown of the project structure and processing pipeline. |
| 🧪 Methodology | Deep dive into EMEP/IPCC tiers and how pega handles calculations. |
| 🤝 Contributing | Guidelines for adding new sectors, fuels, or features. |
If you are a student or postdoc working on data collection, please prioritize the Data Collection Guide.
Key Unit Rules:
- Sector 1.A (Combustion): All data must be normalized to Gigajoules (GJ).
- Sector 1.B (Fugitive): Varies by sub-sector (often PJ or m³).
- Sector 2 (IPPU): All data must be normalized to Megagrams (Mg) (Metric Tonnes).
See the sector-specific instructions for detailed requirements.
This project is licensed under the MIT License - see the LICENSE file for details.
Developed with ❤️ by the Atmospheric Chemistry & Modeling Group