Man page of X-GEN
Section: X-GEN Commands (1)
Updated: April 2005
Return to Main Contents
X-GEN - xgnow
[-z] [-dval ...] [idname] [representative_image]
"xgnow" provides a single-command interface to creating the control files
used in X-GEN. Under normal circumstances it creates a pair of files
containing the environment variables required for operating X-GEN--one for
sh-style shells (bash, ksh, and sh), and the other for csh-style shells
(tcsh, csh). It also creates an index of the images used in the current
project. If the user invokes "xgnow" with no arguments, it looks in the
current directory (.) and the directory above it (..) for any detector
images that might be present. If there are, it divides the list of images
into groups that share a common filename template and recognizes the one with
the largest number of images as the active set. Thus if . has no detector
images in it, but .. has 130 images with names of the form george###.img
and 170 images of the form fred###.img, then the project identifier will be set
to "fred" and command files containing environment variable assignments called
fred.com and fred.cmd (sh and csh, respectively) will be placed in the current
directory. The image index /fred.frm/ will also be created and will look like
. . .
assuming that the current directory is /home/howard/currentdata/xgen.
will be created, but the project identifier will be obtained
differently. In particular, if an actual detector image is specified,
e.g. "xgnow ../fredbaby013.img" then the run ID will be set to
fredbaby, and fredbaby.com, fredbaby.cmd, and fredbaby.frm will
be created. The range of frames will be determined by examining .. and
finding the list of files with names of the form fredbaby###.img
Do not delete global variables before exiting. This is an
internal code and not one the user needs to deal with.
Specify the directory in which to search for images
as <val>. Thus xgnow -d../../crumbs will search for
images in the directory ../../crumbs.
Specify the highest image number as <val>. Thus
"xgnow -h180" will specify that the last image in the data
set should be number 180. This is useful if xgnow is run after
only a few images have been collected, but the user intends to
collect a large number of images in the current set of data.
Thus the user will start the processing effort with an image
index that contains all 180 images, even though only the first
six have been collected when "xgnow" is invoked.
Specify the project identifier as <val>.
Specify an example data image to determine the project
identifier and the data directory.
A non-flag argument that is the name of a file is parsed into a
project identifier and a set of run numbers, as described above.
A non-flag argument that is not the name of an image file is
treated as a project identifier. Thus "xgnow grumble" would
establish that the project identifier is "grumble".
Report bugs to Andy Howard at email@example.com or 312-567-5881.
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
- REPORTING BUGS
This document was created by
using the manual pages.
Time: 02:08:09 GMT, October 03, 2005