DATAMANIP commands


PROGRAM NAME

kasc2map - Import ASCII Data File to Map Segment

DESCRIPTION

This routine will import an ASCII data file and insert it into a data object if it is specified. If there is no source object to insert the new segment into, the data object specified as the output file will be created. The new segment will be inserted into this data object in the map segment. If a source object was specified, then all of its data segments and the global object attributes will be copied to the destination.

The index order is specified by setting the -windex, -hindex, -eindex, -tindex and -dindex flags. They can not be set to the same value.

The start offset is the point to start importing in the ASCII data. All points before this one are ignored.

The skip factor is the number of points to skip in the ASCII data between reads. If the size of the new segment's lowest index is 40 and the skip factor is 5, then this routine will read in 40 points skip 5 and read in 40 more, etc. until the entire ASCII file read in.

Complex values in ASCII are represented by number pairs, surrounded by parenthesis and separated by a comma. For example, (8, 3) represents the complex number 8+3i.

REQUIRED ARGUMENTS

-i1
type: infile
desc: ASCII input data file containing new data segment
-o
type: outfile
desc: output data object

OPTIONAL ARGUMENTS

-i2
type: infile
desc: data object input to insert the new segment into
default: {none}
-so
type: integer
desc: starting point in ASCII file to start importing at
default: 0
bounds: value >= 0
-sf
type: integer
desc: number of points in ASCII file to skip between reads
default: 0
bounds: value >= 0
-wsize
type: integer
desc: map width size must be > 0
default: 1
bounds: value > 0
-windex
type: list
desc: position in the index order for the map width dimension
default: 1 "First"
-hsize
type: integer
desc: map height size must be > 0
default: 1
bounds: value > 0
-hindex
type: list
desc: position in the index order for the map height dimension
default: 2 "Second"
-dsize
type: integer
desc: map depth size must be > 0
default: 1
bounds: value > 0
-dindex
type: list
desc: position in the index order for the map depth dimension
default: 3 "Third"
-tsize
type: integer
desc: map time size must be > 0
default: 1
bounds: value > 0
-tindex
type: list
desc: position in the index order for the map time dimension
default: 4 "Fourth"
-esize
type: integer
desc: map elements size must be > 0
default: 1
bounds: value > 0
-eindex
type: list
desc: position in the index order for the map elements dimension
default: 5 "Fifth"
-type
type: list
desc: data type
default: 11 "Double"

EXAMPLES

SEE ALSO

kasc2val, kasc2loc, kasc2time, kasc2mask, kimportasc

RESTRICTIONS

REFERENCES

COPYRIGHT

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