Proposed AIRS Filename and Local Granule ID (LGID) Convention

 

AIRS filenames used in the TLSCF will correspond with the "identifier" portion of the ECS LGID (Local Granule ID) standard:

 

LGID:shortname:version:identifier

 

where:

":" is a colon that acts as a separator of the parts of the LGID

"LGID" is a literal string

"shortname" is the ECS Earth Science Data Type (ESDT) shortname

"version" is the ECS ESDT version

"identifier" is AIRS.yyyy.mm.dd.ggg.Lev.Instr.Prod.Fvvv as detailed below

 

LGIDs are to be under 80 characters long and guaranteed unique. We guarantee uniqueness by including year, month, and day of start of granule together with granule number of day.

 

We use identifiers of:

 

AIRS.yyyy.mm.dd.ggg.Lev.Instr_Prod.vm.m.r.Fccc

 

Making the whole LGID:

 

LGID:shortname:version:AIRS.yyyy.mm.dd.ggg.Lev.Instr_Prod.c.vm.m.r.lvid.Fccc

 

where:

AIRS is the literal string "AIRS" to identify this as an AIRS+ product.

yyyy.mm.dd is the year/month/day of the start of the granule.

 

Note:

1. yyyy.mm.dd is the date of which T00Z is the start for T00Z.L*.Match_RaObs and T00Z.Loc_RaObs files.
2. yyyy.mm.dd is start of last day specified for VegMapxxX
3. No date info is included for Loc_Fixed_* and Loc_Synop_* files.

 

ggg is the granule number in day (001 - 240).

 

Note:

1. Granule number is replaced by synoptic time for Match_xxxx & Loc_xxxx & Tr_xxxx files that are RaObs, Synop, or ARM. It is omitted for all other Match_xxxx & Loc_xxxx & Tr_xxxx. It should always be one of T00Z, T06Z, T12Z, T18Z for RaObs files.
2. Granule number is omitted for daily products. For browse products (L1B.Browse_AMSU, L1B.Browse_HSB, L1B.Browse_AIRS, L2.Browse_Ret, L2.Browse_CC, L2.DailyRetSum). It is replaced by a single-character node-type identifier:
• “A" for Ascending
• "D" for Descending
3. For other daily products (L1B.VegMap, L1B.VegMapxxX, other Match_xxxx Tr_xxxx, and Loc_xxxx) there is no replacement.
4. The numbering system from 001 - 240 is intimately tied to the idea of 6-minute granules triggered at precise intervals keyed to total elapsed time since start of year 1958. Test granules have been produced with granule numbers outside of this interval or with granule numbers in range but without the corresponding start and end times. These granules are not supported for GDAAC or TDS usage.

 

Lev is processing level: "L1A", "L1B", or "L2"

 

Note:

1. Special level "L1BMW" is used for Match_xxxx files that have only L1B microwave information.
2. No level is used for Tr_xxx & Loc_xxx files.

 

Instr is instrument name:

 

• "AMSU" for AMSU-A
• "HSB" for HSB
• "VIS" for Vis channels of AIRS when there is a separate Vis product
• "AIRS" for AIRS/IR *or* AIRS/IR + AIRS/Vis
• (Missing for Daily & L2 products)

 

Prod is descriptor of product:

For L1A:

• "Scene" for scene footprints
• "Calib" for calibration footprints
• "HREng" for high-rate engineering
• "QaSub" for QA subset
• Omitted for AMSU & HSB, which each have only one L1A product.

 

For L1B:

• "Rad" for science radiances (including MW instruments where radiances are in units of brightness temperature)
• "QaSub" for QA subsets
• "BrSub" for browse subset
• "QaSup" for QA support products (Which are TLSCF-only.)
• "VegMap" for daily vegetation map
• "VegMap"xx"X" for multiday vegetation map (xx is number of days used to make this map 01-99: currently fixed at 10)
• "Browse_AIRS", "Browse_AMSU", and "Browse_HSB" for daily browse packages

 

