User's Guide

DOQTIFIN

Import digital orthophoto quadrangle (DOQ) images in .tif format

Function:

DOQTIFIN imports a digital orthophoto quadrangle (DOQ) file in the .tif format available from the PA Spatial Data Access (PASDA) Web site as of June, 2000. The PASDA .tif files appear to contain pixel dimensions and upper-left corner coordinates but no other useful georeferencing or projection data. The program assumes that the files are in the UTM projection using the WGS84 datum. The program user must enter the UTM zone explicitly.

Parameters:

INTIF
Name of input DOQ file. This must be in the TIFF format distributed in the PASDA .zip archives. The file extension must be included in the filename.

OUT
Name of output LAS image.

ZONE
UTM zone number. The zone number may be calculated from the latitude at the center of the DOQ using the relation: zone = (186 + lat) / 6, where a fractional result is truncated to the next lower integer and latitudes west of Greenwich have negative values. For example, 75.0 degrees west latitude is written as -75.0, so the calculation yields a value of 18.5, which is truncated to zone 18.

Example:

  1. LAS> doqtifin intif=austin_pa_ne.tif out=austin_ne zone=17

    This command imports the PASDA .tif file for the Austin, PA quadrangle, northeast corner, into LAS. The center of this DOQ is at 78.03 degrees west latitude, which places it in UTM zone 17.

Description/Algorithm:

DOQTIFIN begins by extracting the header information from the input .tif file to determine the image size, pixel dimensions, and coordinates of the upper left corner. The program then reads one line at a time from the input and writes it to the output LAS image. When all lines have been processed, the UTM projection and WGS84 datum codes are inserted into the DDR, and the projection coordinates at the other three image corners are computed from the upper-left-corner coordinates.

Nonfatal Error Messages:

    None.

Fatal Error Messages:

  1. [doqtifin-fatal] Fatal error encountered

    A fatal error occurred during processing. The nature of the error is given by the preceding message(s).

  2. [doqtifin-badarg] Error getting argument from TAE interface

    An error occurred while retrieving program arguments. This is probably a software error -- please notify the LAS system manager.

  3. [doqtifin-openin] Error opening input file

    The program was unable to open the input file. Check that the directory and file specified by argument INTIF exist and that read permission is set.

  4. [doqtifin-notbyte] Cannot handle XXX-bit data

    The input file header indicates that the image data size is not 8 bits. The program can only handle 8-bit data.

  5. [doqtifin-nl] Error retrieving number of lines [doqtifin-ns] Error retrieving number of sample per line [doqtifin-nb] Error checking number of bands

    The number of lines, samples per lines, or bands could not be determined from the file header. The file may have become corrupted.

  6. [doqtifin-bands] Input has more than one band

    The input file header indicates that it contains more than one band. DOQTIFIN assumes that the DOQ images are black and white, with only a single band; multi-band images cannot be processed.

  7. [doqtifin-tiled] Cannot process tiled iamge

    The input file header indicates that the image is broken into rectangular tiles. DOQTIFIN cannot process these. If it appears that standard USGS DOQs are being distributed in tiled format, please notify the LAS system manager.

  8. [doqtifin-psize] Pixel size is missing [doqtifin-corn] Corner coordinates missing

    The input file header appears to be missing pixel size (width) or upper-left-corner projection coordinates. The file may have become corrupted.

  9. [doqtifin-read] Error reading input line XXX

    An error occurred while reading the specified line of the image from the input file. The file may have become corrupted.

  10. [doqtifin-write] Error writing output line XXX

    An error occurred while writing the specified output line. Check that there is sufficient free space on the disk or file system.

  11. [doqtifin-noupddr] Unable to update DDR

    An error occurred while trying to insert projection or georeferencing information into the LAS image data descriptor record. The output image data should be usable.

User Notes:

    None.