vpr − print the contents of a VisionX file

vpr [if=infile] [of=ofile] [n=<value>] [-p] [-n] [-i] [-ii] [-if] [-imi] [-imf] [-t]

vpr prints a VisionX file to the screen. In general it is a good idea to pipe the output through a pager. Vpr can also be used to create certain types of VisionX files from ascii data.

vpr may be used to convert VisionX files to a character format (use the -n option to be sure of retaining all information). The character format is a convenient unambiguous format which is useful for transferring data between different computer architectures. This format also makes possible simple editing of VisionX files with a text editor. The character file may be converted back to VisionX form by specifying the "-i" (inverse) option to vpr.

In addition to creating VisionX files from the textual output described above, using the "-i" option, vpr has the ability to create VisionX vector files from ascii data. The "-ii" and "-if" options convert a whitespace-delimited ASCII file into a single vector of type Generic(int) or Generic(float), respectively. Similarly, a rectangular matrix (a sequence of identical-length vectors) may be created from an ASCII file (one vector per line) using the "-imi" and "-imf" options, for int and float data, respectively.

A final utility function is provided by the "-t" option, which will print a list of all currently defined VisionX datatypes. The input file specification is ignored in this case.

n=value

Specify the maximum number of each data item to print. If the value is exceeded no data is printed. The default value is 100.

-p

Show packed elements as they are. Do not unpack their contents which is the default.

-n

Print all data items regardless of length.

-i

perform the inverse function. That is covert a character file in vpr format to a conventional VisionX file Any file generated with "vpr -n" command can be converted back to VisionX form.

-ii

convert a file containing just numeric values to a VisionX file that contains a single VX_GINT vector of these values. Blank lines and lines beginning with # are ignored. This provides a simple method for encoding numeric data into a VisionX file.

-if

This option is similar to -ii above except that a single VX_GFLOAT vector is generated.

-imi

convert a file containing just numeric values to a VisionX file that contains a matrix represented by multiple VX_GINT vectors. One vector is generated for each input line and each line must have the same number of columns. Blank lines and lines beginning with # are ignored.

-imf

This option is similar to -imi above except that multiple VX_GFLOAT vectors are generated.

-t

Print out the names and values of all VisionX element types currently defined and exit.

vls(1), vps(1), vrawtovx(1)

A. P. Reeves and W. J. Kostis