imwcs currently works only on images where the rotation about the center is known to within a few degrees It has been tested extensively only on images with near-zero rotation.
A plane-tangent projection (center right ascension and declination, plate scale, and rotation angle) is fit based on matches between stars in the image and stars in a reference catalog.
As of version 2.8.7, a set of image stars may be hand-matched to sky positions and used to get a WCS or set initial values for a reference catalog-based WCS (See example 6).
Specific catalogs which can be searched include:
Portions of imwcs have been turned into stand-alone programs which are useful in their own right. imsize decodes header information to print the size of the image on the sky. imcat finds the reference stars on that portion of the sky. imstar finds star coordinates within an image. immatch matches stars in an image with stars in a reference catalog.
1. Find image WCS using HST Guide Star Catalog Stars as references
2. Find image WCS using Digitized Sky Survey Stars as references
3. Using SExtractor to find stars in an image
4. Find image WCS using USNO-B1.0 Stars as references
5. Find image WCS using USNO-A2.0 Stars as references
6. Find image WCS using pre-matched stars and USNO-A2.0 Stars