1WCSWARE(1)                       User Commands                      WCSWARE(1)
2
3
4

NAME

6       wcsware - Extract FITS WCS keywords for an image
7

SYNOPSIS

9       wcsware [<option>]... [<fitsfile>]
10

DESCRIPTION

12       wcsware  extracts the WCS keywords for an image from the specified FITS
13       file, constructs wcsprm  structs  for  each  coordinate  representation
14       found  and  performs a variety of operations using them.  It features a
15       "lint" capability as one of its more useful operations.
16
17       By default, all known extensions to the FITS WCS standard are  allowed,
18       including  deprecated  usage.   However, in "lint" mode, strict confor‐
19       mance to the standard is enforced.
20
21       The FITS file may be specified according to the  syntax  understood  by
22       cfitsio,  for example "file.fits.gz+1" refers to the first extension of
23       a gzip'd FITS file.  Use "-" or omit  the  file  name  for  input  from
24       stdin.
25

OPTIONS

27       -a<alt>
28              Specify an alternate coordinate representation (ignored if there
29              is only one).  Can also be specified as a  0-relative  index  in
30              the range 0 to 26, where alternates are sequenced alphabetically
31              following the primary representation.
32
33       -b     Use wcsbth() for primary image  headers,  normally  wcspih()  is
34              used.  (Implies -i.)
35
36       -c     Apply  wcspcx()  to  the  wcsprm struct to decompose CDi_ja into
37              PCi_ja and CDELTia.
38
39       -cp    As for -c, and also unscramble axes.
40
41       -C     As for -c, decompose  CDi_ja  if  present,  otherwise  recompose
42              PCi_ja and CDELTia.
43
44       -Cp    As for -C, and also unscramble axes.
45
46       -f     Apply wcsfix() to the header.
47
48       -h<hdu>
49              Move  to HDU number (1-relative) which is expected to contain an
50              image array.  Overrides cfitsio extended filename syntax.   Also
51              useful for input from stdin.
52
53       -i     Allow image header WCS keywords in binary table headers.
54
55       -l     Validate  (lint) the WCS keyrecords in the specified FITS header
56              for conformance to the WCS standard.  (Implies -s.)
57
58       -m     Apply wcstrim() to the wcsprm struct.
59
60       -o     Use wcshdo() to translate the wcsprm struct into a  FITS  header
61              and print it.
62
63       -p     Print the struct(s) using wcsprt() (default operation).
64
65       -P     Same as -p but don't print a default struct.
66
67       -r     Require strict adherence to the FITS WCS standard, though allow‐
68              ing the deprecated AIPS-convention keywords, CROTAn, EPOCH,  and
69              VELREF,  and  also some other deprecated usage.  (Must follow -l
70              if relaxed linting is required.)
71
72       -s     Require strict adherence to the FITS WCS  standard,  disallowing
73              all deprecated features.
74
75       -t     Terse (with -l), report rejected WCS keyrecords only.
76
77       -v     Verbose (with -l), report recognised WCS keyrecords as well.
78
79       -w     Convert world coordinates, obtained from stdin, to pixel coordi‐
80              nates using wcss2p().
81
82       -x     Convert pixel coordinates, obtained from stdin, to world coordi‐
83              nates using wcsp2s().
84
85       -z     Print the size of the wcsprm struct, including allocated memory.
86
87
88
89wcsware 7.10                      April 2022                        WCSWARE(1)
Impressum