Instrument (instrument)#


The instrument module contains classes and methods for describing the instrumental layout and configuration.

This module is under heavy restructuring and should not be considered ready for general use, except for the CameraGeometry object, which provides pixel positions, etc.

Hierarchy of InstrumentDescription Classes#

  • SubarrayDescription (describes full subarray)

    • TelescopeDescription (describes a single telescope)

      • OpticsDescription (describes the optical support structure and mirror)

      • CameraDescription (describes the camera)

        • CameraGeometry (describes the geometrical aspects of the camera, e.g. only that which is needed by reconstruction methods)

        • CameraReadout (describes the aspects related to the waveform readout e.g. sampling rate and reference pulse shape.geometrical aspects of the camera, e.g.

        • [to come: classes to hold more detailed hardware-level info about a camera]

Other Instrumental Data#

Atmosphere Profiles#

With the instrument module you can also load standard atmosphere profiles, which are read from tables located in ctapipe_resources by default

The function get_atmosphere_profile_functions() returns two interpolation functions that convert between height and atmosphere thickness.


ctapipe.instrument Package#



Deprecated since version v0.16.0.

guess_telescope(n_pixels, focal_length[, ...])

From n_pixels of the camera and the focal_length, guess which telescope we are dealing with.


CameraDescription(name, geometry, readout)

Describes a Cherenkov camera and its associated CameraGeometry and CameraReadout

CameraGeometry(name, pix_id, pix_x, pix_y, ...)

CameraGeometry is a class that stores information about a Cherenkov Camera that us useful for imaging algorithms and displays.

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

Stores properties related to the readout of a Cherenkov Camera.

OpticsDescription(name, size_type, ...)

Describes the optics of a Cherenkov Telescope mirror


Supported Pixel Shapes Enum

SubarrayDescription(name, tel_positions, ...)

Collects the TelescopeDescription of all telescopes along with their positions on the ground.

TelescopeDescription(name, optics, camera)

Describes a Cherenkov Telescope and its associated OpticsDescription and CameraDescription


Raised when an unknown telescope id is encountered


Enumeration for the different kinds of focal lengths.


Enumeration of the different reflector shapes


Enumeration of different telescope sizes (LST, MST, SST)


A stereo trigger that can remove telescope events from subarray events.


Warning raised when using from_name