Source Definition Menu

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 on 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: 










Top Section Menu Options






Sensors


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


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


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


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 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


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


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


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


ECOLOR specifies the color used to display the error bars.
There are 8 possible colors to chose from.



ReSync


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


CLOSE closes the Source Definition Menu window.




Main Section Menu Options

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.  





Source Tree


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


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


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


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


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


SENSOR UNITS brings up a list of the physical units defined for
measurement selected in the Sensor option.



Scan Units


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


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


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


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


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


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.



Valid Data Range


The VALID DATA RANGE options set the minimum and maximum values 
between which the acquired data will be processed.   First entry box is
the minimum valid value and the second is the maximum valid 
value.  The range is specified in terms of the physical units selected 
for the measurement.  All data outside of this range is ignored.



Scan Collapse


The SCAN COLLAPSE set of options defines how to eliminate either
the  Scan or Row portion of a UDF measurement.  The 
options are accessible only when a plot format is defined requiring 
reduction in dimension.  The menu will turn off the SCAN COLLAPSE 
options in cases were it knows that no collapse is needed and will turn 
on the options in cases where it thinks that a collapse may be required.  
In most cases the a collapse is needed when indicated.  If not the collapse 
can be manually defeated in the METHOD option.  Note:  If 
the software decides that a collapse is needed and it has been defeated, 
it will do the collapse using the AVERAGE Method.  All other 
information needed in performing the average will be taken from the SCAN 
COLLAPSE options.






METHOD establishes how to collapse
in scan or row.  The options are:









 Option Definition

 NONE 
     Turn off collapse.  If a plot format needs to collapse 
                      the data it will turn it back on internally setting it 
                      to AVERAGE. 

 AVERAGE 
     Perform a straight average over the data included in 
                      the range in scan indicated in the following options 
                      on the line.

 INTEGRATE
     Perform a box integration over the data included in the 
                      range in scan indicated in the following options on the 
                      line.






The collapse works in the following manner.  Each data point is assumed
valid over a range in scan which extends from the midpoint between it 
and the previous value to the midpoint between it and the next value.  
Starting and ending points in the scan are extended by half the distance
between it and the following or preceding point respectively.  


In the collapse, each data value is multiplied by the percentage if its 
total range which is within the collapse range.  When averaging the data
are then summed and then normalized and when integrating the data is
multiplied by the area over which it is valid.




BEGIN is accessible only if the defined 
measurement is being collapsed in dimension.  It is the value at which to 
begin the collapse and is given in terms of the selected
Scan Units.






END is accessible only if the 
defined measurement is being collapsed in dimension.  It is the value 
at which to end the collapse and is given in terms of the selected
Scan Units.






# 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.









Bottom Section Menu Options






DELETE PAGE


DELETE PAGE deletes the current Plot Definition and all 
menus associated with it.





Option Effects

The primary effects associated with this menu are associated with
the options associated with line plots.  



Default Menu Options

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










Error Bars

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










SpectroScalar Plot

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