Camera Readout#

The CameraReadout stores information regarding the waveform readout from the Cherenkov camera, such as sampling rate and information on the reference pulse shape.

There are several ways to obtain a CameraReadout:

Through the SubarrayDescription of an EventSource or TableLoader
Through reading a SubarrayDescription from an input file using SubarrayDescription.from_hdf or SubarrayDescription.read
use the CameraReadout constructor, where one has to specify all necessary information
load it from a pre-written file, which can be in any format supported by astropy.table.Table, as long as that format allows for header-keywords as well as table entries.

CameraReadout is used by the ImageExtractor in the ctapipe.image module to ensure the images are scaled to the correct units.

Input/Output#

You can write out a CameraReadout by using the CameraReadout.to_table() method to turn it into a Table, and then call its write() function. Reading it back in can be done with CameraReadout.from_table().

readout = CameraReadout(...)  # constructed elsewhere

readout.to_table().write('mycam.fits.gz') # FITS output
readout.to_table().write('mycam.h5', path='/cameras/mycam') # hdf5 output
readout.to_table().write('mycam.ecsv', format='ascii.ecsv') # text table

# later read back in:

readout = CameraReadout.from_table('mycam.ecsv', format='ascii.ecsv')
readout = CameraReadout.from_table('mycam.fits.gz')
readout = CameraReadout.from_table('mycam.h5', path='/cameras/mycam')

Reference/API#

ctapipe.instrument.camera.readout Module#

Utilities for reading or working with Camera geometry files

Classes#

CameraReadout(name, sampling_rate, ...[, ...])

Stores properties related to the readout of a Cherenkov Camera.