9-8
Understanding the CITIfile Data Format
CITIfile Keywords
CITIfile Keywords
Keyword Explanation and Examples
CITIFILE CITIFILE A.01.01 identifies the file as a CITIfile, and
indicates the revision level of the file. The CITIfile
keyword and revision code must precede any other
keywords. The CITIfile keyword at the beginning of the
package assures the device reading the file that the data
that follows is in the CITIfile format. The revision number
allows for future extensions of the CITIfile standard. The
revision code shown here following the CITIfile keyword
indicates that the machine writing this file is using the
A.01.01 version of CITIfile as defined here. Any future
extensions of CITIfile will increment the revision code.
NAME NAME CAL_SET allows the current CITIfile “package” to
be named. The name of the package should be a single
word with no embedded spaces. A list of standard package
names follows:
Label Definition.
RAW_DATA Uncorrected data.
DATA Data that has been error corrected.When only a single
data array exists, it should be named DATA.
FORMATTED Corrected and formatted data.
MEMORY Data trace stored for comparison purposes.
CAL_SET Coefficients used for error correction.
CAL_KIT Description of the standards used.
DELAY_TABLE Delay coefficients for calibration.
VAR VAR FREQ MAG 201 defines the name of the independent
variable (FREQ), the format of values in a
VAR_LIST_BEGIN table (MAG, if used), and the number
of data points (201).Typical names for the independent
variable are FREQ (in Hz), TIME (in seconds), and
POWER (in dBm). For the VAR_LIST_BEGIN table, only
the “MAG” format is supported at this point. # #NA
POWER1 1.0E1 allows variables specific to a particular
type of device to be defined. The pound sign (#) tells the
device reading the file that the following variable is for a
particular device. The “NA” shown here indicates that the
information is for a Network Analyzer. This convention
allows new devices to be defined without fear of conflict
with keywords for previously defined devices. The device
identifier (i.e. NA) may be any number of characters.