Content-type: text/html Man page of X-GEN


Section: X-GEN Commands (1)
Updated: April 2005
Index 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 as follows:
display comment
----- ---------------- ------------------------
< 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:
display comment
< 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.

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.


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:
meaning wraparound?
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.  

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
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 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.


Report bugs to Andy Howard at 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:

This document was created by man2html, using the manual pages.
Time: 02:08:09 GMT, October 03, 2005