Detector constants

Set detector constants

larndsim.consts.detector.TEMPERATURE = 87.17[source]

Detector temperature in K

larndsim.consts.detector.LAR_DENSITY = 1.38[source]

Liquid argon density in \(g/cm^3\)

larndsim.consts.detector.E_FIELD = 0.5[source]

Electric field magnitude in \(kV/cm\)

larndsim.consts.detector.V_DRIFT = 0.1648[source]

Drift velocity in \(cm/\mu s\)

larndsim.consts.detector.ELECTRON_MOBILITY_PARAMS = (551.6, 7158.3, 4440.43, 4.29, 43.63, 0.2053)[source]

Electron mobility constants

larndsim.consts.detector.ELECTRON_LIFETIME = 2200.0[source]

Electron lifetime in \(\mu s\)

larndsim.consts.detector.LONG_DIFF = 4e-06[source]

Longitudinal diffusion coefficient in \(cm^2/\mu s\)

larndsim.consts.detector.TRAN_DIFF = 8.8e-06[source]

Transverse diffusion coefficient in \(cm^2/\mu s\)

larndsim.consts.detector.DRIFT_LENGTH = 0[source]

TPC drift length in \(cm\)

larndsim.consts.detector.DRIFT_MAX_TIME = 0[source]

Time for the full drift calculated from the nominal drift velocity

larndsim.consts.detector.TPC_BORDERS = (0, 3, 2)[source]

Borders of each TPC volume in \(cm\)

larndsim.consts.detector.TPC_OFFSETS = (0, 3, 2)[source]

TPC offsets wrt the origin in \(cm\)

larndsim.consts.detector.TILE_BORDERS = (2, 2)[source]

Pixel tile borders in \(cm\)

larndsim.consts.detector.TIME_SAMPLING = 0.1[source]

Time sampling in \(\mu s\)

larndsim.consts.detector.RESPONSE_SAMPLING = 0.05[source]

Time sampling in the pixel response file in \(\mu s\)

larndsim.consts.detector.RESPONSE_BIN_SIZE = 0.04434[source]

Spatial sampling in the pixel response file in \(cm\)

larndsim.consts.detector.RESPONSE_MAX_TIME = 0.0[source]

The longest cathode charge response in time \(\mu s\)

larndsim.consts.detector.MAX_RADIUS = 4[source]

The maximum radius to consider the neighbouring charge response

larndsim.consts.detector.MIN_STEP_SIZE = 0.001[source]

The step size to chop up segments \(cm\) MIN_STEP_SIZE should be comparable to the smallest bin size in x,y,t of the response file The bin size in x, y is ~0.04 cm (1/10 of a pixel size), and the bin size in t is 50 ns, which is roughly 0.007 cm

larndsim.consts.detector.DEFAULT_PLANE_INDEX = 48879[source]

Default value for pixel_plane, to indicate out-of-bounds edep

larndsim.consts.detector.N_PIXELS = (0, 0)[source]

Total number of pixels

larndsim.consts.detector.N_PIXELS_PER_TILE = (0, 0)[source]

Number of pixels in each tile

larndsim.consts.detector.PIXEL_CONNECTION_DICT = {}[source]

Dictionary between pixel ID and its position in the pixel array

larndsim.consts.detector.PIXEL_PITCH = 0.4434[source]

Pixel pitch in \(cm\)

larndsim.consts.detector.TILE_POSITIONS = {}[source]

Tile position wrt the center of the anode in \(cm\)

larndsim.consts.detector.TILE_ORIENTATIONS = {}[source]

Tile orientations in each anode

larndsim.consts.detector.TILE_MAP = ()[source]

Map of tiles in each anode

larndsim.consts.detector.TILE_CHIP_TO_IO = {}[source]

Association between chips and io channels

larndsim.consts.detector.MODULE_TO_IO_GROUPS = {}[source]

Association between modules and io groups

larndsim.consts.detector.MODULE_TO_TPCS = {}[source]

Association between modules and tpcs

larndsim.consts.detector.DISCRIMINATION_THRESHOLD = 5000.0[source]

Discrimination threshold in e-

larndsim.consts.detector.ADC_HOLD_DELAY = 15[source]

