|AHELP for CIAO 4.9||
Load an RMF file into a RMFCrateDataset.
|filename||Name of the file; it can include CIAO Data Model syntax such as filters and binning values|
|mode||Should the mode be opened for read-only ('r', the default), or for read-write access ('rw').|
The read_rmf command loads the specified RMF file into a RMFCrateDataset.
>>> cds = read_rmf("rmf.fits") >>> print(cds)
The output of the print command is:
RMF Crate Dataset: File Name: meg_1.rmf Read-Write Mode: rw Number of Crates: 3 1) Crate Type: <IMAGECrate> Crate Name: PRIMARY 2) Crate Type: <TABLECrate> Crate Name: MATRIX Ncols: 6 Nrows: 8192 3) Crate Type: <TABLECrate> Crate Name: EBOUNDS Ncols: 3 Nrows: 8192
In this example the RMF is from a grating observation and was obtained from TGCat.
When a file is read in, the write permission is checked against the mode argument and, if it does not match (if mode='rw' but the user does not have write permission, or the file is a gzipped file) then a warning is displayed and the mode is set to 'r'.
The mode argument is only relevant if you call the write method of the crate with no arguments; that is if you say
>>> cr = read_file('tbl.dat', mode='rw') UserWarning: File 'tbl.dat' does not have write permission. Changing to read-only mode. ... >>> cr.write() IOError: File is not writeable.
It is not used if you want to write to a new file or one that is not write protected. That is, you can read in a file in read-only mode, change its contents, and write it out to a new file:
>>> cr = read_file('img.fits', mode='r') >>> ivals = cr.get_image().values >>> ivals += 1 >>> cr.write('modified.fits')
See the bug pages on the CIAO website for an up-to-date listing of known bugs.
Refer to the CIAO bug pages for an up-to-date listing of known issues.