3.10.1.2.1.5. opengate.actors.digitizers

3.10.1.2.1.5.1. Classes

Digitizer	Simple helper class to reduce the code size when creating a digitizer.
DigitizerAdderActor	Equivalent to Gate "adder": gather all hits of an event in the same volume.
DigitizerBlurringActor	Digitizer module for blurring an attribute (single value only, not a vector).
DigitizerSpatialBlurringActor	Digitizer module for blurring a (global) spatial position.
DigitizerEfficiencyActor	Digitizer module for simulating efficiency.
DigitizerEnergyWindowsActor	Consider a list of hits and arrange them according to energy intervals.
DigitizerHitsCollectionActor	Build a list of hits in a given volume.
DigitizerProjectionActor	This actor takes as input HitsCollections and performed binning in 2D images.
DigitizerReadoutActor	This actor is a DigitizerAdderActor + a discretization step:
PhaseSpaceActor	Similar to HitsCollectionActor : store a list of hits.

3.10.1.2.1.5.2. Functions

ene_win_peak(name, energy, energy_width_percent)
ene_win_down_scatter(name, peak_min_value, ...)
ene_win_up_scatter(name, peak_max_value, ...)
energy_windows_peak_scatter(peak_name, ...[, ...])
get_simplified_digitizer_channels_Tc99m(spect_name, ...)
get_simplified_digitizer_channels_Lu177(spect_name, ...)
get_simplified_digitizer_channels_In111(spect_name, ...)
get_simplified_digitizer_channels_I131(spect_name, ...)
get_simplified_digitizer_channels_rad(spect_name, rad, ...)

3.10.1.2.1.5.3. Module Contents

opengate.actors.digitizers.ene_win_peak(name, energy, energy_width_percent)

opengate.actors.digitizers.ene_win_down_scatter(name, peak_min_value, energy_width_percent)

opengate.actors.digitizers.ene_win_up_scatter(name, peak_max_value, energy_width_percent)

opengate.actors.digitizers.energy_windows_peak_scatter(peak_name, down_scatter_name, up_scatter_name, peak, peak_width, down_scatter_width, up_scatter_width=None)

opengate.actors.digitizers.get_simplified_digitizer_channels_Tc99m(spect_name, scatter_flag)

opengate.actors.digitizers.get_simplified_digitizer_channels_Lu177(spect_name, scatter_flag)

opengate.actors.digitizers.get_simplified_digitizer_channels_In111(spect_name, scatter_flag)

opengate.actors.digitizers.get_simplified_digitizer_channels_I131(spect_name, scatter_flag)

opengate.actors.digitizers.get_simplified_digitizer_channels_rad(spect_name, rad, scatter_flag)

class opengate.actors.digitizers.Digitizer(sim, volume_name, digit_name)

Simple helper class to reduce the code size when creating a digitizer. It only avoids repeating mother, output and input_digi_collection parameters.

simulation

volume_name

name

actors = []

hc

set_hit_collection()

add_module(module_type, module_name=None)

get_last_module()

find_first_module(s)

Find the first module that contains the s string

class opengate.actors.digitizers.DigitizerAdderActor(user_info)

Bases: opengate_core.GateDigitizerAdderActor, opengate.actors.base.ActorBase

Equivalent to Gate “adder”: gather all hits of an event in the same volume. Input: a HitsCollection, need aat least TotalEnergyDeposit and PostPosition attributes Output: a Single collections

Policies: - EnergyWinnerPosition: consider position and energy of the hit with the max energy

for all other attributes (Time, etc.): the value of the winner is used.

• EnergyWeightedCentroidPosition: computed the energy-weighted centroid position

  for all other attributes (Time, etc.): the value the last seen hit is used.

type_name = 'DigitizerAdderActor'

static set_default_user_info(user_info)

__str__()

set_group_by_depth()

StartSimulationAction()

EndSimulationAction()

