Scattering.hpp

Go to the documentation of this file. Or view the newest version in sPHENIX GitHub for file Scattering.hpp

// This file is part of the Acts project.
//
// Copyright (C) 2018-2021 CERN for the benefit of the Acts project
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.

#pragma once

#include "Acts/Definitions/Algebra.hpp"
#include "Acts/Material/MaterialSlab.hpp"
#include "Acts/Utilities/UnitVectors.hpp"
#include "ActsFatras/EventData/Particle.hpp"
#include "ActsFatras/Physics/ElectroMagnetic/detail/GaussianMixture.hpp"
#include "ActsFatras/Physics/ElectroMagnetic/detail/GeneralMixture.hpp"
#include "ActsFatras/Physics/ElectroMagnetic/detail/Highland.hpp"

#include <array>
#include <random>

namespace ActsFatras {
namespace detail {

template <typename scattering_model_t>
struct ScatteringImpl {
  scattering_model_t angle;

  template <typename generator_t>
  std::array<Particle, 0> operator()(generator_t &generator,
                                     const Acts::MaterialSlab &slab,
                                     Particle &particle) const {
    // the scattered direction can be computed by rotating the initial
    // direction around a vector orthogonal to the initial direction, i.e. the
    // scattering deflector, by the scattering angle. there are an infinite
    // number of vectors orthogonal to the initial direction. the deflector is
    // rotated by some angle relative to some fixpoint.
    //
    // thus two random angles are required: the random deflector orientation
    // angle drawn uniformly from the [-pi,pi) range and the scattering angle
    // drawn from the specific scattering model distribution.

    // draw the random orientation angle
    const auto psi =
        std::uniform_real_distribution<double>(-M_PI, M_PI)(generator);
    // draw the scattering angle
    const auto theta = angle(generator, slab, particle);

    Acts::Vector3 direction = particle.direction();
    // construct the combined rotation to the scattered direction
    Acts::RotationMatrix3 rotation(
        // rotation of the scattering deflector axis relative to the reference
        Acts::AngleAxis3(psi, direction) *
        // rotation by the scattering angle around the deflector axis
        Acts::AngleAxis3(theta, Acts::makeCurvilinearUnitU(direction)));
    direction.applyOnTheLeft(rotation);
    particle.setDirection(direction);

    // scattering is non-destructive and produces no secondaries
    return {};
  }
};

}  // namespace detail

using GaussianMixtureScattering =
    detail::ScatteringImpl<detail::GaussianMixture>;
using GeneralMixtureScattering = detail::ScatteringImpl<detail::GeneralMixture>;
using HighlandScattering = detail::ScatteringImpl<detail::Highland>;

}  // namespace ActsFatras