Readme   Readme 
WCSTools 3.8.4 WCSTools 3.8.5
WCSTools is a set of software utilities, written in C, which create, WCSTools is a set of software utilities, written in C, which create,
display and manipulate the world coordinate system of a FITS or IRAF display and manipulate the world coordinate system of a FITS or IRAF
image, using specific keywords in the image header which relate pixel image, using specific keywords in the image header which relate pixel
position within the image to position on the sky. Auxillary programs position within the image to position on the sky. Auxillary programs
search star catalogs and manipulate images. search star catalogs and manipulate images.
To make the entire package, type To make the entire package, type
make all make all
in the main directory or, on Solaris machines in the main directory or, on Solaris machines
make -f Makefile.solaris make -f Makefile.solaris
This is version 3.8.4 of the WCSTools package developed by Doug Mink This is version 3.8.5 of the WCSTools package developed by Jessica Mink
(dmink@cfa.harvard.edu) at the Smithsonian Astrophysical Observatory, (jmink@cfa.harvard.edu) at the Smithsonian Astrophysical Observatory,
with significant code or algorithms from with significant code or algorithms from
Mark Calabretta of CSIRO (projection), Mark Calabretta of CSIRO (projection),
Bill Cotton of NRAO (projection), Bill Cotton of NRAO (projection),
Jesse Doggett and Rick White of StScI (DSS projection) Jesse Doggett and Rick White of StScI (DSS projection)
Elwood Downey of the University of Iowa (WCS fitting procedure), Elwood Downey of the University of Iowa (WCS fitting procedure),
John Roll of SAO (network access), John Roll of SAO (network access),
Jing Li of IPAC (SIP distortion), Jing Li of IPAC (SIP distortion),
Pat Wallace of Rutherford Appleton Laboratory, UK (coordinate conversion), Pat Wallace of Rutherford Appleton Laboratory, UK (coordinate conversion),
Frank Valdes of NOAO (support for NOAO's ZPX projection), and Frank Valdes of NOAO (support for NOAO's ZPX projection), and
skipping to change at line 42 skipping to change at line 42
Marquette of the Institut d'Astrophysique de Paris, and David Shupe of IPAC Marquette of the Institut d'Astrophysique de Paris, and David Shupe of IPAC
helped debug the subroutine library. helped debug the subroutine library.
Norman Grogin, Scott Kenyon, Susan Tokarz, Dan Koranyi, Guillermo Torres, Norman Grogin, Scott Kenyon, Susan Tokarz, Dan Koranyi, Guillermo Torres,
Steve Willner, Gus Muensch, Ed Los and others of the CfA and Andreas Jaunse n Steve Willner, Gus Muensch, Ed Los and others of the CfA and Andreas Jaunse n
helped debug the astrometry programs. helped debug the astrometry programs.
Sergio Pascual of the Universidad Complutense de Madrid helped me get Sergio Pascual of the Universidad Complutense de Madrid helped me get
all of the variables initialized. all of the variables initialized.
Details of updates are in the NEWS file, but here is what is new: Details of updates are in the NEWS file, but here is what is new:
Version 3.8.4 (September 1, 2011) Version 3.8.5 (April 12, 2012)
cphead, keyhead, sethead: Fix overflow bug by increasing size of history fr getdate: Fix string overflow in ts0 assignment (2012-03-27)
om 72 to 128 gethead: If length of header/file content string is zero, exit with error
imgetwcs.c, wcsinit.c, wcs.c, wcs.h, worldpos.c: Add TPV WCS for TAN with P sumpix: Improve argument parsing so order doesn't matter (2012-02-01)
V terms matchstar.c: Fix bug in WCSMatch() which miscomputed means
fitsfile.c: Always check first 8 characters of FITS files for "SIMPLE"
imhfile.c: Fix potential overflow in newpixfile assignment (2012-03-27)
imio.c: Change 8-bit pixel values from char to unsigned char
Documentation, with examples and installation directions, is on the Documentation, with examples and installation directions, is on the
World Wide Web at World Wide Web at
http://tdc-www.harvard.edu/software/wcstools/ http://tdc-www.harvard.edu/software/wcstools/
References References
If the WCSTools package has proven useful in your work, please reference If the WCSTools package has proven useful in your work, please reference
at least one of the following papers. If you want to find out which is at least one of the following papers. If you want to find out which is
most applicable, the full texts are available on the WCSTools web site at most applicable, the full texts are available on the WCSTools web site at
http://tdc-www.harvard.edu/software/wcstools/publications/ http://tdc-www.harvard.edu/software/wcstools/publications/
The paper presented at ADASS in 1996 is the best published description The paper presented at ADASS in 1996 is the best published description
of the IMWCS world coordinate system fitting program: of the IMWCS world coordinate system fitting program:
"WCSTools: Putting Image World Coordinate Systems to Use", "WCSTools: Putting Image World Coordinate Systems to Use",
Douglas J. Mink, 1997, in Astronomical Data Analysis Software and Douglas J. Mink, 1997, in Astronomical Data Analysis Software and
Systems VI, A.S.P. Conference Series, Vol. 125, Gareth Hunt and Systems VI, A.S.P. Conference Series, Vol. 125. Edited by Gareth Hunt
H. E. Payne, eds., pp. 249-252. and H. E. Payne.
San Francisco: Astronomical Society of the Pacific, pp. 249-252.
The 1998 ADASS paper is the best published description of the other tools The 1998 ADASS paper is the best published description of the other tools
in the WCSTools package, including SAOimage when used for WCS work: in the WCSTools package, including SAOimage when used for WCS work:
"WCSTools: An Image Astrometry Toolkit", "WCSTools: An Image Astrometry Toolkit",
Douglas J. Mink (1998), in Astronomical Data Analysis Software and Douglas J. Mink, 1999, in Astronomical Data Analysis Software and
Systems VIII, A.S.P. Conference Series, Vol. 172, 1999, Dave Mehringer Systems VIII A.S.P. Conference Series, Vol. 172. Edited by Dave
, Mehringer, Ray Plante, and Doug Roberts.
Ray Plante, Doug Roberts, eds., pp. 498-501. San Francisco: Astronomical Society of the Pacific, pp. 498-501.
A paper presented at the 2001 ADASS conference describes how the A paper presented at the 2001 ADASS conference describes how the
WCSTools package uses the web, among other new features: WCSTools package uses the web, among other new features:
"WCSTools 3.0: More Tools for Image Astrometry and Catalog Searching", "WCSTools 3.0: More Tools for Image Astrometry and Catalog Searching",
Douglas J. Mink, 2001, to be published in Astronomical Data Analysis Douglas J. Mink, in Astronomical Data Analysis Software and Systems XI
Software and Systems XI, whenever it comes out. ,
A.S.P. Conference Series, Vol. 281, 2002. Edited by David
Bohlender, Daniel Durand, and T.H. Handley.
San Francisco: Astronomical Society of the Pacific, pp. 169-172.
This paper presented at the 2002 ADASS conference describes interesting This paper presented at the 2002 ADASS conference describes interesting
ways to use the SCAT program: ways to use the SCAT program:
"Federating Catalogs and Interfacing Them with Archives: A VO Prototyp e", "Federating Catalogs and Interfacing Them with Archives: A VO Prototyp e",
Douglas J. Mink and Michael J. Kurtz, 2002, to be published in Douglas J. Mink and Michael J. Kurtz, 2003, in Astronomical Data Analy
Astronomical Data Analysis Software and Systems XII, whenever it comes sis
out. Software and Systems XII, A.S.P. Conference Proceedings, Vol. 295.
Edited by Harry Payne, Robert Jedrzejewski, and Richard Hook.
San Francisco: Astronomical Society of the Pacific, pp. 51-54.
To assist users in selecting the best catalog to use, we tested the accurac y of To assist users in selecting the best catalog to use, we tested the accurac y of
the various catalogs one is likely to use with imwcs, showing how well it w orks the various catalogs one is likely to use with imwcs, showing how well it w orks
in a pipeline mode on 1728 images. This ADASS paper is an improved version of in a pipeline mode on 1728 images. This ADASS paper is an improved version of
our AAS/DDA paper, adding the UCAC2 catalog and emphasizing usefulness more than our AAS/DDA paper, adding the UCAC2 catalog and emphasizing usefulness more than
astrometry: astrometry:
"A Comparison of Large All-Sky Catalogs" Douglas J. Mink, Warren R. Br "A Comparison of Large All-Sky Catalogs",
own, Douglas J. Mink, Warren R. Brown, and Michael J. Kurtz, 2004, in
and Michael J. Kurtz in Astronomical Data Analysis Software and Systems XII Astronomical Data Analysis Software and Systems XIII, A.S.P. Conferenc
I, e
ASP Conference Proceedings, Vol. 314. Edited by Francois Oschenbein, Mark A Proceedings, Vol. 314. Edited by Francois Oschenbein, Mark Allen,
llen, and Daniel Egret.
and Daniel Egret. San Francisco: Astronomical Society of the Pacific, San Francisco: Astronomical Society of the Pacific, pp. 141-144.
ISSN: 1080-7926, 2004., p. 141.
Program Descriptions Program Descriptions
addpix Add a constant value(s) to specified pixel(s) addpix Add a constant value(s) to specified pixel(s)
bincat Bin a catalog into a FITS image in flux or number bincat Bin a catalog into a FITS image in flux or number
conpix Operate on all of the pixels of an image conpix Operate on all of the pixels of an image
cphead Copy keyword values between FITS or IRAF images cphead Copy keyword values between FITS or IRAF images
delhead Delete specified keywords from FITS or IRAF image file heade rs delhead Delete specified keywords from FITS or IRAF image file heade rs
delwcs Delete the WCS keywords from an image. If both EPOCH and EQUINOX delwcs Delete the WCS keywords from an image. If both EPOCH and EQUINOX
are present, EQUINOX is also deleted. are present, EQUINOX is also deleted.
skipping to change at line 158 skipping to change at line 170
simpos Return RA and Dec for object name (or list of them) using SIMBAD simpos Return RA and Dec for object name (or list of them) using SIMBAD
sky2xy Print image pixel coordinates for given sky coordinates on the sky2xy Print image pixel coordinates for given sky coordinates on the
command line or in a list file. command line or in a list file.
skycoor Convert between J2000, B1950, and Galactic coordinates from the skycoor Convert between J2000, B1950, and Galactic coordinates from the
command line or a file. command line or a file.
sumpix Total pixel values over an image row or column or a specified area sumpix Total pixel values over an image row or column or a specified area
wcshead Print basic world coordinate system information on one line per image wcshead Print basic world coordinate system information on one line per image
xy2sky Print sky coordinates for given image pixel coordinates on the comma nd xy2sky Print sky coordinates for given image pixel coordinates on the comma nd
line or in a list file. line or in a list file.
-Doug Mink, SAO, 2011-09-01 -Jessica Mink, SAO, 2012-04-12
 End of changes. 9 change blocks. 
27 lines changed or deleted 35 lines changed or added

This html diff was produced by rfcdiff 1.41. The latest version is available from http://tools.ietf.org/tools/rfcdiff/