atsys33_README ============= This file provides a description of each of the files available to users who wish to retrieve the USGS, National Mapping Division, Interactive Aerotriangulation System software for their own use. REFERENCE Although this program has been used by the U.S. Geological Survey, no warranty, expressed or implied, is made by the USGS as to the accuracy and functioning of the program and related program material nor shall the fact of distribution constitute any such warranty, and no responsibility is assumed by the USGS in connection herewith. DISCLAIMER The U.S. Geological Survey (USGS) software programs for the National Mapping Division's Interactive Aerotriangulation System are currently under development. No support for this software or documentation will be provided by the USGS beyond validating that the current release of the software and system documentation have been made available. Receipt of the software indicates acknowledgement and acceptance of this fact. Division AT System 3.3, Characteristics of Revision Modifications to the AT system were required to support image coordinate refinement (ICR) employing K and P camera correction coefficients. The K and P correction coefficients result from a rigorous camera calibration technique used by the Division known as the Simultaneous Multicamera Analytical Calibration (SMAC). File Descriptions: ================== 1) AT_SYS33-patch.tar This tar file contains the following revised AT system programs: o AT_RUN - this is the AT system user interface executable. Changes were made which enable AT_RUN to read and properly format camera K and P correction coefficients for input to the AT system's image coordinate refinement programs. o MC6 and ICR_AST - these programs perform the AT system's image coordinate refinement functions. Both programs were modified to perform image coordinate refinement using camera correction data formatted in either the traditional CAMUSGS camera calibration format (which include radial lens distortion correction values at 1-mm intervals along the camera lens axis), or the new CAMSMAC K and P correction format. 2) CAMDAT20-patch.tar - this AT system Oracle application was modified to search and retrieve camera calibration information stored in either the conventional CAMUSGS format or the new CAMSMAC format. The SMAC method of calibrating cameras began in early 1991, therefore, project cameras calibrated prior to 1991 will not have K and P correction values. For these cameras, CAMDAT will retrieve the conventional calibration data, which will continue to reside in the existing Oracle tables, and generated the standard .c2i file. For cameras calibrated after 1991, CAMDAT will retrieve the camera calibration data based on K and P correction coefficients and generate a .k2i file for input to the AT system's ICR programs. The modified CAMDAT files are: camdat - shell script that runs CAMDAT menu program. c_smacinstall - loads camera calibration data from the camsmac.dta file into Oracle tables. script.sql - builds Oracle tables which store camera K and P correction coefficients. CAM_MENU.dmm - executable for CAMDAT menu program. Calls CAMDAT forms program. camdat.frm - executable for CAMDAT forms. cam - builds and formats the .k2i, c2i, and .dmp used in image coordinate refinement. Note, the following two steps must be completed before running the new version of CAMDAT for the first time: 1. The script.sql program needs to be executed. This program builds the two new Oracle tables which function to hold the K and P coefficients used during image coordinate refinement. 2. The most recent release of the camsmac.dta file, distributed by the Division's Optics Lab, will need to be loaded into CAMDAT using the new program c_smacinstall. File format information: ======================== All files were created using the UNIX tar command. To unpack the files, use tar with the "xvof" options. x - extract files v - verbose (file names will echo to screen as they are unpacked) o - the group and owner permissions will be set to the user extracting the files f - file option - causes tar to unpack a file, instead of using a device such as /dev/rmt/0 example: tar xvof .tar The AT system programs contained in the AT_SYS33-patch.tar file should be copied into your existing /at_sys directory. The files contained in the CAMDAT20-patch.tar file should be copied into your existing /at_sys/camdat directory, with the exception of c_smacinstall, which should reside in the /at_sys/camdat/sys directory. NOTE concerning future releases of the AT System: ================================================== Since the USGS cannot provide support for the AT system, there is no mechanism for publicizing new releases of the software. Users are encouraged to recheck the ftp anonymous drop site periodically as new releases will be placed there as they are available. address: ftpmcmc.er.usgs.gov Login: anonymous Psswd: *****---------------------------------***** Although no support to external users is extended, comments, bug reporting, and suggestions may be addressed to: Louis Driber U. S. Geological Survey National Mapping Division, MS 504 1400 Independence Rd. Rolla, MO 65401 Phone: (573) 308-3771 Internet E-Mail: ldriber@usgs.gov April 28, 1997