spline_builder_3d.hpp

// Copyright (C) The DDC development team, see COPYRIGHT.md file
//
// SPDX-License-Identifier: MIT
 
#pragma once
 
#include <cassert>
#include <cstddef>
#include <optional>
#include <string>
#include <utility>
 
#include <ddc/ddc.hpp>
 
#include "spline_boundary_conditions.hpp"
#include "spline_builder.hpp"
#include "spline_builder_2d.hpp"
 
namespace ddc {
 
/**
 * @brief A class for creating a 3D spline approximation of a function.
 *
 * A class which contains an operator () which can be used to build a 3D spline approximation
 * of a function. A 3D spline approximation uses a cross-product between three 1D SplineBuilder.
 *
 * @see SplineBuilder
 */
template <
        class ExecSpace,
        class MemorySpace,
        class BSpline1,
        class BSpline2,
        class BSpline3,
        class DDimI1,
        class DDimI2,
        class DDimI3,
        ddc::BoundCond BcLower1,
        ddc::BoundCond BcUpper1,
        ddc::BoundCond BcLower2,
        ddc::BoundCond BcUpper2,
        ddc::BoundCond BcLower3,
        ddc::BoundCond BcUpper3,
        ddc::SplineSolver Solver>
class SplineBuilder3D
{
public:
    /// @brief The type of the Kokkos execution space used by this class.
    using exec_space = ExecSpace;
 
    /// @brief The type of the Kokkos memory space used by this class.
    using memory_space = MemorySpace;
 
    /// @brief The type of the SplineBuilder used by this class to spline-approximate along first dimension.
    using builder_type1 = ddc::
            SplineBuilder<ExecSpace, MemorySpace, BSpline1, DDimI1, BcLower1, BcUpper1, Solver>;
 
    /// @brief The type of SplineBuilder used by this class to spline-approximate along the second and third dimensions.
    using builder_type_2_3 = ddc::SplineBuilder2D<
            ExecSpace,
            MemorySpace,
            BSpline2,
            BSpline3,
            DDimI2,
            DDimI3,
            BcLower2,
            BcUpper2,
            BcLower3,
            BcUpper3,
            Solver>;
 
    /// @brief The type of the first interpolation continuous dimension.
    using continuous_dimension_type1 = builder_type1::continuous_dimension_type;
 
    /// @brief The type of the second interpolation continuous dimension.
    using continuous_dimension_type2 = builder_type_2_3::continuous_dimension_type1;
 
    /// @brief The type of the third interpolation continuous dimension.
    using continuous_dimension_type3 = builder_type_2_3::continuous_dimension_type2;
 
    /// @brief The type of the first interpolation discrete dimension.
    using interpolation_discrete_dimension_type1
            = builder_type1::interpolation_discrete_dimension_type;
 
    /// @brief The type of the second interpolation discrete dimension.
    using interpolation_discrete_dimension_type2
            = builder_type_2_3::interpolation_discrete_dimension_type1;
 
    /// @brief The type of the third interpolation discrete dimension.
    using interpolation_discrete_dimension_type3
            = builder_type_2_3::interpolation_discrete_dimension_type2;
 
    /// @brief The type of the B-splines in the first dimension.
    using bsplines_type1 = builder_type1::bsplines_type;
 
    /// @brief The type of the B-splines in the second dimension.
    using bsplines_type2 = builder_type_2_3::bsplines_type1;
 
    /// @brief The type of the B-splines in the third dimension.
    using bsplines_type3 = builder_type_2_3::bsplines_type2;
 
    /// @brief The type of the Deriv domain on boundaries in the first dimension.
    using deriv_type1 = builder_type1::deriv_type;
 
    /// @brief The type of the Deriv domain on boundaries in the second dimension.
    using deriv_type2 = builder_type_2_3::deriv_type1;
 
    /// @brief The type of the Deriv domain on boundaries in the third dimension.
    using deriv_type3 = builder_type_2_3::deriv_type2;
 
    /// @brief The type of the domain for the interpolation mesh in the first dimension.
    using interpolation_domain_type1 = builder_type1::interpolation_discrete_dimension_type;
 
    /// @brief The type of the domain for the interpolation mesh in the second dimension.
    using interpolation_domain_type2 = builder_type_2_3::interpolation_discrete_dimension_type1;
 
    /// @brief The type of the domain for the interpolation mesh in the third dimension.
    using interpolation_domain_type3 = builder_type_2_3::interpolation_discrete_dimension_type2;
 
    /// @brief The type of the domain for the interpolation mesh in the 3D dimension.
    using interpolation_domain_type = ddc::DiscreteDomain<
            interpolation_discrete_dimension_type1,
            interpolation_discrete_dimension_type2,
            interpolation_discrete_dimension_type3>;
 
    /**
     * @brief The type of the whole domain representing interpolation points.
     *
     * @tparam The batched discrete domain on which the interpolation points are defined.
     */
    template <concepts::discrete_domain BatchedInterpolationDDom>
    using batched_interpolation_domain_type = BatchedInterpolationDDom;
 
