User's Guide

QREP

Reads an IBIS file and prints the data to the device(s) specified.

Function:

Reads an image based information system (IBIS) file--graphics or tabular--and prints the data to the device(s) specified.

Parameters:

Subcommand -GRAPHICS:
Reads an IBIS graphics file and prints the data to the device(s) specified.

INFILE
Input file. The input file is an IBIS graphics file which contains data values.

PRINT(TERM)
Output destination.


  = TERM:  Terminal.  Output is sent to the user's 
           terminal.
  = LP:    Line printer.  Output is sent to the 
           printer defined by $PRINTER.
  = file:  User-supplied filename.  Output is sent to
           a disk file.
Subcommand -TABULAR:
Reads an IBIS tabular file and prints the data to the device(s) specified.

INFILE
Input file. The input file is an IBIS tabular file.

FILEFORM(GEO)
File format. The format of the IBIS tabular file.


  = GEO:  Geometric format.  This is an IBIS tabular 
          file which contains the following columns 
          in this order.

     Column   Description                    Title
     ______   ___________                    _____

      1-      From frame number	             From Frm  
      2-      To frame number	             To Frm
      3-      Point number	  	     Point #
      4-      Active flag		     Act Flag  
      5-      Input line		     In Line  
      6-      Input sample	  	     In Samp
      7-      To frame line	  	     To Line
      8-      To frame sample	             To Samp
      9-      Mosaic space line	             Mos Line  
     10-      Mosaic space sample	     Mos Samp
     11-      Transform space line           Xfr Line
     12-      Transform space sample	     Xfr Samp  
     13-      BLANK		  	
     14-      Corr. threshold 	             Corr Thr  
     15-      From frame Z	  	     From Z
     16-      To frame Z		     To Z
     17-      Delta Z		             Delta Z
     18-      BLANK
     19-      Frame to frame line residual   Flineres
     20-      Frame to fr. sample residual   Fsampres
     21-      IBIS constant		     Constant
     22-      Mosaic to frame line residual  Mlineres
     23-      Mosaic to fr. sample residual  Msampres
     24-      Unique point number	     U Pt #
     25-      BLANK
     26-      BLANK
     27-      BLANK
     28-      Average mosaic space line	     Ave Line
     29-      Average mosaic space sample    Ave Samp
     30-      BLANK

  = RAD:  Radiometric format.  This is an IBIS tabular
          file which contains the following columns 
          in this order.

     Column   Description	             Title
     ______   ___________                    _____

      1-      From frame number	  	     From Frm
      2-      To frame number	  	     To Frm	
      3-      Point number	  	     Point #
      4-      Active flag		     Act Flag
      5-      From frame line	  	     In Line
      6-      From frame sample	  	     In Samp
      7-      Mosaic space line	  	     Mos Line
      8-      Mosaic space sample	     Mos Samp
      9-      To frame line	  	     To Line
     10-      To frame sample	  	     To Samp
     11-      Fr frame Z(original)  	     F Orig Z
     12-      To frame Z(original)  	     T Orig Z
     13-      Delta Z(original)	  	     Odelta Z
     14-      Line off(original)	     Line Off
     15-      Sample off(original)  	     Samp Off
     16-      Minimum delta Z(original)	     O Min Z
     17-      Maximum delta Z(original)	     O Max Z
     18-      Mean delta Z(original)	     O Mean Z
     19-      From frame Z(mean image)	     F Mean Z
     20-      To frame Z(mean image)	     T Mean Z
     21-      Delta Z(mean image)	     Mdelta Z
     22-      Minimum delta Z(mean image)    M Min Z
     23-      Maximum delta Z(mean image)    M Max Z
     24-      Mean delta Z(mean image)	     M Mean Z
     25-      BLANK
     26-      BLANK
     27-      BLANK
     28-      BLANK
     29-      BLANK
     30-      BLANK

  = TAB:  Tabular format.  This is an IBIS tabular
          file which is not in a standard order.

COLNUM(--)
Column numbers. The columns that are used to create the output. If null, all the columns are read and written to the device specified.