For L2:

• "CC" for cloud-cleared AIRS radiances
• "RetStd" for standard retrieval product
• "RetSup" for support retrieval product
• "RetQa" for retrieval QA Support product (which is TLSCF-only.)
• "RetStat" for retrieval statistics by scanline (which is TLSCF-only.)
• "RetGStat" for Granule-level retrieval statisitcs (which is TLSCF-only.)
• "RetBrSub" for retrieval browse subset
• "CCBrSub" for cloud-cleared browse subset
• "Browse_Ret" for daily retrieval browse packages
• "Browse_CC" for cloud-cleared daily browse packages
• "DailyRetSum" for daily retrieval browse summary

 

Files that can be L1B, L1BMW, or L2:

• "Match_xxxx" for Truth matchup file where xxxx is a truth type descriptor:
• "RaObs" for Radiosonde (PREPQCH)
• "SurfMar" For Surface marine buoy data
• "ARM_yyy" for "ARM/CART" data
• "Fixed_yyy" for fixed sets of locations
• "Synop_yyy" for synoptic sets of locations at a given synoptic time where yyy is the source type variant

 

Files with no associated level:

• "Tr_xxxx" for Correlative Truth files
• "Loc_xxxx" for Truth location file where xxxx is as for Match_xxxx

 

Note: there are no Tr_xxx files for Fixed & Synop. PREPQC truth files for RaObs are created at the GDAAC and do not follow this naming convention at all.

 

c is a single-character source version code, present only for Tr_xxx, Loc_xxx, and Match_xxx files

 

vm.m.r is the PGEVersion uniquely identifying a configuration of source code + static ancillary files. "v" is the literal character 'v'. It is followed by three numbers separated by two "."s. These are the major & minor version numbers and a release number. Example: "v2.5.12" is release 12 of version 2.5. (In the development system and TDS PGEVersion can be vm.m.r.b, but this will never be visible at the GDAAC.)

 

Note: PGEVersion is omitted for Tr_xxx, Loc_Fixed_xxx, and Loc_Synop_xxx files

 

lvid is the LocalVersionID. This field is optional and usually absent.

 

Note:

1. LocalVersionID is not included when the processing facility is "A" or "G"
2. lvid is omitted for Tr_xxx, Loc_Fixed_xxx, and Loc_Synop_xxx files

 

F is processing facility ID:

• "G" for GSFC DAAC
• "A" for AIRS TLSCF official TDS processing
• "T" for AIRS TLSCF official testing
• "S" for AIRS TLSCF officially sanctioned simulation
• "X" for anything else

 

Note: processing facility ID is omitted for Tr_xxx, Loc_Fixed_xxx, and Loc_Synop_xxx files.

 

ccc is cycle number (000 - 999). 000 for first time data is processed at a given facility; 001-999 for later cycles.

 

Note:

1. This cycle number is one less than the 1-based cycle number at Logical ID 1020 in the PCF
2. Cycle number is omitted for Tr_xxx files, and is replaced by ".anc" for Loc_Fixed_xxx, and Loc_Synop_xxx files to mark them as staic ancillaries.
3. When optional fields are absent only one "." appears, never two in a row. Trailing "."s are also omitted.

 

Here's a full set (one of each type) as currently defined:

Produced by Level-1A PGEs:

AIRS.2001.12.03.131.L1A.AMSU.v2.12.5.A000

AIRS.2001.12.03.131.L1A.HSB.v2.12.5.A000

AIRS.2001.12.03.131.L1A.AIRS_Scene.v2.12.5.A000

AIRS.2001.12.03.131.L1A.AIRS_Calib.v2.12.5.A000

AIRS.2001.12.03.131.L1A.AIRS_QaSub.v2.12.5.A000

AIRS.2001.12.03.131.L1A.AIRS_HREng.v2.12.5.A000

AIRS.2001.12.03.131.L1A.VIS_Scene.v2.12.5.A000

AIRS.2001.12.03.131.L1A.VIS_Calib.v2.12.5.A000

 

