User's Guide

IBIS2GBL

Retrieves values from IBIS file which are used to set TAE globals and to create a global parameter file.

Function:

Retrieves particular values specified by the row and column index from an IBIS tabular file and sets the indicated TAE globals with the appropriate values. The current values of the TAE globals $OFFL, $OFFS, $XNL, $XNS, and $MEANZ are also saved in a global parameter file so that, if necessary, they can be restored in a later session.

Parameters:

INFILE
Input file. The input file is an IBIS tabular file. This file should contain data for the frame number specified in the FRAMNUM parameter.

FRAMNUM(1)
Frame number. The frame number is used as the index for the global variable arrays.

PARFILE
Parameter file. The current values of the TAE globals $OFFL, $OFFS, $XNL, $XNS, and $MEANZ are saved in this file so that they can be restored later on by running the program SETGBLS. Note that if the specified file already existed on disk, its contents will be overwritten with the current values of these globals.

PARNAME($OFFL,$OFFS,$XNL,$XNS)
Parameter names. The name of the TAE global variables(s) to be set. These globals are multi-dimensioned arrays.


  = $OFFL:  Offset line number
  = $OFFS:  Offset sample number
  = $XNL:   Number of lines in transformed image
  = $XNS:   Number of samples in transformed image
  = $MEANZ: Mean Delta Z

ROWNUM(1,1,1,1)
Row numbers. The row numbers used to locate the values in the IBIS tabular file. The PARNAME, ROWNUM, and COLNUM parameters work together. The first value in ROWNUM and the first value in COLNUM are used to locate the value that is used to set the global that was entered first in PARNAME and so on.

COLNUM(4,5,8,9)
Column numbers. The column numbers used to locate the values in the IBIS tabular file. The PARNAME, ROWNUM, and COLNUM parameters work together. The first value in ROWNUM and the first value in COLNUM are used to locate the value that is used to set the global that was entered first in PARNAME and so on.

Examples:

  1. LAS> ibis2gbl infile=in framnum=12 parfile=gbls parname=$meanz rownum=1 colnum=18

    The value from row 1, column 18 in IN;IBIS.TAB is used to update the TAE global variable $MEANZ(12). The values of $OFFL, $OFFS, $XNL, $XNS, and $MEANZ are then saved in the file GBLS;TXT.

  2. LAS> ibis2gbl infile=in framnum=5 parfile=gbls parname=("$offl","$offs") rownum=(1,1) colnum=(4,5)

    The value from row 1, column 4 in IN;IBIS.TAB is used to update the TAE global variable $OFFL(5), while the value in row 1, column 5 is used to update $OFFS(5). The values of $OFFL, $OFFS, $XNL, $XNS, and $MEANZ are then saved in the file GBLS;TXT.

Description/Algorithm:

The program begins by getting the user-specified parameters and the current values of the TAE globals $OFFL, $OFFS, $XNL, $XNS, and $MEANZ. The existence of the input IBIS tabular file is checked. This file is then opened and the necessary values are retrieved from the specified locations. The values in the IBIS file are REAL*4; however, they are rounded to the nearest integer so that the indicated INTEGER*4 globals can be updated with the appropriate value. The current values of the TAE globals $OFFL, $OFFS, $XNL, $XNS, and $MEANZ are then saved in the file specified by the PARFILE parameter.

Nonfatal Error Message:

  1. [ibis2gbl-close] Error closing input file

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

Fatal Error Messages:

  1. [ibis2gbl-column] There is no column <XXX> in the IBIS file [ibis2gbl-column] The total number of columns is <XXX>

    A column location was specified in COLNUM that is not in the IBIS tabular file.

  2. [ibis2gbl-fatal] Fatal error encountered

    A fatal error was encountered during processing. The values of the globals are not changed. The global parameter file is not valid. The description of the error encountered should be given in the preceding message.

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

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

  4. [ibis2gbl-read] Error reading input file

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

  5. [ibis2gbl-row] There is no row <XXX> in the IBIS file [ibis2gbl-row] The total number of rows is <XXX>

    A row location was specified in ROWNUM that is not in the IBIS tabular file.

  6. [ibis2gbl-unequal] The number of values specified for the ROWNUM, COLNUM and PARNAME parameters are not equal

    The ROWNUM, COLNUM, and PARNAME parameters work together, and the same number of values must be entered for each one.

User Notes:

  1. The global parameter file created by IBIS2GBL is an ASCII file containing the current values of the TAE globals $OFFL, $OFFS, $XNL, $XNS, and $MEANZ. So, if the user changes any of the values of these globals in any way other than by running IBIS2GBL (for example, with the TCL "LET" command) and then later in the same TAE session runs IBIS2GBL to change another global, the parameter file created would have both changes. However, if the user changed a value with "LET" but did not run IBIS2GBL before exiting the TAE session, the parameter file would not be changed.

  2. Related program is SETGBLS.