NAME¶

fitscheck - script to detect and fix FITS standards violations

SYNOPSIS¶

fitscheck [ OPTION]... [FILE]...

DESCRIPTION¶

fitscheck is a command line script based on pyfits for verifying and updating the CHECKSUM and DATASUM keywords of FITS files. itscheck can also detect and often fix other FITS standards violations. fitscheck facilitates re-writing the non-standard checksums originally generated by pyfits with standard checksums which will interoperate with cfitsio. fitscheck will refuse to write new checksums if the checksum keywords are missing or their values are bad. Use --force to write new checksums regardless of whether or not they currently exist or pass. Use --ignore-missing to tolerate missing checksum keywords without comment.

OPTIONS¶

-h, --help

Display terse usage information (help).

-k [standard | nonstandard | either | none], --checksum= [standard | nonstandard | either | none]

Choose FITS checksum mode or none. Defaults to standard.

-w, --write

Write out file checksums and/or FITS compliance fixes.

-f, --force

Do file update even if original checksum was bad.

-c, --compliance

Do FITS compliance checking, fix if possible.

-i, --ignore-missing

Ignore missing checksums.

-v, --verbose

Generate extra output.

EXAMPLES¶

% fitscheck --checksum either --write *.fits Verify and update checksums, tolerating non-standard checksums, updating to standard checksum. % fitscheck --write --force *.fits Write new checksums, even if existing checksums are bad or missing. % fitscheck --compliance *.fits Verify standard checksums and FITS compliance without changing the files. % fitscheck --checksum nonstandard *.fits Verify original nonstandard checksums only. % fitscheck --checksum none --compliance --write *.fits Only check and fix compliance problems, ignoring checksums. % fitscheck *.fits Verify standard interoperable checksums. % fitscheck --checksum none --write *.fits Delete checksum keywords.