NASA -National Aeronautics and Space Administration
FIND IT @ NASA
HOME MISSIONS DATA TOOLS ABOUT US
NASA Tropospheric Chemistry Integrated Data Ceneter

 

ICARTT Data Format

Amended FFI 2110

Ali Aknan; NASA LaRC

(February 2011)


EXAMPLE - Start/Stop/Mid-point Intervals Sampling


File Format Specification for ICARTT Multi-dimensional Data Files Using FFI 2110:

A. Structure

The FFI descriptor for FFI 2110: two real independent variables, one unbounded and one bounded with its values recorded in the data records. Primary variables are real; auxiliary variables are real.

The file structure (pseudocode) described by the Ames format document looks like this:

NLHEAD 2110
ONAME
ORG
SNAME
MNAME
IVOL NVOL
DATE RDATE
DX(1) DX(2)
[ XNAME(s) ] s=1,2
NV
[ VSCAL(n), n=1,NV ]
[ VMISS(n), n=1,NV ]
[ VNAME(n) ] n=1,NV
NAUXV .................The first auxiliary variable is NX(m,1)
[ ASCAL(a), a=1,NAUXV ]
[ AMISS(a), a=1,NAUXV ]
[ ANAME(a) ] a=1,NAUXV
NSCOML
[ SCOM(k) ] k=1,NSCOML
NNCOML
[ NCOM(k) ] k=1,NNCOML
[ X(m,2) NX(m,1) ( A(m,a), a=2,NAUXV ) ]
[ X(i,m,1) ( V(i,m,n), n=1,NV ) ] i=1,NX(m,1)

Let’s break it down line-by-line:

The first 7 lines are identical to FFI 1001 file type and described in Section 3B.

DX(1): THIS WILL NOT BE USED HERE. FYI: this value represents the intervals for the bounded independent variable (e.g., GeoAltitude).

DX(2): this is the sampling interval for the unbounded independent variable (e.g., UTC); the same details/restrictions apply as they do to the sampling interval in FFI 1001 file type.

[ XNAME(s) ] s=1,2: here you list the names for the 2 independent variables starting with the bounded variable (e.g., GeoAltitude), then the unbounded variable (e.g., UTC).

NV: represents the total number of Primary variables. ALL Primary variables are arrays.

[ VSCAL(n), n=1,NV ] : analogous to FFI 1001 file type.
[ VMISS(n), n=1,NV ] : analogous to FFI 1001 file type.
[ VNAME(n) ] n=1,NV: analogous to FFI 1001 file type.

NAUXV .................The 1st* auxiliary variable is NX(m,1)
- NX(m,1) = Dimension; total number of values for Primary variables (i.e., array size)

[ ASCAL(a), a=1,NAUXV ]: analogous to Primary variables description (see above)
[ AMISS(a), a=1,NAUXV ]: analogous to Primary variables description (see above)
[ ANAME(a) ] a=1,NAUXV: analogous to Primary variables description (see above)

NSCOML
[ SCOM(k) ] k=1,NSCOML: analogous to FFI 1001 file type

NNCOML
[ NCOM(k) ] k=1,NNCOML: analogous to FFI 1001 file type

The Data Section:
[ X(m,2) NX(m,1) ( A(m,a), a=2**,NAUXV ) ]
[ X(i,m,1) ( V(i,m,n), n=1,NV ) ] i=1,NX(m,1)

Each data record contains UTC, Auxiliary and Primary variables:
- Each data record always begins with UTC; the next vlaue will be the Primary variable(s)’ dimension, then the values for the rest of the Auxiliary variables. All of these values from UTC to NAUXV are listed on one line.

The next “NX(m,1)” lines (i.e., 1 thru ArraySize) display the bounded independent variable and all Primary variables’ values in "a column format" starting with bounded independent variable:

- the 1st line in the section will display the first value of the bounded independent variable and the first value for each Primary variable.
- the 2nd line will display the second value of the bounded independent variable and the second value for each Primary variable.
- . . .
- etc.

* {when Start/Stop/Mid-point Sampling Intervals used: the 1* becomes "3"; and variables are listed as follows: UTC_Stop, UTC_Mid, and NX(m,1)}.

** {when Start/Stop/Mid-point Sampling Intervals used: the 2
**
becomes "4"}.

In the Header Normal Section, please include all KEYWORD/VALUE pairs.

If LODs are to be used, then try to use one ULOD_FLAG and one LLOD_FLAG for all parameters. Also to remember that LODs DO NOT apply to Independent variables.

For example (Header Normal Section):

ULOD_FLAG: -7777 (i.e., ALL parameters will use –7777 for their ULOD_FLAG)
ULOD_VALUE: ulod_Vi-2, ulod_Vi-1; ulod_Vi; ulod_Vi+1; . . . . ; ulod_Vn
[where,
{if Start/Stop/Mid-point Sampling Intervals used, then enter N/A; N/A; for UTC_Stop and UTC_Mid (i.e.: ulod_Vi-2;ulod_Vi-1= NA;NA;)}
ulod_Vi = ULOD_arraySize (normally, this will be N/A;)
ulod_Vi+1 = ULOD_NextAuxVar
.
ulod_Vn = ULOD_Last_PRIMARY_VAR
]

Use similar procedure for LLODs. Enter N/A for variables that do not use LODs.

Below is an example for clarification.


EXAMPLE [Start/Stop/Mid-point Intervals Sampling]

