CDAW-9.2 User's Guide (11/27/89) V2.0
[This is part 2 of 3, converted from the original mixed text-and-graphics
format to this plain ASCII text, January 20, 1994.]
[Page numbers have been inserted here to closely match those in the original,
so that the original Table of Contents remains useful. The intervals between
page numbers are non-uniform due to the absence of graphics in this plain ASCII
version.]
--------
Page i
WORKING TABLE OF CONTENTS / PART #2:
III. NOW THAT YOU'VE STARTED: A CONTINUATION OF THE GRAPHICS
TUTORIALS 28
III.A. Completing the Graphics Goals of the Preceding Section 28
III.B. Creating Paper or Transparency Copies of Plots 30
III.C. Saving Things: Save/Restore Options, VMS
Subdirectories and the CDAW Purge/Delete Options: 32
III.C.1. CDAW Purge/Delete Options 32
III.C.2. VMS Subdirectories 33
III.C.3. CDAW Save and Restore Options 34
III.D. An Introduction to "Filters" 35
III.E. "Dimensional Data Sets" and the CDAW Graphics System 41
III.F. Selection of "User Specified" Data Sets 49
--------
Page ii
WORKING LIST OF FIGURES / PART #2:
Figure III.1. ISEE-1 and IMP-8 Magnetic Fields 29
Figure III.2. TAE "Tutor" for Post-Processor File Name Specification 30
Figure III.3. IMP-8 B-Field Components and Variances 37
Figure III.4. Specification Page with Global Filter Select 38
Figure III.5. IMP-8 B-Field Component Values with BZ Variance <0.1 nT2 39
Figure III.6. IMP-8 B-Field Components with VARZ <0.1 nT2 and BY GSE
Plotted Only Where BX GSE >3 nT 40
Figure III.7. Variable Selection Pop-up for 2-Dimensional CDF 44
Figure III.8. SIMPLIFIED Filter Interface for 2-Dimensional CDF:
Automatic Prompt for Filter Definition on 1st Dimension 44
Figure III.9. How Filters Set by the SIMPLIFIED Interface Look 45
Figure III.10. CCE Hot Plasma: Flux at 3 Energies and 10 degree Pitch
Angle 46
Figure III.11. Event 9A CCE Hot Plasma Fluxes (all Energies / Pitch
Angles) 46
Figure III.12. Discrete Variable Value Select "Pop-up" 47
Figure III.13. CCE Hot Plasma Energy Spectra at 5 Pitch Angles 49
Figure III.14. Directory Path Specification Form on "Uselect" 50
--------
Page 28
III. NOW THAT YOU'VE STARTED: A CONTINUATION OF THE GRAPHICS TUTORIALS
Upon re-entering the (XY/Panel Graphics) Summary screens, whether directly
(instruction 11.43a) or by exiting NACS and later restarting via "$ cdaw"
(instructions 11.43b) to get back to the Summary screen, the specifications
you entered previously should be restored.
As before, on entering the Summary screens, the default plot type is Panel.
To see your previous XY specifications, use the left-arrow to reset to XY.
If you then press PF2, you will see all your previously selected variables and
limits displayed, ready for further editing.
Recall that the graphics goals we defined in Section II were the following
plots of three components of magnetic field, for a time within event 9B:
o For ISEE-1, overlaid on a single grid (XY plot; i.e. Figure II.5)
o For ISEE-1, plotted on 3 separate grids (Panel plot; i.e. Figure II.6)
o For ISEE-1 and IMP-8 together on a Panel plot (Figure III.1).
Having accomplished the initial display, we will now continue the example to
complete these goals, then to demonstrate a few other selected capabilities
of the CDAW graphics system and to generate hardcopies of these plots.
III.A Completing the Graphics Goals of the Preceding Section.
III.1) Use PF3, the up-down arrow keys and [CR] to set the plot type to Panel.
If the plot file name is not changed (you should still see the specification
"demo_plot"), any new plots of which "snapshots" are made will be appended to
the previously defined file.
III.2) Use PF2 to switch to the specification page. Use [CR], cntl-H, and
up-down arrows to position to fields. Use PF3 to bring up pop-up selection
menus, up-down arrows and the keys u-d to move the selection highlight and [CR]
to make variable selections. Use left- right arrows to position within
(typeover) character fields (minimum and maximum ranges).
--------
Page 29
III.3) Once the variables have been defined, use PF1 and [CR] to draw the
Panel plot. Use "s" (no [CR]) to save a copy of the plot and "q", [CR] to
return to the TAE "Select" menu. Enter "12", [CR] to return to the Summary
screen.
III.6) Leave the specifications as PANEL and use PF2 to go to the
specifications page. Using the same techniques as before, load BX, BY and BZ
GSE for IMP-8 (variables IJ01BSEX, IJ01BSEY and IJ01BSEZ) into Y#4, Y#5 and
Y#6. You may wish to set those minima / maxima to the range -10.0 to +10.0
(nT). Then use PF1 to plot (output should be Figure III.1), "s" to"snapshot"
and "q", [CR] to go to the graphics "Select" TAE menu.
Figure III.1. ISEE-1 and IMP-8 Magnetic Fields
[The plot for Figure III.1 is omitted from this plain ASCII file.]
--------
Page 30
At this point, we've accomplished our initial graphics goals. Additionally, it
can be seen that changing plot styles (Scatter to Vector to other styles) and
scaling mode (use of Automatic mode in Panel plots) as well as switching LINear
and LOGarithmic scalings for individual Y curves is a trivial extension of the
techniques just discussed.
III.B Creating Paper or Transparency Copies of Plots
It was noted earlier that the TAE "menus" form something of a "tree" structure.
In the introductory section, it was also noted in the first diagram that
access to the "post-processor" for making paper copies of plots (or replaying
previously made plots on terminals) is chosen at a level that precedes the
specification of data sets in the DMS screen.
Within certain sensible limits, however, TAE does allow a user to jump about
the "tree". We can thus return to the highest level of the system and then
invoke the post-processor without destroying the plotting environment we have
just created.
If you start from the 'Select" menu:
III.7a) Enter "top" and [CR].
If you are starting from the VMS "$" prompt:
III.7b) Enter "cdaw", [CR] etc. to get to the initial (or "root") TAE menu,
which branches between Data Manipulation and Graphics.
III.8) Enter "3" (Graphics) and [CR], then "2" (Post-Processor) and [CR].
Figure III.2. TAE "Tutor" for Post-
Processor File Name Specification
____________________________________________________
Tutor: proc "PLTSELEC", library "ngs$menu" Pg 1.
GRAPHICS Post Processor
parm description value
---- ----------- -----
INFILE Name of input plot file " "
Enter: parm=value,HELP,PAGE,SELECT,SHOW,RUN,EXIT,SAVE,RESTORE; RETURN to page.
?
____________________________________________________
At this point, you have been put into a TAE "tutor" screen like Figure III.2.
III.9a) Use the up-arrow to bring up a prompt for the plot file name onto the
TAE "prompt" line at the bottom of the screen. Use the backspace- delete or
rubout key to remove the right quote, then enter the name of the plot file you
defined before quoted as "demo_plot", then [CR] and go on to step III.10.
Please note that the .plt extension on the plot file name is not needed and
should NOT be entered!
But suppose you forget the plot file name you used, but you're pretty sure
you'd recognize it if you saw it again. While TAE command logic will be
discussed more in section IV (and hence the following is presented as a
"cookbook" example only for now), then do the following:
III.9b1) Enter "exit" and [CR] to return to the post-processor selection menu.
III.9b2) Enter "c" (for "command" at the ? TAE menu prompt and [CR].
You will now see a prompt line "NACS>". To that prompt enter "dcl dir *.plt"
to see a directory listing of all the plot files in your current VMS directory.
Once you've noted the correct name:
III.9b3) Enter "m", [CR] at the " NACS>" prompt, then "2", [CR] to get back to
where you can execute instruction III.9a.
III.10) Enter "run" and [CR] to link to this plot file.
The next menu prompts you to select a display device from among various
hardcopy devices available currently at NSSDC or your current terminal (to
replay the plots made).
HARDCOPY DEVICE DESCRIPTION
HP7580 Good quality, color plotter, slow
VERSETEC 80 NO LONGER AVAILABLE AT NSSDC
3M RECORDER NOT CURRENTLY OPERATIONAL
TEKTRONIX 4692 Color plotter, good quality, slow
(only device recommended for images)
TALARIS 2400 Fast, high quality B&W laser printer
(requires free disk space twice plot file size)
As an illustration, we will suppose you have targeted the Talaris Laser Printer
for its speed and resolution, surrendering the modest amount of color in the
plots in trade for quick reproduction (because the Talaris is black-and-white
only). The procedures to use the Tektronix 4692 and other devices are very
similar however. It is generally not necessary to alter the detailed device
options.
--------
Page 31
III.11) Enter "7" and [CR].
III.12) Enter "3" and [CR] to start a VMS batch job to make the hardcopy plots.
You will receive a system message when the job completes, but you are free to
proceed with other analyses while the job is running or waiting to run.
The Talaris printer is located on the main floor in Building 26, in the Xerox
room 142. During the 9.2 workshop, NSSDC staff will FAX Talaris and other
outputs to the CDAW-9 participants IF REQUESTED.
III.13) To return to the "Select" menu, enter "m select" and [CR].
III.C. Saving Things: Save/Restore Options, VMS Subdirectories and the CDAW
Purge/Delete Options:
To allow you (as a new user) to first get a general feeling for the
capabilities of the graphics data selection and Summary screens, we've used a
couple of shortcuts (which we've not described functionally yet) to minimize
the need for you to re-specify a plot environment at each step of this
tutorial. But, in fact, how to save and restore a plotting environment, as
well as how to keep one's disk space usage in reasonable bounds, are facts of
life in a computer system.
III.C.1 CDAW Purge/Delete Options
The graphics environment (data sets selected, plot options specified at a given
point in time) is stored in disk files in the VMS directory assigned to your
account, and from which you are presently running the CDAW/NACS system. This
is one benefit of using TAE as the architectural backbone of the system. So
long as you do not delete those files, you can enter and exit the system with
some flexibility while still preserving the graphics environment you have
defined.
--------
Page 32
That's one reason why we have used the "purge working files and exit to $
prompt" option to exit the system, because "purging" in VMS terminology only
removes old versions of any given type of file rather than completely deleting
them. When we re-enter, the overall graphics system is structured such that "m
select" can jump back in fact to the previous working graphics environment.
The "purge" options in the initializing TAE menu act in the same way.
If you instead re-selected the data sets, at the point of "loading" (or linking
to) the selected data sets, all old working files will be deleted and the
associated plot options lost.
The options that say "Delete working files ..." also completely delete the
working environment. This saves disk space, of course, so it is the
appropriate way to exit the system when you're really finished with a given set
of plots. But you should choose "purge" if you intend to come back again.
III.C.2 VMS Subdirectories
The VMS Operating system allows the creation of a hierarchy of subdirectories
within a given user directory, subject of course to overall quotas on the total
disk space used by the directory as a whole. Files are by default created and
deleted in whatever subdirectory is currently being used unless an explicit VMS
directory path for a file is specified.
While it is certainly possible to construct a subdirectory structure so complex
as to be more hindrance than help, a judicious use of subdirectories can
simplify life and can sometimes greatly increase the utility and effective
performance of the CDAW/NACS system.
For a user with an account "USERNAME" to create a subdirectory which we will
call "CDAW_1" (either upper or lower case letters may be used at any time - the
system does not distinguish upper from lower case in directory and file names),
the user enters the command:
$ create/directory [USERNAME.CDAW_1]
To change to that subdirectory , use:
$ set directory [USERNAME.CDAW_1]
or
$ sd .CDAW_1
(an abbreviation defined on the NSSDC VAX systems)
To return to the main directory, use:
--------
Page 33
$ set directory [USERNAME]
or
$ sd . (also an NSSDC abbreviation)
So as you start to do real analysis, you might find it convenient to create one
or more working subdirectories. Then, if you leave the CDAW system via "purge"
while in any subdirectory, the environment will remain and can be simply
re-entered via "m select" when you restart. You can thus easily maintain
multiple working environments by using multiple subdirectories.
We would also note that your MAIL files (*.mai) can also easily be stored in a
subdirectory, thus keeping your main directory relatively clean in appearance.
See online help for mail and its subcommands for more details in how to set up
a mail subdirectory.
To remove subdirectories, you must first delete all files within them. You
should then "set directory" back to the next level, reset the "protection" on
the .dir file associated with the subdirectory in question (e.g., CDAW-1.DIR)
to allow its deletion, then delete it. See the "Beginner's Guide" and other
VMS manuals and online helps for more detail.
III.C.3 CDAW Save and Restore Options
The CDAW/NACS system itself offers a direct capability to save and restore
graphics "environments" (either a full environment, with data sets and plot
options or the XY/Panel plot options only.
Access to the "Total environment save/restore" is possible both when
preparing to specify graphics data sets (as option #4) and from the graphics
"Select" menu (as option #13). In either case, when "Total environment
save/restore" is invoked, the user will first be asked whether he wishes to
save, restore, or delete a named environment. He will then be presented with
a TAE "tutor" (used in a manner similar to that discussed for the post-
processor / graphics hardcopy options) into which to enter a "name" (an
alphanumeric string of characters appropriate to making part of a VMS file
name) under which the environment was saved or is to be restored.
--------
Page 34
The procedure to enter data is the same as discussed for invoking the
graphics post-processor, namely:
III.14) Enter up-arrow to bring the prompt to enter the environment name to the
TAE command line at the bottom of the screen. Then use rubout / delete to
remove the "", then type the name and enter [CR].
III.15) Then enter "run" and [CR] to execute the save/restore/delete. Note
that "exit" and [CR] exits the TAE tutor WITHOUT executing anything.
An "XY/Panel plot environment save/restore" is accessible only from the TAE
"Select" menu (option #14). It is invoked in an identical manner to the "total
environment save/restore" described above. When only the "plot environment" is
restored, various plot options are restored to the extent that the variables in
the new data sets match in name and properties those in the data sets at the
time the plot environment was saved. This capability is of particular use when
trying to create identically set-up plots over a series of CDAW events, for
example to make our BX/BY/BZ plots for all the events 9A through 9E.
The total environment save/restore can also be used conveniently to re- create
one user's environment for another user. Say for example we have one user at
the workshop in telephone contact with another user in e.g. Los Angeles. Both
are accessing the NSSDC computer/CDAW facilities under their own accounts, the
user in Los Angeles most likely connected to NSSDCA via SPAN. If the user at
NSSDC has set up an interesting plot he/she would like the user in Los Angeles
to see, one procedure would be:
o save the total environment that produced that plot as a named environment
(e.g., the name "netsave"),
o have the user in LA copy all files from the first user's account of the
form "netsave*.*" into his/her own account (primary directory or a working
subdirectory) on NSSDCA, and
o then invoke "cdaw", "m select", "12", and PF1 to see that same plot.
--------
Page 35
III.D. An Introduction to "Filters"
A fairly common requirement is to make a plot of variables Y versus X with
points plotted only where some other variable(s) Z satisfy certain
constraint(s). As an example in a data set such as the IMP-8 magnetometer,
where a fine-scale variance in the components of B has been computed as well as
the average components, we might want to plot only those field values from
times when the field was relatively stable.
The concept of putting constraints on data values not necessarily directly
plotted is termed "Filtering" in the CDAW/NACS software system. The software
interface is structured to make such work simple.
Two kinds of "Filters" are distinguished in the CDAW system:
o "Global Filters" Apply to all curves on a given plot
o "Per-curve Filters" Apply only to a specific curve.
A total of ten "filters" (global plus per-curve) may apply to any given
specific (Y versus X) curve on a plot.
As an example which will demonstrate the operation of filters in an immediate
way, we will go back to execute the problem just described, namely to filter
IMP-8 field component plots based on excluding times with larger variances.
III.16) From the TAE "Select" menu, we may return again directly to the
plotting environment set up earlier. Enter "12" and [CR] to return to the
XY/Panel Summary screens. For convenience, you may want to start a new plot
file; e.g. "demo_plot2" and change the plot title line to reflect this.
--------
Page 36
III.17) Set up a panel plot covering 1900-2000UT on 2nd April, 1986, with the
IMP-8 BX GSE data on the bottom panel (scale -10 to +10 nT) plotted with the
B-field variance XX (variable IJ01VARX). Set up similar plots for BY/VARY and
BZ/VARZ and display the plot (Figure III.3 - note in this example, the plot has
been made using FAST / HARDWARE characters and a Tektronix 4105 emulation).
--------
Page 37
Figure III.3: IMP-8 B-Field Components and Variances.
[The plot for Figure III.3 is omitted from this plain ASCII file.]
--------
Page 38
Note the spikes in BZ variance at approximately 10 minute intervals from 1930
to 2000UT. We will first set up a "Global" filter on IMP-8 BZ variance to plot
only X/Y/Z B-field components where BZ variance is <0.1 nT2.
III.18) Use [CR] and/or "control-H" to position the cursor on the specification
page to the "Filter?" column on the X-variable row. As a convenience, global
filters are specified as filters on the X-variable (one only) and per-curve
filters on the applicable Y-curve.
III.19) Press "y" or PF3 to display the "Filter Specification" form.
The "Filter Specification" form works very much like the primary variable
specification page; i.e., you first specify the variable(s) to be "filtered".
Then specify the filter limits and whether the filters are "Inclusive' (points
are accepted only if the filter condition is met) or "Exclusive" (points are
accepted only if the filter condition is NOT met). When the
inclusive/exclusive filter field is specified by [CR], the "filter
specification" form is automatically exited and the user is returned to the
specification page for plot variables.
Figure III.4. Specification Page with Global Filter Select.
[The plot for Figure III.4 is omitted from this plain ASCII file.]
--------
Page 39
III.20) Use PF3 to bring up the selection pop-up, the up-down arrow keys and
u-d keys to move the highlight on the variable selection pop-up to "IJ01VARZ"
and [CR] to select. The screen should now appear as in Figure III.4. Use
[CR], [CR] to move to the maximum limit field (for data set of "dimension" >0,
pop-ups may automatically appear for variables with only a finite number of
values - dimensionality will be introduced in the next section) and set that to
"0.1". Then use [CR] to move to the "Inc/Exc" field, accept the default "Inc"
and the PF1 pop-up menu to exit the filter specification form.
III.21) Reset the plotted variables to suppress direct plotting of the
variances. Then use PF2 to return to the control page and reset the plot style
to "Scatter" (to show the gaps more clearly). Then use PF1 to draw the plot
(shown below as Figure III.5). You should note the gaps where large BZ
variances take place; also note the filter label at the bottom of the plot.
Figure III.5. IMP-8 B-Field Component Values with BZ Variance <0.1 nT2.
[The plot for Figure III.5 is omitted from this plain ASCII file.]
Use "s" to make a snapshot if you wish for later hardcopy, then "q" and [CR] to
return to the "Select" menu, and "12" and [CR] to return to the Summary screen.
Then use PF2 to return to the specification page.
Note that by moving to the "Filtering" field for the X-variable and typing "y"
or PF3 again, we gain access back to the filter specification form again.
Entering "n" nulls the filter, and successive [CR]'s will exit the form.
However, for illustration here, we will not change the X (or global) filter on
IMP-8 VARZ but will leave it intact.
We'll next specify an additional "per-curve" filter on IMP-8 BY to plot only
those points where IMP-8 BX is >3.0 nT. [N.B: this is an example only.]
III.22) Use [CR]'s to position to the "Filter?" column for the Y-curves. Use
the down-arrow key to position to the "N" for Y#2 (IMP-8 BY GSE).
--------
Page 40
III.23) Enter "y" or PF3 to display the per-curve filter specification form for
this variable. Use arrow, u-d keys to highlight the IMP-8 BX variable
(IJ01BSEX), PF3 to select, and [CR] to move to the minimum field. Then type
"3.0" and 3 [CR]'s to return to the Specification page.
III.24) Now type PF1 to display the plot.
Figure III.6. IMP-8 B-Field Components with VARZ <0.1 nT2 and BY GSE Plotted
Only Where BX GSE >3 nT.
[The plot for Figure III.6 is omitted from this plain ASCII file.]
Note the labels that appears at the bottom of the plot to identify the global
filter on all curves by BZ variability and the per-curve filter on curve #2
(the middle panel) to show that IMP-8 BY plotted has been additionally filtered
by a condition on the value of BX.
III.25) Use "s", "q",. and [CR] to return to the TAE"Select" menu.
Although we will not discuss the issue at length here, note that had we tried
to "filter" e.g. a plot of ISEE-1 B-field components by the IMP-8 variance with
the CDFs we have loaded here, it would NOT have worked. The essential problem
is that the data are not on a common time basis,(4 seconds for ISEE- 1 versus
15+ seconds for IMP-8) and hence the software will not recognize the relation
among the actual data points.
The solution to this problem is to "stratify" one or the other of the data
sets. Stratification (as the term is used in CDAW/NACS) means to
interpolate/extrapolate data from one data set to match precisely the times of
another data set. Stratification is a function accessible in the data
manipulation section of the system and will be discussed further as part of the
general data manipulation discussion in Section IV.
--------
Page 41
III.E. "Dimensional Data Sets" and the CDAW Graphics System
Since almost all of the CDAW-9 data sets are organized in time sequence, the
following discussion is phrased in those terms. The concepts and capabilities
of the underlying software are more general however.
In simple cases such as the ISEE-1 or IMP-8 magnetometer data, all variables
are dependent on time and independent of all other variables. In the
terminology of the CDAW system, these events are referred to as being of
dimensionality zero ("0"). But this need not necessarily be the case.
Consider for example the AMPTE/CCE Hot Plasma Composition data (CC01). In this
data set, energetic particle fluxes are included that are both averaged in
various ways and also individually dependent on:
o Energy and
o Pitch Angle, as well as
o Time.
Because there are two separate (or independent) variables in addition to time
on which other variables (such as flux) may depend, the data set is said to be
of "Dimension 2". We have encoded a display of the dimensional dependence of
the individual variables in the CDAW system as a string of T/F flags between
the variable mnemonic and variable name. The first column indicates dependence
on time (the data set records have been organized by time), the other two
columns show respectively dependence on the dimensions associated with energy
and pitch angle.
For example, proton flux depends on time and both dimensions as noted above,
whereas the averaged background counts depend only on time. Because the
energy and angular bins are fixed, they are not dependent on time and are
termed discrete variables.
If a user were to plot flux versus time without selecting a specific energy
band and pitch angle, multiple points would then be plotted at each time. While
this may sometimes be a desired mode of plotting (to assess range of
variability for example), "filters "on energy and pitch angle are much more
commonly logically appropriate and necessary. The SIMPLIFIED Filters Interface
option is designed to automatically prompt for the appropriate user entries in
the common case. The NORMAL Filters Interface allows greater flexibility to
deal with "uncommon" cases (e.g., a plot at fixed energy but displaying all
flux points regardless of pitch angle to display the range of directional
variation in the flux, which would tend to highlight periods of both low and
high anisotropies).
--------
Page 42
The common format for data that underlies the CDAW graphics system (the Common
Data Format or CDF) has evolved from work in the climate and atmospheric
sciences where complex, dimensional data sets are frequently encountered. As a
consequence, the format and the graphics system feature the ability for users
to look at such data (data sets of dimension >0) in a logical way, while the
system stores and accesses the data internally to optimize performance and
minimize required storage space.
To demonstrate the above, suppose we define our goals for this exercise
(working now on Event 9A) to be:
o to plot flux as a function of time at several fixed energy bands and a
specific look angle (using the SIMPLIFIED Filter Interface),
o to plot differential flux without filters (show range of variation),
o to replot flux as a function of time at several fixed energy bands and a
specific look angle (using the "NORMAL" Filter Interface),
o to plot a series of spectra (flux versus energy) at different look
angles at a fixed time.
To set up for these plots, remember that we can choose first to create a new
subdirectory for these plots (call it [USERNAME.CC01] and set the default
directory to that subdirectory using the procedures outlined above.
III.26) At the "$" prompt, enter "cdaw", [CR] etc. and proceed until
reaching the DMS summary screen for the CDAW-9 database.
III.27) Select the CC01 Event 9A data and use PF1 to load / link to this data
set.
III.28) At the TAE "Select" menu, enter "12", [CR] and set up the control page
to do "Panel" plots, "vector" plot style, "manual " scaling, and enter your
user name, a plot file title, an appropriate plot title of your own choosing,
an appropriate choice of font to your terminal / network connection.
FOR THE FIRST PART OF THIS DEMONSTRATION, PLEASE SET THE "FILTERS INTERFACE" TO
SIMPLIFIED. Now press PF2 to go to the specification page.
--------
Page 43
III.29) We will plot the entire event and so will accept the default X-variable
definition of "TIME" and the minimum / maximum plot limits. We'll also accept
the default X-axis LINear scaling. Because we're going to start by using the
SIMPLIFIED Filter Interface, you should NOT be initially concerned with setting
global or per-curve filters.
III.30) Now position to the field defining the curve Y#1 variable and enter PF3
to bring up the pop-up selection menu (Figure III.7). Note that three columns
of T/F values are displayed, the first column indicating the dependence of a
variable on TIME (e.g., TIME has TFF), the second dependence on energy (e.g.,
CC01ENRG has the pattern FTF, because the energies are not time-dependent) and
third dependence on pitch angle (e.g., CC01PANG has the pattern FFT). However
CC01FLUX is dependent on all three variables (pattern TTT).
III.31) On highlighting and selecting ([CR]) CC01PANG as the Y#1 variable,
another pop-up menu automatically appears prompting selection of one of the
defined energy bands (Figure III.8). When that has been selected (the example
is 0.067 MeV) via [CR], yet a 3rd pop-up prompts for specification of a pitch
angle band (the example is a pitch angle of 10 degrees). It is NOT possible
under the SIMPLIFIED filters interface to specify a range of values for
filtering, unless the Filters? are edited after responding to the automatic
prompts. Hence any XY/Panel plot made under the SIMPLIFIED option will usually
have all curves automatically single-valued.
--------
Page 44
Figure III.7. Variable Selection Pop-up for 2-Dimensional CDF
[The plot for Figure III.7 is omitted from this plain ASCII file.]
Figure III.8. SIMPLIFIED Filter Interface for 2-Dimensional CDF:
Automatic Prompt for Filter Definition on 1st Dimension.
[The plot for Figure III.8 is omitted from this plain ASCII file.]
On specifying the CC01PANG filter, the user is returned to the Specification
page to edit the minimum / maximum plot range values. For this demonstration,
we suggest a range 1.0E+05 to 1.0E+09 be set.
As an exercise, now position to the Filters? column and enter PF3 or Y, [CR].
You will then see the display of Figure III.9, showing that the prompts
previously entered have created single-value per-curve filters on both energy
and pitch angle. Although these could be altered now, instead simply exit back
to the specification page via the PF1 menu.
--------
Page 45
Figure III.9. How Filters Set by the SIMPLIFIED Interface Look.
[The plot for Figure III.13 is omitted from this plain ASCII file.]
III.32) Similarly define Y#3 and Y#5 CC01FLUX values (the example is
0.77 and 20.1 MeV, both at 10 degrees pitch angle) and set all plotted
scales to be LOGarithmic. Then execute the plot via the PF1 draw /
save pop-up menu. The result is shown in Figure III.10 below.
--------
Page 46
Figure III.10. CCE Hot Plasma: Flux at 3 Energies and 10 degree Pitch Angle
[The plot for Figure III.10 is omitted from this plain ASCII file.]
Figure III.11. Event 9A CCE Hot Plasma Fluxes (all Energies / Pitch Angles)
[The plot for Figure III.11 is omitted from this plain ASCII file.]
III.33) The next demonstration will be to plot an totally unfiltered case. For
that, reset to XY plots and NORMAL Filter Interface on the 1st (control) page
and select (via PF3 and [CR]) CC01FLUX as the curve Y#1 variable. Note that no
automatic prompts to set filters now takes place. Then execute the plot via
the PF1 menu, with the result as shown in Figure III.11 (fast/hardware
characters). You may want to use "s" to make a copy, then "q" etc. to return to
the Specification Page.
--------
Page 47
III.34) As an exercise, we will now redo Figure III.10. Reset the plot type to
Panel and return to the specification (2nd) summary page. Move to the
"Filter?" field for the X-axis (here TIME) and type Y or PF3 to display the
"Filter Specification" form.
III.35) Using PF3 to display the selection menu, up-down arrows and u-d keys to
position the highlight, and [CR] to select, set the variable "pitch angle" (
CC01PANG ) as a global filter, then type [CR].
At this point, because pitch angle is a "discrete" or "independent" variable
(it does not depend on TIME in this case), only certain specific values of the
pitch angle are defined and sensible against which to specify limits, another
"pop-up" appears (Figure III.12) from which to select the possible minimum
limit on the pitch angle filter values.
Figure III.12. Discrete Variable Value Select "Pop-up".
[The plot for Figure III.12 is omitted from this plain ASCII file.]
Minimum and maximum are all >= and <=, so minimum = maximum corresponds to
accepting only one specific value. As a convention in this system, maximum <
minimum will be internally reset when a plot is drawn to be maximum=minimum.
III.36) Move the highlights and use [CR] to select a minimum value of the
"global filters" on the pitch angle of 10 (degrees). Use [CR] to move to the
maximum field and set maximum=minimum as required, then the PF1 menu to exit
the Filter Specification form.
III.37) Re-select differential flux (CC01FLUX) as the variable for all of Y#1,
Y#3 and Y#5. By re-selecting these values, all the filters set on the last
Panel plot (defined using the SIMPLIFIED Filter Interface) are removed. Set
"LOG" scale for all three variables as before, then enter [CR] to move to the
"Filter?" field to set "per-curve" filters.
--------
Page 48
III.38) Enter "y" or PF3 to display the filter specification form for Y#1.
Note that the global filters are also displayed on this form but are here
informational and cannot be edited. Set CC01ENRG as the single per- curve
filter on Y#1, then [CR] to the minimum field to display the valid energy
bands. We will select the lowest value of 0.067 keV/e (use PF3). Then type
[CR] to maximum, set that also as 0.067, and PF1, [CR] to exit this per-curve
filter specification.
III.39) Set an per-curve filters on energy (for example, 0.77 keV/e on curve
Y#3 and 20.1 keV/e on Y#5) on the two additional curves. Then plot via PF1.
The result should match Figure III.10 (as we set up using the SIMPLIFIED option
earlier).
To produce energy spectra:
III.40) Type "q" etc. and return to the specification page. Since spectra are
most nicely made on the XY format, change to XY.
Switch to the specification page, change the X-variable to be "Center Energy"
and [CR]. Change the scaling to be "LOG", and substitute for the global filter
on "pitch angle" a global filter on "Time" to restrict to data at 0900 - 0910
UT.
III.41) Now set Y#1 through Y#5 to be the variable CC01FLUX. We will accept
the default flux scalings for now, so min/max can be left unchanged. Scaling
should be changed to "LOG". Then set per-curve filters on each of Y#1 through
Y#5 to cover the range of pitch angles between 0 and 90 degrees in 5 equal
steps; i.e., steps at 10, 30, 50, 70 and 90 degrees. Finally draw the plot.
Figure III.13. CCE Hot Plasma Energy Spectra at 5 Pitch Angles
[The plot for Figure III.13 is omitted from this plain ASCII file.]
--------
Page 49
The techniques used above can be easily extended to handle any data sets with
greater than zero dimension. Also see some of the topics under the image data
discussion (section V, in that imaging data in a sense is really just another
kind of dimensional data.
III.F. Selection of "User Specified" Data Sets
Where data sets may not be specifically located in the primary CDAW-9
directories, such that the data must be accessed by VMS file name, the
"Uselect" option of the DMS screen should be used.
On choosing "Uselect", a pop-up appears in which a VMS directory path may be
specified (as shown in Figure III.14).
--------
Page 50
Figure III.14. Directory Path Specification Form on "Uselect".
[The plot for Figure III.14 is omitted from this plain ASCII file.]
Upon entering [CR], a list of available CDFs on that path appears as a Option
Select pop-up. One of these CDFs may be chosen by [CR], the user may enter PF1
once to modify the directory path (working in typeover mode) or the user may
enter PF1 twice to abort user select mode.
Note that the mnemonics "EVENT9A" through "EVENT9E" have been defined in the
NSSDC VMS system to hold the primary directory paths to the CDFs for these
events.
END SECTION II OF DRAFT
(START SECTION III WITH PAGE 51)
____________________________________________________________________________
Curator: H. Kent Hills (hills@nssdca.gsfc.nasa.gov)
Author and NASA Official: Robert E. McGuire (mcguire@nssdca.gsfc.nasa.gov)
Head, Space Physics Data Facility (Code 632), NASA/GSFC, Greenbelt, MD 20771
Last Revised: 22 Nov 1996 [HKH]
____________________________________________________________________________