Produced by Level-1B PGEs:

AIRS.2001.12.03.131.L1B.AMSU_Rad.v2.12.5.A000

(AIRS.2001.12.03.131.L1B.AMSU_QaSup.v2.12.5.A000)

AIRS.2001.12.03.131.L1B.HSB_Rad.v2.12.5.A000

(AIRS.2001.12.03.131.L1B.HSB_QaSup.v2.12.5.A000)

AIRS.2001.12.03.131.L1B.AIRS_Rad.v2.12.5.A000

AIRS.2001.12.03.131.L1B.AIRS_QaSub.v2.12.5.A000

AIRS.2001.12.03.131.L1B.AIRS_BrSub.v2.12.5.A000

AIRS.2001.12.03.131.L1B.VIS_Rad.v2.12.5.A000

AIRS.2001.12.03.131.L1B.VIS_QaSub.v2.12.5.A000

 

Produced by Level-1B Summary Browse PGEs:

AIRS.2001.12.03.A.L1B.Browse_AMSU.v2.12.5.A000

AIRS.2001.12.03.A.L1B.Browse_HSB.v2.12.5.A000

AIRS.2001.12.03.A.L1B.Browse_AIRS.v2.12.5.A000

 

Produced by Vis Level-1B surface Map PGEs:

AIRS.2001.12.03.L1B.VegMap.v2.12.5.A000

AIRS.2001.12.03.L1B.VegMap10X.v2.12.5.A000

 

Produced by Level-2 Retrieval PGE:

AIRS.2001.12.03.131.L2.CC.v2.12.5.A000

AIRS.2001.12.03.131.L2.RetStd.v2.12.5.A000

AIRS.2001.12.03.131.L2.RetSup.v2.12.5.A000

AIRS.2001.12.03.131.L2.RetBrSub.v2.12.5.A000

AIRS.2001.12.03.131.L2.CCBrSub.v2.12.5.A000

(AIRS.2001.12.03.131.L2.RetQa.v2.12.5.A000)

(AIRS.2001.12.03.131.L2.RetStat.v2.12.5.A000)

(AIRS.2001.12.03.131.L2.RetGStat.v2.12.5.A000)

 

Correlative Truth files:

(AIRS.2001.12.02.Tr_SurfMar.a)

(AIRS.2001.12.03.T13Z.Tr_ARM_NSA.a)

 

Truth location files:

(AIRS.2001.12.03.T12Z.Loc_RaObs.a.v2.12.5.A000)

(AIRS.2001.12.02.Loc_SurfMar.a.v2.12.5.A000)

(AIRS.2001.12.03.T13Z.Loc_ARM_NSA.a.v2.12.5.A000)

(AIRS.Loc_Fixed_ACAR.a.anc)

(AIRS.T18Z.Loc_Synop_1x1.a.anc)

 

Produced by Match Truth & Level-2 matchup Truth PGEs:

AIRS.2001.12.03.T12Z.L2.Match_RaObs.a.v2.12.5.A000

(AIRS.2001.12.03.T12Z.L1B.Match_RaObs.a.v2.12.5.A000)

(AIRS.2001.12.03.T12Z.L1BMW.Match_RaObs.a.v2.12.5.A000)

(AIRS.2001.12.02.L2.Match_SurfMar.a.v2.12.5.A000)

(AIRS.2001.12.03.T13Z.L2.Match_ARM_NSA.a.v2.12.5.A000)

(AIRS.2001.12.03.L2.Match_Fixed_ACAR.a.v2.12.5.A000)

(AIRS.2001.12.03.T18Z.L2.Match_Synop_1x1.a.v2.12.5.A000)

 

Produced by Level-2 Summary Browse PGEs:

AIRS.2001.12.03.A.L2.DailyRetSum.v2.12.5.A000

AIRS.2001.12.03.A.L2.Browse_Ret.v2.12.5.A000

AIRS.2001.12.03.A.L2.Browse_CC.v2.12.5.A000