# obdeect ```{image} _static/images/obdeect_21ratio_small.jpg :alt: obdeect, a simulation chain for imaging atmospheric Cherenkov telescopes :align: center :class: homepage-logo ``` obdeect simulates how light travels from its source to the camera of an imaging atmospheric Cherenkov telescope. The light comes from CORSIKA air showers or from artificial sources such as flashers, LEDs, lasers and stars. It crosses the atmosphere, is traced through the telescope optics, and ends in the camera simulation of sim_telarray. The steps are separate programs that pass **photon streams** to each other, so you can combine them as in a Unix pipeline and replace any one of them. :::{container} homepage-actions ```{button-link} user-guide/index :color: primary :shadow: {fas}`bolt` Start with the user guide ``` ```{button-link} https://github.com/gammasim/obdeect :color: secondary :outline: {fab}`github` GitHub repository ``` ```{button-link} https://github.com/gammasim/obdeect/blob/main/LICENSE :color: secondary :outline: {fas}`scale-balanced` License BSD-3 ``` ::: ```{raw} html Air showers Light sources Atmosphere propagation Telescope ray tracing sim_telarray camera every arrow is a photon stream ``` ## Where to go ::::{grid} 1 2 2 2 :gutter: 3 :::{grid-item-card} {fas}`bolt;pst-color-primary` User guide :link: user-guide/index :link-type: doc :class-card: sd-shadow-sm Install obdeect, run a first pipeline and connect it to sim_telarray. ::: :::{grid-item-card} {fas}`stream;pst-color-primary` Photon stream :link: stream/index :link-type: doc :class-card: sd-shadow-sm The format that connects the steps, with converters from CORSIKA and to sim_telarray and GrOptics. ::: :::{grid-item-card} {fas}`cloud;pst-color-primary` Atmospheric propagation :link: propagation/index :link-type: doc :class-card: sd-shadow-sm Extinction, refraction, timing and scattering between the emission point and the telescope. ::: :::{grid-item-card} {fas}`lightbulb;pst-color-primary` Light sources :link: sources/index :link-type: doc :class-card: sd-shadow-sm Flashers, LEDs, lasers, point sources, night-sky background and muons. ::: :::{grid-item-card} {fas}`eye;pst-color-primary` Ray tracing :link: ray-tracing/index :link-type: doc :class-card: sd-shadow-sm Mirrors, shadowing and optical responses, from the telescope entrance to the camera. ::: :::{grid-item-card} {fas}`clock-rotate-left;pst-color-primary` Changelog :link: changelog :link-type: doc :class-card: sd-shadow-sm What changed in each release. ::: :::: ```{toctree} :hidden: :maxdepth: 2 :caption: User guide user-guide/index user-guide/installation user-guide/quickstart user-guide/pipelines ``` ```{toctree} :hidden: :maxdepth: 2 :caption: Components stream/index propagation/index sources/index ray-tracing/index ``` ```{toctree} :hidden: :caption: Project changelog ```