Isis Home
CV - Cube Visualization
The CV (Cube Visualization) program allows interactive
display of ISIS cube files. (Most other 2D or 3D image
files can also be displayed by using an ISIS detached
label or by using the "raw2isis" program to convert the
data to a standard ISIS cube file.) The interactive
capabilties include functions such as displaying selected
spatial-spatial or spatial-spectral slices through the
cube, "movie" display of different slices, displaying
backplane images as well as core plane images, reporting
cursor coordinates and associated pixel values, zoom and
roam of displayed images, plotting single spectra and
average spectra at selected spatial locations, plotting
spatial profiles, hard-copy output, etc. CV can be used
for visualization of both single-band images that
contain a large spatial extent and imaging spectrometer
data cubes that contain many wavelength bands.
READING IN A CUBE FILE
After starting up IDL, the CV program is run by simply
typing CV (without any parameters) at the IDL prompt.
A file selection panel is then displayed that allows
selection of the cube file that is to be read into memory.
Next, a parameters panel is displayed that allows
selecting the desired subarea of the cube file (using the
SFROM parameter), selecting whether display of backplanes
is desired, and also specifying the range of pixel values
that is to be mapped into the range of intensities or
colors that is available for image display on the
workstation. (This display range can be changed later
without exiting from the program or reading in the file
again.) If "Specified Range" is selected for the Range
Option, then the "Range Min" and "Range Max" values
directly specify the display range. If "AUTO Range" is
selected for the Range Option, then the selected core
pixels will be examined to automatically compute the
display range. In this case, the "Low Sat" and "High Sat"
values specify the percent of pixels that are to be
saturated (outside the computed display range) on the low
and high ends. Note that specifying zero for "Low Sat" or
"High Sat" will cause the computed display range min or
max to be set to the minimum or maximum pixel values that
occur in the selected subarea of the input cube. When the
"AUTO Range" option is selected, the computed display range
is reported on the IDL terminal window.
If backplane display was specified, a control panel is
displayed next that allows selecting the desired
backplanes. The list of file backplane names selected by
the SFROM parameter is shown on the left. Click on a name
to choose it for display. The "Select All" button chooses
all the backplanes. To remove a backplane from the
selected list, click on the item and then use the
"Unselect Item" button. The display range for each
backplane is independent of the core planes and each other
backplane. The initial display range for each backplane
is always automatically computed by using the "Low Sat"
and "High Sat" values. (The display range can be changed
later.) If the pixel data type of a backplane is not one
of the standard ISIS types, then the backplane is
considered to contain 32-bit integer values.
DISPLAYING A FILE
After the cube file data have been read in, the CV top-level
function menu is displayed, and the program automatically
starts the interactive display of the cube file data.
CV uses a number of separate image display windows (as many
as seven), graphics display windows, and control panel
windows for the cube display. Most of these windows can be
turned on or off as desired. However, it is important to
note that this is done by using the control buttons in the
various windows. Windows must never be deleted by using
the window manager. The windows are automatically
positioned on the screen when they are initially created.
The positions of some of the windows are automatically
adjusted as some of the other windows are turned on or off.
It is not feasible for this automatic window positioning to
always maintain a "good" arrangement of the windows. Thus,
the window manager can be used to re-position the windows
as desired. In some cases, moving a window will disable
its automatic positioning and the user-specified position
will be remembered if the window is turned off and then
back on.
The graphics display windows and most of the image display
windows can be re-sized by using the window manager. If a
window is made "too big" (e.g., bigger than necessary to
hold the image being displayed), then the window will "snap
back" to the maximum size that is needed. The control
panel windows can be moved, but they should not be
re-sized.
Displaying a file creates the Main Control panel window,
which allows basic control functions and creation of
additional control panels and data plotting windows. This
window also includes an image display called the "Front
View." The title bar of this window shows the name of
the file (without the directory) that is being displayed.
This initially displays the spatial-spatial image at the
first wavelength band in the cube. The default maximum
size of the Front View display is 500x500. If the spatial
size of the cube is larger than this, then a Subsampled
window is also created, which displays a subsampled view of
the entire spatial area of the cube. A rectangle is drawn
on the Subsampled window to show the region that is being
displayed at full resolution in the Front View window. To
change the displayed region, put the cursor in the
rectangle and drag it while holding down the left mouse
button. When the mouse button is released, the Front View
is changed to show the new region. Clicking or dragging
with the middle mouse button centers the box on the cursor
and updates the displayed Front View. The default maximum
size of the Subsampled window is 200x200, but it can be
re-sized as desired. If the Front View window is re-sized
so that it can contain the entire spatial area of the cube,
then the Subsampled window is automatically deleted. If
the Front View is re-sized so that it is smaller than the
entire spatial area, then the Subsampled window is
automatically created.
TOP LEVEL FUNCTION MENU
The top level menu contains the following function buttons:
"File" - Reads in a cube file. This uses the same file
selection panel and parameters panel that are used at
start-up to read in the first file. A maximum of ten
files can be read into memory while the program is
running. (There is currently no way to remove a
selected file from memory.) Note that the selected
sub-area of each cube file is being held in memory.
If the available physical memory is exceeded, then the
interactive performance will be adversely affected due
to excessive paging. After the cube file data are read
in, the program automatically starts the interactive
display of the cube file data.
"Display" - Starts the display of a file. This function
is used to start a second display instance for a file
or to re-start a display instance that had been stopped.
This creates a new Main Control panel and Front View
window as described above. If more than one file has
been read into memory, then a list of available files
is displayed to allow selecting the desired file. When
multiple displays have been started up, each operates
completely independently of the others. A maximum of
ten display instances can be active at one time. The
labels in the title bars of the image display windows
and most of the control panels identify the display
instance with which they are associated. Note that more
than one display instance can be displaying the same
file; it is not necessary to read in the file more than
once. This allows simultaneous display of multiple
views of the same file, e.g., display of two different
wavelength bands or backplanes at the same time.
"Functions" - Starts up a "concurrent" function that runs in
combination with the display instances. Multiple
concurrent functions can be active at the same time.
However, only one instance of each type of function can
be active. "Starting" a function that is already
active will bring its window to the front of the screen
to insure that it is not obscured by other windows.
The available functions are:
"Report Detector & Grating Position" - Reports
information about the displayed image that is under
the cursor. This includes the name of the file
(including directory), and the detector number and
grating position that correspond to the band number
of the cursor and slice location. These values are
dynamically updated as the cursor is moved across
any of the image display windows.
"Report Image Size" - Reports image size information
for the display window that is under the cursor.
This includes both the virtual and disk coordinates
for the image plane being displayed. The starting
and ending coordinates for the two dimensions of
the displayed image plane are reported. Also, the
number of elements in each dimension are reported.
These values are dynamically updated as the cursor
is moved from one image display window to another.
"Stretch Displayed Images" - Interactively changes the
intensity "stretch" on the image display windows
and/or applies different pseudo-color tables. This
is the same as the standard IDL color table
modification function except that it does not change
the display of ISIS special pixel values. (The
displayed colors for special pixels are controlled
by the Special Pixels control panel, which is
created by the "Functions" button on the Main
Control panel.) Normally, the image display windows
should dynamically change when a new color table is
selected or when the stretch sliders are moved.
However, this might not work properly when
displaying with 24-bit mode on a Sun workstation
that has 24-bit display hardware. In this case,
the new color table or stretch is applied only when
the cursor is moved onto a display window or onto
the "wedge" displayed in the enhance control panel.
Dynamic updates can be restored by using the cursor
to touch the special small black window in the
upper right corner of the screen. Note that you
must then be careful to avoid touching an image
display window or the displayed "wedge" because
doing so will again turn off the dynamic update.
(This peculiar behavior seems to be due to a
"feature" (bug?) in the Sun window manager.) This
problem can be avoided by running in 8-bit display
mode, which is accomplished by typing the command
"device, pseudo=8" when you firt start up IDL.
This command can also be put into your IDL startup
file.
"Special Pixel Colors" - Modifies the colors used for
displaying special pixel values and pixel values
that are outside the current display range.
"Help" - Displays the "top level" help information for CV,
i.e., this document. Note that many of the individual
control panels have their own help information. This
is sometimes accessed through the "Functions" button on
the control panel. Also, note that when a data
plotting window is created for a spatial profile or
spectrum plot, the "Functions" button is initially not
displayed. Clicking the RIGHT mouse button while the
cursor is located to the left of the right-hand
vertical plot axis toggles whether or not the
"Functions" button is displayed. Note that multiple
help windows can be active at the same time. This
allows simultaneously viewing the help information for
multiple control panels. This also allows viewing
different parts of the same help information at the
same time. The text file $ISISHELP/cv.hlp contains the
top level help information plus the help information
for all the control panels and display windows.
"Quit All Displays" - Exits from the CV program and returns
to the IDL prompt. All display windows and control
panels are deleted. Also, all data used by the program
is released, including the memory used for holding any
cube files that had been read in. (Memory used for
holding the compiled IDL code that implements CV is not
released.) At this point, CV can be re-started to
re-initialize the program.
PROGRAMMER: Jim Torson, U.S.G.S., Flagstaff, AZ
SPECIAL PIXEL CONTROL PANEL
Each of the five different types of ISIS special pixel
values that can occur in image cube data is displayed as a
particular color in the image display windows.
The upper five buttons in this control panel allow changing
the colors that are currently being used for displaying the
special pixel values. The label on each button shows the
current display color. Clicking on the button shows a menu
of available colors.
The bottom two buttons change the colors that are being
used for displaying High and Low Display Saturation values,
which are valid cube file pixels whose values lie outside
the current display range. Note that the number of such
pixels can be changed by changing the current core display
range by using the Display Range control panel, which is
started from the "Functions" menu in the Main Control panel.
The display range for backplanes can be changed by using
the Display Backplanes control panel.
Note that the displayed colors for standard special pixel
values and Display Saturation values are never changed
when loading new pseudo-color tables or changing the
display "stretch" by using the "Stretch Displayed Images"
function, which is started from the top level "Functions"
menu.
MAIN CONTROL PANEL
SLIDER CONTROL OF SLICE LOCATIONS - The top part of the
Main Control panel allows interactively selecting different
slices through the cube for display in the image display
windows. When the Main Control panel is initially created,
it includes a slider that allows selecting the wavelength
band for the spatial-spatial image that is displayed in the
Front View window. (The slider is not displayed if the
cube contains only one band.) Dragging the slider button
while holding down either the LEFT or MIDDLE mouse button
changes the currently selected VIRTUAL band number, and the
Front View image display is changed accordingly. Clicking
the LEFT mouse button within the slider area (but not on
the slider button) increments or decrements the currently
selected virtual band number. Note that this allows more
exact control over the selected band number than moving the
slider button. Clicking the MIDDLE mouse button in the
slider area changes the virtual band number to the value
corresponding to the location of the cursor on the slider.
If the Side View display window is turned on (using the
View Control panel), then a slider is included to allow
controlling the virtual sample number of the side view
slice that is displayed. If the Bottom View display window
is turned on, then a slider is included for controlling its
virtual line number.
CURSOR DRAG OF SLICE LOCATIONS - Dragging the cursor across
any of the image display windows (except the Subsampled
window) while holding down the LEFT mouse button changes
the currently selected sample, line, and/or band (depending
upon which display window is used). When the mouse button
is released, the Front View, Side View, and/or Bottom View
windows are updated so that the displayed slices correspond
to the currently selected coordinates. Dragging the cursor
with the MIDDLE mouse button updates the displayed slices
during the dragging.
NUMERICAL VALUE REPORT - The middle part of the Main
Control panel reports both the DISK coordinates (sample,
line, band) and the VIRTUAL coordinates of the cursor when
it is on top of any of the image display windows. This
also includes the wavelength of the reported band number
and the pixel value (DN) of the pixel at the cursor
location. The coordinates of the intersection of the Front
View, Side View and Bottom View slice planes is also
reported. If a backplane rather than a core plane is being
displayed in the Front View, then "-BP-" is reported as the
band number and the backplane pixel value is reported
rather than the core pixel value.
CURSOR DRAG OPTIONS - The lower left part of the Main
Control panel contains three toggle buttons and one
selector button that control what things can be dragged
with the cursor by holding down the LEFT or MIDDLE mouse
buttons. The options are:
"Slice" - Enables/disables dragging the coordinates and
the horizontal and vertical markers that are drawn
on the image display windows to mark the
intersections of the Front View, Side View, and/or
Bottom View slices. This also enables/disables the
updating of displayed slice planes while dragging the
cursor on an image window.
"Profile" - Enables/disables dynamic updating of the
displayed spectrum plot and horizontal or vertical
spatial profile plots.
"Slider" - Enables/disables dynamic update of the displayed
slices as the slider buttons are dragged. If the
slider drag is disabled, the displayed slices are
updated when the mouse button is released.
Box Selector Button - Selects the mode for dragging boxes
drawn on the displayed images. Click on the button
to display a menu of options: "Zoom Box," "Stats Box,"
or "No Box." (Note that turning on a zoom window
automatically selects "Zoom Box" mode. Turning on an
average spectrum or numerical listing function
automatically selects "Stats Box" mode.)
CORE/BACKPLANE BUTTON - If backplane display has been
selected, the control panel includes the "Core/BP" button,
which toggles between displaying the currently selected
core plane or backplane in the Front View windows.
ADDITIONAL FUNCTIONS - The "Functions" button displays a
menu that allows turning on various data plotting windows
and various additional control panels that provide
additional display options. Multiple control panels and/or
plotting windows can be turned on at one time, but only one
instance of each type can be simultaneously active.
"Starting" a window that is already active brings the
window to the front of the screen to insure that it is not
obscured by other windows. The available functions are:
"View" - Turns on additional image display windows to
provide additional views of the image cube. Also
modifies zoom factors.
"Movie" - Controls movie display of different slice
planes.
"Blink" - Controls blink comparision of selected slice
planes. (Not implemented yet.)
"Display Range" - Changes the display range for core
image planes.
"Stretch" - Interactively changes of the intensity
"stretch" on the image display windows and/or
applies different pseudo-color tables. This is
done in such a manner that the current set of
display windows are independent of stretches and
pseudo-color tables applied to other sets of
display windows that may be active.
(Not implemented yet.)
"Statistics" - Creates data plotting windows that
display average spectra for a rectangular region
plotted as a function of either band number or
wavelength. Also creates a window that displays a
numerical listing of pixel values for a rectangular
region. (Listing is not implemented yet.) When
one of these functions is active, one or more boxes
are drawn on the displayed images to select the
desired region.
"Profiles" - Creates data plotting windows that are
dynamically updated as the cursor is dragged across
one of the image display windows. Horizontal and
vertical spatial profiles can be plotted. Also,
spectra can be plotted as a function of either band
number or wavelength.
"Report Backplanes" - Reports selected backplane values
at cursor and slice plane locations.
"Display Backplanes" - Selects which backplane is to be
displayed and changes the display range for each
backplane.
"Markers" - Controls the display of the markers that
show the currently selected slice plane
intersections. This includes setting the colors
of the displayed markers and also setting the
colors of the zoom boxes and statistics boxes.
"PostScript Output" - Writes a description of a
selected image display window to a PostScript
file, which can then be printed on a PostScript
printer.
"Help" - Displays the help information for the Main
Control panel.
STOPPING THE DISPLAY PROCESS - The "Quit This Display"
button deletes all the display windows and control panels
that are associated with this Main Control panel. The
memory used by the display functions is released, but the
cube data array is NOT removed from memory. Thus, the cube
can be displayed again later by using the "Display" button
in the top level menu (without reading in the file again).
VIEW CONTROL PANEL
FRONT VIEW DISPLAY MODE - The "Front View" buttons on the
top line of the View Control panel select the display mode
for the Front View windows. "1 Band" displays a single
selected wavelength band as a gray-scale or pseudo-color
image. "3 Band" allows selecting three bands to be
displayed as a red/green/blue color image. ("3 Band" mode
is not implemented yet.)
SIDE/BOTTOM VIEW ENABLE - The buttons on the second line of
the control panel enable/disable the "Side View" and
"Bottom View" image display windows. The Side View is a
spectral-spatial slice through the cube. This is displayed
as an image in which band number increases to the right and
line number increases downward. The Bottom View is a
spatial-spectral (line-band) slice in which band number
increases downward. The Side/Bottom View windows always
include all wavelength bands. The spatial dimensions of
these windows always include the same spatial coordinates
as the main Front View window. If you attempt to re-size
the Side/Bottom View window, it will just snap back to its
original size. However, re-sizing the main Front View
window results in an automatic re-size of the Side/Bottom
View windows.
CONTROLLING SLICE LOCATIONS - If the Side View and/or
Bottom View windows are turned on, then the Main Control
panel includes sliders for controlling the virtual sample
and/or line coordinates of these slice planes. Vertical
and/or horizontal lines are drawn on the display windows to
mark the locations of the intersections of these orthogonal
slices. (The Marker Control panel (started from the
"Functions" menu in the Main Control panel) selects display
options for these markers.) Also, dragging the cursor
across any of the display windows (except the Subsampled
window) while holding down the LEFT or MIDDLE mouse buttons
dynamically moves the markers. If the LEFT button is used,
the displayed slices are updated when the button is
released. If the MIDDLE button is used, the displayed
slices are updated dynamically as the markers are moved.
(The "Marker" Drag button on the Main Control panel toggles
whether or not this dragging is enabled.)
MAIN ZOOM FACTOR - The Main Zoom "Dec" and "Inc" buttons
decrement or increment the zoom factor used for displaying
the image in the main Front View window. A zoom factor
greater than one uses pixel replication to zoom the image,
and the window is automatically re-sized to hold the zoomed
image. (This might cause the creation of the Subsampled
window if the re-sized main window would exceed the
default maximum screen size.) If the Side View or Bottom
View windows are enabled, then they are re-sized and zoomed
by the same zoom factor. The current zoom factor is
displayed in a text field to the right of the "Dec"/"Inc"
buttons. This field can be edited to enter a new zoom
factor. Typing a "Return" after typing the new value
causes the new factor to be applied immediately. Or, the
"Apply Zoom" button can be used to apply the new zoom
factor. This allows several zoom factors to be changed at
the same time. The "Cancel Zoom" button will cancel any
zoom factors that have been typed but have not yet been
applied.
ZOOM VIEW ENABLE - The "Front View Zoom", "Side View
Zoom", and "Bottom View Zoom" buttons enable/disable
windows that display zoomed views of portions of the Front
View, Side View, or Bottom View windows. (If the Side View
or Bottom View is not being displayed, then it will be
automatically created when the corresponding Zoom view is
turned on.) The default maximum size of the zoom windows
is 200x200 screen pixels, but they can be re-sized as
desired by using the window manager. Note that dragging
the cursor on a Zoom window changes the marker and slice
locations and/or updates the spatial or spectral profile
plots. Also, dragging continues when the cursor is moved
off the Zoom window while holding down the mouse button.
CHANGING ZOOM FACTORS AND LOCATIONS - A rectangle is drawn
on the Front/Side/Bottom window to show the area that is
displayed in its Zoom view window. Holding down the LEFT
mouse button (while the cursor is in a zoom rectangle)
allows dragging the rectangle to a new area. The Zoom
window display is updated when the button is released.
Using the MIDDLE mouse button to drag the rectangle
dynamically updates the Zoom window. The "Zoom" Drag
button on the Main Control panel enables/disables the zoom
dragging function. The zoom factors used for the zoom
windows are controlled by the "Dec"/"Inc" buttons and the
editable zoom factor display fields. The Main Zoom factor
is combined with the zoom window factors. For example, if
the Main Zoom factor is two and the Front View Zoom factor
is three, then a pixel replication factor of six is used
for the display in the zoom window.
DISPLAY RANGE CONTROL PANEL
The control panel shows the current display range for the
core image planes. You can type in a new minimum and/or
maximum value. The new range is applied when you type a
"Return" key or hit the "Apply" button. When you are
typing in a new value, the "Cancel" button restores the
previous value that was applied. (Note that the "Display
Backplanes" control panel provides independent control of
the display range for each backplane.)
REPORT BACKPLANE VALUES SELECTION PANEL
When the "Report Backplanes" function is selected, the list
of backplane names contained in the cube file is displayed.
(Note that this includes only the backplanes in the virtual
cube specified by SFROM.) The "Selected Backplanes" list
displays the backplanes that have been selected for
reporting. Hitting the "Done Selecting Backplanes" button
exits the selection panel and starts reporting the
numerical backplane values at the spatial locations of the
cursor and the intersection of the Side View and Bottom
View slice planes.
When each backplane is selected, it is added to the selected
list. If the pixel data type of the backplane IS NOT one
of the standard types, then it will be reported as a 32-bit
integer value. If the pixel data type IS one of the
standard types, then it is considered to be a floating
point number and you are asked to select the desired format
(Fortran F15.5 or E15.7) for reporting the value. The
E15.7 format will always work for any values. Note that a
backplane can be selected more than once so that it can be
reported in more than one format.
Special format options are applicable to the backplane
named NATIVE_TIME. "Spacecraft Clock Time" uses the value
of the NATIVE_START_TIME label keyword to convert the
backplane values to spacecraft clock time. "Seconds"
reports NATIVE_TIME values as seconds from the beginning of
the observation, which is computed by dividing the stored
integer backplane value by 63.0. "Raw backplane value"
reports the integer value without dividing by 63.0.
DISPLAY BACKPLANES CONTROL PANEL
The list of backplanes that are currently available for
display is shown in the top of the control panel. The
name of the currently selected backplane is high-lighted.
Click on any name to select it.
The bottom part of the control panel shows the display
range for the currently selected backplane. You can type
in a new minimum and/or maximum value. The new range is
applied when you type a "Return" key or hit the "Apply
Range" button. When you are typing in a new value, the
"Cancel Range" button restores the previous value that was
applied. (Note that the "Display Range" control panel
provides independent control of the display range for
core image planes.)
MARKER CONTROL PANEL
The "Marker Display" options specify when to display the
horizontal and vertical lines on the image display windows
that mark the intersections of the currently displayed
Front View, Side View, and Bottom View slice planes. The
default "Sometimes" displays the horizontal and/or vertical
markers only when the corresponding orthogonal slices are
actually being displayed. "Always" causes both markers to
always be displayed. This can be useful because the
intersection of the markers is the sample/line/band
coordinate whose numerical pixel value is reported on the
Main Control panel. This also marks the location of any
dynamic spatial profiles or spectrum plots that are being
displayed. The "Never" option turns off all marker
display.
The "Marker Color" and "Box Color" buttons allow changing
the colors that are used for drawing the markers and the
zoom boxes.
IMAGE POSTSCRIPT OUTPUT CONTROL PANEL
The PostScript Output control panel writes a PostScript
file that describes the current contents of the selected
image display window, which includes the currently
selected display range, pseudo-color table, and interactive
stretch. This file can then be printed on a PostScript
printer to produce a hard-copy of the displayed image.
If the output file is printed on a black-and-white printer,
colors on the displayed image are printed as shades of
grey.
The name of the file to be written is displayed at the
bottom of the control panel. This field can be edited to
specify a different name. If you type a "Return" after
entering a new name, then a warning message will be
displayed if the file name already exists. If you do not
type a "Return", then no warning message is generated and
the "Write File" button will overwrite any previously
existing file.
DATA PLOT WINDOW
Each Data Plot window plots an arbitrary number of X-Y data
sets within a single X-vs-Y axis. An arbitrary number of
Data Plot windows can be active at one time. For the most
part, all Data Plot windows provide the same capabilitites.
However, the following special considerations apply to Data
Plot windows created by one of the "Profiles" options or
"Average Spectrum" options within the "Functions" menu on
the Main Control panel:
1. Only one instance of each type of profile
("Horizontal", "Vertical", "Spectrum Plot - Band",
"Spectrum Plot - Wavelength") or Average Spectrum
("Band" or "Wavelength") can be active at one
time. (If multiple Main Control panels are active,
then each is independent of the others and can have
one instance of each type of plot associated
with it.)
2. For Profiles, the first data set being plotted
within the window is dynamically updated as the
cursor is dragged across one of the image windows
while holding down the LEFT or MIDDLE mouse buttons
(if the "Profile" Drag option is enabled on the Main
Control panel).
3. For Profiles, each time the first data set is
updated, the name associated with it is set to
indicate the coordinates from which the data set was
obtained, e.g., for a spectrum plot, the name
indicates the sample and line coordinates of the
spectrum.
4. For Average Spectrum plots, the first FIVE data sets
within the window are updated as the Statistics box
is dragged on any of the Front View windows (if the
Box drag option is set to "Stats Box"). When the
LEFT mouse button is used, the plots are updated
when the button is released. When the MIDDLE button
is used, the plots are dynamically updated during the
dragging. The average spectrum is plotted as white,
the average plus and minus one standard deviation is
plotted as red, and the minimum and maximum values
within the box are plotted as blue.
5. A vertical line is plotted to mark the current value
for the coordinate along the X axis, e.g., for a
spectrum plot, the current band or wavelength
being displayed in the Front View windows is marked.
6. The initial Y-axis data range is set to the current
display range.
RE-SIZING THE PLOT WINDOW - All data plot windows can be
resized using the window manager.
SPECIAL PIXEL VALUES - ISIS special pixel values are never
plotted in Data Plot windows. For example, if a data set
is being plotted by drawing lines, a special pixel value in
the middle of the Y values will result in a gap in the plot.
PLOT NAME DISPLAY - Clicking the RIGHT mouse button while
the cursor is located to the right of the right-hand
vertical plot axis toggles whether or not the plot names
are displayed along the right side of the window.
AVERAGE SPECTRUM BOX SIZE CONTROLS - When the plot window
is displaying an average spectrum, the top of the window
contains controls that allow incrementing/decrementing the
box size or typing in a specific size. Type a "Return"
after entering one or both of the box dimensions. Note
that a box X or Y size of one pixel is permitted.
FUNCTIONS MENU - Clicking the RIGHT mouse button to the
left of the right-hand vertical plot axis toggles whether
or not the "Functions" button is displayed. The available
functions are:
"Input" - Reads in a new data set from a table file or
Instrument Spectral Library file and adds it to the
list of data sets being plotted.
(Not implemented yet.)
"Output" - Writes plot data to a table file or an
Instrument Spectral Library file. Also writes a
description of the plot window to a PostScript file,
which can then be printed on a PostScript printer.
(Only PostScript output is currently implemented.)
"AveSpec Output" - Writes average spectrum data to a
table file, an Instrument Spectral Library file, or
an ASCII file. The table file is the same format
as that written by the 'cubespec' program and
includes the disk band number, wavelength, average,
standard deviation, minimum and maximum values, and
the count of the number of valid pixels within the
averaging region.
(Only table file output is currently implemented.)
"Data Parameters" - Changes the drawing of data plots,
e.g., name, color, line style, etc.
"Plot Parameters" - Changes the drawing of the plot axes,
e.g., titles, colors, data range, etc.
(Not implemented yet.)
"New Window" - Creates a new, independent, Data Plot
window. The "Same Range" option creates a plot that
has an initial plotting data range that is the same
as the current Data Plot window. The "Auto Range"
option creates a Data Plot window in which the X-axis
and Y-axis plotting ranges are set by examining the
first data set that is plotted.
"Help" - Displays the help information for the Data Plot
windows.
"Quit" - Deletes the Data Plot window and releases all
memory that was used for storing a copy of each data
set and its plot characteristics.
COPYING PLOTS TO OTHER WINDOWS - A copy of a single data
set can be moved from one Data Plot window to another by
using a "drag-and-drop" procedure. Indicate the data set
to be copied by clicking and holding the LEFT mouse button
on the data set name that is displayed along the right side
of the window. Then "drag" the name to the destination
window and release the mouse button. This adds a copy of
the data set to the destination window, including the
current plot characteristics, e.g., name, color, line
style, etc. A data set cannot be "dropped" into the source
window.
POSTSCRIPT OUTPUT CONTROL PANEL
The PostScript Output control panel writes a PostScript
file that describes the current contents of the associated
Data Plot window (not including the "Functions" button).
This file can then be printed on a PostScript printer to
produce a hard-copy of the Data Plot window. When the file
is printed, the black background of the Data Plot window
is printed as white and things that are drawn as white on
the Data Plot window are printed as black. Other colors on
the Data Plot window are printed as the same color if the
printer has color capability.
The "Bits" and "Color" options specify the characteristics
of the output PostScript file. If the file is to be
printed on a black-and-white printer, then "1" bit and "No"
color should be selected. For color output, select "8"
bits and "Yes" for color.
The name of the file to be written is displayed at the
bottom of the control panel. This field can be edited to
specify a different name. If you type a "Return" after
entering a new name, then a warning message will be
displayed if the file name already exists. If you do not
type a "Return", then no warning message is generated and
the "Write File" button will overwrite any previously
existing file.
DATA PARAMETERS CONTROL PANEL
The Data Parameters control panel allows modifying the plot
characteristics of a selected data set. The top part of
the control panel lists the names of the data sets that are
being plotted by the associated Data Plot window. Clicking
on a name will select it and display the name in the
"Selected" field. This field can be edited to specify a
new name for the data set. (Type a "Return" after entering
the new name.) Note that this allows changing the name of
any data set, including the spatial profiles or spectrum
plots that are dynamically updated by dragging the cursor
across an image display window. However, the names of the
dynamic profile data plots (but not the average spectrum
plots) will be replaced each time they are updated.
The buttons and numerical text fields at the botton of the
control panel change the various plot characteristics,
i.e., plotting "Color", line "Style" and "Thickness",
plotting "Symbol" and symbol "Size". (Type a "Return"
after entering a new numerical value.) Note that setting
both line style and symbol to "None" will turn off the
selected plot.