aboutsummaryrefslogtreecommitdiff
path: root/doc/v211revs.hlp
diff options
context:
space:
mode:
authorJoseph Hunkeler <jhunkeler@gmail.com>2015-07-08 20:46:52 -0400
committerJoseph Hunkeler <jhunkeler@gmail.com>2015-07-08 20:46:52 -0400
commitfa080de7afc95aa1c19a6e6fc0e0708ced2eadc4 (patch)
treebdda434976bc09c864f2e4fa6f16ba1952b1e555 /doc/v211revs.hlp
downloadiraf-linux-fa080de7afc95aa1c19a6e6fc0e0708ced2eadc4.tar.gz
Initial commit
Diffstat (limited to 'doc/v211revs.hlp')
-rw-r--r--doc/v211revs.hlp1199
1 files changed, 1199 insertions, 0 deletions
diff --git a/doc/v211revs.hlp b/doc/v211revs.hlp
new file mode 100644
index 00000000..1407df06
--- /dev/null
+++ b/doc/v211revs.hlp
@@ -0,0 +1,1199 @@
+.help IRAF Aug97 "V2.11EXPORT Release Notes"
+.sp 1
+.ce
+IRAF V2.11EXPORT Release Notes
+.ce
+August 27, 1997
+
+
+Modifications and additions to IRAF V2.11EXPORT, compiled since the last
+documented release of IRAF, V2.10.3, are summarized below. V2.11EXPORT is
+a major release of IRAF and will be available for all supported platforms.
+These release notes provide a summary of the major changes in V2.11. More
+detailed technical documentation of all system changes will be found in the
+notes.v210 and notes.v211 files in the iraf$doc and iraf$local directories.
+
+.nf
+ 1. \fBThings to be aware of or watch out for\fR
+ 1.1. Parameter file changes
+ 1.2. Networking change
+ 1.3. Image format change
+ 1.4. FITS kernel
+ 1.5. RFITS/\fIwfits\fR changes
+ 1.6. Merged SunOS and Solaris IRAF systems
+ 1.7. Tape access
+ 1.8. Default magnitude zero changed
+
+ 2. \fBIMAGES package changes\fR
+
+ 3. \fBMajor system changes\fR
+ 3.1. New FITS image kernel (FXF)
+ 3.2. Changes to the IRAF native image format (OIF)
+ 3.3. IMFORT changes
+ 3.4. Environment variables
+ 3.5. New intrinsic functions
+ 3.6. System default modifications
+ 3.7. Libraries added
+ 3.8. Graphics changes
+ 3.9. FITS-related core-level task changes
+ 3.10. General changes
+
+ 4. \fBNew tasks, or old tasks moved to new packages\fR
+
+ 5. \fBTask and package deletions\fR
+
+ 6. \fBModifications to old tasks\fR
+
+ 7. \fBParameter file changes\fR
+.fi
+.nh
+Things to be aware of or watch out for
+.nh 2
+Parameter file changes
+
+Since this is a major release we recommend that you do a \fImkiraf\fR and
+delete all your old parameter files. You may choose not to do this if you
+are in the midst of a project and have setups that may be difficult to
+reproduce. Old IMAGES package parameter files will no longer be recognized,
+however, because of the package reorganization mentioned below. Generally,
+old parameter files are merged automatically with any new parameter files
+if there have been any changes, but if you do have problems you will need
+to \fIunlearn\fR the task before you can proceed. A list of the parameter
+file changes appears below and you may wish to check this list to see how
+this will affect your setups.
+
+The automatic parameter file update/merge mechanism, which is used if you
+do not initialize your parameters with \fImkiraf\fR, is based on file date
+comparisons. If you run IRAF V2.10 after V2.11 has been installed, the
+file dates on your uparm parameter files will be more recent than the
+V2.11 installation date. If you then try to run V2.11, the automatic
+parameter file merge/update will fail due to the file dates. The system
+only updates personal parameter files which are older than the update date
+of the system. A \fImkiraf\fR avoids the problem if you delete your
+parameter files, causing them to be updated from the system default
+versions.
+.nh 2
+Networking change
+
+The "set node = foo" syntax, used to enable remote image display under
+IRAF networking, has changed. The new syntax requires that an exclamation
+be appended to the node name as in the example below (this dates back to
+V2.10.4 so many users will already be familiar with the feature).
+.nf
+
+ cl> set node = "orion!"
+.fi
+.nh 2
+Image format change
+
+The internal IRAF image format (.imh images) has changed. V2.11EXPORT
+can read the old image format but the new image format is not readable by
+V2.10.4 or earlier versions. This means that you can not easily go from
+the new IRAF system (V2.11) to an old one (V2.10.4 or earlier) unless you
+first convert the V2.11 IRAF images to FITS files. All your old V2.10.4
+or earlier images are readable by V2.11EXPORT. The benefit is that the
+new image format is machine independent, slightly more storage efficient,
+and supports long file pathnames. If it is necessary to be able to read
+images written by V2.11 with older software, V2.11 can be made to write
+the old IRAF image format by setting the \fIoifversion\fR environment
+variable, e.g., "set oifversion = 1" (the default is version 2). See
+below for details.
+.nh 2
+FITS kernel
+
+A FITS image kernel is available in V2.11, allowing runtime read and write
+access to FITS files on disk. There are many related changes to IRAF
+image i/o and FITS support. More information on the new image kernel,
+and on the expanded FITS support available in V2.11, is given below.
+.nh 2
+RFITS/WFITS changes
+
+\fIrfits\fR and \fIwfits\fR have been modified to support multi-extension
+FITS files. The extension numbering convention used is the same as in
+the FITS image kernel. As a result, users who read simple FITS files on
+disk with a command such as "rfits diskfilename 1 foo" will find that
+this no longer works - instead use "rfits diskfilename 0 foo". See below
+for details.
+.nh 2
+Merged SunOS and Solaris IRAF systems
+
+A single installation of Sun/IRAF will now simultaneously support both
+SunOS and Solaris (previously separate IRAF distributions were required
+for each).
+.nh 2
+Tape access
+
+The "tapecap" mechanism has changed. The system now looks for the filename
+"tapecap.<node>" followed by the default "tapecap". <node>: should be
+the hostname (as used by IRAF networking) of the server hosting the tape
+drives described by the tapecap file. For example if host "gemini" serves
+up some tape drives it's tapecap file is named "tapecap.gemini". If a
+server-specific tapecap file is not found the default "tapecap" (on the
+possibly remote server node) is used. This feature allows a single IRAF
+installation to be shared by multiple servers.
+.nh 2
+Default magnitude zero changed
+
+The default APPHOT magnitude zero point has been changed from 26.0 to 25.0
+to bring it into agreement with the DAOPHOT package default value and
+thereby avoid confusion for users who switch back and forth between
+packages. The affected APPHOT tasks are \fIphot\fR, \fIphotpars\fR,
+\fIpolypars\fR, \fIpolyphot\fR, \fIqphot\fR, \fIradprof\fR, and \fIwphot\fR.
+The APPHOTX package in the addon DIGIPHOTX package will retain the old
+zero point values until IRAF 2.11 is released after which they will be
+updated.
+
+The default value of the magzero parameter in \fIimexamine\fR was changed
+from 30.0 to 25.0 for consistency with the DIGIPHOT package.
+.nh
+IMAGES package changes
+
+The IMAGES package has been reorganized by function into the 7 subpackages
+listed below.
+.nf
+
+ imcoords - Image coordinates package
+ imfilter - Image filtering package
+ imfit - Image fitting package
+ imgeom - Image geometric transformation package
+ immatch - Image matching and combining package
+ imutil - Image utilities package
+ tv - Image display utilities package
+
+.fi
+The new IMAGES package contains a total of 82 tasks, including 26 new tasks
+from the IMMATCH and VOL external addon packages, 6 existing PROTO package
+tasks, and 1 existing NOAO.PROTO package task. The undocumented IMAGES
+package IMDEBUG and its 6 tasks have been deleted from the IMAGES package.
+User should use the tasks in the ARTDATA package instead.
+
+This reorganization of the IMAGES package should be mostly transparent to
+the user and not affect any existing scripts, unless you were using any of
+the 6 deleted tasks. By default, the IMAGES subpackages are automatically
+loaded when you log in to the CL. Old parameter files will not be recognized
+since the package names have changed.
+.nh
+Major system changes
+.nh 2
+New FITS image kernel (FXF)
+
+V2.11 introduces a new image kernel providing runtime access to FITS
+multi-extension image datafiles. What this means is that IRAF tasks
+can now read and write FITS images directly at runtime. The native IRAF
+image format (used by images with the .imh extension), remains the
+default as it is the most efficient and well-tested format. IMH, FITS,
+and the other types of images supported by IRAF can be used
+interchangeably in most IRAF tasks. Although we have extensively tested
+the new FITS image kernel, it is still evolving, is complex, and still
+has some bugs. Users should use it with caution. Please let us know of
+any problems.
+
+Besides support for classical FITS images, the new FITS kernel also
+supports multi-extension FITS files: several FITS files packed into one
+large file with a PHU (Primary Header Unit) that contains global header
+information shared by the other files. Multi-extension FITS files are
+0-indexed, with the PHU being 0 and the first image extension (or other
+data extension) at index 1. If there is no PHU then the first FITS
+image is 0 and there is no global header.
+
+For further details about the FITS kernel please see the new FITS Kernel
+User's Guide by Nelson Zarate.
+.nh 2
+Changes to the IRAF native image format (OIF)
+
+.nf
+ o It was necessary to change the IRAF image format to increase the
+ maximum path length for header and pixel files. This made it necessary
+ to change the disk image format, since the old format only allowed 80
+ characters for the pixel file pathname. The path lengths can now be up
+ to 255 characters.
+
+ Support for two versions of the image and pixel file headers was added.
+ V2.11 will read both the old image format (V1) and the new image format
+ (V2). But the new image format is not readable by older versions of IRAF.
+
+ o Native format IRAF images (OIF type or extension ".imh") are now machine
+ independent, for example, a PC and a Sun can now access the same images.
+
+ o Support was added for byte swapping pixels. With the machine independent
+ image header, this allows .imh images to be read on any node (integer)
+ or any IEEE-compatible node (floating).
+
+ o Some pointers: "strings foo.imh" (or other tools like the "less" file
+ viewer) can be used at the Unix level to look at the text contained in
+ the new V2 OIF image headers.
+.fi
+.nh 2
+IMFORT changes
+
+.nf
+ o IMFORT was brought up to date to read and write the new V2 ".imh" images.
+ The old V1 format is still supported but new images are written using
+ the new machine independent V2 format by default.
+
+ o Image headers can now be any size (the old IMFORT had a fixed, relatively
+ low, limit on the image header size).
+
+ o The "min_lenuserarea" variable is now supported by IMFORT (since IMFORT
+ is host level the variable must be defined in the host environment).
+ The builtin default header buffer is 64000 chars, which is about 800
+ card images.
+.fi
+.nh 2
+Environment variables
+
+Several new environment variable have been added to the system.
+
+.nf
+ o The new environment variable \fIimextn\fR determines the image kernels
+ (image file formats) recognized by IRAF and defines the mapping of
+ imagefile extensions to these image formats. A file that does not have
+ an extension listed in imextn may not be recognized as an image by all
+ IRAF tasks. The default value of imextn is as follows:
+
+ imextn = "oif:imh fxf:fits,fit plf:pl qpf:qp stf:hhh,??h"
+
+ IRAF tasks will not recognize a file as an image unless it has an
+ extension (except \fIrfits\fR which will read FITS files on disk that
+ have no extensions). The \fIrename\fR task can be used to add
+ extensions to image files if needed. "imextn" can be redefined (use
+ reset imextn = "new-value") to modify the mapping of extensions to
+ image types.
+
+ The meaning of the fields of the default "imextn" are as follows. Each
+ substring corresponds to a single kernel. The "xxx:" is the internal
+ name of the image kernel, i.e. "oif", "fxf", "plf", etc. A comma
+ delimited list of the extensions, or extension patterns, associated with
+ that image format follows the colon. For example, for the FITS image
+ kernel, the internal kernel name is "fxf" and the system default file
+ extensions are ".fits" and ".fit".
+
+ - oif:imh - The original (native) IRAF image format.
+
+ - fxf:fits,fit - The FITS image extension format, which supports
+ classical FITS images as well as multi-extension FITS files.
+
+ - plf:pl - The pixel list format used for compressed pixel masks.
+
+ - qpf:qp - The QPOE image format for event list data (typically
+ X-ray or other high energy data).
+
+ - stf:hhh,??h - The Space Telescope runtime GEIS image format.
+
+ Users can define extensions for the fxf and stf kernels. For example,
+ if you have FITS files on disk that have a .ft extension then you can
+ reset imextn so that IRAF will recognize these image extensions:
+
+ cl> reset imextn="fxf:ft"
+
+ The new .ft extension for the FITS kernel images will now override the
+ default values - the other kernels remain unchanged. ".fits" will no
+ longer be recognized as a FITS file unless you include it in the list
+ of extensions for the "fxf" kernel.
+
+ The first extension given for a kernel defines the default file
+ extension for new images of that type (rather than e.g. the value of
+ imtype, or a builtin default).
+
+ The value of "imextn" is only read once when a process starts up. Hence
+ it is advisable to do a "flpr" (flush process cache) after changing
+ this variable, to force all processes to re-read it.
+
+ o The environment variable \fIimtype\fR defines the default image type for
+ new images created by IRAF. If a file extension is given explicitly
+ when creating a new image then this file extension, in combination with
+ the "imextn" mappings, determines the type of the new image. Otherwise
+ the type is determined by the value of "imtype". Typical values are
+ "imh" for native IRAF images, or "fits" for FITS images. The internal
+ kernel name documented above for "imextn" can be used instead of a file
+ extension to ensure that the desired image format is used regardless of
+ what extensions are assigned to that type by imextn.
+
+ The default value of imtype is "oif,noinherit" which means that the
+ IRAF native format is the default for all new images, regardless of the
+ type of the input image (i.e. do not "inherit" the input image type).
+ "inherit" was the default in V2.10 and earlier versions of IRAF.
+
+ For example, if you wish to use FITS as the default for new images you
+ can set imtype=fits as follows:
+
+ cl> reset imtype="fits"
+ cl> flpr % needed before the next task execution
+
+ Assuming "imextn" defines ".fits" as a valid file extension for FITS
+ imagefiles (kernel "fxf"), all new images produced by IRAF will be FITS
+ files with the extension .fits unless some other extension is given
+ explicitly when creating a new image.
+
+ cl> reset imtype = "imh,inherit"
+
+ This example sets the default type for new images to ".imh" for native
+ format images, but enables image type inheritance. By default new
+ images will be of the same type as the input image. For example if a
+ FITS image is being read another FITS image will be output, or if a
+ pixel mask is being read a pixel mask will be created.
+
+ You can override the default output image type specified by imtype by
+ giving an image extension (as defined by imextn) explicitly in the image
+ name, e.g. "pix.imh", "pix.fits", "pix.pl" and so on.
+
+ o A new environment variable called \fIimclobber\fR has been added.
+ The default value is set to no. If imclobber is set to yes, images
+ can and will be overwritten, without warning, when you create new
+ images.
+
+ o The original IRAF image format (OIF) kernel now supports an environment
+ variable \fIoifversion\fR which, if defined, specifies the file
+ version for new OIF images (for example, oifversion=2 produces the
+ new format, or version 2 images). By default the variable is undefined,
+ the builtin OIF default will be in effect, and new-format images will
+ be generated. This variable is provided only for backwards
+ compatibility, e.g., when using V2.11 IRAF with old software which
+ cannot easily be updated.
+.fi
+.nh 2
+New intrinsic functions
+
+Two new intrinsic functions were added to the CL, \fIimaccess\fR and
+\fIdefvar\fR. \fIimaccess\fR tests whether an image exists, e.g.,
+(imaccess("dev$pix")) or (imaccess(foo.fits[3])). \fIdefvar\fR tests
+whether an environment variable exists, e.g. (defvar("imextn")).
+.nh 2
+System default modifications
+.nf
+
+ o The default size of the user area (\fImin_lenuserarea\fR) was increased
+ to 64000 (about 800 80 character cards). There was some ambiguity about
+ units for min_lenuserarea; it should be consistently characters now.
+
+ o The maximum number of open IRAF logical files was increased from 128 to
+ 256. This is good news for \fIimcombine\fR users.
+
+ o Various buffer limits were increased:
+
+ - The IRAF line length was increased from 161 to 1023 characters.
+ One often ran into this lower limit when entering a long list of
+ input image names, for example.
+
+ - CL commands can now be 2047 characters long (the old limit was
+ 1024) - this is particularly useful for scripts.
+
+ - IRAF file names can now be up to 255 characters long.
+
+ - Expanded file names (pathnames) can be up to 511 characters long.
+.fi
+.nh 2
+Libraries added
+
+The Starlink positional astronomy library SLALIB was added to the math
+package.
+.nh 2
+Graphics changes
+.nf
+
+ o SGI Translator change: Modified the header ID string produced by
+ sgi2uapl to be "%!PS", this is required by certain models of printers.
+
+ o Installed graphcap support for the STSDAS PostScript graphics kernel.
+
+ o The SGI graphics kernel was upgraded with a better roman font, and a
+ new greek font was added. To use the new high-quality greek fonts use
+ the "\fG" escape sequence when you use the "T" keystroke to mark text
+ in a plot, e.g., \fGa \fRHydra would produce " Hydra". The greek font
+ may also be used in label parameters for tasks like GRAPH, for example
+
+ cl> graph dev$pix xlabel="Wavelength\\fG(A)"
+
+ would produce an Angstrom symbol in parenthesis. The double backslash
+ is necessary to pass the escape string thru the CL. A file containing
+ the mappings for the greek fonts and other special characters can be
+ found at http://iraf.noao.edu/greek.ps.
+.fi
+.nh 2
+FITS-related core-level task changes
+.nh 3
+IMHEADER
+
+The behavior of \fIimheader\fR has changed a bit - typed with no arguments
+it will list all the images in the current directory, as in the following
+example:
+
+.nf
+ cl> imhead
+ pix4.imh[512,512][short]: m51 B 600s
+ boc.fits: FXF: must specify which FITS extension (boc.fits)
+ fits.fits[512,512][short]: m51 B 600s
+ pix.fits[512,512][short]: m51 B 600s
+ pix3.fits[512,512][short]: m51 B 600s
+ pix5.fits: FXF: must specify which FITS extension (pix5.fits)
+ zero.fits: FXF: must specify which FITS extension (zero.fits)
+ mask.pl[512,512][int]: m51 B 600s
+ foo.qp[1024,811][int]:
+.fi
+
+The multi-extensions FITS files show up in the list with the message
+"FXF: must specify which FITS extension", since these files contain
+multiple images and the task does not know which image to open to get
+header information.
+
+At present imheader does not use "imextn" to determine what is and is
+not an image. The parameter "imlist" defines the valid imagefile
+extensions. If imextn is modified "imlist" may need to be modified as
+well.
+.nh 3
+RENAME
+
+The \fIrename\fR task was modified to allow a destination directory to be
+specified without changing the filename. A new "field" parameter option
+"all" was added and made the default so the entire filename is changed
+(or moved in the case of a destination directory). When field is set
+to "extn" filenames without an extension will not have the new extension
+appended so a filename isn't generated which can get overwritten.
+.nh 3
+\fIrfits\fR/\fIwfits\fR
+
+Some changes were also implemented in \fIrfits\fR and \fIwfits\fR to add support
+for multi-extension FITS files.
+
+.nf
+ o The default action of \fIwfits\fR when writing to tape is unchanged for
+ single image files.
+
+ \fIwfits\fR now has a new parameter called "fextn" and it is set to
+ "fits". This parameter only affects FITS files written by \fIwfits\fR
+ to disk - the extension .fits will automatically be added to the
+ filenames, so that the files will be automatically recognized by
+ the FITS image kernel.
+
+ \fIwfits\fR also has two additional parameters called "extensions" and
+ "global_hdr" that deal with writing multi-extension FITS files.
+
+ o The default action of \fIrfits\fR from tape to disk remains unchanged.
+
+ If \fIrfits\fR is used to read FITS files on disk then users need to
+ be aware of a change to the behavior of the "file-list" parameter.
+ File-list is now used to define the list of files on the tape as
+ well as the list of extensions in a multi-extension FITS image.
+ To read single FITS images on disk use "" as the value for
+ "file-list". Some users have been using "1" for this value but now
+ that value will try to read the first extension which doesn't
+ exist - use "0" if you wish to put something there.
+
+ \fIrfits\fR will unpack multi-extension FITS files upon a read. If you
+ wish to retain the multi-extension FITS format then use T2D and
+ RENAME.
+.fi
+
+The help pages have been updated to reflect these changes.
+
+\fIwfits\fR now writes ushort (16 bit unsigned short) images to FITS images
+with bitpix=16, bscale=1.0, and bzero=32768.0 by default. \fIrfits\fR will
+read these images back as type ushort.
+.nh 2
+General changes
+
+.nf
+ o The GSURFIT package has been updated to include support for the "half"
+ cross terms option useful in computing plate solutions. Tasks that can
+ make use of this feature have been updated although their default
+ behaviors have not changed.
+
+ o The code which computes the CD matrix from CDELT/CROTA was modified.
+ The old code computed the diagonal (scale) terms correctly but the
+ rotation terms were evidently incorrect. The old code was based on
+ the 1988 Hanisch and Wells WCS paper and the new code is based on a
+ more recent paper by Mark Calabretta et al, which supersedes the
+ 1988 representation. The affect of this change should be limited
+ as it only affects rotated images for which CDELT is given but no
+ CD matrix is defined. (V2.10.4p2)
+
+ o Several new celestial coordinate projection functions have been added.
+ Users with IPAC data that use the CAR projection function should now be
+ able to read the image coordinates directly with LISTPIXELS, etc.
+.fi
+.nh
+New tasks, or old tasks moved to new packages
+
+.nf
+ \fBTask Name Package Function\fR
+
+ CCXYMATCH IMCOORDS Four new tasks for computing and evaluating
+ CCMAP simple astrometric plate solutions and storing
+ CCSETWC them in the image headers in fits-compatible
+ CCTRAN format.
+
+ CCFIND IMCOORDS CCFIND locate objects in an image given a
+ celestial coordinate list and the image wcs.
+
+ IMCCTRAN IMCOORDS Two new tasks for transforming celestial
+ SKYCTRAN coordinate lists and image celestial
+ coordinate systems from one celestial
+ coordinate system to another.
+
+ STARFIND IMCOORDS STARFIND automatically detects stellar objects
+ in a list of images.
+
+ WCSCTRAN IMCOORDS A new task for transforming between IRAF image
+ coordinate systems.
+
+ WCSEDIT IMCOORDS Two unaltered former PROTO package tasks for
+ WCSRESET editing IRAF image coordinate systems.
+
+ FRMEDIAN IMFILTER Four new tasks for doing circular/elliptical/
+ FRMODE ring image median filtering.
+ RMEDIAN
+ RMODE
+
+ IM3DTRAN IMGEOM The former addon VOL package task IM3DTRAN for
+ doing 3D image transposes.
+
+ GEOXYTRAN IMMATCH A new task for transforming coordinate lists
+ using the results of the GEOMAP task.
+
+ IMCENTROID IMMATCH Four new tasks for computing matched pixel
+ SKYXYMATCH lists. IMCENTROID is a modified version of the
+ WCSXYMATCH PROTO package task of the same name.
+ XYXYMATCH
+
+ SKYMAP IMMATCH Two new tasks for computing geometric
+ WCSMAP transforms using the image coordinate system
+ information.
+
+ IMALIGN IMMATCH Three new tasks for doing automated image
+ SREGISTER registration. IMALIGN is a modified version
+ WREGISTER of the PROTO package task of the same name.
+
+ WCSCOPY IMMATCH A new task for copying the coordinate system
+ of a reference image to a set of input images.
+
+ PSFMATCH IMMATCH A new task for matching the PSFs of a set of
+ input images to the PSF of a reference image
+ using Fourier techniques.
+
+ LINMATCH IMMATCH A new task for matching the linear intensity a
+ scale of a set of input images to the
+ intensity scale of a reference image.
+
+ IMFUNCTION IMUTIL The former PROTO package task for applying a
+ single argument function to an image.
+
+ IMJOIN IMUTIL The former addon VOL package task for joining
+ same-dimensioned images along a specified
+ dimension.
+
+ IMREPLACE IMUTIL The former PROTO package task IMREPLACE for
+ replacing bad pixels based on their value.
+
+ IMTILE IMUTIL A modified version of the NOAO.PROTO IRMOSAIC
+ task for tiling same sized 2D images into a
+ single mosaiced image.
+
+ EXPORT DATAIO Two new tasks from the external IMCNV package
+ IMPORT for exporting IRAF images to binary formats
+ and for importing binary files into IRAF
+ images.
+
+ TEXT2MASK PROTO This new task appears in conjunction with a
+ new pixel mask based version of FIXPIX.
+
+ IMEXTENSIONS PROTO This task selects and lists image extensions
+ in files. Image extensions currently occur
+ in multi-extension FITS files and multi-group
+ Geiss (STF format) files.
+
+ CCDMASK CCDRED This new task creates a pixel mask from a
+ CCD image.
+
+ AIDPAR ONEDSPEC New parameter set for automatic line
+ identification for the tasks AUTOIDENTIFY,
+ IDENTIFY and REIDENTIFY.
+
+ AUTOIDENTIFY ONEDSPEC A new task to automatically identify lines
+ and fit the dispersion function.
+
+ SKYTWEAK ONEDSPEC Sky spectra are shifted and scaled to best
+ subtract sky features from data spectra.
+
+ TELLURIC ONEDSPEC Telluric calibration spectra are shifted and
+ scaled to best divide out telluric features
+ from data spectra.
+
+ ASTCALC ASTUTIL An astronomical calculator.
+
+ ASTRADIUS ASTUTIL Finds images within a circle on the sky.
+.fi
+.nh
+Task and package deletions
+
+CUBE, DUMP, GSUBRAS, MAXMIN, MKIMAGE, MKTEST: These tasks have been
+superseded by the equivalent tasks in the IMAGES or ARTDATA packages.
+The functionality of these tasks still exists in the
+iraf$pkg/images/lib/zzdebug.x file.
+
+REGISTER: This task has been renamed to GREGISTER.
+
+IMALIGN, IMCENTROID, IMFUNCTION, IMREPLACE, WCSEDIT, WCSRESET: Moved to the
+IMAGES package.
+.nh
+Modifications to old tasks
+
+Grouped by package, a list of modifications to old tasks in IRAF are
+summarized below. We have included modifications since the V2.10.3
+release.
+.nf
+
+\fBIMFILTER:\fR
+ FMEDIAN, FMODE, MEDIAN, MODE
+ Minimum and maximum good data value parameters zloreject and zhireject
+ and a verbose option parameter were added.
+ MEDIAN, MODE
+ The 64 x 64 maximum kernel size limit was removed from these tasks.
+
+\fBIMMATCH:\fR
+ GEOMAP
+ Renamed the output parameter to database for the sake of consistency
+ with other new images tasks.
+
+ Changed the default value of the reject parameter from 0.0 to INDEF.
+
+ Added the transforms parameter. Transforms permits the user to specify
+ the names of the output database records explicitly.
+
+ Added the parameter results. Results permits the user to save a summary
+ of the results including a description of the transform geometry, and a
+ listing of the input coordinates, the fitted coordinates, and the fit
+ residuals.
+
+ Added the fitgeometry parameter. Fitgeometry permits the user to
+ constrain the linear part of the fit to: 1) x and y shifts only, 2) x
+ and y shifts and rotation only, 3) x and y shifts and x and y scale
+ changes only, 4) x and y shifts, rotation, and a scale change only, 5)
+ x and y shifts, rotation, x and y scale changes only, and 5) x and
+ shifts, rotation, skew, and x and y scale changes.
+ GREGISTER
+ Renamed the register task gregister to emphasize that it is paired with
+ the geomap task and to avoid confusion with the new registration tasks.
+ GEOTRAN, GREGISTER
+ Renamed the transform parameter to transforms.
+
+ Added the verbose parameter.
+ GEOTRAN
+ Added the ability to write to a section of an existing image.
+ IMCOMBINE
+ The limit of the number of images that may be combined has been
+ removed. If the number of images exceeds the maximum number of
+ open images permitted then the images are stacked in a single
+ temporary image and then combined with the project option.
+ Note that this will double the amount of diskspace
+ temporarily. There is also a limitation in this case that the
+ bad pixel mask from the first image in the list will be applied
+ to all the images.
+
+ Integer offsets may be determined from the image world
+ coordinate system.
+
+ A combination of ushort and short images now defaults to
+ integer.
+
+ Added support for type ushort images.
+
+ Added a new options for computing offsets using the image wcs.
+
+ Removed the limit on the maximum number of images that can be combined.
+ IMALIGN, IMCENTROID
+ Renamed the images parameter to input, changed the reference parameter
+ mode from hidden to automatic, and reversed the order of the reference
+ and coords parameters.
+
+\fBIMUTILS:\fR
+ IMEXPR
+ Modified the task so that it will accept an image name that looks like
+ a number in the first few characters, but which is really an image
+ name. For example, "123.imh" or "../foo.imh". The previous version
+ of imexpr was treating any string which looked like a number in the
+ first few characters as a numeric constant. (V2.10.4p2)
+ IMREPLACE
+ The lower value is now rounded up for integer images so that a
+ range like 5.1-9.9 affects pixels 6-9 instead of 5-9.
+ IMSUM
+ Now allows "ushort" data types.
+
+\fBTV:\fR
+ DISPLAY
+ The bad pixel mask, overlay mask, sample mask, and overlay
+ colors parameters and functionality have been added. The
+ "nsample_lines" parameter is now an "nsample" parameter.
+
+ Bugs in the coordinate system sent to the image display for
+ cursor readback were fixed.
+ IMEDIT
+ If xorder or yorder are zero then a median background is
+ computed for the 'a' and 'b' keys.
+ IMEXAMINE
+ ('a' and 'r'): The fit to the radial profile points now
+ includes both a Gaussian and a Moffat profile. The Moffat
+ profile exponent parameter, beta, may be fixed or left free to
+ be fit.
+
+ ('a' and 'r'): New estimates fo the FWHM were added to the 'a'
+ and 'r' keys. These include the Moffat profile fit noted
+ above, a direct measurement of the FWHM from the radially
+ binned profile, and a Gaussian or Moffat fit to the radial
+ enclosed flux profile. The output from these keys was modified
+ to include the new information.
+
+ ('a' and 'r'): The direct FWHM may be used to iteratively
+ adjust the fitting radius to lessen the dependence on the
+ initial fitting radius value.
+
+ ('k'): Added a kimexam parameter set.
+
+ The default value of rimexam.magzero parameter was changed from
+ 30.0 to 25.0 for consistency with the digiphot package.
+
+\fBPROTO:\fR
+ FIELDS
+ The default value for the lines parameter was changed to an open
+ upper limit.
+
+ Changed the default value of the lines parameter from "1-999" to
+ "1-" so that the upper bound would be open ended.
+ FIXPIX
+ This task replaces the old task (now obsolete.ofixpix) and
+ works with the more general pixel mask facilities. It also
+ provides greater flexibility in choosing the interpolation
+ direction.
+
+\fBICFIT\fR used in various tasks:
+ ICFIT
+ The :xyshow output was modified to 1) not include colon labels,
+ 2) print (X, Y, Y fit, Weight) instead of (X, Y fit, Y), and 3)
+ the printed values are those actually used in the fit when using
+ composite points (naverage not 1).
+
+\fBARTDATA:\fR
+ MK1DSPEC
+ Lorentzian and Voigt profiles were added and the parameters and
+ input line list format were changed. The widths are now FWHM
+ instead of gaussian sigmas.
+ MKOBJECTS, MKNOISE
+ The default value of "ranbuf" was changed to zero.
+ GALLIST
+ The default value for the minimum elliptical galaxy axial ratio
+ was changed to 0.3 to cover the range E0-E7 uniformly.
+ MKPATTERN
+ Now allows ndim=0 to make an dataless header.
+ Now allows ushort pixel type.
+
+\fBASTUTIL:\fR
+ SETJD
+ The checking of the epoch keyword value was improved.
+ Previously if there was a problem with the keyword value
+ (missing or malformed) the task would use the epoch of the
+ observation. Now it is an error if an epoch keyword is
+ specified but the epoch value can't be determined. Also a
+ leading 'B' or 'J' is allowed and a warning will be given if
+ the epoch value is unlikely.
+ ASTHEDIT
+ There are new astronomical functions and input/output functions.
+ The command syntax may now use "=" as a delimiter as well as
+ the whitespace.
+
+ A new parameter "update" allows protecting images and accessing
+ read-only images for the purpose of calculating and printing
+ quantities.
+
+ The special variable name "$I" has the value of the image name,
+ $D the current date, and $T the current time.
+
+ The case of no image name creates and deletes a temporary image
+ so the task can be used purely as a calculator (but see
+ astcalc).
+
+\fBCCDRED:\fR
+ CCDPROC
+ The bad pixel fixing was modified to allow use of pixel masks,
+ images, or the text file description. Bad pixel masks are the
+ desired description and use of text files is only supported for
+ backward compatibility. Note that support for the trimmed or
+ untrimmed conversion from text files has been eliminated.
+
+ Line-by-line overscan/prescan subtraction is now provided with
+ three simple algorithms.
+ COMBINE
+ The limit of the number of images that may be combined has been
+ removed. If the number of images exceeds the maximum number of
+ open images permitted then the images are stacked in a single
+ temporary image and then combined with the project option.
+ Note that this will double the amount of diskspace
+ temporarily. There is also a limitation in this case that the
+ bad pixel mask from the first image in the list will be applied
+ to all the images.
+
+ Integer offsets may be determined from the image world
+ coordinate system.
+
+ Fixed a bug where a variable was improperly used for two different
+ purposes causing the algorithm to fail. This also affected IMCOMBINE
+ and SCOMBINE. See bug 316 for details. (V2.10.4p2)
+ COSMICRAYS
+ The output bad pixel data accidentally included some extra fields
+ making it incorrect to use the file directly with BADPIXIMAGE.
+ The extra diagnostic fields were removed. For details, see bug 311
+ in the buglog. (V2.10.4p2)
+
+\fBECHELLE:\fR
+ ECIDENTIFY
+ The dispersion units are now determined from a user parameter,
+ the coordinate list, or the database entry.
+
+\fBIMRED\fR Spectral Packages:
+ DOARGUS, DOFIBERS, DOHYDRA
+ A sky alignment option was added.
+
+ The aperture identification can new be taken from image header
+ keywords.
+
+ The initial arc line identifications is done with the automatic
+ line identification algorithm.
+ DOSLIT, DO3FIBER
+ The initial arc line identifications is done with the automatic
+ line identification algorithm.
+
+\fBONEDSPEC:\fR
+ Support for the Sloan Sky Survey was added by allowing multifiber
+ reductions with up to 500 fibers with non-linear dispersions. (V2.10.4p2)
+
+ BPLOT
+ Fixed a general problem in BPLOT and SLIST that caused a segmentation
+ violation error. See buglog 312 for details. (V2.10.4p2)
+ FITPROFS
+ Modified to include lorentzian and voigt profiles. The
+ parameters and positions file format have changed in this
+ version. A new parameter controls the number of Monte-Carlo
+ samples used in the error estimates.
+ IDENTIFY
+ The dispersion units are now determined from a user parameter,
+ the coordinate list, or the database entry.
+ A new key, 'e', has been added to add features from a line list
+ without doing any fits. This is like the 'l' but without the
+ automatic fitting before and after adding new features.
+
+ A new key, 'b', has been added to apply an automatic line
+ identification algorithm.
+
+ The 'x' key has been changed to use the automatic line
+ identification algorithm. The allows finding much larger
+ shifts.
+
+ The match parameter may now be specified either in user
+ coordinates or in pixels. The default is now 3 pixels.
+
+ The default threshold value has been changed to 0.
+ REIDENTIFY
+ A new parameter, "search", was added to specify a search radius
+ for the automatic line identification algorithm.
+
+ The "nlost" parameter now also applies when not tracing; i.e. it
+ will issue a warning and not record a solution if the specified
+ number of features is lost when reidentifying against a specific
+ reference spectrum as is done with multispec data.
+
+ The task will now work with only a warning if the reference
+ image is absent; i.e. it is possible to reidentify given only
+ the database.
+
+ The addfeatures function will now add features before a fit if
+ there are no reference database features. Previously features
+ could only be added after an initial fit using the reference
+ features and, so, required the reference database to contain
+ features for reidentification. This new feature is useful if
+ one wants to uses a dispersion function from one type of
+ calibration but wants to add features for a different kind of
+ calibration.
+ SAPERTURES
+ This task has been modified to allow use of image header
+ keywords as done in the APEXTRACT package.
+ SARITH
+ Previously both w1 and w2 had to be specified to select a range
+ to be used. Now if only one is specified the second endpoint
+ defaults to the first or last pixel.
+
+ The noise band in multispec data is only copied from the primary
+ spectrum and not modified. This is a kludge until the noise is
+ handled properly.
+
+ Fixed a problem in SARITH and SCOPY where a segmentation error
+ occurred when a wavelength range was specified in the reverse sense
+ of the data and without rebinning. See buglog 323 for details.
+ (V2.10.4p2)
+ SBANDS
+ Fixed a problem in SBANDS that caused a segmentation violation when
+ the number of input bandpasses was greater than 10. See buglog 298
+ for details. (V2.10.4p2)
+ SCOPY
+ Previously both w1 and w2 had to be specified to select a range
+ to copy. Now if only one is specified the second endpoint
+ defaults to the first or last pixel.
+ SPECPLOT
+ The scale and offset parameters may now be a value, a filename,
+ or and image header keyword.
+
+ The 'f' key was added to toggle between world and logical pixel
+ coordinates.
+ SPLOT
+ The profile fitting and deblending was expanded to include
+ lorentzian and voigt profiles. A new parameter controls the
+ number of Monte-Carlo samples used in the error estimates.
+ RSPECTEXT
+ The task now automatically senses the presence of a header.
+
+\fBAPEXTRACT:\fR
+ APALL, APSUM, APNOISE, APNORMALIZE, APSCATTER, APTRACE,
+ APRECENTER, APRESIZE, APMASK, APFIND, APFLATTEN
+ The "apertures" parameter can be used to select apertures for
+ resizing, recentering, tracing, and extraction. This parameter
+ name was previously used for selecting apertures in the
+ recentering algorithm. The new parameter name for this is now
+ "aprecenter".
+ APALL, APSUM
+ The "nsubaps" parameter now allows onedspec and echelle output
+ formats. The echelle format is appropriate for treating each
+ subaperture as a full echelle extraction.
+ APALL
+ The aperture ID table information may now be contained in the
+ image header under the keywords SLFIBnnn.
+ APSUM
+ The dispersion axis parameter was moved to purely a package
+ parameter.
+
+ As a final step when computing a weighted/cleaned spectrum the
+ total fluxes from the weighted spectrum and the simple
+ unweighted spectrum (excluding any deviant and saturated
+ pixels) are computed and a "bias" factor of the ratio of the
+ two fluxes is multiplied into the weighted spectrum and the
+ sigma estimate. This makes the total fluxes the same. In this
+ version the bias factor is recorded in the logfile if one is
+ kept. Also a check is made for unusual bias factors. If the
+ two fluxes disagree by more than a factor of two a warning is
+ given on the standard output and the logfile with the individual
+ total fluxes as well as the bias factor. If the bias factor is
+ negative a warning is also given and no bias factor is applied.
+ In the previous version a negative (inverted) spectrum would
+ result.
+
+\fBRV:\fR
+ RVIDLINES, RVREIDLINES
+ These tasks now work in the units of the input spectra.
+ FXCOR
+ The input spectra are converted to Angstroms for the
+ crosscorrelation and analysis. Thus the velocities will
+ be correctly computed regardless of the units of the
+ input spectra.
+
+\fBDAOPHOT:\fR
+ DAOFIND
+ A major bug in the DAOFIND task centering code that affects the
+ computed x and y positions was fixed. Users should refer to bug
+ log entry number 332 for details. (V2.10.4p2)
+
+ A new roundness statistic was added to the DAOFIND output to
+ bring the task into conformance with standalone DAOPHOT II. The new
+ statistic is sensitive to and tries to eliminate detected objects
+ which are significantly elongated in directions other than 0, 90,
+ 180, and 270 degrees. The original roundness statistic is stored in
+ the ground column, the new one in the sround column. The same
+ default roundness limits apply to both statistics. (V2.10.4p2)
+
+ DAOPARS
+ Added a new parameter "mergerad" to the DAOPARS parameter set.
+ Mergerad permits the user to control the merging process. If
+ mergerad is INDEF (the default setting) the default merging radius
+ is used. If mergerad is 0 object merging is turned off altogether.
+ Otherwise the user can set the merging radius to a specific value.
+ Mergerad is used by the nstar and allstar tasks, but their default
+ behavior is unchanged. (V2.10.4p2)
+
+ Changed the name of the "critovlap" parameter to "critsnratio" to
+ avoid confusion with the meaning of the parameter especially
+ with regard the mergerad parameter. The behavior of the parameter is
+ unchanged. (V2.10.4p2)
+.fi
+.nh
+Parameter file changes
+
+The parameter file changes below are for modifications between V2.10.4
+and V2.11. For a list of parameter file changes between V2.10.3 and
+V2.10.4 see the file iraf/v210/params.v2104.Z in the IRAF FTP archives.
+
+In the tables below each parameter change is identified with one of the
+following codes followed by task_name.parameter_name and the description of
+the change.
+
+.nf
+ n = new parameter
+ c = changed/modified parameter
+ d = deleted parameter
+
+\fBTV:\fR
+ n display.nsample: replaces nsample_lines
+ d display.nsample_lines: replaced by nsample
+ n display.bpmask: specify a bad pixel mask
+ n display.bpdisplay: specify display mode for bad pixel mask
+ n display.bpcolors: specify overlay colors for bad pixel mask
+ n display.overlay: specify an overlay mask
+ n display.ocolors: specify overlay colors for overlay mask
+ n display.zmask: specify a sample mask for the zscale calculation
+ c imedit.xorder: now allows a value of zero for median background
+ c imedit.yorder: now allows a value of zero for median background
+ n rimexam.fittype: specify a profile type to fit - default is now moffat
+ n rimexam.iterations: specify number of iterations to adjust fitting radius
+ n rimexam.beta: specify beta value for moffat fitting
+ c rimexam.buffer: default value changed from 1 to 5
+ c rimexam.width: default value changed from 2 to 5
+ c rimexam.magzero: default value changed from 30 to 25
+ n wcslab.overplot: specify overplotting
+
+\fBDATAIO:\fR
+ n wfits.fextn: extension to append to output disk FITS filename - default is
+ fits
+ n wfits.extensions: write all images to a single FITS file ? - default is no
+ n wfits.global_hdr: prepend a global header to the FITS extensions - default
+ is yes
+
+\fBIMAGES:\fR
+ n fmedian.zloreject: good data minimum
+ n fmedian.zhireject: good data maximum
+ n fmedian.verbose: verbose option
+ n fmode.zloreject: good data minimum
+ n fmode.zhireject: good data maximum
+ n fmode.verbose: verbose option
+ n median.zloreject: good data minimum
+ n median.zhireject: good data maximum
+ n median.verbose: verbose option
+ n mode.zloreject: good data minimum
+ n mode.zhireject: good data maximum
+ n mode.verbose: verbose option
+ n geomap.transforms: list of record names
+ n geomap.results: results summary file
+ n geomap.fitgeometry: fitting geometry
+ d geomap.output: renamed to database
+ c geomap.reject: changed from 0.0 to INDEF
+ n [g]register.verbose: verbose option
+ d [g]register.transform: renamed to transfo
+ n geotran.verbose: verbose option
+ d geotran.transform: renamed to transforms
+ c imcombine.offsets: now allows specifying "wcs" to compute offsets from WCS
+ d imalign.images: renamed to input
+ c imalign.reference: went from hidden to auto
+ c imalign.coords: reversed places with reference
+ d imcentroid.images: renamed to input
+ c imcentroid.reference: went from hidden to auto
+ c imcentroid.coords: reversed places with reference
+ n imheader.imlist: default image names
+
+\fBPLOT:\fR
+ n graph.ltypes: specify the line types
+ n graph.colors: specify the colors
+
+\fBPROTO:\fR
+ n fixpix.masks: new version specifies bad pixel masks
+ n fixpix.linterp: specify mask values for line interpolation
+ n fixpix.cinterp: specify mask values for column interpolation
+ n fixpix.pixels: list pixels that are modified
+ d fixpix.badpixels: new version does not use bad pixel region description
+ c fields.lines: default value changed from "1-9999" to "1-"
+
+\fBARTDATA:\fR
+ n mk1dspec.profile: define the profile type
+ n mk1dspec.gfwhm: replaces sigma for gaussian profile width
+ n mk1dspec.lfwhm: width for lorentzian profile
+ c artdata.randbuf: default value changed from 1000 to 0.
+ c mkpattern.ndim: allows a value of 0 for a dataless header.
+ c mkpattern.pixtype: allows ushort.
+ c gallist.ar: default value changed to 0.3.
+ d mk1dspec.sigma: replaced by gfwhm
+
+\fBASTUTIL:\fR
+ n rvcorrect.keywpars: added to define keywords used
+ n asthedit.prompt: used for new calculator option
+ n asthedit.update: update the header
+ n asthedit.oldstyle: to allow backward compatibility
+
+\fBAPEXTRACT, IMRED\fR spectral packages:
+ n apnoise.apertures: select apertures to be used
+ n apfit.apertures: select apertures to be used
+ n apedit.apertures: select apertures to be used
+ n apfind.apertures: select apertures to be used
+ n apnormalize.apertures: select apertures to be used
+ n apscatter.apertures: select apertures to be used
+ n apsum.apertures: select apertures to be used
+ n aptrace.apertures: select apertures to be used
+ n apresize.apertures: select apertures to be used
+ n apmask.apertures: select apertures to be used
+ n apflatten.apertures: select apertures to be used
+ n aprecenter.apertures: select apertures to be used
+ n aprecenter.aprecenter: was what was previously the apertures parameter
+ n apall.apertures: select apertures to be used
+ n apall.aprecenter: was what was previously the apertures parameter
+
+\fBARGUS, HYDRA, SPECRED:\fR
+ n doargus.crval: for automatic line identifications
+ n doargus.crdelt: for automatic line identifications
+ n doargus.skyalign: night sky alignment option
+ n dohydra.crval: for automatic line identifications
+ n dohydra.crdelt: for automatic line identifications
+ n dohydra.skyalign: night sky alignment option
+ n dofibers.crval: for automatic line identifications
+ n dofibers.crdelt: for automatic line identifications
+ n dofibers.skyalign: night sky alignment option
+ n do3fiber.crval: for automatic line identifications
+ n do3fiber.crdelt: for automatic line identifications
+
+\fBARGUS, HYDRA, KPNOCOUDE, KPNOSLIT, SPECRED:\fR
+ c params.match: default value changed to -3 (3 pixels instead of Angstroms)
+ c sparams.match: default value changed to -3 (3 pixels instead of Angs)
+
+\fBONEDSPEC, IMRED\fR spectral packages:
+ d fitprofs.sigma: replaced by gfwhm
+ d fitprofs.function: replaced by profile
+ d fitprofs.fitsigmas: replaced by fitgfwhm
+ d rspectext.header: removed since the task now senses the header information
+
+\fBONEDSPEC, LONGSLIT, IMRED\fR spectral packages:
+ n identify.units: specify the desired units for the dispersion function
+ n identify.crval: for automatic line identifications
+ n identify.crdelt: for automatic line identifications
+ n identify.aidpars: parameter set for automatic line identifications
+ c identify.match: default value changed to -3 (3 pixels instead of Angstroms)
+ c identify.threshold: default value changed from 10 to 0.
+ c reidentify.match: default value changed to -3 (3 pixels instead of Angs)
+ c reidentify.threshold: default value changed from 10 to 0.
+ n reidentify.crval: for automatic line identifications
+ n reidentify.crdelt: for automatic line identifications
+ n reidentify.aidpars: parameter set for automatic line identifications
+ n reidentify.search: specify a search radius for the automatic line
+ identification algorithm
+ n ecidentify.units: specify the desired units for the dispersion function
+ n fitprofs.profile: define the profile type
+ n fitprofs.gfwhm: replaces sigma for gaussian profile width
+ n fitprofs.lfwhm: width for lorentzian profile
+ n fitprofs.fitgfwhm: replaces fitsigmas
+ n fitprofs.fitlfwhm: select whether to fit lorentzian profile widths
+ n fitprofs.nerrsample: allows control of the error calculation accuracy
+ n splot.nerrsample: allows control of the error calculation accuracy
+
+\fBCCDRED:\fR
+ c ccdproc.fixfile: this now specifies a bad pixel mask
+ c combine.offsets: now allows specifying "wcs" to compute from WCS
+
+\fBRV:\fR
+ n rvcorrect.par: Added the KEYWPARS pset declaration
+
+\fBDAOPHOT:\fR
+ c daopars.critsnratio: critical S/N ratio for group membership - changed
+ the name only from critovlap (V2.10.4p2)
+ n daopars.mergerad: critical object merging radius in scale units
+ (V2.10.4p2)
+.fi
+.endhelp