stilt.observations.read_ggg_oof#

stilt.observations.read_ggg_oof(path, species)[source]#

Read a GGG2020 .oof file into a table of soundings.

A .oof (*.vav.ada.aia.oof) holds one day of retrievals from one instrument. EGI delivers EM27/SUN results this way.

A .oof has no averaging kernel or prior profile, so the ak, ak_pressure, and pressure_levels columns are missing. The kernels are in the run’s *.private.nc (read_ggg_netcdf()), or in a site kernel table by solar zenith angle.

Parameters:

  • path (str | Path) – The .oof file.

  • species (str) – Column variable to read, such as xch4, xco2, xco, xh2o, or xn2o.

Returns:

One row per spectrum. value and uncertainty are the species and its one-sigma error, in the units the column header gives (xch4(ppm) gives ppm). good is flag == 0. sounding_id is the spectrum name. surface_altitude is the instrument’s altitude and surface_pressure the pressure it measured. zenith and azimuth are the solar angles. time comes from the year, day, and UT hour columns. The other x<gas> columns and their errors, flag, zmin (km), and xluft keep their own names.

Return type:

DataFrame