Man page of X-GEN
Section: X-GEN Commands (1)
Updated: April 2005
Return to Main Contents
X-GEN - ewmask
"ewmask" reads in a model-profiles file with environment
variable name WMASK and sets up a CURSES-based editing
facility for it. Upon exit it optionally writes out the
modified WMASK file. There are twelve model profiles kept in a
WMASK file: one for each of the twelve regions on the detector face:
* Regions 0-2 are along the top of the detector, from left to right.
* Regions 3-8 are near the vertical center, from left to right.
* Regions 9-11 are along the bottom, from left to right.
Each model profile are presented to the user as a 7x15x15 pixel
display in which a model profile element is visualized as a value
between 0 and 99, where 0 represents no intensity and 99 represents
maximum (peak) intensity. The display representation usually works
----- ---------------- ------------------------
- < 1
single digit 1-9 3 represents 3% of peak.
lower-case letter c represents 12% of peak.
upper-case letter C represents 38% of peak
asterisk see note below
At any time the user can change this display (using ^T,
see below) to one in which an alternative coding appears:
- < 1
single digit 1-9 3 represents 39% of peak
lower-case letter c represents 49% of peak
upper-case letter C represents 75% of peak
In order to fit 7x15x15 across a 23-line display, the window
must be at least 132 columns wide. A terminal (real or pseudo)
that is incapable of displaying 132 columns will not display properly.
The user can manipulate the model profiles in the following ways:
by typing values (0-9, a-z, or A-Z) into specific pixels of the display;
by navigating around the display of the current model;
by navigating from one display (showing one particular model profile)
by invoking control keystrokes that affect entire groups of pixels
in the current frame, the current model, or in all models.
When the program is first invoked, model number 0 (corresponding
to the upper left-hand corner of the detector) is displayed, with
the cursor set in the first nonzero pixel of the first frame of that
model that has at least one nonzero value. The user can then move
around with the keyboard's arrow keys (if they're active) or with
control keystrokes, as follows:
move up one pixel yes
move left one pixel yes
move right one pixel yes
move down one pixel yes
move to beginning of next row yes
move left one frame yes
move right one frame yes
move to previous model yes
move to next model no*
begin exit sequence --*
^L,on the final model is equivalent to ^E,
i.e. it invokes the exit sequence.
When ^E is invoked, or when ^L is invoked from the final (11th)
model, the screen is cleared and the user is asked whether he or
she wishes to write out the new model profiles before quitting.
With the pixel in a particular spot, the user may type in a
value as 0-9, a-z, or A-Z. The value typed in will be recorded
as the new model-profile value in that spot.
Certain control keystrokes cause changes to groups of pixels. In some
cases the keystroke will invoke a further prompt where the user is
asked for a detail of how to use that command or to define the
scope of the change:
keystroke meaning further prompt of user?
^A/^P zero all pixels none in current frame
^D copy other model number to copy current model
to another model
blank boundary, i.e. --
outermost pixels of frm frame, model, or all?
Gaussian boundaries yes; see below
contiguity enforced frame, model, or all
Lorentzian boundaries yes; see below
redraw model none
recenter model model or all models
In the above table if the rightmost column says "frame, model,
or all?" the user is being asked whether the requested change
applies to the frame where the cursor is, to the entire model
being displayed, or to all twelve models.
The Gaussian and Lorentzian boundary commands (^G and ^V) have
a special sequence of additional questions. They first ask the
Enter a cutoff contour value (0.01-99) on the ellipsoid:
which sets a PERCENTAGE of the peak at which the ellipsoid
might be manipulated. They then ask
will be carried. Finally they ask
Flatten boundary, extrap edges, both, or replace (F,E,B,R)?
so the program is asking whether the user wishes to flatten the
boundary, extrapolate out the edges (i.e., insert small but nonzero
values where "undeserved" zeroes currently lie), do both, or simply
replace the input model with the values derived from the Gaussian or
Lorentzian. After the user answers that question, the appropriate
Report bugs to Andy Howard at firstname.lastname@example.org or 312-567-5881.
Copyright © 2002, Illinois Institute of Technology.
See the file 'LICENSE' for information on usage and redistribution
of this file, and for a DISCLAIMER OF ALL WARRANTIES
- Exit sequence:
- Single-pixel manipulations:
- Global manipulations:
- REPORTING BUGS
This document was created by
using the manual pages.
Time: 02:08:09 GMT, October 03, 2005