Content-type: text/html
Man page of X-GEN
X-GEN
Section: X-GEN Commands (1)
Updated: October 2005
Index
Return to Main Contents
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
environment variables found in that command file will be
installed, including the run identifier.
-
2. If pmotif is invoked without an argument and $HOME/xgensave.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
conversion 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 "pmotif" 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
primary applications, i.e. the ones that are required for processing
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-standard
situations or (in the case of "mrmerge") when we are merging
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 "pmotif".
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 button 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 read what he or
she needs to read.
EXAMPLES
- pmotif:
-
Set up and operate a data processing effort using the data
associated with the command file named in $HOME/xgensave.lst:
- pmotif george
-
Set up and operate a data processing effort for
which the run_id will be "george":
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
-
- OPTIONS
-
- EXAMPLES
-
- REPORTING BUGS
-
- COPYRIGHT
-
This document was created by
man2html,
using the manual pages.
Time: 02:12:19 GMT, October 03, 2005