File name: AROTAL-RAY_DC8_20040715_R1.ict

61, 2110
PI LastName, First Name
Code 916, Goddard Space Flight Center, Greenbelt, MD 20771
AROTAL
PAVE Mission
1, 1
2004, 07, 15, 2006, 01, 18
0.0
Altitude[], meters, Altitude_array
UT_Time, XX.XXXX_hours_from_0_hours_on_flight_date
7
0.1, 0.0001, 0.1, 0.01, 0.0001, 0.1, 0.0001
-999999, -999999, -999999, -999999, -999999, -999999, -999999
TempK[], K, Temperature_array
Log10_NumDensity[], part/cc, Log10_Number_density_array
TempK_Err[], K, Temperature_error_array
AerKlet[], Klet, Aerosol_array
Log10_O3NumDensity[], part/cc, Log10_Ozone_number_density_array
O3_MR[], ppb, Ozone_mixing_ratio_array
Log10_O3NumDensity_Err[], Log10_Ozone_number_density_error_array
13
1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0
-9999, -9999, -9999, -9999, -9999, -9999, -9999, -9999, -9999, -9999, -9999, -9999, -9999
Stop_UT, XX.XXXX_hours_from_0_hours_on_flight_date
Mid_UT, XX.XXXX_hours_from_0_hours_on_flight_date
NumAlts, Number, Number_of_altitudes_reported
Year, UT
Month, UT
Day, UT
AvgTime, xxx.x_minutes, Averaging_time_of_presented_data
Latitude, degrees
Longitude, degrees
PAlt, meters, pressure_altitude
GPSAlt, meters, GPS_altitude
SAT, K, Static_air_temperature
SZA, degrees
4
Data version 0 - archived in the field, preliminary in nature and subject to change in the near future.
These T and O3 values were retrieved using only Rayleigh data (355 & 308nm).
Thus they can be affected by aerosols, PSCs and low (< 97 degrees) SZA.
The archived profile is formed from a 4 min. running average of 20 sec. integrated data sets.
19
PI_CONTACT_INFO: Enter PI Address here
PLATFORM: NASA DC8
LOCATION: Lat, Lon, and Alt included in the data records
ASSOCIATED_DATA: N/A
INSTRUMENT_INFO:
DATA_INFO:
UNCERTAINTY: Enter uncertainty description here
ULOD_FLAG: -7777
ULOD_VALUE: N/A;
LLOD_FLAG: -8888
LLOD_VALUE: N/A;
DM_CONTACT_INFO: Enter Data Manager Info here
PROJECT_INFO: PAVE MISSION: Jan-Feb 2005
STIPULATIONS_ON_USE: Use of these data should be done in consultation with the PI
OTHER_COMMENTS:
REVISION: R1; R0
R1: Minor calibrations were done; however, future revisions are expected.
R0: No Comments
UT_Time, Stop_UT, Mid_UT, NumAlts, Year, Month, Day, AvgTime, Latitude, Longitude, PAlt, GpsAlt, SAT, SZA, Altitude[], TempK[], Log10_NumDensity[], TempK_Err[], AerKlet[], Log10_O3NumDensity[], O3_MR[], Log10_O3NumDensity_Err[]
14.8283, 14.8293, 14.8288, 9, 2005, 2, 3, 0, 42.308, -70.582, 6910, 6979, 242.5, 65.5
     9154, -999999, -999999, -999999, -999999, 113178, 212, -999999
     9304, -999999, -999999, -999999, -999999, 123353, 2250, -999999
     9454, -999999, -999999, -999999, -999999, 123008, 2116, -999999
     9604, -999999, -999999, -999999, -999999, 120933, 1337, -999999
     9754, -999999, -999999, -999999, -999999, 119675, 1019, -999999
     9904, -999999, -999999, -999999, -999999, 122655, 2061, -999999
     10054, -999999, -999999, -999999, -999999, 124384, 3126, -999999
     10204, -999999, -999999, -999999, -999999, 124632, 3371, -999999
     10354, -999999, -999999, -999999, -999999, 121341, 1609, -999999
14.8342, 14.8352, 14.8347, 8, 2005, 02, 03, 0, 42.278, -70.613, 6978, 7043, 241.7, 65.5
     10118, -999999, -999999, -999999, -999999, 124458, 3205, -999999
     10268, -999999, -999999, -999999, -999999, 123160, 2421, -999999
     10418, -999999, -999999, -999999, -999999, 121221, 1582, -999999
     10568, -999999, -999999, -999999, -999999, 120950, 1523, -999999
     10718, -999999, -999999, -999999, -999999, 117339, 680, -999999
     10868, -999999, -999999, -999999, -999999, 122751, 2423, -999999
     11018, -999999, -999999, -999999, -999999, 124230, 3491, -999999
     11168, -999999, -999999, -999999, -999999, 124039, 3424, -999999




NASA - National Aeronautics and Space
 Administration
Curator: Ali Aknan
NASA Official: Dr. Gao Chen

+ Freedom of Information Act
+ Budgets, Strategic Plans and Accountability Reports
+ The President's Management Agenda
+ Inspector General Hotline
+ Equal Employment Opportunity Data Posted Pursuant to the No Fear Act
+ Information-Dissemination Priorities and Inventories
+ Privacy Policy and Important Notices
+ USA.gov
+ ExpectMore.gov
+ Multimedia Browser Plug-ins
+ Comments or Questions?