ADC hold delay in clock cycles

larndsim.consts.detector.ADC_BUSY_DELAY = 9[source]

ADC busy delay in clock cycles

larndsim.consts.detector.PERIODIC_RESET_CYCLES = -1[source]

periodic reset cycles in clock cycles

larndsim.consts.detector.RESET_CYCLES = 1[source]

Reset time in clock cycles

larndsim.consts.detector.CLOCK_CYCLE = 0.1[source]

Clock cycle time in \(\mu s\)

larndsim.consts.detector.ROLLOVER_CYCLES = 2147483648[source]

Clock rollover / reset time in larpix clock ticks (32-digit clock)

larndsim.consts.detector.PPS_CYCLES = 10000000.0[source]

PPS reset time

larndsim.consts.detector.USE_PPS_ROLLOVER = True[source]

True if using PPS reset / false for clock rollover

larndsim.consts.detector.GAIN = 0.004[source]

Front-end gain in \(mV/e-\)

larndsim.consts.detector.BUFFER_RISETIME = 0.1[source]

Buffer risetime in \(\mu s\) (set >0 to include buffer response simulation)

larndsim.consts.detector.V_CM = 478.1[source]

Common-mode voltage in \(mV\)

larndsim.consts.detector.V_REF = 1568[source]

Reference voltage in \(mV\)

larndsim.consts.detector.V_PEDESTAL = 580[source]

Pedestal voltage in \(mV\)

larndsim.consts.detector.ADC_COUNTS = 256[source]

Number of ADC counts

larndsim.consts.detector.ADC_SCALE_FACTOR = 1[source]

Scale factor to adjust the ADC range

larndsim.consts.detector.RESET_NOISE_CHARGE = 900[source]

Reset noise in e-

larndsim.consts.detector.UNCORRELATED_NOISE_CHARGE = 500[source]

Uncorrelated noise in e-

larndsim.consts.detector.DISCRIMINATOR_NOISE = 650[source]

Discriminator noise in e-

larndsim.consts.detector.LARPIX_VERSION = 2[source]

LArPix version (default v2)

larndsim.consts.detector.PACKET_VERSION = 2[source]

LArPix packet class version

larndsim.consts.detector.PACKET_TYPE = 0[source]

Data packet type

larndsim.consts.detector.LARPIX_HDF5_VERSION = 2.4[source]

LArPix HDF5 dataset version

larndsim.consts.detector.EVENT_RATE = 100000[source]

Average time between events in microseconds

larndsim.consts.detector.NON_BEAM_EVENT_GAP = 0[source]

Offset of the non-beam event time in microseconds

larndsim.consts.detector.DIFF_N_SIGMAS = 5[source]

Pad the signal range to allow N sigmas of diffusion

larndsim.consts.detector.NEIGHBORING_PIX_DIST = [][source]

Distances of the neighboring pixels to the center pixel

larndsim.consts.detector.electron_mobility(efield, temperature)[source][source]

Calculation of the electron mobility w.r.t temperature and electric field. .. rubric:: References

Parameters:
  • efield (float) – electric field in kV/cm

  • temperature (float) – temperature

Returns:

electron mobility in cm^2/kV/us

Return type:

float

larndsim.consts.detector.load_detector_properties(config_keyword)[source][source]
larndsim.consts.detector.get_n_modules(detprop_file)[source][source]

The function loads the global detector properties (not subject to the module variations) stores the constants as global variables

Parameters:

detprop_file (str) – detector properties YAML filename

larndsim.consts.detector.set_multi_properties(bucket, n_mod, i_module, message='')[source][source]
larndsim.consts.detector.set_detector_properties(detprop_file, pixel_file, response_file=None, i_module=-1, geo_only=False)[source][source]

The function loads the detector properties and the pixel geometry YAML files and stores the constants as global variables

Parameters:
  • detprop_file (str) – detector properties YAML filename It is acceptable to provide a single value or a list with one element for electric field and electron lifetime.

  • pixel_file (str) – pixel layout YAML filename

  • i_module (int) – module id, default value i_module = -1. i_module < 0 means all module share the same detector configuration.

larndsim.consts.detector.load_response(response_file)[source][source]