NAME 

osiv_getmap - retrieves correlation map from osiv data file

SYNOPSIS 

osiv_getmap -f frame -w window [-o output] [-p format] file

DESCRIPTION 

osiv_getmap is a program for extracting a correlation map from an osiv data file. If the file is "-", data will be read from stdin. However, since osiv_getmap requires random access to the file this is rarely useful. Similarly, if the output file is omitted or set to "-", data will be written to stdout.

OPTIONS 

-o - output file
This is a text file whose format is specified by the "-p" option.
-f - frame number
The frame number is specified as in the original osiv call.
-w - window number
The window number is given in "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 - print format
osiv_getmap traverses through the map making a call to printf() for every element. The x displacement is specified with `%u', the y displacement with `%v', and the correlation value with `%e'. The default is `%.0u %.0v %+.4e\n'.

SEE ALSO 

osiv(1), osiv_getargs(1), osiv_getvects(1), osiv_draw(1), osiv_mkwsd(1), readovd(1).

BUGS 

Let me know, my email address is jamesas@uclink.berkeley.edu.

COPYRIGHT NOTICE 

Copyright © 2002 James Strother.