    /**
     * @brief The type of the batch domain (obtained by removing the dimensions of interest
     * from the whole domain).
     *
     * @tparam The batched discrete domain on which the interpolation points are defined.
     *
     * Example: For batched_interpolation_domain_type = DiscreteDomain<X,Y,Z,T> and dimensions of interest X, Y and Z,
     * this is DiscreteDomain<T>.
     */
    template <concepts::discrete_domain BatchedInterpolationDDom>
    using batch_domain_type = ddc::remove_dims_of_t<
            BatchedInterpolationDDom,
            interpolation_discrete_dimension_type1,
            interpolation_discrete_dimension_type2,
            interpolation_discrete_dimension_type3>;
 
    /**
     * @brief The type of the whole spline domain (cartesian product of 3D spline domain
     * and batch domain) preserving the order of dimensions.
     *
     * @tparam The batched discrete domain on which the interpolation points are defined.
     *
     * Example: For batched_interpolation_domain_type = DiscreteDomain<X,Y,Z,T> and dimensions of interest X, Y and Z
     * (associated to B-splines tags BSplinesX, BSplinesY and BSplinesZ), this is DiscreteDomain<BSplinesX, BSplinesY, BSplinesZ, T>
     */
    template <concepts::discrete_domain BatchedInterpolationDDom>
    using batched_spline_domain_type
            = ddc::detail::convert_type_seq_to_discrete_domain_t<ddc::type_seq_replace_t<
                    ddc::to_type_seq_t<BatchedInterpolationDDom>,
                    ddc::detail::TypeSeq<
                            interpolation_discrete_dimension_type1,
                            interpolation_discrete_dimension_type2,
                            interpolation_discrete_dimension_type3>,
                    ddc::detail::TypeSeq<bsplines_type1, bsplines_type2, bsplines_type3>>>;
 
    /**
     * @brief The type of the whole Derivs domain (cartesian product of the 1D Deriv domain
     * and the associated batch domain) in the first dimension, preserving the order of dimensions.
     *
     * @tparam The batched discrete domain on which the interpolation points are defined.
     *
     * Example: For batched_interpolation_domain_type = DiscreteDomain<X,Y,Z,T> and dimensions of interest X, Y and Z,
     * this is DiscreteDomain<Deriv<X>, Y, Z, T>.
     */
    template <concepts::discrete_domain BatchedInterpolationDDom>
    using batched_derivs_domain_type1 = ddc::replace_dim_of_t<
            BatchedInterpolationDDom,
            interpolation_discrete_dimension_type1,
            deriv_type1>;
 
    /**
     * @brief The type of the whole Derivs domain (cartesian product of the 1D Deriv domain
     * and the associated batch domain) in the second dimension, preserving the order of dimensions.
     *
     * @tparam The batched discrete domain on which the interpolation points are defined.
     *
     * Example: For batched_interpolation_domain_type = DiscreteDomain<X,Y,Z,T> and dimensions of interest X, Y, and Z
     * this is DiscreteDomain<X, Deriv<Y>, Z, T>.
     */
    template <concepts::discrete_domain BatchedInterpolationDDom>
    using batched_derivs_domain_type2 = ddc::replace_dim_of_t<
            BatchedInterpolationDDom,
            interpolation_discrete_dimension_type2,
            deriv_type2>;
 
    /**
     * @brief The type of the whole Derivs domain (cartesian product of the 1D Deriv domain
     * and the associated batch domain) in the third dimension, preserving the order of dimensions.
     *
     * @tparam The batched discrete domain on which the interpolation points are defined.
     *
     * Example: For batched_interpolation_domain_type = DiscreteDomain<X,Y,Z,T> and dimensions of interest X, Y, and Z
     * this is DiscreteDomain<X, Y, Deriv<Z>, T>.
     */
    template <concepts::discrete_domain BatchedInterpolationDDom>
    using batched_derivs_domain_type3 = ddc::replace_dim_of_t<
            BatchedInterpolationDDom,
            interpolation_discrete_dimension_type3,
            deriv_type3>;
 
    /**
     * @brief The type of the whole Derivs domain (cartesian product of the 2D Deriv domain
     * and the associated batch domain) in the first and second dimensions, preserving the order
     * of dimensions.
     *
     * @tparam The batched discrete domain on which the interpolation points are defined.
     *
     * Example: For batched_interpolation_domain_type = DiscreteDomain<X,Y,Z,T> and dimensions of interest X, Y and Z,
     * this is DiscreteDomain<Deriv<X>, Deriv<Y>, Z, T>.
     */
    template <concepts::discrete_domain BatchedInterpolationDDom>
    using batched_derivs_domain_type1_2 = ddc::replace_dim_of_t<
            ddc::replace_dim_of_t<
                    BatchedInterpolationDDom,
                    interpolation_discrete_dimension_type1,
                    deriv_type1>,
            interpolation_domain_type2,
            deriv_type2>;
 
