============
S1PhotonHits
============

Link to source: `S1PhotonHits <https://github.com/XENONnT/fuse/blob/master/fuse/plugins/detector_physics/s1_photon_hits.py>`_ 

Plugin Description
==================
Plugin to simulate the number of detected S1 photons using a S1 light
collection efficiency map.

Technical Details
-----------------

.. code-block:: python

   depends_on = ('microphysics_summary',)
   provides = ('s1_photon_hits',)
   data_kind = interactions_in_roi
   __version__ = 0.3.0


Provided Columns
================

s1_photon_hits
--------------

.. list-table::
   :widths: 25 25 50
   :header-rows: 1

   * - Field Name
     - Data Type
     - Comment
   * - n_s1_photon_hits
     - int32
     - Number detected S1 photons
   * - time
     - int64
     - Start time since unix epoch [ns]
   * - endtime
     - int64
     - Exclusive end time since unix epoch [ns]

Config Options
==============

.. list-table::
   :widths: 25 25 10 40
   :header-rows: 1

   * - Option
     - default
     - track
     - Help
   * - debug
     - False
     - False
     - Show debug informations
   * - deterministic_seed
     - True
     - True
     - Set the random seed from lineage and run_id, or pull the seed from the OS
   * - digitizer_bits
     - take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=digitizer_bits
     - True
     - Number of bits of the digitizer boards
   * - digitizer_voltage_range
     - take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=digitizer_voltage_range
     - True
     - Voltage range of the digitizer boards [V]
   * - gain_model_mc
     - list-to-array://xedocs://pmt_area_to_pes?as_list=True&sort=pmt&detector=tpc&run_id=plugin.run_id&version=ONLINE&attr=value
     - True
     - PMT gain model
   * - p_double_pe_emision
     - take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=p_double_pe_emision
     - True
     - Probability of double photo-electron emission
   * - pmt_circuit_load_resistor
     - take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=pmt_circuit_load_resistor
     - True
     - PMT circuit load resistor [kg m^2/(s^3 A)]
   * - s1_detection_efficiency
     - take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=s1_detection_efficiency
     - True
     - S1 detection efficiency
   * - s1_pattern_map
     - pattern_map://resource://simulation_config://SIMULATION_CONFIG_FILE.json?&key=s1_pattern_map&fmt=pkl&pmt_mask=plugin.pmt_mask
     - True
     - S1 LCE correction map
   * - user_defined_random_seed
     - None
     - True
     - Define the random seed manually. You need to set deterministic_seed to False

Dependency Graph
================


