Clicking the Define Button at the bottom of the General Definition Menu brings up one instance of the Source Definition Menu. This menu allows for the selection of one or more measurements from a single UDF source, each of which will be output within the ASCII dump. A new menu is produced each time the Define Button is clicked on allowing for data from multiple sources to be included within a dump. All measurements within a UDF are accessible through this menu.
When a Source Definition Menu is spawned it is made immediately visible as:
SENSORS allows secondary UDF measurements to be selected based on the single primary UDF measurement defined in the Main Panel of the Menu. The option is unaccessible until the DATA option in the Main Menu Panel is defined. There is no distinction in the treatment of a secondary and primary measurement and the term is used only to differentiate how the measurement was obtained. The SENSOR options are:
| Option | Definition |
|---|---|
| ONE | Include only the primary measurement defined in the Main Section of the Menu. |
| ALL | Include all measurements found in the UDF definition defined in the Main Section of the Menu. |
| FULL GROUP | Include all measurements found under the GROUP which includes primary measurement defined in the Main Section of the Menu. |
| FULL MATRIX | For a Matrix measurement, include all of the matrix columns. If the measurement is not a Matrix measurement and this option is selected it will revert to the ALL option. |
Secondary measurements are inferred from the PIDF using the attributes set for the primary measurement. In particular a secondary measurement will be included only if it meets both the criteria under which it was selected and if it includes either the same unit number as the primary source or a unit number which has a local_id value identical to local_id in the unit number of primary source.
Phase Data indicates if the UDF phase information associated with the defined measurement(s) should be included in the ASCII dump. If there are secondary measurements defined in the menu the phase information for those measurements can be suppressed in this option as often they will be idential to that of the primary measurement. The options are:
| Option | Definition |
|---|---|
| OMIT | Include no phase angle information |
| INCLUDE/ONE | Include phase angle information for primary measurement only. |
| INCLUDE/ALL | Include phase angle information for all measurements. |
Phase Data indicates if the UDF polar angle information associated with the defined measurement(s) should be included in the ASCII dump. If there are secondary measurements defined in the menu the phase information for those measurements can be suppressed if desired. The options are:
| Option | Definition |
|---|---|
| OMIT | Include no polar angle information |
| INCLUDE/ONE | Include polar angle information for primary measurement only. |
| INCLUDE/ALL | Include polar angle information for all measurements. |
CLOSE closes the Source Definition Menu window.
The options in the main portion of the menu define the primary data source. Attributes set for the primary source carry over to any secondary sources selected.
The SOURCE TREE option line defines the UDF or IDFS lineage of the primary source. Options must be set beginning with the PROJECT option.
PROJECT
sets the PROJECT acronym of the source.
MISSION
sets the MISSION acronym of the source.
EXPERIMENT
sets the EXPERIMENT acronym of the source.
INSTRUMENT
sets the INSTRUMENT acronym of the source.
VIRTUAL
sets the VIRTUAL INSTRUMENT acronym of the source.
DATA indicates the PIDF category of data to display in the source selection. This is not be confused with the VIDF measurement source. The main difference between the two is data classified as ancillary data in the VIDF may appear in the PIDF either under the Sensor Data and/or the Ancillary Data categories. The options displayed under DATA depend on the categories defined in the PIDF. Categories for which there are no entries are not displayed in the option list. The possible options include:
| Option | Definition |
|---|---|
| Sensor | Select data listed under the PIDF sensor definitions. This is the main data definition area containing all of the defined UDF sensor definitions and possibly some or all of the defined UDF ancillary data. This option should always be present. |
| Scan | Select data listed under the PIDF scan block definitions. This option will only appear if the UDF sensor data has an array index associated with it (vector or matrix data). |
| Ancillary | Select data listed under the PIDF ancillary definitions. Only data classified as ancillary data within the UDF will appear in these definitions. |
| Mode | Select data listed under the PIDF mode definitions. This option will only appear if the UDF definition contains mode data. |
| Quality | Select data listed under the PIDF quality definitions. This option should always be present. |
| Spin Angle | Select data listed under the PIDF spin angle definitions. This option will be present only if the PIDF has be set up to recognize that the data may have a phase angle dependence. |
| Pitch Angle | Select data listed under the PIDF pitch angle definitions. This option will be present only if the PIDF has be set up to recognize that the data may have a pitch angle dependence. |
GROUP brings up a list of the data groupings defined in the PIDF. This option is not accessible if the Data option has been selected as Mode.
SENSOR brings up a list of the measurements defined under the PIDF group selected in the Group option. This option is not available when the group option is not accessible.
MATRIX COLUMN sets the column of data in a matrix measurement is to be returned. This option is not accessible if either the group option is not accessible or if the UDF sensors do not return matrix data.
SENSOR UNITS brings up a list of the physical units defined for measurement selected in the Sensor option.
SCAN UNITS brings up a list of the physical units defined for the scan indices of the measurement selected in the Sensor option. If the measurement has no associated scan indices then this option will become inaccessible once selected.
ANCILLARY is accessible only when the Data option has been set to Ancillary. The button brings up the list of measurements defined under the PIDF ancillary category which are associated with the measurement selected under the Sensor option.
ANCILLARY UNITS is accessible only if the Ancillary Data option has been enabled. It brings up the list of the physical units defined for measurement selected in the Ancillary option.
MODES is accessible only if the Data option has been set to Mode. It brings up the list of measurements defined under the PIDF mode category.
MODE UNITS is accessible only if the Data option has been set to Mode. It brings up the list of the physical units defined for the mode selected in the Mode option.
QUALITY UNITS is accessible only if the Data option has been set to Quality. It brings up the list of the physical units defined for the quality data.
DELETE PAGE deletes the current Plot Definition and all menus associated with it.