NASA Ames Metadata Format: FFI 2160


Metadata pertaining to a given NASA Ames formatted data file are recorded in the first lines (header) of the file itself. The header is made of three subsections: This document gives the format of the header body for FFI 2160.

Symbols used

DX Interval identifier for the first independent variable (real number). It is the interval between two successive values of X1 if this interval is uniform, i.e. if X1(i+1)-X1(i) = X1(i)-X1(i-1) for all i such that 1 < i < NX(m).
For a non-uniform interval, DX = 0.
LENX Length (number of characters) of X2. Not more than 132 characters long.
XNAMEs Name and unit of the sth independent variable. Not more than 132 characters long.
NV Number of primary dependent variables. Note that the NASA Ames checking programme does not accept NV=0.
NAUXV Number of auxiliary dependent variables, including NX.
NAUXC Number of auxiliary variables which are character strings.
VSCALn Scale factor (real number) for the nth primary variable. VSCALn is the number by which the recorded values of Vn must be multiplied in order to convert it in the unit of measure specified in VNAMEn (see below). If the nth primary variable is not rescaled, then VSCALn = 1.
VMISSn Missing value identifier for the nth primary variable (real number). VMISSn is a number indicating missing or erroneous values in the record of the nth primary variable. It must be larger than the maximal "good" value of Vn.
VNAMEn Name and unit of the nth primary dependent variable. VNAMEn must not be more than 132 characters long. The unit specified in VNAMEn must be the unit of VSCALn*Vn.
ASCALa Scale factor for the ath auxiliary variable, (0 < a < NAUXV-NAUXC+1).
ASCAL1 is an integer (usually 1).
For 1 < a < NAUXV-NAUXC+1, ASCALa is real.
ASCALa is the number by which the recorded values of Aa must be multiplied in order to convert it in the unit of measure specified in ANAMEa (see below). If the ath auxiliary variable is not rescaled, then ASCALa = 1.
AMISSa Missing value identifier for the ath auxiliary variable. AMISSa indicates missing or erroneous values in the record of the ath auxiliary variable.
AMISS1 is an integer and for 1 < a < NAUXV-NAUXC+1, AMISSa is a real number. In these 2 cases, AMISSa must be larger than the maximal "good" value of Aa.
For NAUXV-NAUXC < a < NAUXV+1, AMISSa is a character string. In this last case, AMISSa could in principle be any character string of length inferior or equal to LENAa. Actually, the NASA Ames checker associated to the BADC File Uploader, that has been written by the authors of the NASA Ames Format Standard, will compare the ASCII values of the initial characters of Aa and AMISSa. The file will be rejected if the ASCII value of the initial character of Aa is found to be larger than the ASCII value of the initial character of AMISSa. The user is therefore advised to use values of AMISSa starting with z in lower case (for example, zzzzzz), since z has the highest ASCII value of all alphanumeric characters.
LENAa Length (number of characters) of Aa for NAUXV-NAUXC < a < NAUXV+1.
For 0 < a < NAUXV-NAUXC+1, LENAa is not defined.
ANAMEa Name and unit (except for a = 1) of the ath auxiliary dependent variable.
ANAME1 = NUMBER OF VALUES OF THE BOUNDED INDEPENDENT VARIABLE.
ANAMEa must not be more than 132 characters long. For 1 < a < NAUXV-NAUXC+1, the unit specified in ANAMEa must be the unit of ASCALa*Aa.

VSCAL, VMISS and VNAME must be listed in the same order as the one in which the primary variables are recorded in the data section (n ranging from 1 to NV).

Similarly, ASCAL, AMISS and ANAME must be listed in the same order as the one in which the auxiliary variables are recorded in the data section.

Condensed notation

DX
LENX
[ XNAMEs ] s=1,2
NV
[ VSCALn, n=1,NV ]
[ VMISSn, n=1,NV ]
[ VNAMEn ] n=1,NV
NAUXV
NAUXC
[ ASCALa, a=1,NAUXV-NAUXC ]
[ AMISSa, a=1,NAUXV-NAUXC ]
[ LENAa, a=NAUXV-NAUXC+1,NAUXV ]
[ AMISSa ] a=NAUXV-NAUXC+1,NAUXV
[ ANAMEa ] a=1,NAUXV

Expanded notation

DX
LENX
XNAME1
XNAME2
NV
VSCAL1 ... VSCALNV
VMISS1 ... VMISSNV
VNAME1
...
VNAMENV
NAUXV
NAUXC
ASCAL1 ... ASCALNAUXV-NAUXC
AMISS1 ... AMISSNAUXV-NAUXC
LENANAUXV-NAUXC+1 ... LENANAUXV
AMISSNAUXV-NAUXC+1
...
AMISSNAUXV
ANAME1 ['NUMBER OF VALUES OF THE FIRST PRIMARY VARIABLE']
...
ANAMENAUXV

Back to FFI Summary.