stilt.observations.read_oco2

stilt.observations.read_oco2(path, *, lon_range=None, lat_range=None)

Read an OCO-2 or OCO-3 L2 Lite XCO2 file into a table of soundings.

Follows the Lite FP v10/v11 layout (oco2_LtCO2_*.nc4, oco3_LtCO2_*.nc4): the retrieval and its levels at the root, the viewing geometry and surface altitude under Sounding, the surface pressure under Retrieval. lon_range and lat_range keep only the soundings inside a box.

value is xco2 in ppm with the product’s fill as NaN; good is xco2_quality_flag == 0. The twenty pressure_levels and the kernel on them (ak_pressure, ak) are reordered from the surface up (the file lists them from space down). apriori is the CO2 prior profile on the same levels, pressure_weight the retrieval’s pressure weighting function, and apriori_column the prior XCO2. zenith and azimuth are the sensor angles toward the satellite; the solar angles are alongside.

Return type:

DataFrame

Parameters:

• path (str | Path)

• lon_range (tuple[float, float] | None)

• lat_range (tuple[float, float] | None)