User's Guide

CATFILE

Concatenates up to one hundred IBIS tabular files to produce a new IBIS tabular file

Function:

Concatenates up to one hundred image based information systems (IBIS) tabular files to produce a new IBIS tabular file. The files are combined by placing each input file after the previous file. Therefore, the number of columns in each input file must be the same.

Parameters:

INFILE
Input files. The input IBIS tabular files.

OUTFILE
Output file. The output IBIS tabular file created by concatenating the specified input tabular files. The number of columns in OUTFILE is the same as in the input files. The number of rows in OUTFILE is determined by adding together the number of rows in each input file.

Example:

  1. LAS> catfile infile = (a b c) outfile=concat

    The input files A, B, and C are concatenated to produce the output IBIS tabular file CONCAT.

Description/Algorithm:

The program begins with the standard initialization and retrieval of user-specified parameters. The input and output IBIS tabular files are opened. Corresponding columns from the input tabular files are transferred to the same column of the output tabular file in such a manner that the first entry from each tabular file directly follows the last entry from the previous tabular file.

Nonfatal Error Message:

  1. [catfile-close] Error closing <XXXXX> file

    An error was encountered closing <XXXXX> file. The data may still be valid.

Fatal Error Messages:

  1. [catfile-fatal] Fatal error encountered

    A fatal error was encountered during processing. The output IBIS tabular file may or may not be valid. The message that is displayed immediately preceding this message is the specific error that was encountered.

  2. [catfile-ncols] The number of columns in each input file are not equal. Input file n has x columns The first input file has y columns

    The input files do not have the same number of columns. The specified input file was the first one found that differs.

  3. [catfile-open] Error opening <XXX> file

    An error was encountered while trying to open the specified IBIS tabular file.

  4. [catfile-read] Error reading input file n

    An error was encountered while trying to read from the specified input IBIS tabular file.

  5. [catfile-rows] Output file would have x number of rows This exceeds the limit of 32767 rows

    The maximum number of rows allowed in an IBIS tabular file would be exceeded if the input files were concatenated.

  6. [catfile-write] Error writing output file

    An error was encountered while trying to write to the output IBIS tabular file.

User Note:

  1. The number of columns in each input IBIS tabular file must be the same.