get another manpage
NAME
X-GEN - pmotif
SYNOPSIS
xgen pmotif [run_id]
DESCRIPTION
"pmotif" enables an Motif-based management of X-GEN capabilities.
Since it is built with Motif widgets, it must be run on a screen with
X-windows capabilities. Pmotif has a number of internal capabilities
that can be invoked by pushing buttons on its display menus. This is
one of the few X-GEN applications that exists as an executable on its
own, so it can be run without "xgen" in front of its name.
OPTIONS
run_id Every data processing effort has a run identifier (run_id)
associated with it. pmotif will determine the run identifier in
one of four ways:
1. If pmotif is invoked with an argument, that argument is taken
to
be the run identifier. See "Parameter", below.
If pmotif is invoked without an argument but the file
$HOME/xgensave.lst exists, that file is queried to see if it
contains the name of a command file--typically a name like
/u2/user3/nov04/lyso04/lyso04.cmd. If it does, then the environ-
ment variables found in that command file will be installed,
including the run identifier.
2. If pmotif is invoked without an argument and $HOME/xgen-
save.lst
does not exist, then the current directory (.) is examined to
see if there are any detector images in it. If there are, it
gleans a run identifier from the prefixes of the names of the
detector images. If there is more than one group of images in
the current directory, the group that has the largest number of
images is chosen.
3. If none of the above possibilities works, the directory above
the
current directory (..) is examined and used in the same way.
4. If there are no detector images in either (.) or (..), then a
nominal run_id is chosen.
In all instances the user can override the pre-determined run_id
within the program.
Pixel-to-centimeter conversions:
For detectors with time-independent conversions from pixels to
centimeters and back again, "pmotif" examines the images it is
working with and copies over a standard pixel-to-centimeter con-
version file with suffix .uca into the current working directory
for use during data processing. Thus if the run identifier is
george and the data come from a Mar 165 CCD detector, then "pmo-
tif" will, when the user sets up the command files, copy over a
standard file marccd.uca into $WORK/george.uca.
Top-Level Menu:
The toplevel pmotif menu has a button for each of the major
applications within the X-GEN suite. For the most part the pri-
mary applications, i.e. the ones that are required for process-
ing data under ordinary circumstances, are found in the center
column of the menu -- "spots", "refall", "integrate", "reduce",
and "scalem". The other applications are employed in non-stan-
dard situations or (in the case of "mrmerge") when we are merg-
ing multiple runs together. When the user mashes any button on
this top-level menu (other than the Exit button at the bottom)
the application displays a menu specific to that program. Each
of these menus enables the user to modify the default settings
for running that program, and then run that application.
Pmotif (Environment Variables and Images) Menu:
The upper-left button on the primary "pmotif" menu says "pmo-
tif". If the user clicks that button, a menu appears allowing
the user to manipulate the run identifier, the names of the
directories in which the working files, the scratch files, and
the raw data live. It also allows control over the index of data
images.
Application Menus:
All of the buttons other than "pmotif" and Exit on the top-level
"pmotif" menu bring up menus for specific X-GEN applications. As
mentioned earlier, the individual menus enable users to set up
and then run specific applications.
You can alter the names of the input and output files, the
Boolean variables (seen as pushbuttons on the left side of this
example), the switches (listed on the right with the letters
that introduce those switches), and the non-switch parameters
(the last three entries in the above menu). There is some effort
made to set the default values of these parameters based on
logic, but the user is free to alter those values for the run.
When the setup for the application is complete, the user can
mash the "RUN & Wait" or "RUN & Don't Wait" buttons, either of
which makes the application begin. In the first instance it will
run synchronously; in the second, asynchronously. The third but-
ton closes down the spots menu. The fourth brings up a text help
menu, which can be closed with a QUIT button when the user has
will be "george":
REPORTING BUGS
Report bugs to Andy Howard at howard@iit.edu or 312-567-5881.
COPYRIGHT
Copyright (C) 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
Version 5.5.5 October 2005 X-GEN(1)
"get my man!" .. in association with
man2html
and cor