IPTpy is a Python-based tool designed to process input data for CESM. It serves as a partial replacement for the NCL-based Input Processing Tool (IPT) for MUSICA, which is no longer maintained or updated by the NSF National Center for Atmospheric Research (NCAR).
IPTpy enables users to generate global anthropogenic emissions from Copernicus Atmosphere Monitoring Service (CAMS) or Community Emissions Data System (CEDS) inventories for the finite volume dynamic core (FV dycore), covering the most recent historical data. Compared to the original, IPTpy offers greater flexibility by allowing users to generate specific species and specify data on a monthly basis.
Table 1 Comparison of IPT and IPTpy for processing emission inputs
| Feature | IPT | IPTpy |
|---|---|---|
| Functions | Processing anthropogenic and biomass emissions for FV and SE dycores | Processing anthropogenic emissions for FV dycore |
| Global anthropogenic emission inventories | CAMS-GLOB-ANTv4.2, CEDSv2017_05_18 | CAM-GLOB-ANTv5.3, CAM-GLOB-ANTv6.2, CEDSv2021_04_21 |
| Global biomass burning emission inventories | FINN, QFED | Not applicable yet |
| Emission species | Generates all species by default (no user selection). | Allows users to select specific species as needed. |
| Emission period | Selected by year(s). | Selected by year(s) and months |
- While IPT-py does not yet replicate all IPT functionalities, contributions are welcome to enhance its capabilities further.
Table 2 Comparison of Global Anthropogenic Emission Inventories
| Feature | CAMS-GLOB-ANT | CEDSv2021_04_21 |
|---|---|---|
| Time step | Monthly | Monthly |
| Period | 2000-01-01 to present | 1750-01-16 to 2019-12-16 |
| Version | v5.3, v6.2 | v2021_04_21 |
| Spatial resolution | 0.1°x0.1° | 0.5°x0.5° |
| Download method | Wget | Globus (1750-2019), Wget (1950-2019)) |
- Verify Default Input Data First: Ensure that CESM job scripts run successfully using the default input data before incorporating user-customized input data. This helps isolate potential errors caused by modifications. For issues unrelated to input data, refer to DiscussCESM Forums for support.
- Understand Emission Input Interpolation: Emission datasets such as CEDS provide data on the 16th of each month. If a simulation starts on 01 Jan 2015, the input must include data from 16 Dec 2014 to enable interpolation between 16 Dec 2014 and 16 Jan 2015. Similarly, if a simulation extends to the end of 2015, the input must include 16 Jan 2016 to interpolate emissions from 16 Dec 2015 to 16 Jan 2016.
error1: imp_sol: step failed to converge @ (lchnk,vctrpos,nstep,dt,time) = 1281 431 1 11.25000 22.50000
notes: If the simulation stops due to CAM failing to converge, it likely indicates an issue with the input data, such as missing values (fill values) instead of actual data.
- Contributors: Yuan Sun, Zhonghua Zheng ([email protected])
- If you’re interested in contributing to the development of a Python-based IPT for CESM/CAM-Chem/MUSICA/CTSM, please reach out to Yuan Sun or submit an issue on the Issues page for any ideas or suggestions. We will respond as soon as possible.
- We also provide testing scripts for validating IPTpy functions in CESM.