Entry point to compute central sums up to the 4th order with the provided mean values.
Description and Assumptions
The oneapi::mkl::stats::central_sum function is used to compute an array of central sums up to the 4th order (central sums for each dataset's dimension) with the provided mean values.
:ref:`onemkl_stats_central_sum_user_mean` supports the following precisions for data:
T float
double
Syntax
namespace oneapi::mkl::stats {
template<method Method = method::fast, typename Type, layout ObservationsLayout>
void central_sum(sycl::queue& queue,
sycl::buffer<Type, 1> mean,
const dataset<ObservationsLayout, sycl::buffer<Type, 1>>& data,
sycl::buffer<Type, 1> central_sum_2,
sycl::buffer<Type, 1> central_sum_3 = {0},
sycl::buffer<Type, 1> central_sum_4 = {0});
}
Template Parameters
- Method
Method which is used for estimate computation. The specific values are as follows:
oneapi::mkl::stats::method::fast
- Type
- Data precision.
- ObservationsLayout
- Data layout. The specific values are described in :ref:`onemkl_stats_dataset`.
Input Parameters
- queue
- The queue where the routine should be executed.
- mean
- sycl::buffer to the array of provided mean values.
- data
- Dataset which is used for computation.
Output Parameters
- central_sum_2
- sycl::buffer array of 2nd order central sum values.
- central_sum_3
- Optional parameter. sycl::buffer array of 3rd order central sum values.
- central_sum_4
- Optional parameter. sycl::buffer array of 4th order central sum values.
Throws
- oneapi::mkl::invalid_argument
- Exception is thrown when central_sum_2.get_count() == 0 & central_sum_3.get_count() == 0 & central_sum_4.get_count() == 0, or mean.get_count() == 0, or dataset object is invalid
Syntax
namespace oneapi::mkl::stats {
template<method Method = method::fast, typename Type, layout ObservationsLayout>
sycl::event central_sum(sycl::queue& queue,
Type* mean,
const dataset<ObservationsLayout, Type*>& data,
Type* central_sum_2,
Type* central_sum_3 = nullptr,
Type* central_sum_4 = nullptr,
const std::vector<sycl::event> &dependencies = {});
}
Template Parameters
- Method
Method which is used for estimate computation. The specific values are as follows:
oneapi::mkl::stats::method::fast
- Type
- Data precision.
- ObservationsLayout
- Data layout. The specific values are described in :ref:`onemkl_stats_dataset`.
Input Parameters
- queue
- The queue where the routine should be executed.
- mean
- Pointer to the array of provided mean values.
- data
- Dataset which is used for computation.
- dependencies
- Optional parameter. List of events to wait for before starting computation, if any.
Output Parameters
- central_sum_2
- Pointer to the array of the 2nd order central sum values.
- central_sum_3
- Optional parameter. Pointer to the array of the 3rd order central sum values.
- central_sum_4
- Optional parameter. Pointer to the array of the 2nd order central sum values.
Throws
- oneapi::mkl::invalid_argument
- Exception is thrown when central_sum_2 == nullptr & central_sum_3 == nullptr & central_sum_4 == nullptr, or mean == nullptr, or dataset object is invalid
Return Value
Output event to wait on to ensure computation is complete.
Parent topic: :ref:`onemkl_stats_routines`