    /**
     * @brief The type of the whole Derivs domain (cartesian product of the 2D Deriv domain
     * and the associated batch domain) in the second and third dimensions, preserving the order
     * of dimensions.
     *
     * @tparam The batched discrete domain on which the interpolation points are defined.
     *
     * Example: For batched_interpolation_domain_type = DiscreteDomain<X,Y,Z,T> and dimensions of interest X, Y, and Z
     * this is DiscreteDomain<X, Deriv<Y>, Deriv<Z>, T>.
     */
    template <concepts::discrete_domain BatchedInterpolationDDom>
    using batched_derivs_domain_type2_3 = ddc::replace_dim_of_t<
            ddc::replace_dim_of_t<
                    BatchedInterpolationDDom,
                    interpolation_discrete_dimension_type2,
                    deriv_type2>,
            interpolation_domain_type3,
            deriv_type3>;
 
    /**
     * @brief The type of the whole Derivs domain (cartesian product of the 2D Deriv domain
     * and the associated batch domain) in the first and third dimensions, preserving the order
     * of dimensions.
     *
     * @tparam The batched discrete domain on which the interpolation points are defined.
     *
     * Example: For batched_interpolation_domain_type = DiscreteDomain<X,Y,Z,T> and dimensions of interest X, Y, and Z
     * this is DiscreteDomain<Deriv<X>, Y, Deriv<Z>, T>.
     */
    template <concepts::discrete_domain BatchedInterpolationDDom>
    using batched_derivs_domain_type1_3 = ddc::replace_dim_of_t<
            ddc::replace_dim_of_t<
                    BatchedInterpolationDDom,
                    interpolation_discrete_dimension_type1,
                    deriv_type1>,
            interpolation_domain_type3,
            deriv_type3>;
 
    /**
     * @brief The type of the whole Derivs domain (cartesian product of the 3D Deriv domain
     * and the batch domain), preserving the order of dimensions.
     *
     * @tparam The batched discrete domain on which the interpolation points are defined.
     *
     * Example: For batched_interpolation_domain_type = DiscreteDomain<X,Y,Z,T> and dimensions of interest X, Y and Z,
     * this is DiscreteDomain<Deriv<X>, Deriv<Y>, Deriv<Z>, T>.
     */
    template <concepts::discrete_domain BatchedInterpolationDDom>
    using batched_derivs_domain_type
            = ddc::detail::convert_type_seq_to_discrete_domain_t<ddc::type_seq_replace_t<
                    ddc::to_type_seq_t<BatchedInterpolationDDom>,
                    ddc::detail::TypeSeq<
                            interpolation_discrete_dimension_type1,
                            interpolation_discrete_dimension_type2,
                            interpolation_discrete_dimension_type3>,
                    ddc::detail::TypeSeq<deriv_type1, deriv_type2, deriv_type3>>>;
 
private:
    builder_type1 m_spline_builder1;
    builder_type_2_3 m_spline_builder_2_3;
    std::string m_label;
 
public:
    /**
     * @brief Build a SplineBuilder3D acting on interpolation_domain.
     *
     * @param label A label used to tag parallel regions and memory allocations for profiling.
     *
     * @param interpolation_domain The domain on which the interpolation points are defined, without the batch dimensions.
     *
     * @param cols_per_chunk A parameter used by the slicer (internal to the solver) to define the size
     * of a chunk of right-hand-sides of the linear problem to be computed in parallel (chunks are treated
     * by the linear solver one-after-the-other).
     * This value is optional. If no value is provided then the default value is chosen by the requested solver.
     *
     * @param preconditioner_max_block_size A parameter used by the slicer (internal to the solver) to
     * define the size of a block used by the Block-Jacobi preconditioner.
     * This value is optional. If no value is provided then the default value is chosen by the requested solver.
     *
     * @see SplinesLinearProblemSparse
     */
    explicit SplineBuilder3D(
            std::string label,
            interpolation_domain_type const& interpolation_domain,
            std::optional<std::size_t> cols_per_chunk = std::nullopt,
            std::optional<unsigned int> preconditioner_max_block_size = std::nullopt)
        : m_spline_builder1(interpolation_domain, cols_per_chunk, preconditioner_max_block_size)
        , m_spline_builder_2_3(interpolation_domain, cols_per_chunk, preconditioner_max_block_size)
        , m_label(std::move(label))
    {
    }
 
    /**
     * @brief Build a SplineBuilder3D acting on interpolation_domain.
     *
     * @param interpolation_domain The domain on which the interpolation points are defined, without the batch dimensions.
     *
     * @param cols_per_chunk A parameter used by the slicer (internal to the solver) to define the size
     * of a chunk of right-hand-sides of the linear problem to be computed in parallel (chunks are treated
     * by the linear solver one-after-the-other).
     * This value is optional. If no value is provided then the default value is chosen by the requested solver.
     *
     * @param preconditioner_max_block_size A parameter used by the slicer (internal to the solver) to
     * define the size of a block used by the Block-Jacobi preconditioner.
     * This value is optional. If no value is provided then the default value is chosen by the requested solver.
     *
     * @see SplinesLinearProblemSparse
     */
    explicit SplineBuilder3D(
            interpolation_domain_type const& interpolation_domain,
            std::optional<std::size_t> cols_per_chunk = std::nullopt,
            std::optional<unsigned int> preconditioner_max_block_size = std::nullopt)
        : SplineBuilder3D(
                  "no-label",
                  interpolation_domain,
                  cols_per_chunk,
                  preconditioner_max_block_size)
    {
    }
 
