DATAMANIP commands


PROGRAM NAME

kprdata - Print Data in Formatted ASCII

DESCRIPTION

kprdata prints the selected segments of data from the input object in ASCII format to a file or to the screen.

If the Print Attributes option (-att) is selected, all header and data information is printed before any data is printed. (These non-data lines begin with a #, which indicates that the line is a "comment".)

After the attribute lines, data fields selected by the user are formatted in the following order.

Implicit Indexing: Location Data: Time Data: Value Data: Mask Data.

This data can be followed by map data (if selected):

Map Indexing: Map Data.

This data can be followed by connectivity data.

When map data exists, selecting the "Map Value Data Through Map" option will cause the value data to be mapped through the map data before being presented.

The implicit indexing options, Print Implicit Indexing (-ind), and Print Map Indexing (-mind), if selected, will print the indices of the data. The index values index both the value data and explicit location and time data. For instance, in the following example, the index [0][0][0][1] points to the 3D location data [4][27][38], and the value of 104.5.

t d h w Location Value
0 0 0 1 4 27 38 104.5

The Replacement for Masked Values option (-replace) allows value data which has mask data associated with it, to be printed with the masked values replaced by the given string.

Complex data is printed as real/imaginary pairs (real, imaginary).

If data segments that do not exist in the input data object are selected, kprdata will return a warning message indicating that the segments do not exist. Information about other selected segments will be printed.

If the location grid is uniform or rectilinear and only the location data is being printed, then the location data will be printed in a manner consistent with the grid type. That is, a uniform grid implies that the location begin and end will be printed, and a rectilinear grid implies that the data for the width, height, and depth axes will be printed. When location data is printed with any other parts of the data model, it is presented as if it were curvilinear location data.

REQUIRED ARGUMENTS

-i
type: infile
desc: Input Data Object

OPTIONAL ARGUMENTS

-attr
type: flag
desc: Print Object Information & Attributes
-loc
type: flag
desc: Print Location Data
-time
type: flag
desc: Print Time Data
-val
type: flag
desc: Print Value Data
-mask
type: flag
desc: Print Mask Data
-ind
type: flag
desc: Print Implicit Indexing
-replace
type: string
desc: Replacement String for Masked Values
default: *
-f
type: outfile
desc: Resulting Output File
default: {none}

Mutually Exclusive Group; if desired, specify ONE of:

AT LEAST ONE OF the Group:

-mind
type: flag
desc: Print Implicit Map Indexing
AND/OR
-map
type: flag
desc: Print Map Data

-mval
type: flag
desc: Map Value Data Through Map

EXAMPLES

kprdata -i in_object -attr -val -ind
This command sequence will cause the attributes, followed by the value data, with indices, to be printed to stdout.

kprdata -i in_obj -map -mind -val -f out_file
This command sequence will print all of the value data, followed by the map data, with indices, to the file out_file.

SEE ALSO

RESTRICTIONS

REFERENCES

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.