diagram a [Home]
diagram b
 
     
 

FITS World Coordinate Systems

 

Literature

The FITS "World Coordinate System" (WCS) convention defines keywords and usage that provide for the description of astronomical coordinate systems in a FITS image header.

Electronic versions of the four (WCS) papers and related background material are available:

I: "Representations of world coordinates in FITS", Greisen, E.W. & Calabretta, M.R. (2002), Astronomy & Astrophysics, 395, 1061-1075.   (gzip'd PostScript version)

Also a supplement to Paper I entitled Concatenation of FITS World Coordinate Systems by Steve Allen and Doug Mink.

II: "Representations of celestial coordinates in FITS", Calabretta. M.R., & Greisen, E.W., (2002), Astronomy & Astrophysics, 395, 1077-1122.   (gzip'd PostScript version)

III: "Representations of spectral coordinates in FITS", Greisen, E.W., Calabretta, M.R. Valdes, F.G., & Allen, S.L., (2006), Astronomy & Astrophysics, 446, 747-771.   (gzip'd PostScript version)

IV: "Representations of distortions in FITS world coordinate systems", Calabretta, Valdes, Greisen, & Allen, draft dated 2004/04/22.   (PDF version)

Miscellaneous notes on the derivation of some formulae and special conditions in Paper II, dated 2004/02/11.   (PDF version)

 

This diagram illustrating Bonne's projection with conformal latitude +35° was produced by WCSLIB, a C implementation of the coordinate transformations defined in the FITS WCS papers. The non-oblique native graticule is in dark green.

The oblique 15° celestial graticule centred on celestial coordinates (0°, +45°) with north celestial pole at native coordinates (45°, 0°) is colour-coded blue, red and white (in increasing order) with the equator and prime meridian in yellow.


Errata dated 2007/12/22 for Papers I, II & III.   (PDF version)

"Mapping on the HEALPix grid", Calabretta & Roukema, as accepted by Monthly Notices of the Royal Astronomical Society (MNRAS) on 2007/07/25, introduces the HPX projection type. (gzip'd PostScript version)

The official refereed version of the paper was published as MNRAS 381 865, and can be accessed from ADS .

Introduction to celestial coordinate systems; slides (in HTML) from a talk explaining FITS world coordinate systems.

 

Software &c.

WCSLIB is implemented in C, with support for FORTRAN via a set of wrapper functions.

The main change in WCSLIB 4.4.x (4.4.4 as of 2009/09/14) is a doxygen-generated programming manual (HTML and PDF) which should make it easier to navigate around the WCSLIB functions and data structures.



A general curvilinear axis drawing routine, PGSBOX, for PGPLOT that can optionally interface to WCSLIB has been included with WCSLIB since version 2.5.



Utility program, HPXcvt converts 1D HEALPix pixelization data stored in a variety of forms in FITS, including ring or nested organization in a binary table extension, into a 2D primary image array with HPX coordinate representation. It has been included with WCSLIB since version 4.3.

An example (13MiB bzip'd) is provided of its application to the WMAP 3-year Internal Linear Combination map.



Example FITS files produced for each of the projections in Paper II and for a selection of spectral representations from Paper III, are available for testing purposes.

 

Dr. Mark R. Calabretta ( mcalabre@atnf.csiro.au)
Last modified: 2010/01/20