    /**
     * @brief Build a SplineBuilder3D acting on the interpolation domain contained in batched_interpolation_domain.
     *
     * @param label A label used to tag parallel regions and memory allocations for profiling.
     *
     * @param batched_interpolation_domain The domain on which the interpolation points are defined.
     *
     * @param cols_per_chunk A parameter used by the slicer (internal to the solver) to define the size
     * of a chunk of right-hand-sides of the linear problem to be computed in parallel (chunks are treated
     * by the linear solver one-after-the-other).
     * This value is optional. If no value is provided then the default value is chosen by the requested solver.
     *
     * @param preconditioner_max_block_size A parameter used by the slicer (internal to the solver) to
     * define the size of a block used by the Block-Jacobi preconditioner.
     * This value is optional. If no value is provided then the default value is chosen by the requested solver.
     *
     * @see SplinesLinearProblemSparse
     */
    template <concepts::discrete_domain BatchedInterpolationDDom>
    explicit SplineBuilder3D(
            std::string label,
            BatchedInterpolationDDom const& batched_interpolation_domain,
            std::optional<std::size_t> cols_per_chunk = std::nullopt,
            std::optional<unsigned int> preconditioner_max_block_size = std::nullopt)
        : SplineBuilder3D(
                  std::move(label),
                  interpolation_domain_type(batched_interpolation_domain),
                  cols_per_chunk,
                  preconditioner_max_block_size)
    {
    }
 
    /**
     * @brief Build a SplineBuilder3D acting on the interpolation domain contained in batched_interpolation_domain.
     *
     * @param batched_interpolation_domain The domain on which the interpolation points are defined.
     *
     * @param cols_per_chunk A parameter used by the slicer (internal to the solver) to define the size
     * of a chunk of right-hand-sides of the linear problem to be computed in parallel (chunks are treated
     * by the linear solver one-after-the-other).
     * This value is optional. If no value is provided then the default value is chosen by the requested solver.
     *
     * @param preconditioner_max_block_size A parameter used by the slicer (internal to the solver) to
     * define the size of a block used by the Block-Jacobi preconditioner.
     * This value is optional. If no value is provided then the default value is chosen by the requested solver.
     *
     * @see SplinesLinearProblemSparse
     */
    template <concepts::discrete_domain BatchedInterpolationDDom>
    explicit SplineBuilder3D(
            BatchedInterpolationDDom const& batched_interpolation_domain,
            std::optional<std::size_t> cols_per_chunk = std::nullopt,
            std::optional<unsigned int> preconditioner_max_block_size = std::nullopt)
        : SplineBuilder3D(
                  "no-label",
                  interpolation_domain_type(batched_interpolation_domain),
                  cols_per_chunk,
                  preconditioner_max_block_size)
    {
    }
 
    /// @brief Copy-constructor is deleted.
    SplineBuilder3D(SplineBuilder3D const& x) = delete;
 
    /**
     * @brief Move-constructs.
     *
     * @param x An rvalue to another SplineBuilder3D.
     */
    SplineBuilder3D(SplineBuilder3D&& x) = default;
 
    /// @brief Destructs.
    ~SplineBuilder3D() = default;
 
    /// @brief Copy-assignment is deleted.
    SplineBuilder3D& operator=(SplineBuilder3D const& x) = delete;
 
    /** @brief Move-assigns.
     *
     * @param x An rvalue to another SplineBuilder.
     * @return A reference to this object.
     */
    SplineBuilder3D& operator=(SplineBuilder3D&& x) = default;
 
    /**
     * @brief Get the domain for the 3D interpolation mesh used by this class.
     *
     * This is 3D because it is defined along the dimensions of interest.
     *
     * @return The 3D domain for the interpolation mesh.
     */
    interpolation_domain_type interpolation_domain() const noexcept
    {
        return ddc::DiscreteDomain<
                interpolation_domain_type1,
                interpolation_domain_type2,
                interpolation_domain_type3>(
                m_spline_builder1.interpolation_domain(),
                m_spline_builder_2_3.interpolation_domain());
    }
 
    /**
     * @brief Get the whole domain representing interpolation points.
     *
     * Values of the function must be provided on this domain in order
     * to build a spline representation of the function (cartesian product of 3D interpolation_domain and batch_domain).
     *
     * @param batched_interpolation_domain The whole domain on which the interpolation points are defined.
     *
     * @return The domain for the interpolation mesh.
     */
    template <concepts::discrete_domain BatchedInterpolationDDom>
    BatchedInterpolationDDom batched_interpolation_domain(
            BatchedInterpolationDDom const& batched_interpolation_domain) const noexcept
    {
        assert(interpolation_domain() == interpolation_domain_type(batched_interpolation_domain));
        return batched_interpolation_domain;
    }
 
    /**
     * @brief Get the batch domain.
     *
     * Obtained by removing the dimensions of interest from the whole interpolation domain.
     *
     * @param batched_interpolation_domain The whole domain on which the interpolation points are defined.
     *
     * @return The batch domain.
     */
    template <concepts::discrete_domain BatchedInterpolationDDom>
    batch_domain_type<BatchedInterpolationDDom> batch_domain(
            BatchedInterpolationDDom const& batched_interpolation_domain) const noexcept
    {
        assert(interpolation_domain() == interpolation_domain_type(batched_interpolation_domain));
        return ddc::remove_dims_of(batched_interpolation_domain, interpolation_domain());
    }
 
