| 1 |
WCSTools libwcs Subroutines (3.9.0, March 11, 2011) |
| 2 |
|
| 3 |
actread.c |
| 4 |
Return stars from the USNO ACT Reference Catalog |
| 5 |
binread.c |
| 6 |
Return stars from catalog files in the TDC binary catalog format |
| 7 |
catread.c |
| 8 |
Return stars from catalog files in the TDC ASCII catalog format |
| 9 |
catutil.c |
| 10 |
Subroutines for catalog identification and number range decoding |
| 11 |
cel.c |
| 12 |
WCSLIB spherical coordinate transformation drivers |
| 13 |
daoread.c |
| 14 |
Read x, y, and magnitude from DAOFIND output file and return x, y, and |
| 15 |
flux for use by IMSTAR or IMWCS. |
| 16 |
dateutil.c |
| 17 |
Subroutines for conversions between various date and time formats |
| 18 |
distort.c |
| 19 |
Subroutines for conversions between image pixel and focal plane coordinates |
| 20 |
dsspos.c |
| 21 |
dsspos() uses the WCS structure to compute sky coordinates given |
| 22 |
image pixel X and Y for images with Digitized Sky Survey plate solutions |
| 23 |
in their headers. dsspix() uses the WCS structure to compute image |
| 24 |
pixel X and Y given sky coordinates for DSS images. Algorithms from |
| 25 |
StSCI CASB. |
| 26 |
fileutil.c |
| 27 |
Subroutines for finding size and contents of ASCII files |
| 28 |
findstar.c |
| 29 |
findStars() gets the location and brightest pixel of stars in the given |
| 30 |
image. Included are subroutines to find and reject bright pixels and |
| 31 |
compute a star centroid. |
| 32 |
fitsfile.c |
| 33 |
FITS header and image reading and writing subroutines, including FITS |
| 34 |
table support. |
| 35 |
fitswcs.c |
| 36 |
GetWCSFITS() returns a WCS structure used by wcs.c subroutines from a FITS |
| 37 |
or IRAF .imh image, reading only the header. |
| 38 |
GetFITShead() returns a FITS header from a FITS or IRAF .imh image. |
| 39 |
DelWCS() delete the WCS keywords in a FITS header. |
| 40 |
fortcat.c |
| 41 |
Fortran wrapper subroutines for catalog reading subroutines ctgread() and ctgrnum() |
| 42 |
fortwcs.c |
| 43 |
Fortran wrapper subroutines for all useful subroutines in wcs.c and wcsinit.c |
| 44 |
gscread.c |
| 45 |
Return HST Guide Stars from standard CDROM format FITS table files for |
| 46 |
a given RA, Dec, and magnitude range or list of star numbers. |
| 47 |
gsc2read.c |
| 48 |
Return GSC II Stars using an HTTP query over the web for |
| 49 |
a given RA, Dec, and magnitude range or list of star numbers. |
| 50 |
hget.c |
| 51 |
Subroutines to extract values from FITS headers by keyword. |
| 52 |
Subroutines for parsing RA and Dec strings are included. |
| 53 |
hput.c |
| 54 |
Subroutines to implant values into FITS headers by keyword (and to |
| 55 |
delete headers). |
| 56 |
iget.c |
| 57 |
Subroutines to extract values from IRAF multi-keyword header parameters |
| 58 |
imhfile.c |
| 59 |
IRAF header and image reading and writing subroutines. IRAF headers |
| 60 |
are converted to FITS headers for use by other programs and can be |
| 61 |
derived from FITS headers for writing. |
| 62 |
imio.c |
| 63 |
Subroutines to get, put, and move pixels of various data types between images |
| 64 |
im memory and a program. |
| 65 |
imrotate.c |
| 66 |
RotFITS() rotates an image by 90, 180, or 270 degrees, with an optional |
| 67 |
left-right reflection before the rotation. |
| 68 |
imgetwcs.c |
| 69 |
GetWCSFITS() reads world coordinate system header information and returns |
| 70 |
the image center coordinates and size as well as the wcs data structure. |
| 71 |
imsetwcs.c |
| 72 |
SetWCSFITS() uses findStars to find the stars in an image, gscread to |
| 73 |
find the Guide Stars in the nominal image region, and findRegisration or |
| 74 |
findCoords to fit plate-tangent WCS to the image. |
| 75 |
lin.c |
| 76 |
WCSLIB linear transformation subroutines |
| 77 |
matchstar.c |
| 78 |
StarMatch() takes a list of reference star positions and a list |
| 79 |
of object coordinates from an image and finds the image pixels |
| 80 |
which correspond to each of the reference stars. It then uses these |
| 81 |
matches to get an image center, plate scale, and rotation. The actual |
| 82 |
fit is based on the amoeba subroutine in Numerical Recipes, and all |
| 83 |
necessary subroutines are included. |
| 84 |
platepos.c |
| 85 |
platepos() uses the WCS structure to compute sky coordinates given |
| 86 |
image pixel X and Y for images with polynomial plate solutions |
| 87 |
in their headers. platepix() uses the WCS structure to compute image |
| 88 |
pixel X and Y given sky coordinates for such images. Algorithms are based |
| 89 |
on those in dsspos.c, but go straight from pixels to angles without an |
| 90 |
intermediate plate coordinate. |
| 91 |
poly.c |
| 92 |
Polynomial evaluation for SCAMP distortion correction |
| 93 |
proj.c |
| 94 |
WCSLIB spherical map projection subroutines |
| 95 |
sdssread.c |
| 96 |
Return Sloan Digital Sky Survey Photometry Catalog sources using an |
| 97 |
HTTP query over the web for a given RA, Dec, and magnitude range. |
| 98 |
sortstars.c |
| 99 |
Subroutines to sort lists of stars by right ascension, magnitude, or flux |
| 100 |
sph.c |
| 101 |
WCSLIB spherical coordinate transformation subroutines |
| 102 |
tabread.c |
| 103 |
Return stars from a tab table format catalog file for a given RA, Dec, |
| 104 |
and magnitude range or list of star numbers. Based on John Roll's |
| 105 |
Starbase format. |
| 106 |
tmcread.c |
| 107 |
Return 2MASS Point Source Catalog stars from the catalog as ungzipped from |
| 108 |
the DVD into (or linked from) a common root directory for a given RA, Dec, |
| 109 |
and magnitude range or list of star numbers. Both IDR2 and All-Sky release |
| 110 |
formats are supported. |
| 111 |
tnxpos.c |
| 112 |
tnxpos() uses the WCS keywords set up for IRAF's TNX projection to compute |
| 113 |
sky coordinates given image pixel X and Y. tnxpix() uses the WCS structure |
| 114 |
to compute image pixel X and Y given sky coordinates for such images. The |
| 115 |
projection is a tangent plane with corrections between the rotation and |
| 116 |
scaling and the actual projection. |
| 117 |
uacread.c |
| 118 |
Return USNO A and SA Catalog stars from their standard CDROM format |
| 119 |
files for a given RA, Dec, and magnitude range or list of star numbers. |
| 120 |
ubcread.c |
| 121 |
Return USNO B Catalog stars from their standard format files for a |
| 122 |
given RA, Dec, and magnitude range or list of star numbers. |
| 123 |
ucacread.c |
| 124 |
Return USNO UCAC1, UCAC2, or UCAC3 Catalog stars from their standard format |
| 125 |
files for a given RA, Dec, and magnitude range or list of star numbers. |
| 126 |
ujcread.c |
| 127 |
Return USNO UJ Catalog stars from its standard CDROM format files for |
| 128 |
a given RA, Dec, and magnitude range or list of star numbers. |
| 129 |
wcs.c |
| 130 |
Subroutines for using FITS or IRAF header spatial world coordinate |
| 131 |
system information. |
| 132 |
wcsinit.c |
| 133 |
Subroutines to initialize WCS structure from a FITS header |
| 134 |
wcscon.c |
| 135 |
Subroutines for converting between B1950, J2000, and galactic |
| 136 |
coordinates, mostly based on Starlink SLA_LIB subroutines. |
| 137 |
webread.c |
| 138 |
Open Starbase files across the Internet using HTTP queries |
| 139 |
worldpos.c |
| 140 |
worldpos() uses the WCS structure to compute sky coordinates given |
| 141 |
image pixel X and Y for images with header information for any of 8 |
| 142 |
standard world coordinate systems. worldpix() uses the WCS structure |
| 143 |
to compute image pixel X and Y given sky coordinates for the same images. |
| 144 |
Mostly from NRAO. |
| 145 |
zpxpos.c |
| 146 |
zpxpos() uses the WCS keywords set up for IRAF's ZPX projection to |
| 147 |
compute sky coordinates given image pixel X and Y. zpxpix() uses |
| 148 |
the WCS structure to compute image pixel X and Y given sky coordinates |
| 149 |
for such images. The projection is a tangent plane with corrections |
| 150 |
between the rotation and scaling and the actual projection. |
| 151 |
|
| 152 |
fitshead.h |
| 153 |
Declarations of FITS header access subroutines |
| 154 |
fitsfile.h |
| 155 |
Declarations of image access subroutines and FITS table data structure. |
| 156 |
imio.h |
| 157 |
Declarations of subroutines to convert binary formats of numbers |
| 158 |
lwcs.h |
| 159 |
Constants used by star-finding and WCS-setting subroutines |
| 160 |
wcscat.h |
| 161 |
Declarations for star catalog data structures |
| 162 |
wcs.h |
| 163 |
Declaration of WCS data structure and useful conversions. |
| 164 |
wcslib.h |
| 165 |
Declarations for WCSLIB high level driver subroutines, trig and inverse |
| 166 |
trig functions, spherical map projection subroutines, spherical coordinate |
| 167 |
transformation drivers, and linear transformation subroutines |
| 168 |
|
| 169 |
* Notes: |
| 170 |
WCSLIB subroutines were written by Mark Calabretta of CSIRO and have |
| 171 |
been modified in several ways: |
| 172 |
1) His distributed wcs.h has been changed to wcslib.h, and |
| 173 |
2) wcstrig.c subroutine names have been changed from <function>d() |
| 174 |
to <function>deg() to avoid name conflicts on some operating |
| 175 |
systems. |
| 176 |
3) ifndef's at start of headers files have been named to reflect |
| 177 |
the names of the header files, i.e. wcslib_h_ in wcslib.h. |
| 178 |
4) All header files have been combined into wcslib.h |
| 179 |
5) Emmanuel Bertin's SCAMP distortion has been added to proj.c:1 |