Clicking the Define Button at the bottom of the Plot 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 plot definition. A new menu is produced each time the Define Button is clicked, allowing for data from multiple sources to be included within a plot. All measurements within a UDF are accessible through this menu.
If the selected data are being displayed in a line plot, there are a number of options defining how the data should be displayed. This includes the line color, the line style, etc. All of the line plot options are found in the Top Section of the 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.
AXIS sets the axis against which the all selected data, both primary and secondary, will be plotted. The option is inaccessible unless the defined plot is a line plot (scalar/time plots and spectral plots). All other plot formats have their data plotted against the left Y-axis.
AXIS has 4 options of which only the first two have meaning under the current implementation of the UDF Plot Program. The latter two are intended for the X-Y (scalar-scalar) plot which is not implemented at this time. The options are:
| Option | Definition |
|---|---|
| LEFT | Plot all the defined sources against the Left Y-Axis. |
| RIGHT | Plot all the defined sources against the Right Y-Axis. |
| BOTTOM | Plot all the defined sources against the Bottom X-Axis. |
| TOP | Plot all the defined sources against the Top X-Axis. |
OUTPUT AS sets the display format to use when displaying a line plot. The option is inaccessible for other plot formats. Both the primary and secondary sources defined in the menu will have the same display attribute. The options are:
| Option | Definition |
|---|---|
| HISTOGRAM PLOT | Lines parallel to X-axis are drawn through the data points stretching half the distance to the adjacent data points. Perpendicular lines connect the parallel lines. |
| LINE PLOT | Lines are drawn point to point. |
| SCATTER PLOT | Symbol is plotted for each data point. |
| BAR GRAPH | Filled in HISTOGRAM PLOT |
| LABELED LINE. | Combination LINE PLOT and SCATTER PLOT. |
| SPECTROSCALAR | Scalar values are plotted in a band parallel to the X-Axis with color used to indicate intensity. |
COLOR sets the color used to display the data of the primary measurement. There are 8 possible colors to chose from. The option is only accessible if the plot format is a line plot.
The colors used to plot secondary measurements are selected by rotating through the color selections beginning with the color after the one selected for the primary source. The color Black is excluded from the rotation. If there are more than 7 total sources the colors will duplicate themselves in which case other steps must be taken to separate the sources, such as restricting the number of sources to be no more than 7 per plot.
The SPECTROSCALAR option in Output As does not use the COLOR option.
SYMBOL defines the character(s) used when a Scatter or Labeled Line Plot is selected as the output format and is inaccessible otherwise. Any alpha/numeric character(s) can be used as the Plot Symbol. Multiple characters are allowed as long as there are no spaces. The color of the output symbol is taken from the COLOR option.
In addition to the alpha/numeric symbols there are a number of non-alpha/numeric symbols which can be selected. These are given in the table below. Note: the apostrophe ' must be included in the symbol name.
| Symbol | Definition |
|---|---|
| 'FSTAR' | Filled Star |
| 'FBOX' | Filled Box |
| 'FUTRI' | Filled Inverted Triangle |
| 'FDTRI' | Filled Triangle |
| 'BLOT' | Filled Circle |
| 'STAR' | Unfilled Circle |
| 'DIA' | Unfilled Diamond |
| 'CIRCLE' | Unfilled Circle |
| 'BOX' | Unfilled Box |
| 'DTRI' | Unfilled Triangle |
When there are secondary measurements being plotted the symbols for these measurements are set by rotating through the non-alpha/numeric symbols. If the symbol used to represent the primary data was selected from this list then the symbols representing the secondary data begin with the next symbol, otherwise the rotation begins with the Filled Box. The combined rotation in both the scatter symbol and color allow for a significant number of sources to be defined before the color/symbol pattern repeats.
SYM SIZE sets the size of the symbols output in a Scatter or Labeled Line Plot and is inaccessible if one of these output formats has not been selected. Valid sizes run from 3 to 32767 with character size increasing with value. As a general rule of thumb 10 is a good selection. At a label size of 1000 a single character will completely fill the plot page.
ERROR BARS allows for error bars to be output with the plotted data. Error Bars can be output in any line plot format plot (scalar/time plots and spectra plots). The errors are computed as mean standard deviations. The error bar display options include:
| Option | Definition |
|---|---|
| X | Show deviation in X only. |
| Y | Show deviation in Y only. |
| XY (LINES) | Show deviations in X and Y as a cross-hair. |
| XY (BOX) | Show deviations in X and Y as a box surrounding centered on the data. |
ECOLOR specifies the color used to display the error bars. There are 8 possible colors to chose from.
Thaw allows a the user the option to freeze the buttons or not to. What this means is when the button is set on thaw, any button that is changed then the succeeding buttons are then blank. If the button is on freeze then the succeeding buttons would not be affected. For example, if thaw was on then when Mission was changed all the succeeding buttons would be changed to be blank. If freeze was on then when Mission was changed none of the succeeding buttons would be changed. NOTE: Freeze only works if all the succeeding buttons following the changed button are options for the new button. The two options under Thaw are:
| Option | Definition |
|---|---|
| FREEZE | This option will freeze all buttons in place so they won't change when a previous button is changed. |
| THAW | This option will allow the buttons to be changed whenever a previous button is changed. |
RESYNC allows a manual resync of the menu with the current plot type. This is needed when the plot type is altered after the measurements have been selected. This will turn on the line plot options if the plot type has been changed to one of the line plot formats, and will reset the axis scaling according to values found in the PIDF.
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 been 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 either the Data option has been set to Ancillary or when the Function Of option in the plot definition menu indicates that one of the axes is a function of Anc Scan. 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 quality flags of the indicated sensor data.
Data Range is used to specify the minimum and maximum allowable data range for the data that is recieved.
Scan Collapse is used to reduced the amount of data recieved from the Data Range.
# OF BINS is accessible only if the defined measurement is being collapsed in dimension. It represents a number of subdivisions within the interval defined by BEGIN and END. A collapse is performed within each of the defined subdivisions resulting in # OF BINS scalar products each of which is passed to the Plot Definition as a distinct value. The construction of the subdivisions is defined through the next two Collapse options.
LIMITS ARE is accessible only if the defined measurement is being collapsed in dimension and if the # OF BINS option has been set to a value larger than 1. The option sets how to interpret the BEGIN and END specifications when setting up the subdivisions with the collapse interval. The options are:
| Option | Definition |
|---|---|
| CENTERS | The BEGIN and END values are the the center value of the first and last collapse subregion. |
| ENDS | The BEGIN and END values are the leading edge of the first collapse subregion and trailing edge of the last collapse subregion respectively. |
SCALING is accessible only if the defined measurement is being collapsed in dimension and if the # OF BINS option has been set to a value larger than 1. The option specifies the algorithm to use in computing the centers and edges of the collapse subregions. The options are:
| Option | Definition |
|---|---|
| LINEAR | The centers of the collapse subregions are linearly spaced between the centers of the first and last subregion. |
| LOG | The centers of the collapse subregions are logarithmically spaced between the centers of the first and last subregion. |
DELETE PAGE deletes the current Plot Definition and all menus associated with it.
The primary effects associated with this menu are associated with the options associated with line plots.
With the plot format set for a spectra plot and only selecting the source, in this case one column of data from an FUV WIC image:
produces
Expanding the X axis and adding Error Bars
produces
Scatter Plot, Symbol, Sym Size
Plotting the data as a Scatter Plot, using the default Symbol, and a Symbol Size of 15
produces
Plotting the data as a SpectroScalar is useful for displaying many traces in a single plot panel. It is especially useful in displaying status flags.
produces
| &larr Previous | TOC | HOME | Next &rarr | |
| Plot Label Menu | Vector Source Menu |