SYNOPSIS

fitsverify filename ...

fitsverify @filelist.txt

DESCRIPTION

This task reads one or more input FITS files and verifies that the files conform to the specifications of the FITS Standard document (known as the NASA/Science Office of Standards and Technology 'Definition of the Current FITS Standard', document number, NOST 100-2.0, available online at http://fits.gsfc.nasa.gov/). The input filename template may contain wildcard characters, in which case all matching files will be tested. Alternatively, the name of an ASCII text file containing a list of file names, one per line, may be entered preceded by an '@' character.

OPTIONS

-l

list all header keywords

-q

quiet; print one-line pass/fail summary per file

-e

only test for error conditions; don't issue warnings

-h

Help

ERROR CONDITIONS

\[bu]

Mandatory keyword not present or out of order

\[bu]

Mandatory keyword has wrong datatype or illegal value

\[bu]

END header keyword is not present

\[bu]

Sum of table column widths is inconsistent with NAXIS1 value

\[bu]

BLANK keyword present in image with floating-point datatype

\[bu]

TNULLn keyword present for floating-point binary table column

\[bu]

Bit column has non-zero fill bits or is not left adjusted

\[bu]

ASCII TABLE column contains illegal value inconsistent with TFORMn

\[bu]

Address to a variable length array not within the data heap

\[bu]

Extraneous bytes in the FITS file following the last HDU

\[bu]

Mandatory keyword values not expressed in fixed format

\[bu]

Mandatory keyword duplicated elsewhere in the header

\[bu]

Header contains illegal ASCII character (not ASCII 32 - 126)

\[bu]

Keyword name contains illegal character

\[bu]

Keyword value field has illegal format

\[bu]

Value and comment fields not separated by a slash character

\[bu]

END keyword not filled with blanks in columns 9 - 80

\[bu]

Reserved keyword with wrong datatype or illegal value

\[bu]

EXTEND not present in the primary array if there are extensions

\[bu]

BLOCKED, if present, not among the first 36 keywords

\[bu]

XTENSION keyword in the primary array

\[bu]

Column related keyword (TFIELDS, TTYPEn,TFORMn, etc.) in an image

\[bu]

SIMPLE, EXTEND, or BLOCKED keyword in any extension

\[bu]

BSCALE, BZERO, BUNIT, BLANK, DATAMAX, DATAMIN keywords in a table

\[bu]

Image WCS keywords (CTYPEn, CRPIXn, CRVALn, etc.) in a table

\[bu]

Table WCS keywords (TCTYPn, TCRPXn, TCRVLn, etc.) in an image

\[bu]

TDIMn or THEAP keyword in an ASCII table

\[bu]

TBCOLn keyword in a Binary table

\[bu]

THEAP keyword in a binary table that has PCOUNT = 0

\[bu]

XTENSION, TFORMn, TDISPn or TDIMn value contains leading space(s)

\[bu]

Index of any WCS keyword (CRPIXn, CRVALn, etc.) greater than value of WCSAXES

\[bu]

Index of any table column descriptor keyword (TTYPEn, TFORMn, etc.) greater than value of TFIELDS

\[bu]

TSCALn or TZEROn present for an ASCII, logical, or Bit column

\[bu]

TDISPn value is inconsistent with the column datatype

\[bu]

Length of a variable length array greater than the maximum length as given by the TFORMn keyword

\[bu]

Logical column contains illegal value not equal to 'T', 'F', or 0

\[bu]

Character string column contains non-ASCII text character

\[bu]

Header fill bytes not all blanks

\[bu]

Data fill bytes not all blanks in ASCII tables or all zeros in any other type of HDU

\[bu]

Gaps between defined ASCII table columns contain characters with ASCII value > 127

WARNING CONDITIONS

\[bu]

SIMPLE = F

\[bu]

Presence of deprecated keywords BLOCKED or EPOCH

\[bu]

2 HDUs have identical EXTNAME, EXTVER, and EXTLEVEL values

\[bu]

BSCALE or TSCALn value = 0.

\[bu]

BLANK OR TNULLn value exceeds the legal range

\[bu]

TFORMn has 'rAw' format and r is not a multiple of w

\[bu]

DATE = 'dd/mm/yy' and yy is less than 10 (Y2K problem??)

\[bu]

Index of any WCS keyword (CRPIXn, CRVALn, etc.) greater than value of NAXIS, if the WCSAXES keyword is not present

\[bu]

Duplicated keyword (except COMMENT, HISTORY, blank, etc.)

\[bu]

Column name (TTYPEn) does not exist or contains characters other than letter, digit and underscore

\[bu]

Calculated checksum inconsistent with CHECKSUM or DATASUM keyword

AUTHOR

HEASARC at NASA/GSFC

REPORTING BUGS

http://heasarc.gsfc.nasa.gov/cgi-bin/ftoolshelp