    /**
     * @brief Get the 3D domain on which spline coefficients are defined.
     *
     * The 3D spline domain corresponding to the dimensions of interest.
     *
     * @return The 3D domain for the spline coefficients.
     */
    ddc::DiscreteDomain<bsplines_type1, bsplines_type2, bsplines_type3> spline_domain()
            const noexcept
    {
        return ddc::DiscreteDomain<bsplines_type1, bsplines_type2, bsplines_type3>(
                ddc::discrete_space<bsplines_type1>().full_domain(),
                ddc::discrete_space<bsplines_type2>().full_domain(),
                ddc::discrete_space<bsplines_type3>().full_domain());
    }
 
    /**
     * @brief Get the whole domain on which spline coefficients are defined.
     *
     * Spline approximations (spline-transformed functions) are computed on this domain.
     *
     * @param batched_interpolation_domain The whole domain on which the interpolation points are defined.
     *
     * @return The domain for the spline coefficients.
     */
    template <concepts::discrete_domain BatchedInterpolationDDom>
    batched_spline_domain_type<BatchedInterpolationDDom> batched_spline_domain(
            BatchedInterpolationDDom const& batched_interpolation_domain) const noexcept
    {
        assert(interpolation_domain() == interpolation_domain_type(batched_interpolation_domain));
        return ddc::replace_dim_of<interpolation_discrete_dimension_type1, bsplines_type1>(
                ddc::replace_dim_of<interpolation_discrete_dimension_type2, bsplines_type2>(
                        ddc::replace_dim_of<
                                interpolation_discrete_dimension_type3,
                                bsplines_type3>(batched_interpolation_domain, spline_domain()),
                        spline_domain()),
                spline_domain());
    }
 
