gpiv_series(1) [debian man page]

GPIV_SERIES(1)						      General Commands Manual						    GPIV_SERIES(1)

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-corre-
	      lation 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)

Check Out this Related Man Page

GPIV_SCALE(1)						      General Commands Manual						     GPIV_SCALE(1)

NAME

       gpiv_scale - Scaling of PIV data.

SYNOPSIS

       gpiv_scale [-h | --help] [-p | --print] [-s M |-S M] [-t dT |-T dT] [-v | --version] [-zp x0 y0] [-zv x0 y0] [filename] < stdin > stdout

DESCRIPTION

       gpiv_scale  applies  the  image	magnification and the time between successive recordings to the PIV estimators. This results that particle
       displacements [px] are modified to velocities [m/s] and their positions from [px] to [m]. A physical reference for the positions of the PIV
       data can be applied by means of the image zero-offset option.

       If  filename  is used, the parameters and options to be used for gpiv_scale are subsequently read from the image header (filename.h in case
       of raw binary images) or from the configuration resources (containing the IMG and POST keys). The parameters may be overruled by  the  com-
       mand line options, as explained below.

Options
       -h | --help
	      On-line help.

       -p | --print
	      Prints parameters, command line options and input and output filenames to stdout.  The output is identic of filename.par, in case -f
	      is used.

       -s M   spatial scaling with magnification factor M [m/px]

       -S M   Inverse spatial scaling with magnification factor M [m/px]; returns scaled data to their original magnitudes.

       -v | --version
	      Prints version information on standard output, then exits successfully.

       -t dT  Translates particle displacements into velocities by devising them with the time between subsequent recordings dT [s].

       -T dT  Inverse time scaling. Returns velocities into displacements [px]

       [-z x0 y0]
	      Relates the positions of the observations of velocities/displacements to a physical location in the experiment by image zero offset-
	      ting. x0 y0 denote the physical position of pixel (0,0) in the image.

       filename
	      Input PIV file. Overrides stdin and stdout. The output will be written to filename.sc.piv. Parameters are stored in filename.par and
	      may be used for future use by including them in ./gpivrc.

       SEE ALSO
	      gpivtools

NOTES

AUTHOR

       Gerber Van der Graaf

BUGS

       The program has been tested for PIV data. So far, no bugs have been found.

								  8 November 2006						     GPIV_SCALE(1)

Linux and UNIX Man Pages

gpiv_series(1) [debian man page]

Check Out this Related Man Page