osiv_dump

Langue: en

Version: 148763 (fedora - 04/07/09)

Section: 1 (Commandes utilisateur)

NAME

osiv_dump - retrieves information from osiv data file

SYNOPSIS

osiv_dump [-o output_file] FILE

DESCRIPTION

osiv_dump is a program for extracting the arguments, vectors, and correlation maps which are contained in an osiv data file. The flags --vectors, --arguments, and --maps are used to control which data is included in the output.

OPTIONS

-o FILE
The text file to which the output should be written. If this option is not used, then output is written to the standard out by default.
-a --arguments
This flag causes the argument list stored in the data file to be included in the output. The format of the output is identical to the input format for osiv_corr.
-v --vectors
This flag causes the vector flow field stored in the data file to be included in the output. The format of the output is usually a set of four space-delimited columns, but the format can also be modified with the "-p" option.
-m --maps
This flag causes the correlation maps stored in the data file to be included in the output. The format of the output is usually a set of three space-delimited columns, but the format can also be modified with the "-c" option.
-f INTEGER
This flag is used to specify the range of frame numbers for which vectors or correlation maps should be printed. Ranges are specified with one of the following forms: start, start:finish, or start:increment:finish. Negative values for the increment or for the finish will result in the use of default values for these fields. By default, vectors from all frames are printed. The frame number is specified as in the original osiv_corr call.
-w INTEGER
This flag is used to specify the window number and is set to zero by default. The window number is given in a "row-major" format. In other words, the index is c+r*nc, where c is the column, r is the row, and nc is the number of columns in the grid.
-p FORMAT
The format for printing the vectors is specified using conventions similiar to that of the C function printf. The window grid is traversed row-wise and a call to printf is made for every vector. The x position is specified with `%x', the y position with `%y', the x displacement with `%u', and the y displacement with `%v'. The default is `%06.1x %06.1y %+0.8u %+0.8v\n'.
-c FORMAT
The format for printing the correlation map is specified using conventions similiar to that of the C function printf. The map is traversed row-wise and a call to printf is made for every element. The x displacement is specified with `%u', the y displacement with `%v', and the correlation value with `%e'. The default is `%+05.1u %+05.1v %010.1e\n'.
--omit-fbreaks
This flag causes the output to occur without newlines between subsequent frames. This is sometimes useful if the output is intended to be parsed by another program.
--omit-headers
This flag causes the output to occur without headers. This is often useful if the output is intended to be parsed by another program.
--omit-newlines
This flag causes the output to occur without trailing newlines. This is sometimes useful if the output is intended to be parsed by another program.

MORE INFO

Additional documentation can be found online at www.osiv.org.

SEE ALSO

osiv_corr(1), osiv_draw(1), osiv_tune(1), osiv_synth(1),
readovd(3).

BUGS

No known bugs. Please report bugs as www.osiv.org. Copyright © 2002 James Strother.