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