DOCUMENTATION/ GEOMS DATA REPORTING/ MWR
Microwave Radiometer (MWR) template description
Document history
Version |
Date |
Comments |
003 |
December 01, 2021 |
GEOMS MWR template |
002 |
July 18, 2013 |
GEOMS MWR template v002 |
001 |
September 05, 2012 |
GEOMS MWR template v001 |
v3 |
December 01, 2021 |
AVDC/NDACC MWR reporting guidelines (revised version in preparation) |
v1/v2 |
September 09, 2006 |
AVDC/NDACC MWR reporting guidelines v001 |
Overview
This document outlines data reporting requirements for the Microwave Radiometer (MWR) systems of the Network for the Detection of Atmospheric Composition Change (NDACC). These guidelines were developed by the Microwave Radiometer Working Group of the NDACC and the Aura Validation Data Center (AVDC) to facilitate the submission of MWR datasets compliant to the Generic Earth Observation Metdata Standard (GEOMS) to the Aura Validation Data Center (AVDC) and the NDACC Data Handling Pacility (DHF).
Template description
- Instrument Naming
Although microwave radiometer systems have the capability to measure multiple entities simultaneously, the instrument names of the different MWR systems are based on the primary measured entity [GAS] to be reported in the file, as shown in Tables below.
- Variable Reporting
Each measured primary entity [GAS] requires a list of 22 mandatory variables to be reported within a file MWR.[GAS] (24 variables for MWR.O3), and 1 optional variable (see Tables below):
- Additional Notes
DATETIME - is a single weighted mean time of the measurement - i.e. after accounting for periods where there are no measurements because of poor weather conditions, calibrations etc.
INTEGRATION.TIME - the effective integration time of the spectra used in the retrieval, which will generally be less than the difference between the start and stop times (after accounting for non-spectral, bad or missing measurements).
[GAS].MIXING.RATIO.VOLUME_EMISSION_AVK - if averaging kernels are routinely generated for each measurement as part of the retrieval, these should be reported in the HDF file, otherwise a generic set may be used.
Averaging kernel and a-priori measurements are included in the file so users have the option to convolve higher resolution datasets to the microwave resolution. This means that the reported altitude range will typically be wider than the normal measurement range. However, this does not mean that all data variables should be reported over the full range.
The following variables would generally be reported over the full range:
ALTITUDE,
PRESSURE.INDEPENDENT,
TEMPERATURE.INDEPENDENT,
[GAS].MIXING.RATIO.VOLUME_EMISSION_APRIORI,
[GAS].MIXING.RATIO.VOLUME_EMISSION_AVK
The remaining data variables from Tables below should contain measurements over the normal measurement range of the instrument only (i.e. not including measurements where the averaging kernels are not well resolved, or the errors are high, or the a-priori dependence is high etc). Fill values (see Tables below) should then be used over the remaining altitude range.
SOURCE.PRODUCT - only used when the HDF file is converted from another format e.g. NDACC NASA/Ames. The format of the entry is ORIGINAL.ARCHIVE_ORIGINAL.FILENAME_ORIGINAL.FILE.CREATION.DATE e.g. NDACC_LAHO1208.NDM_20120820
- Variable Fill Values
The variable fill value is a number inserted as a substitute data element if a data element of a variable is default or missing.
- File Granularity
The reporting granularity for MWR measurements should be daily or, for instruments with lower temporal resolution, one measurement per file.
- Metadata - Global Attributes
Each MWR.[GAS] file requires one set of Global Attributes. These have been grouped in to three categories describing the file contents, namely Originator Attributes, Dataset Attributes and File Attributes. An example of a microwave ozone global attributes measurement at Mauna Loa, Hawaii is given in Tables below.
- Metadata - Variable Attributes
Each variable reported in a MWR.[GAS] file requires one set of Variable Attributes. An example of an attribute set is given in Tables below.
Templates and examples
GEOMS-EX-LIDAR-VA (LIDAR variable attributes example)
# | Variable name | Variable value | Comment |
0 | VAR_NAME | O3.MIXING.RATIO.VOLUME_DERIVED | Refer to GEOMS document |
1 | VAR_DESCRIPTION | Derived Ozone mixing ratio (ppmv) | Free format |
2 | VAR_NOTES | | Free format |
3 | VAR_SIZE | 210 | The number of elements in each dimension |
4 | VAR_DEPEND | ALTITUDE | INDEPENDENT, CONSTANT, self-referencing or a previously given one dimensional variable (in this case ALTITUDE) |
5 | VAR_DATA_TYPE | DOUBLE | Allowable formats are BYTE, SHORT, INTEGER, REAL, DOUBLE, STRING |
6 | VAR_UNITS | ppmv | Refer to GEOMS document |
7 | VAR_SI_CONVERSION | 0.0;1.0E-6;1 | Refer to GEOMS document |
8 | VAR_VALID_MIN | -10.00 | |
9 | VAR_VALID_MAX | 20.00 | |
10 | VAR_FILL_VALUE | -90000.00
| |
Download in CSV format GEOMS-EX-LIDAR-VA.csv (last updated: December 01, 2021).
top
GEOMS-TE-MWR-DS (MWR data sources)
ERROR_SQL=select show, datasource, description from datasource where datasource like '%MWR%' and show != '0' ORDER BY datasource;top
GEOMS-TE-MWR-VA (MWR Variable Attributes Template)
# | Variables | Dependencies/Dimensions | Units | Data type | Comment | Req |
0 | LATITUDE.INSTRUMENT | CONSTANT | deg | REAL | Inst. geolocation | x |
1 | LONGITUDE.INSTRUMENT | CONSTANT | deg | REAL | Inst. geolocation | x |
2 | ALTITUDE.INSTRUMENT | CONSTANT | m | INTEGER | Inst. geolocation | x |
3 | DATETIME | DATETIME | MJD2K | DOUBLE | Weighted meas. time | x |
4 | ANGLE.VIEW_AZIMUTH | [CONSTANT|DATETIME] | deg | REAL | Inst. view. azimuth | x |
5 | ANGLE.VIEW_ZENITH_MEAN | DATETIME | deg | REAL | Mean inst. view. angle | x |
6 | ANGLE.SOLAR_ZENITH_MEAN | DATETIME | deg | REAL | Weighted mean SZA | x |
7 | OPACITY.ATMOSPHERIC_EMISSION | DATETIME | Np | REAL | Opacity | x |
8 | DATETIME.START | DATETIME | MJD2K | DOUBLE | Meas. start | x |
9 | DATETIME.STOP | DATETIME | MJD2K | DOUBLE | Meas. End | x |
10 | INTEGRATION.TIME | DATETIME | h | DOUBLE | Effective meas. time | x |
11 | ALTITUDE | ALTITUDE | m | INTEGER | Ref. GMH | x |
12 | PRESSURE_INDEPENDENT | [ALTITUDE|DATETIME;ALTITUDE] | hPa | REAL | P ref. profile | x |
13 | TEMPERATURE_INDEPENDENT | [ALTITUDE|DATETIME;ALTITUDE] | K | REAL | T ref. profile | x |
14 | [GAS].MIXING.RATIO.VOLUME_EMISSION | [ALTITUDE|DATETIME;ALTITUDE] | ppmv | REAL | | x |
15 | [GAS].MIXING.RATIO.VOLUME_EMISSION_UNCERTAINTY.RANDOM.STANDARD | [ALTITUDE|DATETIME;ALTITUDE] | ppmv | REAL | | x |
16 | [GAS].MIXING.RATIO.VOLUME_EMISSION_UNCERTAINTY.SYSTEMATIC.STANDARD | [ALTITUDE|DATETIME;ALTITUDE] | ppmv | REAL | | x |
17 | [GAS].MIXING.RATIO.VOLUME_EMISSION_UNCERTAINTY.COMBINED.STANDARD | [ALTITUDE|DATETIME;ALTITUDE] | ppmv | REAL | | x |
18 | [GAS].MIXING.RATIO.VOLUME_EMISSION_RESOLUTION.ALTITUDE | [ALTITUDE|DATETIME;ALTITUDE] | m | INTEGER | | x |
19 | [GAS].MIXING.RATIO.VOLUME_EMISSION_APRIORI | [ALTITUDE|DATETIME;ALTITUDE] | ppmv | REAL | | x |
20 | [GAS].MIXING.RATIO.VOLUME_EMISSION_APRIORI.CONTRIBUTION | [ALTITUDE|DATETIME;ALTITUDE] | % | REAL | | x |
21 | [GAS].MIXING.RATIO.VOLUME_EMISSION_AVK | [ALTITUDE;ALTITUDE|DATETIME;ALTITUDE;ALTITUDE] | 1 | REAL | | x |
22 | O3.COLUMN.PARTIAL_EMISSION | DATETIME | DU | REAL | | x if O3 is reported |
23 | O3.NUMBER.DENSITY_EMISSION | [ALTITUDE|DATETIME;ALTITUDE] | molec m-3 | REAL | | x if O3 is reported |
24 | H2O.COLUMN_DERIVED | DATETIME | molec cm-2 | REAL | derived integrated water vapor partial column from retrieval | o |
25 | SOURCE.PRODUCT | INDEPENDENT
| [empty] | STRING | Information relevant to the source history of the Metadata and Data | o |
Download in CSV format GEOMS-TE-MWR-VA.csv (last updated: December 01, 2021).
top
GEOMS-EX-MWR-GA (MWR Global Attributes Example)
# | Variable name | Variable value | Comment |
0 | PI_NAME | Parrish;Alan | |
1 | PI_AFFILIATION | University of Massachusetts;UMASS | |
2 | PI_ADDRESS | 619 Lederle GRC, University of Massachusetts;Amherst MA 01003;UNITED STATES | |
3 | PI_EMAIL | parrish@astro.umass.edu | |
4 | DO_NAME | Parrish;Alan | |
5 | DO_AFFILIATION | University of Massachusetts;UMASS | |
6 | DO_ADDRESS | 619 Lederle GRC, University of Massachusetts;Amherst MA 01003;UNITED STATES | |
7 | DO_EMAIL | parrish@astro.umass.edu | |
8 | DS_NAME | Boyd;Ian | |
9 | DS_AFFILIATION | University of Massachusetts;UMASS | |
10 | DS_ADDRESS | 619 Lederle GRC, University of Massachusetts;Amherst MA 01003;UNITED STATES | |
11 | DS_EMAIL | iboyd@astro.umass.edu | |
12 | DATA_DESCRIPTION | Atmospheric ozone profiles from continuous ground-based microwave measurements at Lauder, New Zealand | Free format |
13 | DATA_DISCIPLINE | ATMOSPHERIC.PHYSICS;REMOTE.SENSING;GROUNDBASED | Refer to GEOMS document |
14 | DATA_GROUP | EXPERIMENTAL;PROFILE.STATIONARY | Refer to GEOMS document |
15 | DATA_LOCATION | LAUDER | Refer to GEOMS document |
16 | DATA_SOURCE | MWR.O3_UMASS001 | Refer to GEOMS document |
17 | DATA_VARIABLES | LATITUDE.INSTRUMENT; LONGITUDE.INSTRUMENT; ALTITUDE.INSTRUMENT; DATETIME; ANGLE.VIEW_AZIMUTH; ANGLE.VIEW_ZENITH_MEAN; ANGLE.SOLAR_ZENITH_MEAN; OPACITY.ATMOSPHERIC_EMISSION; DATETIME.START; DATETIME.STOP; INTEGRATION.TIME; ALTITUDE; PRESSURE_INDEPENDENT; TEMPERATURE_INDEPENDENT; O3.MIXING.RATIO.VOLUME_EMISSION; O3.MIXING.RATIO.VOLUME_EMISSION_UNCERTAINTY.RANDOM.STANDARD; O3.MIXING.RATIO.VOLUME_EMISSION_UNCERTAINTY.SYSTEMATIC.STANDARD; O3.MIXING.RATIO.VOLUME_EMISSION_UNCERTAINTY.COMBINED.STANDARD; O3.MIXING.RATIO.VOLUME_EMISSION_RESOLUTION.ALTITUDE; O3.MIXING.RATIO.VOLUME_EMISSION_APRIORI; O3.MIXING.RATIO.VOLUME_EMISSION_APRIORI.CONTRIBUTION; O3.MIXING.RATIO.VOLUME_EMISSION_AVK; O3.COLUMN.PARTIAL_EMISSION; O3.NUMBER.DENSITY_EMISSION; SOURCE.PRODUCT | Refer to GEOMS document |
18 | DATA_START_DATE | 20080101T001100Z | ISO8601 |
19 | DATA_STOP_DATE | 20080101T082200Z | ISO8601 |
20 | DATA_FILE_VERSION | 001 | Refer to GEOMS document |
21 | DATA_MODIFICATIONS | Final v6.0 dataset | Free format |
22 | DATA_CAVEATS | None | Free format |
23 | DATA_RULES_OF_USE | Please contact Alan Parrish at parrish@astro.umass.edu | Free format |
24 | DATA_ACKNOWLEDGEMENT | We thank the NIWA support staff for their efforts. | Free format |
25 | DATA_QUALITY | None | Free format |
26 | DATA_TEMPLATE | GEOMS-TE-MWR-003 | Refer to GEOMS document |
27 | DATA_PROCESSOR | | Refer to GEOMS document |
28 | FILE_NAME | groundbased_mwr.o3_umass001_lauder_20080101t001100z_20080101t082200z_001.hdf | Naming convention |
29 | FILE_GENERATION_DATE | 20110325T144148Z | ISO8601 |
30 | FILE_ACCESS | AVDC;NDACC | Project dependent |
31 | FILE_PROJECT_ID | | Project dependent |
32 | FILE_DOI | | [TBD] |
33 | FILE_ASSOCIATION | NDACC | Project dependent |
34 | FILE_META_VERSION | 04R007 IDLCR8HDF
| Refer to GEOMS document |
Download in CSV format GEOMS-EX-MWR-GA.csv (last updated: December 01, 2021).
top
|