ARRREAD

Description

ARRREAD reads an array of numbers that are stored in a text file and writes the data to an array segment (type 181).

Parameters

Name	Type	Caption	Length	Value range
TFILE *	String	Text file name	1 - 192
FILE *	String	Output file name	1 - 192
ARRSEG	Integer	Array segment	0 - 1
DBSN	String	Array segment name	0 - 8	Default: ARRREAD
DBSD	String	Array segment description	0 - 64

* Required parameter

Parameter descriptions

TFILE

Specifies the name of the text file from which the data values are read.

FILE

Specifies the PCIDSK image file to receive the values that are stored in the text file. This file already exists and is not created by ARRREAD.

ARRSEG

Optionally specifies the array segment (type 181) to receive the data. If an array segment is not specified, a new one is created.

DBSN

Specifies a name (up to 8 characters) for the output array segment or layer.

DBSD

Describes (in up to 64 characters) the contents or origins of the output array segment or layer.

Details

ARRREAD reads an array of numbers from a text file and writes them to an array segment in a PCIDSK file.

If the default array segment (ARRSEG) is used, a new array segment is created to receive the data.

A segment name and description can be specified if a new segment will be created. If the default is used, the segment name is "ARRREAD" and the segment description is blank.

Example

Read an array of numbers from the text file TEST.TXT and write it to a new array segment in TEST.PIX.

The text file, TEST.TXT, has the following data values:

 1.0
 2.0
 3.0

EASI>TFILE  = "TEST.TXT"
EASI>FILE   = "TEST.PIX"
EASI>ARRSEG =                  ! Default, create the array segment
EASI>DBSN   =                  ! Default, segment name is "ARRREAD"
EASI>DBSD   =                  ! Default, segment description is " "
EASI>RUN ARRREAD

Environments	PYTHON :: EASI :: MODELER
Quick links	Description :: Parameters :: Parameter descriptions :: Details :: Example :: Related