debian man page for fitscheck

fitscheck(1)							   PyFITS 3.0.7 						      fitscheck(1)

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  gen-
       erated 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 check-
       sums regardless of whether or not they currently exist or pass.	Use --ignore-missing to tolerate missing checksum  keywords  without  com-
       ment.

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.

fitscheck							     June 2012							      fitscheck(1)