wcsware(1) User Commands wcsware(1)
NAME
wcsware - Extract FITS WCS keywords for an image
SYNOPSIS
wcsware [<option>]... [<fitsfile>]
DESCRIPTION
wcsware extracts the WCS keywords for an image from the specified FITS
file, constructs wcsprm structs for each coordinate representation
found and performs a variety of operations using them. It features a
"lint" capability as one of its more useful operations.
By default, all known extensions to the FITS WCS standard are allowed,
including deprecated usage. However, in "lint" mode, strict confor-
mance to the standard is enforced.
The FITS file may be specified according to the syntax understood by
cfitsio, for example "file.fits.gz+1" refers to the first extension of
a gzip'd FITS file. Use "-" or omit the file name for input from
stdin.
OPTIONS
-a<alt>
Specify an alternate coordinate representation (ignored if there
is only one). Can also be specified as a 0-relative index in
the range 0 to 26, where alternates are sequenced alphabetically
following the primary representation.
-b Use wcsbth() for primary image headers, normally wcspih() is
used. (Implies -i.)
-c Apply wcspcx() to the wcsprm struct to decompose CDi_ja into
PCi_ja and CDELTia.
-cp As for -c, and also unscramble axes.
-C As for -c, decompose CDi_ja if present, otherwise recompose
PCi_ja and CDELTia.
-Cp As for -C, and also unscramble axes.
-f Apply wcsfix() to the header.
-h<hdu>
Move to HDU number (1-relative) which is expected to contain an
image array. Overrides cfitsio extended filename syntax. Also
useful for input from stdin.
-i Allow image header WCS keywords in binary table headers.
-l Validate (lint) the WCS keyrecords in the specified FITS header
for conformance to the WCS standard. (Implies -s.)
-m Apply wcstrim() to the wcsprm struct.
-o Use wcshdo() to translate the wcsprm struct into a FITS header
and print it.
-p Print the struct(s) using wcsprt() (default operation).
-P Same as -p but don't print a default struct.
-r Require strict adherence to the FITS WCS standard, though allow-
ing the deprecated AIPS-convention keywords, CROTAn, EPOCH, and
VELREF, and also some other deprecated usage. (Must follow -l
if relaxed linting is required.)
-s Require strict adherence to the FITS WCS standard, disallowing
all deprecated features.
-t Terse (with -l), report rejected WCS keyrecords only.
-v Verbose (with -l), report recognised WCS keyrecords as well.
-w Convert world coordinates, obtained from stdin, to pixel coordi-
nates using wcss2p().
-x Convert pixel coordinates, obtained from stdin, to world coordi-
nates using wcsp2s().
-z Print the size of the wcsprm struct, including allocated memory.
wcsware 7.7 July 2021 wcsware(1)
wcslib 7.7 - Generated Sat Jan 29 09:13:18 CST 2022