    /**
     * @brief Compute a 3D spline approximation of a function.
     *
     * Use the values of a function (defined on
     * SplineBuilder3D::batched_interpolation_domain) and the derivatives of the
     * function at the boundaries (in the case of BoundCond::HERMITE only)
     * to calculate a 3D spline approximation of this function.
     *
     * The spline approximation is stored as a ChunkSpan of coefficients
     * associated with B-splines.
     *
     * @param[out] spline
     *      The coefficients of the spline computed by this SplineBuilder.
     * @param[in] vals
     *      The values of the function at the interpolation mesh.
     * @param[in] derivs_min1
     *      The values of the derivatives at the lower boundary in the first dimension.
     * @param[in] derivs_max1
     *      The values of the derivatives at the upper boundary in the first dimension.
     * @param[in] derivs_min2
     *      The values of the derivatives at the lower boundary in the second dimension.
     * @param[in] derivs_max2
     *      The values of the derivatives at the upper boundary in the second dimension.
     * @param[in] derivs_min3
     *      The values of the derivatives at the lower boundary in the third dimension.
     * @param[in] derivs_max3
     *      The values of the derivatives at the upper boundary in the third dimension.
     * @param[in] mixed_derivs_min1_min2
     *      The values of the the cross-derivatives at the lower boundary in the first dimension and the lower boundary in the second dimension.
     * @param[in] mixed_derivs_max1_min2
     *      The values of the the cross-derivatives at the upper boundary in the first dimension and the lower boundary in the second dimension.
     * @param[in] mixed_derivs_min1_max2
     *      The values of the the cross-derivatives at the lower boundary in the first dimension and the upper boundary in the second dimension.
     * @param[in] mixed_derivs_max1_max2
     *      The values of the the cross-derivatives at the upper boundary in the first dimension and the upper boundary in the second dimension.
     * @param[in] mixed_derivs_min2_min3
     *      The values of the the cross-derivatives at the lower boundary in the second dimension and the lower boundary in the third dimension.
     * @param[in] mixed_derivs_max2_min3
     *      The values of the the cross-derivatives at the upper boundary in the second dimension and the lower boundary in the third dimension.
     * @param[in] mixed_derivs_min2_max3
     *      The values of the the cross-derivatives at the lower boundary in the second dimension and the upper boundary in the third dimension.
     * @param[in] mixed_derivs_max2_max3
     *      The values of the the cross-derivatives at the upper boundary in the second dimension and the upper boundary in the third dimension.
     * @param[in] mixed_derivs_min1_min3
     *      The values of the the cross-derivatives at the lower boundary in the first dimension and the lower boundary in the third dimension.
     * @param[in] mixed_derivs_max1_min3
     *      The values of the the cross-derivatives at the upper boundary in the first dimension and the lower boundary in the third dimension.
     * @param[in] mixed_derivs_min1_max3
     *      The values of the the cross-derivatives at the lower boundary in the first dimension and the upper boundary in the third dimension.
     * @param[in] mixed_derivs_max1_max3
     *      The values of the the cross-derivatives at the upper boundary in the first dimension and the upper boundary in the third dimension.
     * @param[in] mixed_derivs_min1_min2_min3
     *      The values of the the cross-derivatives at the lower boundary in the first dimension, the lower boundary in the second dimension and the lower boundary in the third dimension.
     * @param[in] mixed_derivs_max1_min2_min3
     *      The values of the the cross-derivatives at the upper boundary in the first dimension, the lower boundary in the second dimension and the lower boundary in the third dimension.
     * @param[in] mixed_derivs_min1_max2_min3
     *      The values of the the cross-derivatives at the lower boundary in the first dimension, the upper boundary in the second dimension and the lower boundary in the third dimension.
     * @param[in] mixed_derivs_max1_max2_min3
     *      The values of the the cross-derivatives at the upper boundary in the first dimension, the upper boundary in the second dimension and the lower boundary in the third dimension.
     * @param[in] mixed_derivs_min1_min2_max3
     *      The values of the the cross-derivatives at the lower boundary in the first dimension, the lower boundary in the second dimension and the upper boundary in the third dimension.
     * @param[in] mixed_derivs_max1_min2_max3
     *      The values of the the cross-derivatives at the upper boundary in the first dimension, the lower boundary in the second dimension and the upper boundary in the third dimension.
     * @param[in] mixed_derivs_min1_max2_max3
     *      The values of the the cross-derivatives at the lower boundary in the first dimension, the upper boundary in the second dimension and the upper boundary in the third dimension.
     * @param[in] mixed_derivs_max1_max2_max3
     *      The values of the the cross-derivatives at the upper boundary in the first dimension, the upper boundary in the second dimension and the upper boundary in the third dimension.
     */
    template <class Layout, class BatchedInterpolationDDom>
    void operator()(
            ddc::ChunkSpan<
                    double,
                    batched_spline_domain_type<BatchedInterpolationDDom>,
                    Layout,
                    memory_space> spline,
            ddc::ChunkSpan<double const, BatchedInterpolationDDom, Layout, memory_space> vals,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type1<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> derivs_min1
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type1<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> derivs_max1
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type2<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> derivs_min2
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type2<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> derivs_max2
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type3<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> derivs_min3
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type3<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> derivs_max3
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type1_2<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_min1_min2
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type1_2<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_max1_min2
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type1_2<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_min1_max2
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type1_2<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_max1_max2
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type2_3<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_min2_min3
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type2_3<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_max2_min3
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type2_3<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_min2_max3
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type2_3<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_max2_max3
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type1_3<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_min1_min3
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type1_3<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_max1_min3
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type1_3<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_min1_max3
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type1_3<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_max1_max3
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_min1_min2_min3
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_max1_min2_min3
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_min1_max2_min3
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_max1_max2_min3
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_min1_min2_max3
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_max1_min2_max3
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_min1_max2_max3
            = std::nullopt,
            std::optional<ddc::ChunkSpan<
                    double const,
                    batched_derivs_domain_type<BatchedInterpolationDDom>,
                    Layout,
                    memory_space>> mixed_derivs_max1_max2_max3
            = std::nullopt) const;
};
 
 
template <
        class ExecSpace,
        class MemorySpace,
        class BSpline1,
        class BSpline2,
        class BSpline3,
        class DDimI1,
        class DDimI2,
        class DDimI3,
        ddc::BoundCond BcLower1,
        ddc::BoundCond BcUpper1,
        ddc::BoundCond BcLower2,
        ddc::BoundCond BcUpper2,
        ddc::BoundCond BcLower3,
        ddc::BoundCond BcUpper3,
        ddc::SplineSolver Solver>
template <class Layout, class BatchedInterpolationDDom>
void SplineBuilder3D<
        ExecSpace,
        MemorySpace,
        BSpline1,
        BSpline2,
        BSpline3,
        DDimI1,
        DDimI2,
        DDimI3,
        BcLower1,
        BcUpper1,
        BcLower2,
        BcUpper2,
        BcLower3,
        BcUpper3,
        Solver>::
operator()(
        ddc::ChunkSpan<
                double,
                batched_spline_domain_type<BatchedInterpolationDDom>,
                Layout,
                memory_space> spline,
        ddc::ChunkSpan<double const, BatchedInterpolationDDom, Layout, memory_space> vals,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type1<BatchedInterpolationDDom>,
                Layout,
                memory_space>> derivs_min1,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type1<BatchedInterpolationDDom>,
                Layout,
                memory_space>> derivs_max1,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type2<BatchedInterpolationDDom>,
                Layout,
                memory_space>> derivs_min2,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type2<BatchedInterpolationDDom>,
                Layout,
                memory_space>> derivs_max2,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type3<BatchedInterpolationDDom>,
                Layout,
                memory_space>> derivs_min3,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type3<BatchedInterpolationDDom>,
                Layout,
                memory_space>> derivs_max3,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type1_2<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_min1_min2,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type1_2<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_max1_min2,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type1_2<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_min1_max2,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type1_2<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_max1_max2,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type2_3<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_min2_min3,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type2_3<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_max2_min3,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type2_3<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_min2_max3,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type2_3<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_max2_max3,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type1_3<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_min1_min3,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type1_3<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_max1_min3,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type1_3<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_min1_max3,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type1_3<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_max1_max3,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_min1_min2_min3,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_max1_min2_min3,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_min1_max2_min3,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_max1_max2_min3,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_min1_min2_max3,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_max1_min2_max3,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_min1_max2_max3,
        std::optional<ddc::ChunkSpan<
                double const,
                batched_derivs_domain_type<BatchedInterpolationDDom>,
                Layout,
                memory_space>> mixed_derivs_max1_max2_max3) const
{
    auto const batched_interpolation_domain = vals.domain();
 
    assert(interpolation_domain() == interpolation_domain_type(batched_interpolation_domain));
    assert(batch_domain_type<BatchedInterpolationDDom>(batched_interpolation_domain)
           == batch_domain_type<BatchedInterpolationDDom>(spline.domain()));
 
    if (batch_domain(batched_interpolation_domain).empty()) {
        return;
    }
 
    // Build the derivatives along the second dimension
    auto const batched_interpolation_deriv_domain2
            = ddc::replace_dim_of<interpolation_discrete_dimension_type2, deriv_type2>(
                    batched_interpolation_domain,
                    ddc::DiscreteDomain<deriv_type2>(
                            ddc::DiscreteElement<deriv_type2>(BSpline2::degree() % 2),
                            ddc::DiscreteVector<deriv_type2>(bsplines_type2::degree() / 2)));
 
    ddc::Chunk spline_derivs_min2_alloc(
            m_label + " > spline_derivs_min2 (ddc::SplineBuilder3D::operator())",
            m_spline_builder1.batched_spline_domain(batched_interpolation_deriv_domain2),
            ddc::KokkosAllocator<double, MemorySpace>());
    auto spline_derivs_min2 = spline_derivs_min2_alloc.span_view();
    auto spline_derivs_min2_opt = std::optional(spline_derivs_min2.span_cview());
    if constexpr (BcLower2 == ddc::BoundCond::HERMITE) {
        m_spline_builder1(
                spline_derivs_min2,
                *derivs_min2,
                mixed_derivs_min1_min2,
                mixed_derivs_max1_min2);
    } else {
        spline_derivs_min2_opt = std::nullopt;
    }
 
    ddc::Chunk spline_derivs_max2_alloc(
            m_label + " > spline_derivs_max2 (ddc::SplineBuilder3D::operator())",
            m_spline_builder1.batched_spline_domain(batched_interpolation_deriv_domain2),
            ddc::KokkosAllocator<double, MemorySpace>());
    auto spline_derivs_max2 = spline_derivs_max2_alloc.span_view();
    auto spline_derivs_max2_opt = std::optional(spline_derivs_max2.span_cview());
    if constexpr (BcUpper2 == ddc::BoundCond::HERMITE) {
        m_spline_builder1(
                spline_derivs_max2,
                *derivs_max2,
                mixed_derivs_min1_max2,
                mixed_derivs_max1_max2);
    } else {
        spline_derivs_max2_opt = std::nullopt;
    }
 
    // Build the derivatives along the third dimension
    auto const batched_interpolation_deriv_domain3
            = ddc::replace_dim_of<interpolation_discrete_dimension_type3, deriv_type3>(
                    batched_interpolation_domain,
                    ddc::DiscreteDomain<deriv_type3>(
                            ddc::DiscreteElement<deriv_type3>(BSpline3::degree() % 2),
                            ddc::DiscreteVector<deriv_type3>(bsplines_type3::degree() / 2)));
 
    ddc::Chunk spline_derivs_min3_alloc(
            m_label + " > spline_derivs_min3 (ddc::SplineBuilder3D::operator())",
            m_spline_builder1.batched_spline_domain(batched_interpolation_deriv_domain3),
            ddc::KokkosAllocator<double, MemorySpace>());
    auto spline_derivs_min3 = spline_derivs_min3_alloc.span_view();
    auto spline_derivs_min3_opt = std::optional(spline_derivs_min3.span_cview());
    if constexpr (BcLower3 == ddc::BoundCond::HERMITE) {
        m_spline_builder1(
                spline_derivs_min3,
                *derivs_min3,
                mixed_derivs_min1_min3,
                mixed_derivs_max1_min3);
    } else {
        spline_derivs_min3_opt = std::nullopt;
    }
 
    ddc::Chunk spline_derivs_max3_alloc(
            m_label + " > spline_derivs_max3 (ddc::SplineBuilder3D::operator())",
            m_spline_builder1.batched_spline_domain(batched_interpolation_deriv_domain3),
            ddc::KokkosAllocator<double, MemorySpace>());
    auto spline_derivs_max3 = spline_derivs_max3_alloc.span_view();
    auto spline_derivs_max3_opt = std::optional(spline_derivs_max3.span_cview());
    if constexpr (BcUpper3 == ddc::BoundCond::HERMITE) {
        m_spline_builder1(
                spline_derivs_max3,
                *derivs_max3,
                mixed_derivs_min1_max3,
                mixed_derivs_max1_max3);
    } else {
        spline_derivs_max3_opt = std::nullopt;
    }
 
    // Build the cross derivatives along the second and third dimensions
    auto batched_interpolation_deriv_domain2_3
            = ddc::replace_dim_of<interpolation_discrete_dimension_type3, deriv_type3>(
                    batched_interpolation_deriv_domain2,
                    ddc::DiscreteDomain<deriv_type3>(
                            ddc::DiscreteElement<deriv_type3>(BSpline3::degree() % 2),
                            ddc::DiscreteVector<deriv_type3>(bsplines_type3::degree() / 2)));
 
    ddc::Chunk spline_derivs_min2_min3_alloc(
            m_label + " > spline_derivs_min2_min3 (ddc::SplineBuilder3D::operator())",
            m_spline_builder1.batched_spline_domain(batched_interpolation_deriv_domain2_3),
            ddc::KokkosAllocator<double, MemorySpace>());
    auto spline_derivs_min2_min3 = spline_derivs_min2_min3_alloc.span_view();
    auto spline_derivs_min2_min3_opt = std::optional(spline_derivs_min2_min3.span_cview());
    if constexpr (BcLower2 == ddc::BoundCond::HERMITE || BcLower3 == ddc::BoundCond::HERMITE) {
        m_spline_builder1(
                spline_derivs_min2_min3,
                *mixed_derivs_min2_min3,
                mixed_derivs_min1_min2_min3,
                mixed_derivs_max1_min2_min3);
    } else {
        spline_derivs_min2_min3_opt = std::nullopt;
    }
 
    ddc::Chunk spline_derivs_min2_max3_alloc(
            m_label + " > spline_derivs_min2_max3 (ddc::SplineBuilder3D::operator())",
            m_spline_builder1.batched_spline_domain(batched_interpolation_deriv_domain2_3),
            ddc::KokkosAllocator<double, MemorySpace>());
    auto spline_derivs_min2_max3 = spline_derivs_min2_max3_alloc.span_view();
    auto spline_derivs_min2_max3_opt = std::optional(spline_derivs_min2_max3.span_cview());
    if constexpr (BcLower2 == ddc::BoundCond::HERMITE || BcUpper3 == ddc::BoundCond::HERMITE) {
        m_spline_builder1(
                spline_derivs_min2_max3,
                *mixed_derivs_min2_max3,
                mixed_derivs_min1_min2_max3,
                mixed_derivs_max1_min2_max3);
    } else {
        spline_derivs_min2_max3_opt = std::nullopt;
    }
 
    ddc::Chunk spline_derivs_max2_min3_alloc(
            m_label + " > spline_derivs_max2_min3 (ddc::SplineBuilder3D::operator())",
            m_spline_builder1.batched_spline_domain(batched_interpolation_deriv_domain2_3),
            ddc::KokkosAllocator<double, MemorySpace>());
    auto spline_derivs_max2_min3 = spline_derivs_max2_min3_alloc.span_view();
    auto spline_derivs_max2_min3_opt = std::optional(spline_derivs_max2_min3.span_cview());
    if constexpr (BcUpper2 == ddc::BoundCond::HERMITE || BcLower3 == ddc::BoundCond::HERMITE) {
        m_spline_builder1(
                spline_derivs_max2_min3,
                *mixed_derivs_max2_min3,
                mixed_derivs_min1_max2_min3,
                mixed_derivs_max1_max2_min3);
    } else {
        spline_derivs_max2_min3_opt = std::nullopt;
    }
 
    ddc::Chunk spline_derivs_max2_max3_alloc(
            m_label + " > spline_derivs_max2_max3 (ddc::SplineBuilder3D::operator())",
            m_spline_builder1.batched_spline_domain(batched_interpolation_deriv_domain2_3),
            ddc::KokkosAllocator<double, MemorySpace>());
    auto spline_derivs_max2_max3 = spline_derivs_max2_max3_alloc.span_view();
    auto spline_derivs_max2_max3_opt = std::optional(spline_derivs_max2_max3.span_cview());
    if constexpr (BcUpper2 == ddc::BoundCond::HERMITE || BcUpper3 == ddc::BoundCond::HERMITE) {
        m_spline_builder1(
                spline_derivs_max2_max3,
                *mixed_derivs_max2_max3,
                mixed_derivs_min1_max2_max3,
                mixed_derivs_max1_max2_max3);
    } else {
        spline_derivs_max2_max3_opt = std::nullopt;
    }
 
    // Spline1-approximate vals (to spline1)
    ddc::Chunk spline1_alloc(
            m_label + " > spline1 (ddc::SplineBuilder3D::operator())",
            m_spline_builder1.batched_spline_domain(batched_interpolation_domain),
            ddc::KokkosAllocator<double, MemorySpace>());
    ddc::ChunkSpan const spline1 = spline1_alloc.span_view();
 
    m_spline_builder1(spline1, vals, derivs_min1, derivs_max1);
 
    m_spline_builder_2_3(
            spline,
            spline1.span_cview(),
            spline_derivs_min2_opt,
            spline_derivs_max2_opt,
            spline_derivs_min3_opt,
            spline_derivs_max3_opt,
            spline_derivs_min2_min3_opt,
            spline_derivs_max2_min3_opt,
            spline_derivs_min2_max3_opt,
            spline_derivs_max2_max3_opt);
}
 
} // namespace ddc