API

Muon light

LumenManufaktur.LMParametersType

The parameter set for light detection.

Arguments

  • minimum_distance: the minimum distance [m] between muon track and PMT
  • module_radius: radius of the optical module [m] used to implement shadowing of the PMT by the optical module
  • lambda_min: minimum wavelength [ns]
  • lambda_max: maximum wavelength [ns]
  • n: average index of refraction of medium (default: water) corresponding to the group velocity
  • legendre_coefficients: a tuple of two vectors which contain the Legendre coefficients
  • dispersion_model: the dispersion model (default: Bailey at 1 atm pressure)
  • scattering_model: the scattering model (default: Kopelevich)
  • scattering_probability_model: the scattering probability model (default: p00075)
  • absorption_model: the absorption model
source
LumenManufaktur.directlightfrommuonFunction
directlightfrommuon(params::LMParameters, pmt::PMTModel, R, θ, ϕ)

Returns the number of photo-electrons from direct Cherenkov light from a muon with a closest distance of R [m] to the PMT and the angles θ [rad] (zenith) and ϕ [rad] (azimuth) with respect to the PMT axis.

Arguments

  • params: parameters of the setup
  • pmt: the PMT model
  • R: (closest) distance [m] between muon and PMT
  • ϕ: zenith angle [rad] which is 0 when the PMT points away from the muon track (in x-direction) and rotates counter clockwise to the y-axis when viewed from above, while the z-axis points upwards.
  • θ: azimuth angle [rad] which is 0 when the PMT points upwards (along the z-axis) and π/2 when pointing downwards. Between 0 and π/2, the PMT points to the z-axis
source
directlightfrommuon(params::LMParameters, pmt::PMTModel, R, θ, ϕ, Δt)

Probability density function for direct Cherenkov light from a muon with a closest distance of R [m] to the PMT, the angles θ [rad] (zenith) and ϕ [rad] (azimuth) with respect to the PMT axis and a time difference Δt [ns] relative to direct Cherenkov light. Returns dP/dt [npe/ns].

Arguments

  • params: parameters of the setup
  • pmt: the PMT model
  • R: (closest) distance [m] between muon and PMT
  • ϕ: zenith angle [rad] which is 0 when the PMT points away from the muon track (in x-direction) and rotates counter clockwise to the y-axis when viewed from above, while the z-axis points upwards.
  • θ: azimuth angle [rad] which is 0 when the PMT points upwards (along the z-axis) and π/2 when pointing downwards. Between 0 and π/2, the PMT points to the z-axis
  • Δt: time difference [ns] relative to the Cherenkov light
source
LumenManufaktur.scatteredlightfrommuonFunction
scatteredlightfrommuon(params::LMParameters, pmt::PMTModel, D, cd, θ, ϕ, Δt)

Probability density function for scattered light from muon. Returns [d^2P/dt/dx].

Arguments

  • params: parameters of the setup
  • pmt: PMT model
  • D: distance between track segment and PMT [m]
  • cd: cosine angle of muon direction and track segment - PMT position
  • θ: zenith angle orientation PMT [rad]
  • ϕ: azimuth angle orientation PMT [rad]
  • Δt: time difference relative to direct Cherenkov light
source
LumenManufaktur.PMTModelType

The PMT model.

Arguments

  • photocathode_area: the total are of the photocathode [m^2]
  • quantum_efficiency: a callable which returns the quantum efficiency for a given wavelength [ns]
  • angular_acceptance: a callable which returns the angular acceptance (for values between -1 and 1) for a given wavelength [ns]
source