SROW(1)
Starting row. This is the starting row of data which is read and printed to the device(s) specified.

NROWS(--)
Number of rows. This is the number of rows of data which are read and printed to the device(s) specified. If null, all the rows are read and written to the device specified.

OUTFORM("8(1X,F8.2)
Output format. This is a FORTRAN format statement which is used to specify how the output will be formatted. All the data in an IBIS tabular file is stored as REAL*4 data; and therefore, the output data format must use an edit descriptor that can handle REAL*4 data. Refer to the FORTRAN manual of your system for a list of valid edit descriptors.

TEXT(--)
Column titles. The heading that each column has in the output. This parameter is only needed when TAB is specified in the FILEFORM parameter. If null, no headings are written to the output. The titles are limited to ten characters each.

PRINT(TERM)
Output destination.


  = TERM:  Terminal.  Output is sent to the user's 
           terminal.
  = LP:    Line printer.  Output is sent to the 
           printer defined by $PRINTER.
  = file:  User-supplied filename.  Output is sent to
           a disk file.

Examples:

  1. LAS> qrep-grapics infile=in.dat print=term

    IN.DAT, which is in a graphics format, is read and printed to the terminal.

  2. LAS> qrep-tabular infile=in.dat colnum=(1,3,5,7,8) outform="(5f11.4)" print=(term,lp)

    IN.DAT, which is in a geometric tabular format, is read starting at the first row. All the rows and columns 1, 3, 5, 7, 8 are read and written to the terminal and the line printer specified by $PRINTER.

    OUTFORM will create five columns of data per line with a precision of five places to the left of the decimal point and four places to the right of the decimal point as indicated by the following information:

    Column        1          2          3          4          5
    Heading   From Frm   Point #    In Line    To Line    To Samp
    Format      F11.4      F11.4      F11.4      F11.4      F11.4
    Example   12345.1234 12345.1234 12345.1234 12345.1234 12345.1234
    

  3. LAS> qrep-tabular infile=in.dat fileform=tab colnum=(1,2,3,4,9) srow=5 nrows=10 text=("from frame","to frame n", "delta z","meandeltaz","point numb") outform="(2x,f8.2,1x,f4.0,1x,f8.2,1x,f10.4,1x,f5.0)" print=file

    IN.DAT, which is in a tabular format, is read starting at row 5. Ten rows and columns 1, 2, 3, 4, 9 are read and written to a disk file named QREP.PRT. OUTFORM will create an output of five columns as indicated by the following information.

            Column	    1        2       3        4       5
            Heading   From Fra To F Delta Z  MeanDeltaZ Point
            Format  2X   F8.2 XF4.0X   F8.2 X  F10.4   X F5.0
            Example    1234.12 1234  1234.12  1234.1234 12345
    

Description/Algorithms:

Subcommand -GRAPHICS:

After reading the input parameters, INFILE is opened and the data is read. This data is then printed to the device specified in PRINT. After all the data is printed, all the files are closed and the completion message is displayed.

Subcommand -TABULAR:

After reading the input parameters, INFILE is opened and the columns specified are read in one row at a time starting at SROW. These columns are then printed to the device specified in PRINT. After NROW rows are printed, all the files are closed and the completion message is displayed.

Nonfatal Error Message:

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

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

Fatal Error Messages:

  1. [qrep-fatal] Fatal error encountered

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

  2. [qrep-open] Cannot open <XXXXXX> file

    The <XXXXXX> file could not be opened and processing is terminated. Verify that the <XXXXXX> file exists.

  3. [qrep-read] Error reading <XXXXXX> file

    The <XXXXXX> file could not be read; and therefore, an output file cannot be created. Verify that the format of the file is correct.

User Notes:

  1. Output lines that are longer than 80 characters wrap around to the next line of the screen.

  2. Titles are truncated to be only as long as the OUTFORM parameter allows for that particular column.
  3. Note: each line is limited to 8 characters. If the column is 8 characters long there is no space between columns, it makd hard to recognize the values.