RASTER
Home ›
Software ›
Manual Pages ›
RASTER
Section: User Commands (1)
Updated:
Index
Return to Main Contents
NAME
raster - pseudo-3D raster graph
SYNOPSIS
raster
[runfile]
DESCRIPTION
Raster
produces a pseudo-3D raster graph of traces
from a run file, as created by
cap(1),
or
analysis(1).
The first valid trace from each frame is read from the specified
runfile
and displayed.
If no
runfile
is specified, you will have to select one later.
At the bottom of the display,
raster
prints the following menu prompt line:
-
Alt-pens Baseline Clip File Go Hide Interpolate Locations Markers Plot Quit
Start-bin Titles Vis-X-marks X-incr Y-incr
An operation is initiated by typing a single letter,
the first letter of an item in the menu line.
You can also step through the menu using the space bar and the
backspace (or erase) key, to highlight the item you want, then
press RETURN to select that item.
Alt-pens
This selection allows you to
vary the pen numbers, and hence the plotting colours, of the traces displayed.
on the graph.
You are prompted for a list of pen numbers for trace plotting, which must be
in the range indicated in the prompt.
The traces will be plotted by alternating through this list of pen numbers
in rotation.
If this list is empty, as it is by default, the Data pen (described below)
is used instead.
Baseline
Since the height of traces may drift somewhat,
raster
must measure a
reference level
for each trace in order to properly align the traces on the display.
This selection allows you to
choose the part of the trace which is averaged
to obtain the reference level or baseline.
You will first have to do a
File
operation, if you haven't selected a file yet.
The selected trace from the
first non-empty frame is displayed on the screen.
You can get another frame using the
N
or
P
keys to select the next or previous frames.
Select the desired measurement range by using the pointing device
to move the cursor to the desired position
on the displayed waveform, then pressing either button
A
to set the START marker to the X-axis position of the cursor, or button
B
to set the END marker.
Press button
C
or
D
when you are done.
If you set the START and END markers to negative values, left of the
displayed sweep, then
raster
will display the traces as absolute voltage levels, without normalizing
to a baseline.
You can also disable normalization using the
R
key to select "no reference."
Clip
This selection allows you to
choose the range of voltage levels, relative to the baseline,
which are to be displayed from each trace.
As well, it lets you clip off the start or end of the traces.
You will first have to do a
File
operation, if you haven't selected a file yet.
The selected trace from the
first non-empty frame is displayed on the screen.
You can get another frame using the
N
or
P
keys to select the next or previous frames.
Select the desired display range by using the pointing device
to move the cursor to the desired level
on the displayed waveform, then pressing either button
A
to set the minimum level to the Y-axis position of the cursor and
the starting offset to the X-axis position of the cursor, or button
B
to set the maximum level and the ending offset.
You can then use the space and backspace keys to make fine adjustments to
the last level set.
(These don't affect the X offsets.)
If you want to set the Y range explicitly, press the
Y
key, and the program will prompt you for the upper and lower bounds,
which you enter in mV.
Similarly, pressing the
X
key will allow you to enter the left and right bounds in ms.
Button
C
toggles the clipping option.
If clipping is turned on, the display is limited to the range you selected.
If clipping is turned off, the display is automatically scaled to include
all data points in the traces.
Press button
D
when you are done.
File
This selection allows you to
choose a new
runfile,
trace number
and frame list
to be displayed.
You are prompted to enter the name of the file.
Type in this name, then hit RETURN.
If the file is a valid
runfile,
and its frames each contain more than one trace,
you will also be prompted for a trace number.
If a valid trace number is specified, or if there is only one
valid trace number, that trace will be displayed for each frame.
If the file contains more than one frame,
you will then be prompted
to enter a list of frame numbers,
which must be in the range indicated in the prompt.
If you enter a valid frame number list,
the trace you chose will be loaded from
the specified frames, and displayed in that order.
If no input is entered, the default list shown in the prompt
(initially "All", meaning all frames from first to last)
is used.
The format for this list is the same as the
frame list
format in
frmsel(1).
If you were displaying several frames, and with the latest selection
you display much fewer frames, you will likely have to increase the
X-incr
and
Y-incr
to get proper spacing.
Go
This selection causes the graph to be redisplayed,
after parameters have been changed.
Hide
This selection allows you to set the
hidden-line
option.
If this option is enabled, as it is initially, traces will be
partially obscured by those in front of them.
This usually makes the graph clearer and more aesthetically pleasing.
If disabled, traces will be displayed in their entirety.
Initially, this option is enabled.
Interpolate
This selection allows you to set the
interpolation
option.
If this option is enabled, the data points of the
displayed traces will be connected by line segments.
If disabled, only the data points are displayed.
Initially, this option is enabled.
Locations
This selection allows you to
move or remove the X and Y scale bars, and to reduce the screen area
used to draw the traces.
You are first asked for the scale bar coordinates.
Enter up to four numbers on the line, separated by spaces,
indicating the X and Y positions of the time scale,
then the X and Y positions of the voltage scale.
(These positions are specified in pixel offsets, and vary
depending on your screen resolution.)
If any of these numbers is omitted from the end of the line, a
0
is assumed.
Initially, this line is blank, so both scale bars are placed at (0,0).
If the X or Y position for either scale bar is given as a
negative number, that scale bar is not drawn.
Next, you are asked for the trace area size reductions.
Enter up to four numbers on this line, indicating the reductions
(in pixels) on the left, bottom, right, and top of the traces.
If any of these numbers is omitted from the end of the line, a
0
is assumed.
These reductions are especially useful when you need to make room
somewhere for the scale bars.
Markers
This selection allows you to
place vertical and/or horizontal marker lines at selected locations
on the graph.
You are first prompted for a list of up to twenty-six X markers
(vertical lines).
Enter these in the units shown on the graph's X-axis scale bar,
usually milliseconds.
You are then prompted for a list of up to twenty-six Y markers
(horizontal lines).
Enter these in the units shown on the graph's Y-axis scale bar,
usually millivolts.
(The Y markers are displayed relative to the baseline of the traces.)
Hitting RETURN for either list leaves it untouched.
Typing a space, then RETURN for either list clears that list.
The X markers are only shown when the
X-incr
is set to zero,
and the Y markers are only shown when the
Y-incr
is set to zero.
This restriction is required because the markers are meaningless unless
the relevant data are properly aligned.
The X markers, when shown, are tagged with capital letters.
The Y markers, when shown, are tagged with lower case letters.
A line above the graph shows the time or voltage values
associated with each of the marker lines.
Note that these numbers may not be exactly those that you typed in;
the marker positions are rounded to the data's X or Y resolution.
For example, if the displayed traces contain samples at every 0.3 ms,
then a marker requested at 10 ms will actually be placed at 9.9 ms.
Plot
This selection
brings you to the plotting sub-system,
which presents you with a secondary menu.
See
PLOTTING
below.
Quit
This selection causes the program to terminate.
Start-bin
If the current
runfile
is the result of a
cycle-triggered average,
this selection allows you to
choose which bin represents the start of the cycle.
Initially, the graph begins with bin
1.
You are prompted to enter the starting bin number.
Respond by typing a number greater than 0,
and not greater than the number of bins (traces) displayed,
then hit RETURN.
Titles
This selection allows you to set the
top-title
option.
If this option is enabled, the
two title lines, at the top of the graph,
will be displayed.
If disabled, the lines are omitted,
and the graph is slightly expanded to use up the extra space.
Initially, this option is enabled.
The first of these two lines shows the file name and the number
of frames in the file.
The second shows the run description, if available, followed by
the frame description line (from the
.frd
file, if available) for the first frame selected from the run.
Vis-X-marks
This selection allows you to
place vertical marker lines at selected locations on the graph,
using the pointing device.
The
X-incr
must be set to zero for this, so that the traces are aligned to
the same time offsets.
The graph will be redisplayed so that the effect of any parameter
changes will be seen, then you can proceed to add or delete
markers.
To add markers, use the pointing device to move the cursor the
the desired offset on the display, then press button
A
to place a marker at that location.
To delete a marker, place the cursor directly over the marker you
wish to delete, then press button
B.
You cannot move an existing marker - you must delete it and
place a new one at the location you want.
The markers are lettered sequentially from A to Z.
When you add a marker, it is tagged with the next available
letter, and when you delete a marker all following markers are
re-lettered to eliminate the gap.
Press button
C
or
D
when you are done.
X-incr, Y-incr
These selections allow you to change the X and Y increments.
These numbers represent the number of pixels by which
one trace is offset from the next.
When a
runfile
is selected,
raster
attempts to calculate ideal increments,
but small adjustments may improve the appearance of the graph.
The X-increment you specify can be a negative number.
This will change the "viewing angle" of the graph.
Specifying a negative Y-increment will cause the traces to be
displayed in the reverse order.
Increasing the offset between traces causes the displayed traces to shrink.
If either increment is too large,
raster
will not be able to draw the graph.
!command
Whenever the menu line has just been printed,
instead of typing a letter to select a menu item,
you can type an exclamation point, followed by any UNIX command,
then hit RETURN.
A UNIX shell is invoked to interpret and execute this command.
You can recall and edit the last command entered, by hitting the
"up arrow" key, or Control-K, after typing the exclamation point.
$ or %
Whenever the menu line has just been printed,
you can also type either a dollar sign
($),
to invoke an interactive Bourne shell,
or a percent sign
(%),
to invoke an interactive C shell.
In either case, the shell will continue accepting commands until
you type a
Control-D,
to exit from the shell, and return to
raster.
? or /
Whenever the menu line has just been printed,
you can also type either a question mark
(?),
or slash
(/),
to get a short description of all choices available in the current menu.
PLOTTING
The
Plot
selection is used to produce a plot
similar to what would be displayed on the screen by the
Go
operation.
A new menu is presented, allowing you to change certain
plotting parameters.
The choices are:
-
Axes Data File Interpolation Markers Plotter Quit Screen Text Video
Selections are made by typing the first letter of an item in this menu.
Axes, Data, and Markers
These selections allow you to
change the pen numbers used to plot axes, data points, and markers,
respectively.
You will be prompted to enter a pen number,
an integer from
0 to 8.
The three pen numbers are initially set to
1.
Selecting pen number 0 suppresses plotting of those items.
File
This selection allows you to store the HPGL commands used
to plot the graph in a file.
You will then be able to plot this graph, at a later time, by invoking
hardcopy(1).
You will be prompted to enter the file name.
If you enter a file name, the graph will be stored in this file.
If the file already existed, it will be overwritten.
Interpolation
This selection allows you to change the plot interpolation
option.
If this option is enabled, the data points of the plotted graph
will be connected by line segments.
If disabled, only the data points are plotted.
This is similar to the "Interpolate" option for the screen
display, but is maintained as a separate option because it is
common to want interpolation enabled for plotting, but not for
the screen display.
Plotting with interpolation enabled
allows the plotter to work much faster,
with less wear on the pen.
Plotter
This selection allows you to
plot the graph directly to the plotter.
The
hardcopy
program is invoked
to plot the displayed graph.
Before beginning this operation, make sure the plotter is powered up,
on-line, and that a clean sheet of paper has been loaded.
Also make sure the plotter's
autoload
option is enabled.
Quit
This selection returns you to the previously displayed menu.
Screen
This selection allows you to change the screen redraw option.
If this option is enabled, the graph will be redrawn on the
screen while it is being sent to the file or the spooler.
If disabled, the current contents of the screen will remain,
while the plot is generated.
Text
This selection allows you to change the plot text option.
If this option is disabled, the generated plot will not contain
any text; all titles and labels will be stripped from it,
leaving only the axes, tick marks, data points, etc.
This is useful when the plot is reduced in size to the point
where the text would be illegible.
If enabled, the generated graph will be complete with all titles
and labels.
Video
This selection does not affect the pen plotter, but instead
produces a printed copy of the video display's current contents
- a screen dump -
by invoking
sdump(1).
The same thing can be accomplished by pressing the
quit
key, normally
Control-B.
The
Plot/Video
operation has the advantage that it can be used even when
the program
is reading its commands from a file, rather than the terminal.
Also, the
Plot/Video
operation clears the menu area before performing the screen dump.
X WINDOW SUPPORT
When the X Window version of this program is run on an X Window terminal,
a new window will be shown for
displaying program output.
Unless the input was redirected from a file, it will be taken from the
keyboard when this window is the "input focus", i.e. the active window.
When running this way, it is essentially detached from the
xterm
window from which you run the command, and it can be run in the background.
As for most other X Window programs in this package,
the following X command line options are accepted:
- -cursor num
-
You can specify any cursor number (not cursor names)
in the Standard Cursor Symbols
described in the
X Window System User's Guide
using the
-cursor
or
-curs
option.
The default value is 68, the left pointer symbol.
This can also be specified using the
CURSOR
environment variable.
- -display [host]:server[.screen]
-
By default, the host, server and screen, which identify your X terminal,
are obtained from the environment variable
DISPLAY.
However, you can also specify them using the
-display
or
-disp
option.
The
host
is the name of the machine or terminal, on which the window is to be created,
server
is the server number, and
screen
is the screen number (default is 0).
- -fn font
-
You can specify any fixed-width font to be used for text display
using the
-fn
or
-font
option.
The default value is
9x15
if the window is at least 900 pixels wide initially,
and
fixed
otherwise.
This can also be specified using the
SCRFONT
environment variable.
- -geometry geometry
-
By default, the program will create a window that covers most of the display.
However, you can specify custom window dimensions and location using the
-geometry
or
-geom
option.
The format of the
geometry
string is described in the
X Window System User's Guide.
This can also be specified using the
GEOMETRY
environment variable.
- -iconic
-
This option will cause the program to start up in an iconified state,
which can be reactivated by double-clicking on the icon.
- -rev
-
This option will cause the program to
use reverse video in its display window.
- -title name
-
This option will change the name
shown on the window's title bar, which is usually just the program name.
It can also be given as
-name
name.
NOTES
Raster
should be run from a graphics terminal,
or X terminal,
in order to view generated graphs.
It can be run from other types of terminals, to plot out graphs,
but no graphs will be generated on screen.
FILES
*.frm the frame file (or runfile)
*.txt the run description
*.frd the frame descriptions
SEE ALSO
cap(1), analysis(1), frmsel(1), hardcopy(1), sdump(1)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- Alt-pens
-
- Baseline
-
- Clip
-
- File
-
- Go
-
- Hide
-
- Interpolate
-
- Locations
-
- Markers
-
- Plot
-
- Quit
-
- Start-bin
-
- Titles
-
- Vis-X-marks
-
- X-incr, Y-incr
-
- !command
-
- $ or %
-
- ? or /
-
- PLOTTING
-
- Axes, Data, and Markers
-
- File
-
- Interpolation
-
- Plotter
-
- Quit
-
- Screen
-
- Text
-
- Video
-
- X WINDOW SUPPORT
-
- NOTES
-
- FILES
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 17:58:06 GMT, February 20, 2019
Copyright © G. R. Detillieux,
Spinal Cord Research Centre,
The University of Manitoba.