class opengate.actors.digitizers.DigitizerBlurringActor(user_info)

Bases: opengate_core.GateDigitizerBlurringActor, opengate.actors.base.ActorBase

Digitizer module for blurring an attribute (single value only, not a vector). Usually for energy or time.

type_name = 'DigitizerBlurringActor'

static set_default_user_info(user_info)

set_param(user_info)

set_param_gauss(user_info)

set_param_inverse_square(user_info)

set_param_linear(user_info)

__str__()

StartSimulationAction()

EndSimulationAction()

class opengate.actors.digitizers.DigitizerSpatialBlurringActor(user_info)

Bases: opengate_core.GateDigitizerSpatialBlurringActor, opengate.actors.base.ActorBase

Digitizer module for blurring a (global) spatial position.

type_name = 'DigitizerSpatialBlurringActor'

static set_default_user_info(user_info)

set_param(user_info)

__str__()

StartSimulationAction()

EndSimulationAction()

class opengate.actors.digitizers.DigitizerEfficiencyActor(user_info)

Bases: opengate_core.GateDigitizerEfficiencyActor, opengate.actors.base.ActorBase

Digitizer module for simulating efficiency.

type_name = 'DigitizerEfficiencyActor'

static set_default_user_info(user_info)

set_param(user_info)

__str__()

StartSimulationAction()

EndSimulationAction()

class opengate.actors.digitizers.DigitizerEnergyWindowsActor(user_info)

Bases: opengate_core.GateDigitizerEnergyWindowsActor, opengate.actors.base.ActorBase

Consider a list of hits and arrange them according to energy intervals. Input: one DigiCollection Output: as many DigiCollections as the number of energy windows

type_name = 'DigitizerEnergyWindowsActor'

static set_default_user_info(user_info)

__str__()

StartSimulationAction()

EndSimulationAction()

class opengate.actors.digitizers.DigitizerHitsCollectionActor(user_info)

Bases: opengate_core.GateDigitizerHitsCollectionActor, opengate.actors.base.ActorBase

Build a list of hits in a given volume. - the list of attributes to be stored is given in the ‘attributes’ options - output as root

type_name = 'DigitizerHitsCollectionActor'

static set_default_user_info(user_info)

__str__()

StartSimulationAction()

EndSimulationAction()

class opengate.actors.digitizers.DigitizerProjectionActor(user_info)

Bases: opengate_core.GateDigitizerProjectionActor, opengate.actors.base.ActorBase

This actor takes as input HitsCollections and performed binning in 2D images. If there are several HitsCollection as input, the slices will correspond to each HC. If there are several runs, images will also be slice-stacked.

type_name = 'DigitizerProjectionActor'

static set_default_user_info(user_info)

output_image = None

start_output_origin = None

__str__()

__getstate__()

compute_thickness(volume, channels)

Get the thickness of the detector volume, in the correct direction. By default, it is Z. We use the ‘projection_orientation’ to get the correct one.

StartSimulationAction()

EndSimulationAction()

class opengate.actors.digitizers.DigitizerReadoutActor(user_info)

Bases: opengate_core.GateDigitizerReadoutActor, opengate.actors.base.ActorBase

This actor is a DigitizerAdderActor + a discretization step: the final position is the center of the volume

type_name = 'DigitizerReadoutActor'

static set_default_user_info(user_info)

__str__()

StartSimulationAction()

EndSimulationAction()

class opengate.actors.digitizers.PhaseSpaceActor(user_info)

Bases: opengate_core.GatePhaseSpaceActor, opengate.actors.base.ActorBase

Similar to HitsCollectionActor : store a list of hits. However only the first hit of given event is stored here.

type_name = 'PhaseSpaceActor'

static set_default_user_info(user_info)

__getstate__()

fNumberOfAbsorbedEvents = 0

fTotalNumberOfEntries = 0

__str__()

StartSimulationAction()

EndSimulationAction()