******************************************************************************* * Text: Description of GetImage Version 1.1 Update * * * * File: * * getimg11.txt * * * * Description: * * This file describes update 1 to GetImage Version 1.0. * * * * History: * * Created : 01-JUN-94 by J. Doggett * * for the Association of Universities for Research in Astronomy, Inc. * * at the Space Telescope Science Institute, * * to facilitate the accessing of data from the CD-ROM set of the * * Digitized Sky Survey. * * Delivered : 30-NOV-94 by J. Doggett * * GetImage Version 1.1 * * * * Copyright (c) 1994, Association of Universities for Research in Astronomy, * * Inc. All Rights Reserved. * * Produced under National Aeronautics and Space Administration grant * * NAG W-2166. * ******************************************************************************* I. INTRODUCTION --------------- Two significant changes have been made to GetImage with the release of version 1.1. GetImage now manages better the mounting of CD-ROM discs under UNIX operating systems, and it may be driven from a special task within the Space Telescope Science Data Analysis System (STSDAS) called "getimage" under both OpenVMS and UNIX systems. In addition, several minor problems have been resolved. The major changes are described in the next section, along with a list of files modified with the current update. II. DESCRIPTION OF UPDATE 1 FOR GETIMAGE Version 1.0 ---------------------------------------------------- 1. ENHANCEMENTS --------------- The program ss_mount has been developed to handle the mounting of CD-ROM discs under UNIX operating systems. ss_mount may used with or without a volume manager such as "vold" under Solaris or "cdromd" under IRIX. In addition, if ss_mount is installed with uid set to root, non-privileged users may mount CD-ROM discs without a volume manager. See Appendix A in the file "install.unx" for more information about the ss_mount program. A command line option (-m/-M) has been added to GetImage for UNIX systems to override the mount point as specified by the environment variable DSS_MTPT. For example, the option "-m /cdrom" will instruct GetImage to mount CD-ROM discs at "/cdrom" in the file system. The -m/-M option was added to fulfill requirements of the STSDAS task "getimage" running under UNIX operating systems. The -m/M option does ***************************************************** n* Description of GetImage Version 1.1 Update page 2 * ***************************************************** not apply under OpenVMS, and is ignored by GetImage under OpenVMS. GetImage and the file "headers/lo_comp.lis" have been modified so that "headers/lo_comp.lis", as copied from the directory "HEADERS" on disc 102, will now be read correctly by GetImage on UNIX systems without requiring any modifications to "headers/lo_comp.lis". Do NOT attempt to fold "headers/lo_comp.lis" as described in the software installation notes which accompanied Part I of the Digitized Sky Survey. GetImage will not function properly if "headers/lo_comp.lis" is altered in any way. 2. BUG FIXES ------------ GetImage now correctly sets the extensions for the file identifiers of the compressed data files on the CD-ROM discs for the few UNIX systems that correctly interpret the file identifiers on the CD-ROM discs (ie, with upper case letters and trailing version numbers). The function "pltmodel" in the source file "astrmcal.c" now properly computes derivatives when applying Newton's method to invert the astrometric solutions. This was only a minor bug because the error in the incorrect code affected only the rate of convergence to the inversion solution, and not the actual solution. 3. OTHER MODIFICATIONS ---------------------- The ANSI C code of GetImage no longer misinterprets the return value of the function fprint for compilers whose fprint function does not conform to the ANSI C standard. 4. FILES UPDATED IN GETIMAGE VERSION 1.1 ---------------------------------------- Top directory: * build.unx (for UNIX systems only) * build.vms (for OpenVMS systems only) * buildmms.vms (for OpenVMS systems only) * getimage.unx (for UNIX systems only) * install.unx (for UNIX systems only) * install.vms (for UNIX systems only) * makefile.unx (for UNIX systems only) * osdepend.txt * readme.txt src subdirectory: * astrmcal.c * astronmy.c ***************************************************** * Description of GetImage Version 1.1 Update page 3 * ***************************************************** * config.h * extrctn.c * generic.c * getimage.c * header.c * header.h * image.c * lnkd_lst.c * plate.c Detailed descriptions of the modifications made to these files are given in Appendix A below. Note that other files were modified, but only with cosmetic changes. 5. FILES ADDED WITH GETIMAGE VERSION 1.1 ---------------------------------------- Top directory: * getimg11.txt (this file) src subdirectory: * ss_mount.c A. DESCRIPTION OF UPDATES TO FILES MODIFIED WITH GETIMAGE VERSION 1.1 --------------------------------------------------------------------- Top directory: build.unx - Modified to NOT copy the default C-Shell script "getimage.unx" over an existing file with the name "getimage". build.vms - Modified to NOT copy the default command procedure "GETIMAGE.VMS" to a new version of an existing file with the name "GETIMAGE.COM". buildmms.vms - Modified to NOT copy the default command procedure "GETIMAGE.VMS" to a new version of an existing file with the name "GETIMAGE.COM". getimage.unx - Modified to set the environment variables DSS_MNT and DSS_DMNT to use the ss_mount program. install.unx - Removed instructions for dealing with the ranlib command because the make file now takes care of that, ***************************************************** * Description of GetImage Version 1.1 Update page 4 * ***************************************************** - Modified to reflect the addition of the ss_mount program for use with GetImage, - Modified the instructions for copying the header files for Part II of the Digitized Sky Survey. install.vms - Modified the instructions for copying the header files for Part II of the Digitized Sky Survey. makefile.unx - Modified to function properly on the DEC OSF/1 Operating System, - Added target for making the ss_mount program, - Added target for making only GetImage without making ss_mount, - Now will always execute the ranlib command before linking if ranlib is in /usr/bin. osdepend.txt - Updated for the use of the ss_mount program. readme.txt - Added explanation of the addition of the ss_mount program, - Added description of new -m/-M option. src subdirectory: astrmcal.c - pltmodel: Corrected error in term [11] of the "Derivative of Y model wrt y". astronomy.c - Write_DMS: Took out error trap of fprintf statement to allow the non-ANSI standard ULTRIX C to work. config.h - Added definition of __VAX macro if VAX is defined, and made sure __VAX is not defined if VAX is not defined, - Added definition of USE_SSMOUNT macro for compiling GetImage with hooks for the ss_mount program. extrctn.c - Read_Extraction_Info: Modified to reflect change in the argument list of the function gethdr. generic.c - dtotal: Corrected declaration of local variable d to double from errant int. getimage.c ***************************************************** * Description of GetImage Version 1.1 Update page 5 * ***************************************************** - createUNIX_CDROMmountCommand: Modified to facilitate the use of the ss_mount program to handle the mounting of CD-ROM discs on UNIX systems, - Get_Cand_Plates_Extraction_Info: Modified to facilitate the use of the ss_mount program to handle the mounting of CD-ROM discs on UNIX systems, - Get_Disc_Error_Action: Modified to facilitate the use of the ss_mount program to handle the mounting of CD-ROM discs on UNIX systems, - Get_GetImage_Options: Added input of new -m option, - mountCDROM: Modified to facilitate the use of the ss_mount program to handle the mounting of CD-ROM discs on UNIX systems, - Print_Help_and_Stop: Added description of new -m option, - Print_Usage: Put in new -m option. header.c - fillhdr: Modified to create DATE record that conforms to the "FITS" standard, - gethdr: Removed Plate_Name argument which is not needed, and modified to fill the "plate_name" field in the header with the "region_no" field read from the header file. header.h - Modified gethdr prototype to reflect change in its argument list. image.c - Decompress_Image: Fixed bug in determining which image tile files to decompress for extractions near a plate edge, - Set_Tile_File_Name_Extension: Original version checked case from the extension of the input template filename, and failed if the extension was all numerical digits. The new version now looks for a letter starting from the end of the template filename. At least one letter will be found because all image tile file names begin with a letter. lnkd_lst.c - Insert_Linked_List_Data function: Previous version failed to set properly the "Previous" field of the original node when inserting a new node. This error has been rectified even ***************************************************** * Description of GetImage Version 1.1 Update page 6 * ***************************************************** though it does not affect GetImage. plate.c - Read_Plate_Info: Modified for the change in format of the input file from records separated with a new-line character to records separted with a dollar * sign ($). *