3D cloud metrics for OCO-2 observations

The dataset contain contains supplementary data and the 3D cloud metrics described and analyzed in "Analysis of 3D Cloud Effects in OCO-2 XCO2 Retrievals”, Massie, S. T., Cronk, H., Merrelli, A., Schmidt, K. S., Chen, H., and Baker, D., Atmospheric Measurement Techniques, 14, 1475–1499, 2021. https://doi.org/10.5194/amt-14-1475-2021 The supplementary data files include the average OCO-2 - TCCON XCO2 differences from several key figures in the manuscript (6, 7, 12). The OCO-2 data was extracted from Version 10 XCO2 retrievals from a subset of the data record used for testing and development by the OCO-2 algorithm team. <br> figure6_ocean_distkm.dat<br> figure6_land_distkm.dat<br> These text files contain the average OCO-2 - TCCON XCO2 differences for several variations of the OCO2 XCO2 (raw and bias corrected, quality filter 0 or 1) as a function of the cloud distance metric. The first file includes only OCO-2 ocean glint data, and corresponds to Figure 6 from the manuscript. The second file contains the equivalent data for OCO-2 land (not plotted in the manuscript). figure7_ocean_csnoiseratio.dat<br> figure7_land_csnoiseratio.dat<br> These text files contains the average OCO-2 - TCCON XCO2 differences for several variations of the OCO-2 XCO2 (raw and bias corrected, quality filter 0 or 1) as a function of the color slice noise ratio. The first file includes only OCO-2 ocean glint data, and corresponds to Figure 7 from the manuscript. The second file contains the equivalent data for OCO-2 land (not plotted in the manuscript). figure12_ocean.dat<br> figure12_land.dat<br> These text files contain the average OCO-2 - TCCON XCO2 differences for several variations of the OCO-2 XCO2, same as above, but as a function of both the cloud distance metric and the color slice noise ratio. The x-variable is the cloud distance metric, and the y-variable is the colorslice noise ratio.<br> The first file includes only OCO-2 glint data, and corresponds to Figure 12 from the manuscript. The second file contains the equivalent data for OCO-2 land (not plotted in the manuscript). <br> 3D cloud metric data:<br> 3d_cloud_metrics_oco2_v9_2014.zip<br> 3d_cloud_metrics_oco2_v9_2015.zip<br> 3d_cloud_metrics_oco2_v9_2016.zip<br> 3d_cloud_metrics_oco2_v9_2017.zip<br> 3d_cloud_metrics_oco2_v9_2018.zip<br> 3d_cloud_metrics_oco2_v9_2019.zip These files are created with observation arrays that match those contained within the version 9 OCO-2 Lite XCO2 product available at NASA Earthdata: OCO-2 Science Team/Michael Gunson, Annmarie Eldering (2018), OCO-2 Level 2 bias-corrected XCO2 and other select fields from the full-physics retrieval aggregated as daily files, Retrospective processing V9r, Greenbelt, MD, USA, Goddard Earth Sciences Data and Information Services Center (GES DISC), 10.5067/W8QGIYNKS3JC Each file is a daily aggregrate, with matched observation lists to the parent version 9 Lite XCO2 files. Each file contains a copy of the sounding_id from the original Lite product files. These files are grouped into yearly zip files to facilitate easier file transfer. Each daily file is in netCDF4 format with appropriate metadata to describe the fields and their units. The filenames are derived from the parent version 9 Lite XCO2 file with "3Dmetrics" added as a suffix. For example, the first file from 2014 is named "oco2_LtCO2_140906_B9003r_180927215925s_3Dmetrics.nc4" which is derived from the Version 9 Lite product file "oco2_LtCO2_140906_B9003r_180927215925s.nc4".<br>本数据集包含《OCO-2 XCO2反演中的三维云效应分析》（*Analysis of 3D Cloud Effects in OCO-2 XCO2 Retrievals*）一文中所描述与分析的补充数据及三维云量度指标，该论文作者为Massie, S. T.、Cronk, H.、Merrelli, A.、Schmidt, K. S.、Chen, H.与Baker, D.，发表于《大气测量技术》（*Atmospheric Measurement Techniques*）2021年第14卷，页码范围1475–1499，数字对象标识符（Digital Object Identifier, DOI）：10.5194/amt-14-1475-2021。 补充数据文件包含该论文图6、7、12中多组关键图表的平均轨道碳观测卫星2号（OCO-2）与总碳柱观测网络（Total Carbon Column Observing Network, TCCON）的XCO2差值。本次所用OCO-2数据源自OCO-2算法团队用于测试与开发的部分数据记录的第10版XCO2反演结果。 ### 图6对应数据文件 `figure6_ocean_distkm.dat`与`figure6_land_distkm.dat`： 这两个文本文件存储了不同配置下OCO-2 XCO2（原始反演结果、偏差校正结果，质量过滤参数为0或1）的平均OCO-2与TCCON XCO2差值，该差值为云距离量度的函数。其中第一个文件仅包含OCO-2海洋耀斑数据，对应论文图6；第二个文件包含等效的OCO-2陆地数据（未在论文中绘图展示）。 ### 图7对应数据文件 `figure7_ocean_csnoiseratio.dat`与`figure7_land_csnoiseratio.dat`： 这两个文本文件存储了不同配置下OCO-2 XCO2（原始反演结果、偏差校正结果，质量过滤参数为0或1）的平均OCO-2与TCCON XCO2差值，该差值为彩色切片信噪比的函数。其中第一个文件仅包含OCO-2海洋耀斑数据，对应论文图7；第二个文件包含等效的OCO-2陆地数据（未在论文中绘图展示）。 ### 图12对应数据文件 `figure12_ocean.dat`与`figure12_land.dat`： 这两个文本文件存储了不同配置下OCO-2 XCO2的平均OCO-2与TCCON XCO2差值，配置与前述一致，但该差值同时为云距离量度和彩色切片信噪比的函数，其中x轴变量为云距离量度，y轴变量为彩色切片信噪比。其中第一个文件仅包含OCO-2海洋耀斑数据，对应论文图12；第二个文件包含等效的OCO-2陆地数据（未在论文中绘图展示）。 ### 三维云量度数据 数据集包含以下年度打包压缩文件： `3d_cloud_metrics_oco2_v9_2014.zip`、`3d_cloud_metrics_oco2_v9_2015.zip`、`3d_cloud_metrics_oco2_v9_2016.zip`、`3d_cloud_metrics_oco2_v9_2017.zip`、`3d_cloud_metrics_oco2_v9_2018.zip`、`3d_cloud_metrics_oco2_v9_2019.zip` 上述文件基于与NASA Earthdata平台发布的第9版OCO-2 Lite XCO2产品匹配的观测数组生成。该产品由OCO-2科学团队/Michael Gunson、Annmarie Eldering于2018年发布，为逐日聚合的全物理反演OCO-2 Level 2偏差校正XCO2及其他选定字段的回溯处理V9r版本，存储于美国马里兰州格林贝尔特的戈达德地球科学数据与信息服务中心（Goddard Earth Sciences Data and Information Services Center, GES DISC），DOI：10.5067/W8QGIYNKS3JC。 每个文件为逐日聚合数据，其观测列表与对应的第9版Lite XCO2父文件一致，且包含原始Lite产品文件中的`sounding_id`（探测ID）。文件按年度打包为zip压缩包以简化文件传输。每个单日文件均采用netCDF4格式，附带描述各字段及其单位的元数据。文件名由第9版Lite XCO2父文件名添加`3Dmetrics`后缀生成，例如2014年的首个文件名为`oco2_LtCO2_140906_B9003r_180927215925s_3Dmetrics.nc4`，其对应的第9版Lite产品父文件为`oco2_LtCO2_140906_B9003r_180927215925s.nc4`。