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)