cylinder2D.hpp

// This file is part of the ACTS project.
//
// Copyright (C) 2016 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 https://mozilla.org/MPL/2.0/.
 
#pragma once
 
// Project include(s)
#include "detray/definitions/algebra.hpp"
#include "detray/definitions/containers.hpp"
#include "detray/definitions/detail/qualifiers.hpp"
#include "detray/definitions/indexing.hpp"
#include "detray/definitions/math.hpp"
#include "detray/definitions/units.hpp"
#include "detray/geometry/coordinates/cartesian3D.hpp"
#include "detray/geometry/coordinates/cylindrical2D.hpp"
#include "detray/geometry/detail/shape_utils.hpp"
 
// System include(s)
#include <limits>
#include <ostream>
#include <stdexcept>
#include <string_view>
 
namespace detray {

class cylinder2D {
 public:
  static constexpr std::string_view name = "cylinder2D";

  enum boundaries : unsigned int {
    e_r = 0u,
    e_lower_z = 1u,
    e_upper_z = 2u,
    e_size = 3u,
  };

  template <concepts::scalar scalar_t>
  using bounds_type = darray<scalar_t, boundaries::e_size>;

  template <concepts::algebra algebra_t>
  using local_frame_type = cylindrical2D<algebra_t>;

  template <typename bool_t>
  using result_type = detail::boundary_check_result<bool_t>;

  static constexpr std::size_t dim{2u};

  template <concepts::scalar scalar_t, concepts::point point_t>
  DETRAY_HOST_DEVICE inline scalar_t min_dist_to_boundary(
      const bounds_type<scalar_t> &bounds, const point_t &loc_p) const {
    return math::min(math::fabs(loc_p[1] - bounds[e_lower_z]),
                     math::fabs(bounds[e_upper_z] - loc_p[1]));
  }

  template <concepts::algebra algebra_t>
  DETRAY_HOST_DEVICE constexpr result_type<dbool<algebra_t>> check_boundaries(
      const bounds_type<dscalar<algebra_t>> &bounds,
      const dtransform3D<algebra_t> &trf, const dpoint3D<algebra_t> &glob_p,
      const dscalar<algebra_t> tol =
          std::numeric_limits<dscalar<algebra_t>>::epsilon(),
      const dscalar<algebra_t> edge_tol = 0.f) const {
    // Rotate to local cartesian
    const auto loc_p = cartesian3D<algebra_t>::global_to_local(trf, glob_p, {});
 
    // Only need the z-position for the check
    return check_boundaries(
        bounds,
        dpoint2D<algebra_t>{static_cast<dscalar<algebra_t>>(0.f), loc_p[2]},
        tol, edge_tol);
  }

  template <concepts::scalar scalar_t, concepts::point point_t>
  DETRAY_HOST_DEVICE constexpr auto check_boundaries(
      const bounds_type<scalar_t> &bounds, const point_t &loc_p,
      const scalar_t tol = std::numeric_limits<scalar_t>::epsilon(),
      const scalar_t edge_tol = 0.f) const {
    auto inside_mask{((bounds[e_lower_z] - tol) <= loc_p[1] &&
                      loc_p[1] <= (bounds[e_upper_z] + tol))};
 
    decltype(inside_mask) inside_edge{false};
    if (detail::any_of(edge_tol > 0.f)) {
      const scalar_t full_tol{tol + edge_tol};
      inside_edge = ((bounds[e_lower_z] - full_tol) <= loc_p[1] &&
                     loc_p[1] <= (bounds[e_upper_z] + full_tol));
    }
 
    return result_type<decltype(inside_mask)>{inside_mask, inside_edge};
  }


  template <concepts::scalar scalar_t>
  DETRAY_HOST_DEVICE constexpr scalar_t measure(
      const bounds_type<scalar_t> &bounds) const {
    return area(bounds);
  }

  template <concepts::scalar scalar_t>
  DETRAY_HOST_DEVICE constexpr scalar_t area(
      const bounds_type<scalar_t> &bounds) const {
    return 2.f * constant<scalar_t>::pi * bounds[e_r] *
           (bounds[e_upper_z] - bounds[e_lower_z]);
  }

  template <concepts::scalar scalar_t>
  DETRAY_HOST_DEVICE constexpr bounds_type<scalar_t> merge(
      const bounds_type<scalar_t> &bounds,
      const bounds_type<scalar_t> &o_bounds) const {
    bounds_type<scalar_t> new_bounds{};
 
    new_bounds[e_r] = math::max(bounds[e_r], o_bounds[e_r]);
    new_bounds[e_lower_z] = math::min(bounds[e_lower_z], o_bounds[e_lower_z]);
    new_bounds[e_upper_z] = math::max(bounds[e_upper_z], o_bounds[e_upper_z]);
 
    return new_bounds;
  }

  template <concepts::algebra algebra_t>
  DETRAY_HOST_DEVICE inline darray<dscalar<algebra_t>, 6> local_min_bounds(
      const bounds_type<dscalar<algebra_t>> &bounds,
      const dscalar<algebra_t> env =
          std::numeric_limits<dscalar<algebra_t>>::epsilon()) const {
    assert(env > 0.f);
 
    const dscalar<algebra_t> xy_bound{bounds[e_r] + env};
    return {-xy_bound, -xy_bound, bounds[e_lower_z] - env,
            xy_bound,  xy_bound,  bounds[e_upper_z] + env};
  }

  template <concepts::algebra algebra_t>
  DETRAY_HOST_DEVICE dpoint3D<algebra_t> centroid(
      const bounds_type<dscalar<algebra_t>> &bounds) const {
    return {static_cast<dscalar<algebra_t>>(0.f),
            static_cast<dscalar<algebra_t>>(0.f),
            0.5f * (bounds[e_lower_z] + bounds[e_upper_z])};
  }

  template <concepts::algebra algebra_t>
  DETRAY_HOST dvector<dpoint3D<algebra_t>> vertices(
      const bounds_type<dscalar<algebra_t>> & /*unused*/,
      dindex /*unused*/) const {
    throw std::runtime_error(
        "Vertex generation for cylinders is not implemented");
    return {};
  }

  template <concepts::scalar scalar_t>
  DETRAY_HOST constexpr bool check_consistency(
      const bounds_type<scalar_t> &bounds, std::ostream &os) const {
    constexpr auto tol{10.f * std::numeric_limits<scalar_t>::epsilon()};
 
    if (bounds[e_r] < tol) {
      os << "DETRAY ERROR (HOST): Radius must be in the range (0, "
            "numeric_max)"
         << std::endl;
      return false;
    }
    if (bounds[e_lower_z] >= bounds[e_upper_z] ||
        math::fabs(bounds[e_lower_z] - bounds[e_upper_z]) < tol) {
      os << "DETRAY ERROR (HOST): Neg. half length must be smaller than "
            "pos. half "
            "length.";
      return false;
    }
 
    return true;
  }
};
 
}  // namespace detray