Muon image analysis

Algorithms for detecting and characterizing muon images

ctapipe.image.muon Package

Functions

kundu_chaudhuri_circle_fit(x, y, weights)

Fast and reliable analytical circle fitting method previously used in the H.E.S.S.

mean_squared_error(pixel_x, pixel_y, …)

Calculate the weighted mean squared error for a circle

intensity_ratio_inside_ring(pixel_x, …)

Calculate the ratio of the photons inside a given ring with coordinates (center_x, center_y), radius and width.

ring_completeness(pixel_x, pixel_y, weights, …)

Estimate how complete a ring is.

ring_containment(radius, center_x, center_y, …)

Estimate angular containment of a ring inside the camera (camera center is (0,0))

Classes

MuonIntensityFitter(**kwargs)

MuonRingFitter(**kwargs)

Different ring fit algorithms for muon rings

MuonProcessor(**kwargs)

Takes cleaned images and extracts muon rings.

Class Inheritance Diagram

digraph inheritance7f2f22ec32 { bgcolor=transparent; rankdir=LR; size="8.0, 12.0"; "Component" [URL="../../api/ctapipe.core.component.Component.html#ctapipe.core.component.Component",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base class of all Components."]; "Configurable" -> "Component" [arrowsize=0.5,style="setlinewidth(0.5)"]; "Configurable" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled"]; "HasTraits" -> "Configurable" [arrowsize=0.5,style="setlinewidth(0.5)"]; "HasDescriptors" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",tooltip="The base class for all classes that have descriptors."]; "HasTraits" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled"]; "HasDescriptors" -> "HasTraits" [arrowsize=0.5,style="setlinewidth(0.5)"]; "MuonIntensityFitter" [URL="../../api/ctapipe.image.muon.intensity_fitter.MuonIntensityFitter.html#ctapipe.image.muon.intensity_fitter.MuonIntensityFitter",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top"]; "TelescopeComponent" -> "MuonIntensityFitter" [arrowsize=0.5,style="setlinewidth(0.5)"]; "MuonProcessor" [URL="../../api/ctapipe.image.muon.processor.MuonProcessor.html#ctapipe.image.muon.processor.MuonProcessor",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Takes cleaned images and extracts muon rings. Should be run after ImageProcessor."]; "TelescopeComponent" -> "MuonProcessor" [arrowsize=0.5,style="setlinewidth(0.5)"]; "MuonRingFitter" [URL="../../api/ctapipe.image.muon.ring_fitter.MuonRingFitter.html#ctapipe.image.muon.ring_fitter.MuonRingFitter",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Different ring fit algorithms for muon rings"]; "Component" -> "MuonRingFitter" [arrowsize=0.5,style="setlinewidth(0.5)"]; "TelescopeComponent" [URL="../../api/ctapipe.core.telescope_component.TelescopeComponent.html#ctapipe.core.telescope_component.TelescopeComponent",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="A component that needs a `~ctapipe.instrument.SubarrayDescription` to be constructed,"]; "Component" -> "TelescopeComponent" [arrowsize=0.5,style="setlinewidth(0.5)"]; }

ctapipe.image.muon.processor Module

High level muon analysis (MuonProcessor Component)

Classes

MuonProcessor(**kwargs)

Takes cleaned images and extracts muon rings.

Class Inheritance Diagram

digraph inheritance8634299759 { bgcolor=transparent; rankdir=LR; size="8.0, 12.0"; "Component" [URL="../../api/ctapipe.core.component.Component.html#ctapipe.core.component.Component",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base class of all Components."]; "Configurable" -> "Component" [arrowsize=0.5,style="setlinewidth(0.5)"]; "Configurable" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled"]; "HasTraits" -> "Configurable" [arrowsize=0.5,style="setlinewidth(0.5)"]; "HasDescriptors" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",tooltip="The base class for all classes that have descriptors."]; "HasTraits" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled"]; "HasDescriptors" -> "HasTraits" [arrowsize=0.5,style="setlinewidth(0.5)"]; "MuonProcessor" [URL="../../api/ctapipe.image.muon.processor.MuonProcessor.html#ctapipe.image.muon.processor.MuonProcessor",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Takes cleaned images and extracts muon rings. Should be run after ImageProcessor."]; "TelescopeComponent" -> "MuonProcessor" [arrowsize=0.5,style="setlinewidth(0.5)"]; "TelescopeComponent" [URL="../../api/ctapipe.core.telescope_component.TelescopeComponent.html#ctapipe.core.telescope_component.TelescopeComponent",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="A component that needs a `~ctapipe.instrument.SubarrayDescription` to be constructed,"]; "Component" -> "TelescopeComponent" [arrowsize=0.5,style="setlinewidth(0.5)"]; }

ctapipe.image.muon.intensity_fitter Module

Class for performing a HESS style 2D fit of muon images

To do:
  • Deal with astropy untis better, currently stripped and no checks made

  • unit tests

  • create container class for output

Classes

MuonIntensityFitter(**kwargs)

Class Inheritance Diagram

digraph inheritanceff45d2bb27 { bgcolor=transparent; rankdir=LR; size="8.0, 12.0"; "Component" [URL="../../api/ctapipe.core.component.Component.html#ctapipe.core.component.Component",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base class of all Components."]; "Configurable" -> "Component" [arrowsize=0.5,style="setlinewidth(0.5)"]; "Configurable" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled"]; "HasTraits" -> "Configurable" [arrowsize=0.5,style="setlinewidth(0.5)"]; "HasDescriptors" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",tooltip="The base class for all classes that have descriptors."]; "HasTraits" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled"]; "HasDescriptors" -> "HasTraits" [arrowsize=0.5,style="setlinewidth(0.5)"]; "MuonIntensityFitter" [URL="../../api/ctapipe.image.muon.intensity_fitter.MuonIntensityFitter.html#ctapipe.image.muon.intensity_fitter.MuonIntensityFitter",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top"]; "TelescopeComponent" -> "MuonIntensityFitter" [arrowsize=0.5,style="setlinewidth(0.5)"]; "TelescopeComponent" [URL="../../api/ctapipe.core.telescope_component.TelescopeComponent.html#ctapipe.core.telescope_component.TelescopeComponent",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="A component that needs a `~ctapipe.instrument.SubarrayDescription` to be constructed,"]; "Component" -> "TelescopeComponent" [arrowsize=0.5,style="setlinewidth(0.5)"]; }

ctapipe.image.muon.ring_fitter Module

Classes

MuonRingFitter(**kwargs)

Different ring fit algorithms for muon rings

Class Inheritance Diagram

digraph inheritancee47a9616bb { bgcolor=transparent; rankdir=LR; size="8.0, 12.0"; "Component" [URL="../../api/ctapipe.core.component.Component.html#ctapipe.core.component.Component",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Base class of all Components."]; "Configurable" -> "Component" [arrowsize=0.5,style="setlinewidth(0.5)"]; "Configurable" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled"]; "HasTraits" -> "Configurable" [arrowsize=0.5,style="setlinewidth(0.5)"]; "HasDescriptors" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",tooltip="The base class for all classes that have descriptors."]; "HasTraits" [fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled"]; "HasDescriptors" -> "HasTraits" [arrowsize=0.5,style="setlinewidth(0.5)"]; "MuonRingFitter" [URL="../../api/ctapipe.image.muon.ring_fitter.MuonRingFitter.html#ctapipe.image.muon.ring_fitter.MuonRingFitter",fillcolor=white,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.25,shape=box,style="setlinewidth(0.5),filled",target="_top",tooltip="Different ring fit algorithms for muon rings"]; "Component" -> "MuonRingFitter" [arrowsize=0.5,style="setlinewidth(0.5)"]; }