PANTHEON_D1.2_Inventory Estimation Platform

Inventory Estimation Platform Emission Horizon Platform is a developing tool for calculating emissions inventories. It allows users to select data across sectors, fuels, and technologies, applying emission factors (EF) for calculations. While still in early stages, the platform offers basic filtering and data selection, with plans for further development and enhancements. Overview Emission Horizon Platform is an emissions inventory tool designed to simplify the process of calculating and managing emissions across various sectors, fuels, and technologies. The platform allows users to integrate activity data and emission factors (EF), providing flexible filtering options and easy-to-use emission calculation features. The platform is still in development, but it already supports basic data selection, EF integration, and emission calculations with more advanced features planned for future updates. System Requirements To run the platform, you need to have Python 3.8+ installed on your system. You can check your Python version by running python --version. Additionally, all required dependencies are listed in the requirements.txt file, which can be installed via pip install -r requirements.txt. Ensure that your environment meets these prerequisites before setting up the platform. Installation First, clone the repository to your local machine by running the command git clone https://github.com/yourusername/emission-horizon.git. After cloning the repository, navigate to the project directory and install the required dependencies by running pip install -r requirements.txt. This will ensure that all the necessary packages are available for the platform to run smoothly. How to Run the Platform Once the platform is installed, navigate to the project directory in your terminal and run the command python app.py. This will start the platform and allow you to interact with it either through the terminal interface or the web-based UI, depending on your configuration. Simply follow the prompts and begin selecting your data and emission factors. How to Use the Platform Step 1: Selecting Activity Data After running the platform, you will be prompted to select the activity data. The platform provides filtering options for sectors, fuels, fuel subtypes, country, and source IDs (C1 and C2). You will also be able to choose the dataset from available options like IEA or USGS. Once you've selected your data, it will be ready for the next step, where emission factors can be chosen. Step 2: Selecting Emission Factors (EF) Once you’ve filtered the activity data, the platform will display a list of emission factors (EF) related to the pollutants and technologies you’ve selected. Choose the appropriate pollutant (e.g., CO2, NOx, SO2) and technology (tech) to ensure accurate emission calculations. The platform will automatically match the selected EF with the corresponding activity data. Step 3: Entering Activity Values With your emission factors selected, you’ll now need to enter the activity value, which represents the amount of activity for the given sector or technology (e.g., tons of fuel burned, energy consumed). The platform uses the formula Emission = Activity × EF to calculate emissions, where Activity is the value you input and EF is the selected emission factor. Step 4: Viewing Results After entering the activity value, the platform will calculate and display the emission results. The result will include a summary of the emissions based on the activity value and emission factor selected. You will also see a table displaying the emission factors available for the selected pollutants and technologies, as well as a table listing your selected emission factors for the calculation. Advanced Features (Work in Progress) In future updates, the platform will support activity scaling, allowing users to adjust activity values for different scenarios (e.g., baseline vs. future projections). Additionally, scenario comparison features will be added to allow users to compare emissions across different datasets or time periods. These features are currently under development and will be included in upcoming releases. File Structure The project directory contains the following files and folders: app.py: The main script to run the platform. requirements.txt: A list of all Python dependencies required to run the platform. /data: Contains activity data and emission factor files. /config: Configuration files, such as mappings for sectors, fuels, and emission factors. /output: The directory where the platform stores the results of your calculations. Customization To add new emission factors, place the relevant EF files into the /data directory. The platform will automatically recognize and load these files. You can also modify the mappings for sectors, fuels, and emission factors by editing the configuration files in the /config folder. This makes it easy to customize the platform for your specific needs or to incorporate new data sources. Troubleshooting If you encounter issues, here are some common troubleshooting steps: No rows in Emission Factor Table: This can happen if no emission factors are available for the selected pollutant or technology. Double-check your selections to ensure valid data. Invalid Activity Value: Ensure that the activity value you input is a valid number. The platform only accepts numeric values for this field. If these solutions do not resolve your issue, check the console for additional error messages or contact support. Contributing We welcome contributions to the Emission Horizon Platform. If you’d like to contribute, please follow these steps: Fork the repository. Create a new branch for your changes. Make your changes and ensure they follow the coding standards. Submit a pull request with a clear description of the changes you made. Please make sure to include tests for new features and maintain the existing code style.