.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.4.
.TH WCSWARE "1" "May 2024" "wcsware 8.3" "User Commands"
.SH NAME
wcsware \- Extract FITS WCS keywords for an image
.SH SYNOPSIS
.B wcsware
[\fI<option>\fR]... [\fI<fitsfile>\fR]
.SH 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.
.PP
By default, all known extensions to the FITS WCS standard are allowed,
including deprecated usage.  However, in "lint" mode, strict conformance
to the standard is enforced.
.PP
The FITS file may be specified according to the syntax understood by
cfitsio, for example "file.fits.gz+1" refers to the first extension (the
second HDU) of a gzip'd FITS file.  Use "\-" or omit the file name for
input from stdin.
.SH OPTIONS
.TP
\fB\-a\fR<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.
.TP
\fB\-b\fR
Use wcsbth() for primary image headers, normally wcspih()
is used.  (Implies \fB\-i\fR.)
.TP
\fB\-c\fR
Apply wcspcx() to the wcsprm struct to decompose CDi_ja
into PCi_ja and CDELTia.
.TP
\fB\-cp\fR
As for \fB\-c\fR, and also unscramble axes.
.TP
\fB\-C\fR
As for \fB\-c\fR, decompose CDi_ja if present, otherwise recompose
PCi_ja and CDELTia.
.TP
\fB\-Cp\fR
As for \fB\-C\fR, and also unscramble axes.
.TP
\fB\-f\fR
Apply wcsfix() to the header.
.TP
\fB\-h\fR<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.
.TP
\fB\-i\fR
Allow image header WCS keywords in binary table headers.
.TP
\fB\-l\fR
Validate (lint) the WCS keyrecords in the specified FITS
header for conformance to the WCS standard.  (Implies \fB\-s\fR.)
.TP
\fB\-m\fR
Apply wcstrim() to the wcsprm struct.
.TP
\fB\-o\fR
Use wcshdo() to translate the wcsprm struct into a FITS
header and print it.
.TP
\fB\-p\fR
Print the struct(s) using wcsprt() (default operation).
.TP
\fB\-P\fR
Same as \fB\-p\fR but don't print a default struct.
.TP
\fB\-r\fR
Require strict adherence to the FITS WCS standard, though
allowing the deprecated AIPS\-convention keywords, CROTAn,
EPOCH, and VELREF, and also some other deprecated usage.
(Must follow \fB\-l\fR if relaxed linting is required.)
.TP
\fB\-s\fR
Require strict adherence to the FITS WCS standard,
disallowing all deprecated features.
.TP
\fB\-t\fR
Terse (with \fB\-l\fR), report rejected WCS keyrecords only.
.TP
\fB\-v\fR
Verbose (with \fB\-l\fR), report recognised WCS keyrecords as well.
.TP
\fB\-w\fR
Convert world coordinates, obtained from stdin, to pixel
coordinates using wcss2p().
.TP
\fB\-x\fR
Convert pixel coordinates, obtained from stdin, to world
coordinates using wcsp2s().
.TP
\fB\-z\fR
Print the size of the wcsprm struct, including allocated
memory.