THE UDF IDL INTERFACE

The second row of menu buttons represent the IDL processing options. These options allow the user to select how the UDF IDL interface routines process and organize the UDF data in the IDL UDF data structure. Each options corresponds to a UDF IDL Interface keyword.

When beginning a new Menu Definition the Units option should be set as desired before the READ option, which reads in the PIDF information, is invoked. This will ensure that the default measurement units are correctly set.

UNITS

The UNITS option sets the default measurement unit to use when assigning units to the UDF measurements. This option is equivalent to the UDF IDL Interface keyword BASEUNIT.

Option	Definition
MINIMUM	Use the first PIDF unit defined for all measurements.
MAXIMUM	Use the last PIDF unit defined for all measurements.

STORAGE

The STORAGE option defines how the UDF sensor data is organized in the IDL UDF data structure. Sensor data refers to measurements which are defined in the PIDF Sensor Block and have a PIDF source field set to V indicating that the measurement is defined in the VIDF as a sensor measurement. The option is equivalent to the UDF IDL keyword SFORMAT.

Option	Definition
STANDARD	Each measurement is returned as a separate field in the IDL UDF data structure. A measurement is stored under the structure field with the same name as listed in the PIDF for that measurement. If a measurement is being returned with two different units the field name containing the first defined unit will have _V1 appended to it and the field name containing the second defined unit will have _V2 appended to it.
COLLAPSE	All sensor measurements are returned in a single field in the IDL structure. The field has the name ALLSDATA. The measurements are returned in the order in which they are listed in the PIDF SENSOR block. Measurements being returned with dual units are stored sequentially (one after the other).
GROUP	Every measurement in a defined PIDF group is returned in its own field in the IDL UDF data structure. The field name is identical to the PIDF group name. Measurements in any field are laid down in the same order as they are listed in the PIDF.

FORMAT

The FORMAT option sets the floating point representation used to return the measurements listed under the PIDF SENSOR, ANCILLARY, and MODE sections. The option is equivalent to the UDF IDL keyword DFORMAT.

Option	Definition
SINGLE	Data is returned as single precision (4 byte) floating point data.
DOUBLE	Data is returned as double precision (8 byte) floating point data.

AZIMUTH

The AZIMUTH option sets the format used to return the start and stop UDF azimuth (phase) data associated with the sensor measurements. This option is equivalent to the UDF IDL keyword AZIMUTH.

Option	Definition
ONCE/READ	One set of start and stop azimuth data is returned in the IDL UDF data structure. The returned data has the same resolution as the returned sensor data. The azimuth values are constructed using the VIDF Azimuth Info Constant value associated with the first defined VIDF sensor.
ONCE/DATA	The start and stop azimuth information is returned once per sensor in the IDL UDF data structure. The start azimuth data are returned in a single structure field as are the stop azimuth data. The data is laid down in each block in the same order as the sensor measurements are defined in the PIDF SENSOR block.

ELEVATION

The ELEVATION option sets the format used to return the start and stop UDF elevation (theta) data associated with the sensor measurements. This option is equivalent to the UDF IDL keyword THETA.

Option	Definition
ONCE/READ	One start and stop elevation value is returned for each returned sensor in the IDL UDF data structure.
ONCE/DATA	The start and stop elevation values are returned for each sensor in the IDL UDF data structure at the same resolution as the sensor data. That is for array or matrix data the elevation values are returned as the full array or matrix resolution.

ARRAY INDICES

The ARRAY INDICES option sets the format used to return the UDF array index data. UDF array index data is returned in the IDL UDF data structure only when the UDF sensor measurements return either array or matrix data. This option is equivalent to the UDF IDL keyword INDICES.

Option	Definition
ONCE/READ	One set of array indices is returned in the IDL UDF data structure. The returned data has the same resolution as the returned sensor data. The array indices are those associated with the first defined VIDF sensor.
ONCE/DATA	The array index information is returned once per sensor in the IDL UDF data structure. The information is returned in a single structure field. It is laid down in the block in the same order as the sensor measurements are defined in the PIDF SENSOR block.