DATAMANIP commands
PROGRAM NAME
kasc2mask - Import ASCII Data File to Mask 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
mask 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, -dindex,
-tindex and -eindex 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: width size must be > 0
default: 1
bounds: value > 0
- -windex
-
type: list
desc: position in the index order for the width dimension
default: 1 "First"
- -hsize
-
type: integer
desc: height size must be > 0
default: 1
bounds: value > 0
- -hindex
-
type: list
desc: position in the index order for the height dimension
default: 2 "Second"
- -dsize
-
type: integer
desc: depth size must be > 0
default: 1
bounds: value > 0
- -dindex
-
type: list
desc: position in the index order for the depth dimension
default: 3 "Third"
- -tsize
-
type: integer
desc: time size must be > 0
default: 1
bounds: value > 0
- -tindex
-
type: list
desc: position in the index order for the time dimension
default: 4 "Fourth"
- -esize
-
type: integer
desc: elements size must be > 0
default: 1
bounds: value > 0
- -eindex
-
type: list
desc: position in the index order for the elements dimension
default: 5 "Fifth"
- -type
-
type: list
desc: data type
default: 11 "Double"
EXAMPLES
SEE ALSO
kasc2val, kasc2loc, kasc2time, kasc2map, kimportasc
RESTRICTIONS
REFERENCES
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.