.. raw:: html

    <!-- Title: %3 Pages: 1 -->
    <svg width="341pt" height="692pt"
     viewBox="0.00 0.00 340.83 692.00" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
    <g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 688)">
    <title>%3</title>
    <polygon fill="white" stroke="transparent" points="-4,4 -4,-688 336.83,-688 336.83,4 -4,4"/>
    <!-- s1_photon_hits -->
    <g id="node1" class="node">
    <title>s1_photon_hits</title>
    <g id="a_node1"><a xlink:href="#s1-photon-hits" xlink:title="s1_photon_hits">
    <ellipse fill="#56c46c" stroke="black" cx="143.84" cy="-666" rx="79.89" ry="18"/>
    <text text-anchor="middle" x="143.84" y="-662.3" font-family="Times,serif" font-size="14.00">s1_photon_hits</text>
    </a>
    </g>
    </g>
    <!-- microphysics_summary -->
    <g id="node2" class="node">
    <title>microphysics_summary</title>
    <g id="a_node2"><a xlink:href="#microphysics-summary" xlink:title="microphysics_summary">
    <ellipse fill="#56c46c" stroke="black" cx="143.84" cy="-594" rx="119.68" ry="18"/>
    <text text-anchor="middle" x="143.84" y="-590.3" font-family="Times,serif" font-size="14.00">microphysics_summary</text>
    </a>
    </g>
    </g>
    <!-- s1_photon_hits&#45;&gt;microphysics_summary -->
    <g id="edge1" class="edge">
    <title>s1_photon_hits&#45;&gt;microphysics_summary</title>
    <path fill="none" stroke="black" d="M143.84,-647.7C143.84,-639.98 143.84,-630.71 143.84,-622.11"/>
    <polygon fill="black" stroke="black" points="147.34,-622.1 143.84,-612.1 140.34,-622.1 147.34,-622.1"/>
    </g>
    <!-- interactions_in_roi -->
    <g id="node3" class="node">
    <title>interactions_in_roi</title>
    <g id="a_node3"><a xlink:href="#interactions-in-roi" xlink:title="interactions_in_roi">
    <ellipse fill="#56c46c" stroke="black" cx="96.84" cy="-378" rx="96.68" ry="18"/>
    <text text-anchor="middle" x="96.84" y="-374.3" font-family="Times,serif" font-size="14.00">interactions_in_roi</text>
    </a>
    </g>
    </g>
    <!-- microphysics_summary&#45;&gt;interactions_in_roi -->
    <g id="edge2" class="edge">
    <title>microphysics_summary&#45;&gt;interactions_in_roi</title>
    <path fill="none" stroke="black" d="M120.36,-576.14C109.48,-566.86 97.69,-554.32 91.84,-540 73.8,-495.85 82.02,-439.07 89.51,-406.09"/>
    <polygon fill="black" stroke="black" points="92.94,-406.8 91.88,-396.26 86.13,-405.16 92.94,-406.8"/>
    </g>
    <!-- quanta -->
    <g id="node4" class="node">
    <title>quanta</title>
    <g id="a_node4"><a xlink:href="#quanta" xlink:title="quanta">
    <ellipse fill="#56c46c" stroke="black" cx="143.84" cy="-522" rx="42.79" ry="18"/>
    <text text-anchor="middle" x="143.84" y="-518.3" font-family="Times,serif" font-size="14.00">quanta</text>
    </a>
    </g>
    </g>
    <!-- microphysics_summary&#45;&gt;quanta -->
    <g id="edge3" class="edge">
    <title>microphysics_summary&#45;&gt;quanta</title>
    <path fill="none" stroke="black" d="M143.84,-575.7C143.84,-567.98 143.84,-558.71 143.84,-550.11"/>
    <polygon fill="black" stroke="black" points="147.34,-550.1 143.84,-540.1 140.34,-550.1 147.34,-550.1"/>
    </g>
    <!-- electric_field_values -->
    <g id="node5" class="node">
    <title>electric_field_values</title>
    <g id="a_node5"><a xlink:href="#electric-field-values" xlink:title="electric_field_values">
    <ellipse fill="#56c46c" stroke="black" cx="228.84" cy="-450" rx="103.98" ry="18"/>
    <text text-anchor="middle" x="228.84" y="-446.3" font-family="Times,serif" font-size="14.00">electric_field_values</text>
    </a>
    </g>
    </g>
    <!-- microphysics_summary&#45;&gt;electric_field_values -->
    <g id="edge4" class="edge">
    <title>microphysics_summary&#45;&gt;electric_field_values</title>
    <path fill="none" stroke="black" d="M163.97,-576.26C174.61,-566.56 187.21,-553.6 195.84,-540 208.08,-520.72 216.74,-496.23 222.1,-477.83"/>
    <polygon fill="black" stroke="black" points="225.52,-478.61 224.82,-468.04 218.77,-476.74 225.52,-478.61"/>
    </g>
    <!-- clustered_interactions -->
    <g id="node6" class="node">
    <title>clustered_interactions</title>
    <g id="a_node6"><a xlink:href="#clustered-interactions" xlink:title="clustered_interactions">
    <ellipse fill="#fbce56" stroke="black" cx="120.84" cy="-162" rx="114.28" ry="18"/>
    <text text-anchor="middle" x="120.84" y="-158.3" font-family="Times,serif" font-size="14.00">clustered_interactions</text>
    </a>
    </g>
    </g>
    <!-- interactions_in_roi&#45;&gt;clustered_interactions -->
    <g id="edge5" class="edge">
    <title>interactions_in_roi&#45;&gt;clustered_interactions</title>
    <path fill="none" stroke="black" d="M89.96,-359.99C78.89,-330 60.06,-266.14 77.84,-216 81.5,-205.68 88.13,-195.9 95.1,-187.61"/>
    <polygon fill="black" stroke="black" points="97.72,-189.94 101.8,-180.16 92.51,-185.26 97.72,-189.94"/>
    </g>
    <!-- volume_properties -->
    <g id="node7" class="node">
    <title>volume_properties</title>
    <g id="a_node7"><a xlink:href="#volume-properties" xlink:title="volume_properties">
    <ellipse fill="#fbce56" stroke="black" cx="183.84" cy="-234" rx="96.68" ry="18"/>
    <text text-anchor="middle" x="183.84" y="-230.3" font-family="Times,serif" font-size="14.00">volume_properties</text>
    </a>
    </g>
    </g>
    <!-- interactions_in_roi&#45;&gt;volume_properties -->
    <g id="edge6" class="edge">
    <title>interactions_in_roi&#45;&gt;volume_properties</title>
    <path fill="none" stroke="black" d="M97.07,-359.98C98.06,-341.05 101.92,-310.23 115.84,-288 123.38,-275.97 134.66,-265.58 145.88,-257.27"/>
    <polygon fill="black" stroke="black" points="148.19,-259.92 154.38,-251.32 144.18,-254.18 148.19,-259.92"/>
    </g>
    <!-- volume_selection -->
    <g id="node8" class="node">
    <title>volume_selection</title>
    <g id="a_node8"><a xlink:href="#volume-selection" xlink:title="volume_selection">
    <ellipse fill="#fbce56" stroke="black" cx="214.84" cy="-306" rx="90.18" ry="18"/>
    <text text-anchor="middle" x="214.84" y="-302.3" font-family="Times,serif" font-size="14.00">volume_selection</text>
    </a>
    </g>
    </g>
    <!-- interactions_in_roi&#45;&gt;volume_selection -->
    <g id="edge7" class="edge">
    <title>interactions_in_roi&#45;&gt;volume_selection</title>
    <path fill="none" stroke="black" d="M124.51,-360.59C140.63,-351.02 161.16,-338.85 178.57,-328.52"/>
    <polygon fill="black" stroke="black" points="180.53,-331.42 187.35,-323.31 176.96,-325.4 180.53,-331.42"/>
    </g>
    <!-- quanta&#45;&gt;interactions_in_roi -->
    <g id="edge13" class="edge">
    <title>quanta&#45;&gt;interactions_in_roi</title>
    <path fill="none" stroke="black" d="M133.52,-504.36C127.61,-494.19 120.46,-480.72 115.84,-468 108.53,-447.86 103.63,-424.08 100.64,-406.17"/>
    <polygon fill="black" stroke="black" points="104.07,-405.45 99.06,-396.12 97.16,-406.54 104.07,-405.45"/>
    </g>
    <!-- quanta&#45;&gt;electric_field_values -->
    <g id="edge14" class="edge">
    <title>quanta&#45;&gt;electric_field_values</title>
    <path fill="none" stroke="black" d="M162.71,-505.46C173.86,-496.28 188.2,-484.47 200.67,-474.2"/>
    <polygon fill="black" stroke="black" points="203.05,-476.77 208.55,-467.71 198.6,-471.37 203.05,-476.77"/>
    </g>
    <!-- electric_field_values&#45;&gt;interactions_in_roi -->
    <g id="edge15" class="edge">
    <title>electric_field_values&#45;&gt;interactions_in_roi</title>
    <path fill="none" stroke="black" d="M198.23,-432.76C179.82,-423 156.19,-410.47 136.38,-399.97"/>
    <polygon fill="black" stroke="black" points="137.77,-396.74 127.29,-395.15 134.49,-402.92 137.77,-396.74"/>
    </g>
    <!-- geant4_interactions -->
    <g id="node9" class="node">
    <title>geant4_interactions</title>
    <g id="a_node9"><a xlink:href="#geant4-interactions" xlink:title="geant4_interactions">
    <ellipse fill="#40c4f3" stroke="black" cx="120.84" cy="-18" rx="102.88" ry="18"/>
    <text text-anchor="middle" x="120.84" y="-14.3" font-family="Times,serif" font-size="14.00">geant4_interactions</text>
    </a>
    </g>
    </g>
    <!-- clustered_interactions&#45;&gt;geant4_interactions -->
    <g id="edge8" class="edge">
    <title>clustered_interactions&#45;&gt;geant4_interactions</title>
    <path fill="none" stroke="black" d="M107.7,-143.91C100.92,-134.01 93.35,-120.96 89.84,-108 85.66,-92.56 85.66,-87.44 89.84,-72 92.42,-62.48 97.19,-52.92 102.22,-44.59"/>
    <polygon fill="black" stroke="black" points="105.22,-46.39 107.7,-36.09 99.34,-42.6 105.22,-46.39"/>
    </g>
    <!-- cluster_index -->
    <g id="node10" class="node">
    <title>cluster_index</title>
    <g id="a_node10"><a xlink:href="#cluster-index" xlink:title="cluster_index">
    <ellipse fill="#40c4f3" stroke="black" cx="171.84" cy="-90" rx="72.59" ry="18"/>
    <text text-anchor="middle" x="171.84" y="-86.3" font-family="Times,serif" font-size="14.00">cluster_index</text>
    </a>
    </g>
    </g>
    <!-- clustered_interactions&#45;&gt;cluster_index -->
    <g id="edge9" class="edge">
    <title>clustered_interactions&#45;&gt;cluster_index</title>
    <path fill="none" stroke="black" d="M133.19,-144.05C139.33,-135.63 146.87,-125.28 153.65,-115.97"/>
    <polygon fill="black" stroke="black" points="156.55,-117.93 159.61,-107.79 150.89,-113.81 156.55,-117.93"/>
    </g>
    <!-- volume_properties&#45;&gt;clustered_interactions -->
    <g id="edge11" class="edge">
    <title>volume_properties&#45;&gt;clustered_interactions</title>
    <path fill="none" stroke="black" d="M168.59,-216.05C160.97,-207.58 151.59,-197.17 143.18,-187.82"/>
    <polygon fill="black" stroke="black" points="145.68,-185.37 136.39,-180.28 140.48,-190.05 145.68,-185.37"/>
    </g>
    <!-- volume_selection&#45;&gt;volume_properties -->
    <g id="edge12" class="edge">
    <title>volume_selection&#45;&gt;volume_properties</title>
    <path fill="none" stroke="black" d="M207.34,-288.05C203.81,-280.09 199.52,-270.41 195.58,-261.51"/>
    <polygon fill="black" stroke="black" points="198.74,-260 191.49,-252.28 192.34,-262.84 198.74,-260"/>
    </g>
    <!-- cluster_index&#45;&gt;geant4_interactions -->
    <g id="edge10" class="edge">
    <title>cluster_index&#45;&gt;geant4_interactions</title>
    <path fill="none" stroke="black" d="M159.5,-72.05C153.45,-63.75 146.04,-53.58 139.33,-44.38"/>
    <polygon fill="black" stroke="black" points="142.15,-42.3 133.43,-36.28 136.49,-46.42 142.15,-42.3"/>
    </g>
    </g>
    </svg>