Content-type: text/html Man page of X-GEN

X-GEN

Section: X-GEN Commands (1)
Updated: April 2005
Index Return to Main Contents
 

NAME

X-GEN - xgnow  

SYNOPSIS

xgnow [-z] [-dval ...] [idname] [representative_image]  

DESCRIPTION

"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
1/home/howard/currentdata/fred001.img 2/home/howard/currentdata/fred002.img 3/home/howard/currentdata/fred003.img 4/home/howard/currentdata/fred004.img
. . .
170/home/howard/currentdata/fred170.img

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  

OPTIONS

-z
Do not delete global variables before exiting. This is an internal code and not one the user needs to deal with.
-d<val>
Specify the directory in which to search for images as <val>. Thus xgnow -d../../crumbs will search for images in the directory ../../crumbs.
-h<val>
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.
-i<val>
Specify the project identifier as <val>.
-x<val>
Specify an example data image to determine the project identifier and the data directory.
<arg>
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".
 

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
REPORTING BUGS
COPYRIGHT

This document was created by man2html, using the manual pages.
Time: 02:08:09 GMT, October 03, 2005