.TH fitscheck 1 "April 2015" "fitscheck" "astropy 1.0.2"
.SH NAME
fitscheck \- script to detect and fix FITS standards violations
.SH SYNOPSIS
.B fitscheck
[\fIOPTION\fR]... [\fIFILE\fR]...
.SH DESCRIPTION
.PP
\fBfitscheck\fR is a command line script based on pyfits for verifying
and updating the CHECKSUM and DATASUM keywords of FITS files.
\fBitscheck\fR can also detect and often fix other FITS standards
violations. \fBfitscheck\fR facilitates re\-writing the non-standard
checksums originally generated by pyfits with standard checksums which
will interoperate with cfitsio.
.PP
\fBfitscheck\fR will refuse to write new checksums if the checksum keywords
are missing or their values are bad.  Use \fB\-\-force\fR to write new
checksums regardless of whether or not they currently exist or pass.
Use \fB\-\-ignore-missing\fR to tolerate missing checksum keywords without
comment.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Display terse usage information (help).
.TP
\fB\-k\fR [\fIstandard\fR | \fInonstandard\fR | \fIeither\fR | \fInone\fR], \fB\-\-checksum\fR=[\fIstandard\fR | \fInonstandard\fR | \fIeither\fR | \fInone\fR]
Choose FITS checksum mode or none. Defaults to standard.
.TP
\fB\-w\fR, \fB\-\-write\fR
Write out file checksums and/or FITS compliance fixes.
.TP
\fB\-f\fR, \fB\-\-force\fR
Do file update even if original checksum was bad.
.TP
\fB\-c\fR, \fB\-\-compliance\fR
Do FITS compliance checking, fix if possible.
.TP
\fB\-i\fR, \fB\-\-ignore\-missing\fR
Ignore missing checksums.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Generate extra output.
.SH "EXAMPLES"
.B "% fitscheck --checksum either --write *.fits"
.br
Verify and update checksums, tolerating non-standard checksums, updating to standard checksum.
    
.B "% fitscheck --write --force *.fits"
.br
Write new checksums, even if existing checksums are bad or missing.

.B "% fitscheck --compliance *.fits"
.br
Verify standard checksums and FITS compliance without changing the files.

.B "% fitscheck --checksum nonstandard *.fits"
.br   
Verify original nonstandard checksums only.

.B "% fitscheck --checksum none --compliance --write *.fits"
.br
Only check and fix compliance problems,  ignoring checksums.

.B "% fitscheck *.fits"
.br
Verify standard interoperable checksums.

.B "% fitscheck --checksum none --write *.fits"
.br
Delete checksum keywords.