/ ciao4.16 / bugs / acis_clear_status_bits.html

Bugs: acis_clear_status_bits

For detailed information and examples of running this tool, refer to the acis_clear_status_bits ahelp file. This script is part of the CIAO Scripts Package.

Bugs

Files must have read and write access.

This tool requires that the files have read and write access. It will quietly fail if it is not.

In addition to normal file system permisison one may set with chmod, it also requires the file be uncompressed and not have any filters applied.

# OK
unix% /bin/ls -l acis_evt.fits
-rw-r--r--  1 user group  5209 Jan 31 08:20 acis_evt.fits
unix% acis_clear_status_bits acis_evt.fits

# BAD
unix% acis_clear_status_bits acis_evt1.fits.gz
unix% acis_clear_status_bits acis_evt1.fits[ccd_id=3]
unix% chmod a-w acis_evt.fits
unix% acis_clear_status_bits acis_evt.fits

To verify that the tool has worked properly, users can check for the CLSTBITS keyword. If it was not present in the input file then it will be present in the output file if the tool ran correctly.

unix% dmkeypar acis_evt.fits CLSTBITS echo+
11111111011000000011111111000001

/ ciao4.16 / bugs / acis_clear_status_bits.html