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