Getimage 1.3 Patch A Release

STScI ACDSD MAST CASB DSS Home

GetImage Version 1.3 was released to provide several enhancements to GetImage. Patch A to Version 1.3 was released to correct a problem in the decompression software.


GetImage Version 1.3 Update Highlights

I. Introduction
There are five primary changes to GetImage with the release of version 1.3. The maximum size of field names has been increased to 20 characters for UNIX and OpenVMS machines. An option has been added to select the criterion used to select the plate from which a requested field will be extracted. The name of extracted images files may now be specified on the command line. The experimental scheme for accessing CD-ROMs mounted in a jukebox on OpenVMS systems has been modified. The recommended means for mounting CD-ROMs on Solaris 2.x and IRIX machines has changed.
II. GetImage Version 1.3 Enhancements
1. Field Name Size
The maximum size of field names has been increased to 20 characters for UNIX and OpenVMS operating systems. The limit is still 4 characters when compiling on other operating systems to prevent possible invalid file names because the field name is used to construct the image file names. Note, that the terminal must now be 95 characters wide to avoid line-wrapping to accommodate longer field names.
2. Automatic Plate Selection Criteria
By default, GetImage 1.2 and earlier versions automatically select the plate whose center is closest to each requested field because astrometry and photometry are slightly more reliable closer to the plate center.

However, in some instances, this closest-to-center criterion may result in the selection of a plate in which the requested field is off the emulsion. To avoid this problem, GetImage 1.3, by default, will select the plate in which the requested field is furthest from the plate edge. The furthest-from-edge criterion will always select a plate in which the requested field falls on the emulsion except possibly where the sky coverage of the survey plates has almost no overlap.

The plate selection criterion may specified on the command line with a new "-p" option. GetImage will select the plate in which the field is closest to the center if "-p =c" is present on the command line. If, instead, "-p =e" is on the command line, then GetImage will select the plate in which the field is furthest from the edge. The furthest-from-the-edge criterion is the default behavior.

Alternatively, the individual plate from which a field is extracted may be specified by the unique id of the plate. The plate from which to extract images is specified with the -p option in the form "-p " where is the unique plate id associated with a particular plate. Plate id's may be found in the plate list file bundled with the headers, or in the FITS table found on the last disc of the survey CD-ROM set. For example, the plate covering sky region XE001 has plate id 0DDI.

3. Image File Name
The name of extracted image files may now be specified on the GetImage command line. The option "+imagename" will direct GetImage to create image files with root name . Note, however, that on UNIX operating systems GetImage will only extract the first image to prevent file overwriting. On OpenVMS systems, successive extracted images will have file names with successively higher version numbers.
4. Jukebox Under OpenVMS
The experimental scheme for using GetImage with a CD-ROM jukebox has been modified to accommodate a jukebox remotely NFS mounted onto an OpenVMS system. A separate executable must now be compiled for OpenVMS systems using stand-alone CD-ROM readers or a jukebox to access CD-ROMs. See the files INSTALL.VMS and README.TXT for information about installing and using GetImage with a CD-ROM jukebox.
5. CD-ROMs Under Solaris 2.x and IRIX
The ss_mount program used by GetImage for mounting CD-ROMs has proven inadequate for Solaris 2.x systems running the vold device manager. However, a reasonable work around has been identified and is described in the UNIX installations instructions in the file "install.unx." This work around has also proven to be an improvement for use with IRIX systems.

Jump to Top of GetImage 1.3 Patch A Release


GetImage Version 1.3a Update Highlights GetImage 1.3a is a quick release to correct a bug that causes images extracted from the northern edge of most plates to have skewed objects.

The only changes to files in GetImage was modification of src/image.c and inclusion of this file, getimg13a.txt. The modification to src/image.c was in the function Decompress_Image. The argument list in the call to hdecompress was changed back to the way it was in version 1.1 because it was actually correct and the change in version 1.2 broke the code.

Jump to Top of GetImage 1.3 Patch A Release


Obtaining the GetImage 1.3 Patch A Release A compressed tar file of GetImage 1.3a may be obtained at getimage.tar.Z . You may obtain the release in an OpenVMS backup save set via anonymous ftp from ftp.stsci.edu in the file getimage.bck from the directory /software/casb/programs/getimage/1_3a/ using transfer type backup.

If you are upgrading from GetImage Version 1.1 or earlier, you will need a new version of the plate list file called lo_comp.lis. This file may be obtained by setting your browser to download as a file from lo_comp.lis. The new plate list file should be installed into the headers directory below the GetImage installation directory. If your operating system has version numbers for files (such as OpenVMS), set the version number for the plate list file to be 1.

Instructions for installing GetImage may be found after unpacking the archive file in the files getimage/install.unx and [.GETIMAGE]INSTALL.VMS for UNIX and OpenVMS system respectively.

Jump to Top of GetImage 1.3 Patch A Release


[ New Alpha Release (Version 2.0) | GetImage Home ]


GetImage is produced by the Catalogs and Surveys Branch (CASB) at the Space Telescope Science Institute (ST ScI).
For inquiries send e-mail to getimage@stsci.edu.

Copyright © 1997 The Association of Universities for Research in Astronomy, Inc. All Rights Reserved.
Last updated 30 April 1997.