Content-type: text/html
Man page of X-GEN
X-GEN
Section: X-GEN Commands (1)
Updated: April 2005
Index
Return to Main Contents
NAME
X-GEN - ewmask
SYNOPSIS
ewmask
DESCRIPTION
"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.
Displays:
-
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
as follows:
- value
-
display comment
-
----- ---------------- ------------------------
- < 1
-
- blank.
- 1-9
-
single digit 1-9 3 represents 3% of peak.
- 10-35
-
lower-case letter c represents 12% of peak.
- 36-61
-
upper-case letter C represents 38% of peak
- 62-99
-
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:
- value
-
display comment
- < 1
-
blank
- 1-36
-
dot
- 37-46
-
single digit 1-9 3 represents 39% of peak
- 47-72
-
lower-case letter c represents 49% of peak
- 73-98
-
upper-case letter C represents 75% of peak
- 99
-
asterisk
-
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.
Keystrokes (general):
-
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)
to another;
- *
-
by invoking control keystrokes that affect entire groups of pixels
in the current frame, the current model, or in all models.
Navigation:
-
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:
- keystroke
-
meaning wraparound?
- up-arrow
-
move up one pixel yes
- left-arrow
-
move left one pixel yes
- right-arrow
-
move right one pixel yes
- down-arrow
-
move down one pixel yes
- ^J
-
move to beginning of next row yes
- ^H
-
move left one frame yes
- ^I/tab
-
move right one frame yes
- ^B
-
move to previous model yes
- ^L
-
move to next model no*
- ^E
-
begin exit sequence --*
^L,on the final model is equivalent to ^E,
i.e. it invokes the exit sequence.
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.
Single-pixel manipulations:
-
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.
Global manipulations:
-
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
- ^F
-
blank boundary, i.e. --
outermost pixels of frm frame, model, or all?
- ^G
-
Gaussian boundaries yes; see below
- ^K
-
contiguity enforced frame, model, or all
- ^V
-
Lorentzian boundaries yes; see below
- ^W
-
redraw model none
- ^X
-
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
user
-
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
operation commences.
REPORTING BUGS
Report bugs to Andy Howard at howard@iit.edu or 312-567-5881.
COPYRIGHT
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
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- Displays:
-
- Navigation:
-
- Exit sequence:
-
- Single-pixel manipulations:
-
- Global manipulations:
-
- REPORTING BUGS
-
- COPYRIGHT
-
This document was created by
man2html,
using the manual pages.
Time: 02:08:09 GMT, October 03, 2005