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