User's Guide

MTBGEN

Generates an IBIS tabular file

Function:

Generates an image based information system (IBIS) tabular file. Writes data values entered by the user or data values of zero to an IBIS tabular file.

Parameters:

Subcommand -ZEROS:
Writes data values of zero to an IBIS tabular file.

OUTFILE
Output file. Output IBIS tabular file.

NROWS
Number of rows. The number of rows to be created in the output tabular file.

NCOLS
Number of columns. The number of columns to be created in the output tabular file.
Subcommand -DATA:
Writes data values entered by user to an IBIS tabular file.

OUTFILE
Output file. Output IBIS tabular file.

NROWS
Number of rows. The number of rows to be created in the output tabular file.

NCOLS
Number of columns. The number of columns to be created in the output tabular file.

OUTCOL
Output columns. The destination columns which will receive data in the output tabular file. Columns not specified are filled with zeros. The first column specified in OUTCOL will receive the data entered in IDVALS1 and so on.

IDVALS1
Input data values. The values to be written to the output tabular file. The values entered in IDVALS1 are output to the first column number specified in OUTCOL.

If the number of values entered in IDVALS1 is less than the number of rows in the output file, the remainder of the column is filled with zeros. It is a fatal error if the number of values entered in IDVALS1 is greater than the number of rows in the output file.

IDVALS2(--)
Input data values. The values to be written to the output tabular file. The values entered in IDVALS2 are output to the second column number specified in OUTCOL.

If the number of values entered in IDVALS2 is less than the number of rows in the output file, the remainder of the column is filled with zeros. It is a fatal error if the number of values entered in IDVALS2 is greater than the number of rows in the output file.

IDVALS3(--)
Input data values. The values to be written to the output tabular file. The values entered in IDVALS3 are output to the third column number specified in OUTCOL.

If the number of values entered in IDVALS3 is less than the number of rows in the output file, the remainder of the column is filled with zeros. It is a fatal error if the number of values entered in IDVALS3 is greater than the number of rows in the output file.

IDVALS4(--)
Input data values. The values to be written to the output tabular file. The values entered in IDVALS4 are output to the forth column number specified in OUTCOL.

If the number of values entered in IDVALS4 is less than the number of rows in the output file, the remainder of the column is filled with zeros. It is a fatal error if the number of values entered in IDVALS4 is greater than the number of rows in the output file.

IDVALS5(--)
Input data values. The values to be written to the output tabular file. The values entered in IDVALS5 are output to the fifth column number specified in OUTCOL.

If the number of values entered in IDVALS5 is less than the number of rows in the output file, the remainder of the column is filled with zeros. It is a fatal error if the number of values entered in IDVALS5 is greater than the number of rows in the output file.

IDVALS6(--)
Input data values. The values to be written to the output tabular file. The values entered in IDVALS6 are output to the sixth column number specified in OUTCOL.

If the number of values entered in IDVALS6 is less than the number of rows in the output file, the remainder of the column is filled with zeros. It is a fatal error if the number of values entered in IDVALS6 is greater than the number of rows in the output file.

IDVALS7(--)
Input data values. The values to be written to the output tabular file. The values entered in IDVALS7 are output to the seventh column number specified in OUTCOL.

If the number of values entered in IDVALS7 is less than the number of rows in the output file, the remainder of the column is filled with zeros. It is a fatal error if the number of values entered in IDVALS7 is greater than the number of rows in the output file.

IDVALS8(--)
Input data values. The values to be written to the output tabular file. The values entered in IDVALS8 are output to the eighth column number specified in OUTCOL.

If the number of values entered in IDVALS8 is less than the number of rows in the output file, the remainder of the column is filled with zeros. It is a fatal error if the number of values entered in IDVALS8 is greater than the number of rows in the output file.

IDVALS9(--)
Input data values. The values to be written to the output tabular file. The values entered in IDVALS9 are output to the ninth column number specified in OUTCOL.

If the number of values entered in IDVALS9 is less than the number of rows in the output file, the remainder of the column is filled with zeros. It is a fatal error if the number of values entered in IDVALS9 is greater than the number of rows in the output file.

IDVALS10(--)
Input data values. The values to be written to the output tabular file. The values entered in IDVALS10 are output to the tenth column number specified in OUTCOL.

If the number of values entered in IDVALS10 is less than the number of rows in the output file, the remainder of the column is filled with zeros. It is a fatal error if the number of values entered in IDVALS10 is greater than the number of rows in the output file.

Examples:

  1. LAS> mtbgen-zeros outfile=temp nrows=8 ncols=15

    The output tabular file TEMP is created with all zero values. There are eight rows and fifteen columns in TEMP.

  2. LAS> mtbgen-data outfile=temp nrows=5 ncols=4 outcol=(1,3) idvals1=(1,2,3,4,5) idvals2=(1.5, 2.2, 1.0, 2.4)

    The following tabular file would be created using the parameters for Example 2.

    			        TEMP
    	     		----------------------
    	 		| 1.0  0.0  1.5  0.0 |
    			| 2.0  0.0  2.2  0.0 |
    			| 3.0  0.0  1.0  0.0 |
    		  	| 4.0  0.0  2.4  0.0 |
    			| 5.0  0.0  0.0  0.0 |
    		        ----------------------
    

Description/Algorithm:

The program begins with the standard initialization and retrieval of user-specified parameters. The output IBIS tabular file is opened and the indicated values are written to it.

Nonfatal Error Messages:

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

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

  2. [mtbgen-extra] Extra values entered in IDVALS n. These values are not processed

    The user entered values into more IDVALS parameters than was specified by OUTCOL. The specified IDVALS parameter is ignored.

Fatal Error Messages:

  1. [mtbgen-data] Missing IDVALS specification

    Not enough IDVALS parameters were specified. The number of columns entered in OUTCOL and the number of IDVALS parameters specified should match.

  2. [mtbgen-excess] Too many values entered in IDVALS n

    The number of values entered in the indicated IDVALS parameter was larger than the number of rows in the output tabular file.

  3. [mtbgen-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.

  4. [mtbgen-open] Error opening output file

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

  5. [mtbgen-outcol] OUTCOL column specification exceeds NCOLS

    A column number was entered in OUTCOL that is larger than the number of columns in the output tabular file.

  6. [mtbgen-write] Error writing output file

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

User Note:

  1. If the user enters values into more IDVALS parameters than the number of columns entered in the OUTCOL parameter, the extra ones are ignored. For example, if the user specified that OUTCOL=(1,2) IDVALS1=(1,2,3) IDVALS2=(4,5,6) and IDVALS3=(7,8,9), the values in IDVALS3 are not referenced.