NAME

       gpiv_series - Script for (parallel) processing a series of numbered files.

SYNOPSIS

       gpiv_series [-a | --arg_n] [-b | --basename FILE] [-e | --ext ext] [-f | --first N] [-l | --last N] [-i |
       --incr N] [-x|| --prefix] [-h | --help] [-n | --none] [-p | --print] [--pad] "process -key1 ..."

DESCRIPTION

       gpiv_series  processes  a  series  of  numbered  files. If no parameters are defined at the command line,
       standard parameters will be used that are defined in the script. Principally, any program or  script  may
       be invoked by gpiv_series. "Process" is a string which represents the name of the program to be executed,
       including eventually command line options and arguments. The file to be processed, as constructed from -b
       c.s., will be appended to the "process" string. If the program has to be feeded with -f "filename", write
       -f at the end of the string.

       When using the parallelised version, mpipython is invoked and the script may be launched with mpirun. The
       script  needs  that  all input files are accessible on each node by copying all data or by (NFS) mounting
       the File System containing the input data on each node.

       This program does not use the parameter resources from libgpiv.

Options

       -a | --arg_n
              If the process needs the current number in its argument list instead of prepending/appending it to
              the FILE, the number will be put before (-f) filename in the "process" string.

       -b | --basename FILE
              The FILE has to be given without its extension. FILE represents the file name without its  number.
              It  is  supposed  that  the  leading  or ending number in the filename is the counter that will be
              applied by gpiv_series when processing.

       -e | --ext EXT
              add an extension EXT after the filename (without the leading ".") in "process".

       -f | --first N
              Defines the counter N of the number at which the analyses starts.  Default: 0.

       -l | --last N
              The last number N that will be processed. Default: 0.

       -i | --incr N
              Increment number with N. Default: 1. This might be useful, for  example,  if  subsequent  numbered
              images are combined for cross-correlation with the gpiv_img2gpiv tool.

       -x | --prefix
              Use prefix numbering to file basename.

       -h | --help
              On-line help.

       -n | --none
              Suppresses real execution, only prints the process to stdout.

       -p | --print
              Prints the process to be performed on each file to stdout.

       --pad  N
              Padding a number with N zero's when combining with the filename.

       SEE ALSO
              gpivtools

NOTES

AUTHOR

       Gerber Van der Graaf

BUGS

       The parallelised script has only been tested with the LAM version of mpipython.

                                                 19 Januari 2005                                  GPIV_SERIES(1)