NAME

       fitsverify - test if file conform to the FITS format

SYNOPSIS

       fitsverify [OPTION]... FILE...
       fitsverify [OPTION]... @FILELIST

DESCRIPTION

       fitsverify  is  a utility program designed to verify that 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 https://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

       Flags must be separate and appear before filenames.

       -H     Test ESO HIERARCH keywords

       -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     Show help.

ERROR CONDITIONS

       • Mandatory keyword not present or out of order

       • Mandatory keyword has wrong datatype or illegal value

       • END header keyword is not present

       • Sum of table column widths is inconsistent with NAXIS1 value

       • BLANK keyword present in image with floating-point datatype

       • TNULLn keyword present for floating-point binary table column

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

       • ASCII TABLE column contains illegal value inconsistent with TFORMn

       • Address to a variable length array not within the data heap

       • Extraneous bytes in the FITS file following the last HDU

       • Mandatory keyword values not expressed in fixed format

       • Mandatory keyword duplicated elsewhere in the header

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

       • Keyword name contains illegal character

       • Keyword value field has illegal format

       • Value and comment fields not separated by a slash character

       • END keyword not filled with blanks in columns 9 - 80

       • Reserved keyword with wrong datatype or illegal value

       • EXTEND not present in the primary array if there are extensions

       • BLOCKED, if present, not among the first 36 keywords

       • XTENSION keyword in the primary array

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

       • SIMPLE, EXTEND, or BLOCKED keyword in any extension

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

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

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

       • TDIMn or THEAP keyword in an ASCII table

       • TBCOLn keyword in a Binary table

       • THEAP keyword in a binary table that has PCOUNT = 0

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

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

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

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

       • TDISPn value is inconsistent with the column datatype

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

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

       • Character string column contains non-ASCII text character

       • Header fill bytes not all blanks

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

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

WARNING CONDITIONS

       • SIMPLE = F

       • Presence of deprecated keywords BLOCKED or EPOCH

       • 2 HDUs have identical EXTNAME, EXTVER, and EXTLEVEL values

       • BSCALE or TSCALn value = 0.

       • BLANK OR TNULLn value exceeds the legal range

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

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

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

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

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

       • Calculated checksum inconsistent with CHECKSUM or DATASUM keyword

AUTHOR

       HEASARC at NASA/GSFC

EXIT STATUS

       The  exit  status of fitsverify is the sum of the number of errors and warnings issued, capped at 255. It
       returns 0 if no errors or warnings have been found.

SEE ALSO

       fitscopy(1).

CFITSIO version 4.5.0                             October 2024                                     fitsverify(1)