STILT-NOx (for GMD submission)

This release contains model input (e.g., preprocessed EDGARv6 files) and model scripts (r/src/chem_lifetime) for simulating tropospheric NO2 columns. These changes are initially designed for working with TROPOMI v1 and v2 data.

Reference for the GMDD paper: Wu, D., Laughner, J. L., Liu, J., Palmer, P. I., Lin, J. C., and Wennberg, P. O.: A simplified non-linear chemistry-transport model for analyzing NO2 column observations, EGUsphere [preprint], https://doi.org/10.5194/egusphere-2023-876, 2023.

This paper is still in review and we expect possible changes to the model scripts during revisions. One can start with run_xstilt.r for generating the trajectories from each TROPOMI satellite sounding and then use run_stilt_nox.r to simulate NO2 columns [ppb]. More descriptions are included in the README.md.

X-STILT for TROPOMI and OCO-2/3

• Latest release on X-STILT in interpreting TROPOMI (use with cautions for NO2, no chemistry implemented yet) and OCO-2/3 data.
• README can be found at https://github.com/uataq/X-STILT/blob/master/README.md.
• Please always download the development version from https://github.com/uataq/X-STILT. Versions on Zenodo can be outdated.
• Please refer to the STILT tutorial https://github.com/uataq/stilt, if you are not familiar with our Lagrangian system.

This version bookmarks the code version documented in the following manuscripts:
Wu, D., Lin, J. C., Fasoli, B., Oda, T., Ye, X., Lauvaux, T., Yang, E. G., and Kort, E. A.: A Lagrangian approach towards extracting signals of urban CO2 emissions from satellite observations of atmospheric column CO2 (XCO2): X-Stochastic Time-Inverted Lagrangian Transport model ("X-STILT v1"), Geosci. Model Dev., 11, 4843-4871, https://doi.org/10.5194/gmd-11-4843-2018, 2018.

Wu, D., Liu, J., Wennberg, P. O., Palmer, P. I., Nelson, R. R., Kiel, M., and Eldering, A.: Towards sector-based attribution using intra-city variations in satellite-based emission ratios between CO2 and CO, Atmos. Chem. Phys. Discuss. [preprint], https://doi.org/10.5194/acp-2021-1029, accepted, 2022.

Please contact Dien Wu (dienwu@caltech.edu) OR preferrable submit a pull request on GitHub describing your specific error messages.

X-STILT

This release includes the model code of X-STILT built on STILT-R version 2 (Fasoli et al., 2018) and STILT (Lin et al., 2003). Important changes from the last version v1.3 include X-STILT code refactoring with STILTv2 being a submodule along with few optimizations and minor changes:

• Refactor transport error code using the latest X-STILT framework (see run_xstilt). Specifically, move the traj-level CO2 calculation (starting with cal.trajfoot.stat()) into before_footprint_xstilt().

• Minor bugs/typos fixed (leading to very small impact on the calculation), when 1) weighting traj-level foot for trajec with wind error component (wgt.trajec.footv3) and 2) calculating the traj-level CO2 (cal.trajfoot.stat). Specifically, no AK weighting for endpts.trajfoot.r.

• Remove two sections of the code for simplifications, including 1) calculation of lat-int signals or errors in run_xstilt and 2) two scripts for plotting that used to be in ./r/src/plot_scripts.

• Optimize several functions for trajec-level CO2 calculations (*.trajfoot) to reduce the memory needed.

This version bookmarks the code version documented in the following manuscript:
Wu, D., Lin, J. C., Fasoli, B., Oda, T., Ye, X., Lauvaux, T., Yang, E. G., and Kort, E. A.: A Lagrangian approach towards extracting signals of urban CO2 emissions from satellite observations of atmospheric column CO2 (XCO2): X-Stochastic Time-Inverted Lagrangian Transport model ("X-STILT v1"), Geosci. Model Dev., 11, 4843-4871, https://doi.org/10.5194/gmd-11-4843-2018, 2018.

Please contact Dien Wu (Dien.Wu@utah.edu) if you have any questions, comments, and suggestions.

X-STILT (for Geoscientific Model Development 2018)

This release includes the model code of X-STILT built on STILT (Lin et al., 2003) and STILT-R version 2 (Fasoli et al., 2018) and bookmarks the code version documented in the following manuscript:

Wu, D., Lin, J. C., Oda, T., Ye, X., Lauvaux, T., Yang, E. G., and Kort, E. A.: A Lagrangian Approach Towards Extracting Signals of Urban CO2 Emissions from Satellite Observations of Atmospheric Column CO2 (XCO2): X-Stochastic Time-Inverted Lagrangian Transport model ("X-STILT v1.1"), Geosci. Model Dev. Discuss., https://doi.org/10.5194/gmd-2018-123, in review, 2018.

Please contact Dien Wu (Dien.Wu@utah.edu) if you have any questions, comments, and suggestions.