ctapipe is not stable yet, so expect large and rapid changes to structure and functionality as we explore various design choices before the 1.0 release.

TailCutsDataVolumeReducer#

class ctapipe.image.TailCutsDataVolumeReducer(**kwargs: Any)[source]#

Bases: DataVolumeReducer

Reduce the time integrated shower image in 3 Steps:

  1. Select pixels with tailcuts_clean.

  2. Add iteratively all pixels with Signal S >= boundary_thresh with ctapipe module dilate until no new pixels were added.

  3. Adding new pixels with dilate to get more conservative.

Attributes:
image_extractor_type: String

Name of the image_extractor to be used.

n_end_dilates: IntTelescopeParameter

Number of how many times to dilate at the end.

do_boundary_dilation: BoolTelescopeParameter

If set to ‘False’, the iteration steps in 2) are skipped and normal TailcutCleaning is used.

Attributes Summary

do_boundary_dilation

If set to 'False', the iteration steps in 2) are skipped andnormal TailcutCleaning is used.

image_extractor_type

Name of the ImageExtractor subclass to be used.

n_end_dilates

Number of how many times to dilate at the end.

Methods Summary

select_pixels(waveforms[, tel_id, ...])

Abstract method to be defined by a DataVolumeReducer subclass.

Attributes Documentation

do_boundary_dilation#

If set to ‘False’, the iteration steps in 2) are skipped andnormal TailcutCleaning is used.

image_extractor_type#

Name of the ImageExtractor subclass to be used. The name of a ImageExtractor subclass. Possible values: [‘FullWaveformSum’, ‘FixedWindowSum’, ‘GlobalPeakWindowSum’, ‘LocalPeakWindowSum’, ‘SlidingWindowMaxSum’, ‘NeighborPeakWindowSum’, ‘TwoPassWindowSum’, ‘FlashCamExtractor’, ‘BaselineSubtractedNeighborPeakWindowSum’]

n_end_dilates#

Number of how many times to dilate at the end.

Methods Documentation

select_pixels(waveforms, tel_id=None, selected_gain_channel=None)[source]#

Abstract method to be defined by a DataVolumeReducer subclass. Call the relevant functions for the required pixel selection.

Parameters:
waveforms: ndarray

Waveforms stored in a numpy array of shape (n_pix, n_samples).

tel_id: int

The telescope id. Required for the ‘image_extractor’ and ‘camera.geometry’ in ‘TailCutsDataVolumeReducer’.

selected_gain_channel: ndarray

The channel selected in the gain selection, per pixel. Required for the ‘image_extractor’ in ‘TailCutsDataVolumeReducer’.

Returns:
mask: array

Mask of selected pixels.