Skip to content

Add CMORized NOAA GML surface flask concentration measurement of N2O #4059

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

jlenh
Copy link
Contributor

@jlenh jlenh commented May 22, 2025

Description

This PR adds the N2O dataset pendant from #3847

This work adds a downloader and a formatter to ESMValTool to download and CMORize surface flask measurements of N2O from the Global Monitoring Lab (GML) of NOAA. This work contributes to the ongoing development of a recipe and diagnostic to evaluate model output of surface concentrations of trace gases against the NOAA GML station measurements #3838.

The downloader retrieves event-based and monthly station averages of surface flask measurements of N2O (see NOAA-GML) as an archive. Only the monthly averages of each station are CMORized here and are already computed following the methodology described on NOAA's GML website from the event-based files also present in the downloaded archive. The dataset archives are downloaded separately for each trace gas.

The formatter CMORizes the station monthly averages for a given trace gas by creating a NetCDF file containing all stations for which a location was available in the corresponding event files. The NetCDF file holds a time series for each station with the coordinates station_id, latitude and longitude. The general dataset architecture is taken from #3227 which implemented a CMORizer for time series of surface station observations. This allows the access to all stations data in a single file, speeding up loading times and processing operations. The general formatting functions are implemented in a separate file from which a single function is then imported and called in the respective trace gases formatter files.

Note: the CMORized variable produced here n2os is not available in the CMOR table CMIP6 - Amon. However, in the case of model outputs, it needs to be derived from its 3D counterparts (n2o, see #2611).

Note2: For the N2O dataset and the variable n2os, it requires a new release of ESMValCore to incorporate the addition of the variable in the CMOR tables.


Before you get started

Checklist

It is the responsibility of the author to make sure the pull request is ready to review. The icons indicate whether the item will be subject to the 🛠 Technical or 🧪 Scientific review.

New or updated data reformatting script

@jlenh jlenh self-assigned this May 22, 2025
@jlenh jlenh requested a review from a team as a code owner May 22, 2025 15:54
@jlenh jlenh added observations requires new ESMValCore release A new release of ESMValCore is needed to solve this issue/merge this pull request.. looking for technical reviewer looking for scientific reviewer labels May 22, 2025
@jlenh jlenh changed the title Transfer changes and files from previous branch Add CMORized NOAA GML surface flask concentration measurement of N2O May 22, 2025
@jlenh jlenh added this to the v2.13.0 milestone Jun 20, 2025
@jlenh
Copy link
Contributor Author

jlenh commented Aug 8, 2025

Scientific @schlunma or @bettina-gier ? Technical @valeriupredoi ?
If you could review this so it is ready to be merged when I take care of the release 🤓
It is basically the same as for #3847 but for N2O (in the end I did a PR for the diagnostic for all the gases so it did not really change anything to separate the cmorizers for this)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
looking for scientific reviewer looking for technical reviewer observations requires new ESMValCore release A new release of ESMValCore is needed to solve this issue/merge this pull request..
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add CMORized NOAA Global Monitoring Lab surface flask concentration measurements of trace gases (CH4, CO2, N2O)
1 participant