From 24d61149e242f9117f50207a49fcda4bc92fe1af Mon Sep 17 00:00:00 2001 From: Oudihat-Radia Date: Mon, 29 Jul 2024 10:04:33 +0200 Subject: [PATCH 1/3] Update digitizer_and_detector_modeling.rst Documentation for Multiples Killer --- docs/digitizer_and_detector_modeling.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/digitizer_and_detector_modeling.rst b/docs/digitizer_and_detector_modeling.rst index 73f611bfd..19022836a 100644 --- a/docs/digitizer_and_detector_modeling.rst +++ b/docs/digitizer_and_detector_modeling.rst @@ -1422,9 +1422,9 @@ A presort buffer contains singles that have not yet been checked for coincidence Multiple coincidence removal ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -If the multiple coincidences are kept and not splitted into pairs (ie. if any of the **keepXXX** multiple coincidence policy is used), the multicoincidences could participate to dataflow occupancy, but could not be written to the disk. Unless otherwise specified, any multicoincidence is then cleared from data just before the disk writing. If needed, this clearing could be performed at any former coincidence processing step, by inserting the **multipleKiller** module at the required level. This module has no parameter and just kill the multicoincidence events. Multiple coincidences split into many pairs are not affected by this module and cannot be distinguished from the normal "simple" coincidences. To insert a multipleKiller, one has to use the syntax:: +If the multiple coincidences are kept and not split into pairs (i.e., if any of the **keepXXX** multiple coincidence policies are used), the multicoincidences could contribute to dataflow occupancy but cannot be written to the disk. Unless otherwise specified, any multicoincidence is then cleared from data just before the disk writing. If needed, this clearing could be performed at any earlier coincidence processing step by inserting the **multipleKiller** module at the required level. This module has no parameters and simply removes the multicoincidence events. Multiple coincidences split into many pairs are not affected by this module and cannot be distinguished from normal "simple" coincidences. To insert a multipleKiller, use the syntax:: +/gate/digitizerMgr/CoincidenceDigitizer/finalCoinc/insert MultiplesKiller - /gate/digitizer/myCoincChain/insert multipleKiller Example of a digitizer setting ------------------------------ @@ -1529,6 +1529,7 @@ Example:: 87 /gate/digitizer/finalCoinc/buffer/setBufferSize 32 B 88 /gate/digitizer/finalCoinc/buffer/setReadFrequency 14.45 MHz 89 /gate/digitizer/finalCoinc/buffer/setMode 0 + Lines 1 to 15: The branch named "Singles" contains the result of applying the adder, readout, blurring, and threshold (50 keV) modules. From 6b054c4cc9db68f17abbafea769ac332f1fd921c Mon Sep 17 00:00:00 2001 From: Oudihat-Radia Date: Wed, 31 Jul 2024 09:41:16 +0200 Subject: [PATCH 2/3] Update digitizer_and_detector_modeling.rst --- docs/digitizer_and_detector_modeling.rst | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/digitizer_and_detector_modeling.rst b/docs/digitizer_and_detector_modeling.rst index 19022836a..e80f9a04c 100644 --- a/docs/digitizer_and_detector_modeling.rst +++ b/docs/digitizer_and_detector_modeling.rst @@ -1154,7 +1154,7 @@ Then, the rejection can be set to the whole event or only to those pulses within Example:: - /gate/digitizerMgr/absorber/SinglesDigitizer/Singles/insert multipleRejection + /gate/digitizerMgr/absorber/SinglesDigitizer/Singles/insert multipleRejection /gate/digitizerMgr/absorber/SinglesDigitizer/Singles/multipleRejection/setMultipleDefinition volumeID /gate/digitizerMgr/absorber/SinglesDigitizer/Singles/multipleRejection/setEventRejection 1 @@ -1411,11 +1411,21 @@ The dead time for coincidences works in the same way as that acting on the *sing Coincidence buffers ~~~~~~~~~~~~~~~~~~~ +It simulates the operation of a detector by modeling coincidences, transfer speed limits, and data loss due to buffer capacity overflows. It manages a memory buffer for coincidence events, allowing for the modeling of data loss due to buffer overflow. It uses a read frequency and allows defining the buffer size and read mode, influencing how events are processed. There are two buffer operation modes. Mode 1 empties the entire buffer at each read clock tick, while Mode 0 reads events one by one. + +Example:: + +/gate/digitizerMgr/CoincidenceDigitizer/finalCoinc/insert Buffer +/gate/digitizerMgr/CoincidenceDigitizer/finalCoinc/Buffer/setBufferSize 64 B +/gate/digitizerMgr/CoincidenceDigitizer/finalCoinc/Buffer/setReadFrequency 10 MHz +/gate/digitizerMgr/CoincidenceDigitizer/finalCoinc/Buffer/setMode 1 + For a coincidence sorter user can chose a presort buffer with a following command: /gate/digitizer/Coincidences/setPresortBufferSize 256 + A presort buffer contains singles that have not yet been checked for coincidence with the already open coincidence windows. The default value is 256, the minimum value is 32. For more details, check https://iopscience.iop.org/article/10.1088/0031-9155/61/18/N522 @@ -1423,6 +1433,8 @@ Multiple coincidence removal ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If the multiple coincidences are kept and not split into pairs (i.e., if any of the **keepXXX** multiple coincidence policies are used), the multicoincidences could contribute to dataflow occupancy but cannot be written to the disk. Unless otherwise specified, any multicoincidence is then cleared from data just before the disk writing. If needed, this clearing could be performed at any earlier coincidence processing step by inserting the **multipleKiller** module at the required level. This module has no parameters and simply removes the multicoincidence events. Multiple coincidences split into many pairs are not affected by this module and cannot be distinguished from normal "simple" coincidences. To insert a multipleKiller, use the syntax:: + + /gate/digitizerMgr/CoincidenceDigitizer/finalCoinc/insert MultiplesKiller From 961ce782fffdffd562032c5e350a9e2a1c8dea6b Mon Sep 17 00:00:00 2001 From: Oudihat-Radia Date: Fri, 30 Aug 2024 10:51:07 +0200 Subject: [PATCH 3/3] Update digitizer_and_detector_modeling.rst --- docs/digitizer_and_detector_modeling.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/digitizer_and_detector_modeling.rst b/docs/digitizer_and_detector_modeling.rst index e80f9a04c..43c238524 100644 --- a/docs/digitizer_and_detector_modeling.rst +++ b/docs/digitizer_and_detector_modeling.rst @@ -1415,10 +1415,10 @@ It simulates the operation of a detector by modeling coincidences, transfer spee Example:: -/gate/digitizerMgr/CoincidenceDigitizer/finalCoinc/insert Buffer -/gate/digitizerMgr/CoincidenceDigitizer/finalCoinc/Buffer/setBufferSize 64 B -/gate/digitizerMgr/CoincidenceDigitizer/finalCoinc/Buffer/setReadFrequency 10 MHz -/gate/digitizerMgr/CoincidenceDigitizer/finalCoinc/Buffer/setMode 1 +/gate/digitizerMgr/CoincidenceDigitizer/finalCoinc/insert buffer +/gate/digitizerMgr/CoincidenceDigitizer/finalCoinc/buffer/setBufferSize 64 B +/gate/digitizerMgr/CoincidenceDigitizer/finalCoinc/buffer/setReadFrequency 10 MHz +/gate/digitizerMgr/CoincidenceDigitizer/finalCoinc/buffer/setMode 1 For a coincidence sorter user can chose a presort buffer with a following command: @@ -1435,7 +1435,7 @@ Multiple coincidence removal If the multiple coincidences are kept and not split into pairs (i.e., if any of the **keepXXX** multiple coincidence policies are used), the multicoincidences could contribute to dataflow occupancy but cannot be written to the disk. Unless otherwise specified, any multicoincidence is then cleared from data just before the disk writing. If needed, this clearing could be performed at any earlier coincidence processing step by inserting the **multipleKiller** module at the required level. This module has no parameters and simply removes the multicoincidence events. Multiple coincidences split into many pairs are not affected by this module and cannot be distinguished from normal "simple" coincidences. To insert a multipleKiller, use the syntax:: -/gate/digitizerMgr/CoincidenceDigitizer/finalCoinc/insert MultiplesKiller +/gate/digitizerMgr/CoincidenceDigitizer/finalCoinc/insert multiplesKiller Example of a digitizer setting