21.02
|
OpenCL kernel to reshape the RHS matrix when performing the matrix multiplication In particular, this kernel splits the input matrix in blocks of size K0xN0 and stores each one in the output matrix unrolling the values. More...
#include <CLGEMMReshapeRHSMatrixKernel.h>
Public Member Functions | |
CLGEMMReshapeRHSMatrixKernel () | |
Default constructor. More... | |
CLGEMMReshapeRHSMatrixKernel (const CLGEMMReshapeRHSMatrixKernel &)=delete | |
Prevent instances of this class from being copied (As this class contains pointers) More... | |
CLGEMMReshapeRHSMatrixKernel & | operator= (const CLGEMMReshapeRHSMatrixKernel &)=delete |
Prevent instances of this class from being copied (As this class contains pointers) More... | |
CLGEMMReshapeRHSMatrixKernel (CLGEMMReshapeRHSMatrixKernel &&)=default | |
Allow instances of this class to be moved. More... | |
CLGEMMReshapeRHSMatrixKernel & | operator= (CLGEMMReshapeRHSMatrixKernel &&)=default |
Allow instances of this class to be moved. More... | |
~CLGEMMReshapeRHSMatrixKernel ()=default | |
Default destructor. More... | |
void | configure (const ICLTensor *input, ICLTensor *output, const GEMMRHSMatrixInfo &rhs_info) |
Initialise the kernel's input and output. More... | |
void | configure (const CLCompileContext &compile_context, const ICLTensor *input, ICLTensor *output, const GEMMRHSMatrixInfo &rhs_info) |
Initialise the kernel's input and output. More... | |
void | run (const Window &window, cl::CommandQueue &queue) override |
Enqueue the OpenCL kernel to process the given window on the passed OpenCL command queue. More... | |
Public Member Functions inherited from ICLKernel | |
ICLKernel () | |
Constructor. More... | |
cl::Kernel & | kernel () |
Returns a reference to the OpenCL kernel of this object. More... | |
template<typename T > | |
void | add_1D_array_argument (unsigned int &idx, const ICLArray< T > *array, const Strides &strides, unsigned int num_dimensions, const Window &window) |
Add the passed 1D array's parameters to the object's kernel's arguments starting from the index idx. More... | |
void | add_1D_tensor_argument (unsigned int &idx, const ICLTensor *tensor, const Window &window) |
Add the passed 1D tensor's parameters to the object's kernel's arguments starting from the index idx. More... | |
void | add_1D_tensor_argument_if (bool cond, unsigned int &idx, const ICLTensor *tensor, const Window &window) |
Add the passed 1D tensor's parameters to the object's kernel's arguments starting from the index idx if the condition is true. More... | |
void | add_2D_tensor_argument (unsigned int &idx, const ICLTensor *tensor, const Window &window) |
Add the passed 2D tensor's parameters to the object's kernel's arguments starting from the index idx. More... | |
void | add_2D_tensor_argument_if (bool cond, unsigned int &idx, const ICLTensor *tensor, const Window &window) |
Add the passed 2D tensor's parameters to the object's kernel's arguments starting from the index idx if the condition is true. More... | |
void | add_3D_tensor_argument (unsigned int &idx, const ICLTensor *tensor, const Window &window) |
Add the passed 3D tensor's parameters to the object's kernel's arguments starting from the index idx. More... | |
void | add_4D_tensor_argument (unsigned int &idx, const ICLTensor *tensor, const Window &window) |
Add the passed 4D tensor's parameters to the object's kernel's arguments starting from the index idx. More... | |
virtual void | run_op (ITensorPack &tensors, const Window &window, cl::CommandQueue &queue) |
Enqueue the OpenCL kernel to process the given window on the passed OpenCL command queue. More... | |
template<typename T > | |
void | add_argument (unsigned int &idx, T value) |
Add the passed parameters to the object's kernel's arguments starting from the index idx. More... | |
void | set_lws_hint (const cl::NDRange &lws_hint) |
Set the Local-Workgroup-Size hint. More... | |
cl::NDRange | lws_hint () const |
Return the Local-Workgroup-Size hint. More... | |
void | set_wbsm_hint (const cl_int &wbsm_hint) |
Set the workgroup batch size modifier hint. More... | |
cl_int | wbsm_hint () const |
Return the workgroup batch size modifier hint. More... | |
const std::string & | config_id () const |
Get the configuration ID. More... | |
void | set_target (GPUTarget target) |
Set the targeted GPU architecture. More... | |
void | set_target (cl::Device &device) |
Set the targeted GPU architecture according to the CL device. More... | |
GPUTarget | get_target () const |
Get the targeted GPU architecture. More... | |
size_t | get_max_workgroup_size () |
Get the maximum workgroup size for the device the CLKernelLibrary uses. More... | |
template<unsigned int dimension_size> | |
void | add_tensor_argument (unsigned &idx, const ICLTensor *tensor, const Window &window) |
template<typename T , unsigned int dimension_size> | |
void | add_array_argument (unsigned &idx, const ICLArray< T > *array, const Strides &strides, unsigned int num_dimensions, const Window &window) |
Add the passed array's parameters to the object's kernel's arguments starting from the index idx. More... | |
Public Member Functions inherited from IKernel | |
IKernel () | |
Constructor. More... | |
virtual | ~IKernel ()=default |
Destructor. More... | |
virtual bool | is_parallelisable () const |
Indicates whether or not the kernel is parallelisable. More... | |
virtual BorderSize | border_size () const |
The size of the border for that kernel. More... | |
const Window & | window () const |
The maximum window the kernel can be executed on. More... | |
Static Public Member Functions | |
static Status | validate (const ITensorInfo *input, const ITensorInfo *output, const GEMMRHSMatrixInfo &rhs_info) |
Static function to check if given info will lead to a valid configuration of CLGEMMReshapeRHSMatrixKernel. More... | |
Static Public Member Functions inherited from ICLKernel | |
static constexpr unsigned int | num_arguments_per_1D_array () |
Returns the number of arguments enqueued per 1D array object. More... | |
static constexpr unsigned int | num_arguments_per_1D_tensor () |
Returns the number of arguments enqueued per 1D tensor object. More... | |
static constexpr unsigned int | num_arguments_per_2D_tensor () |
Returns the number of arguments enqueued per 2D tensor object. More... | |
static constexpr unsigned int | num_arguments_per_3D_tensor () |
Returns the number of arguments enqueued per 3D tensor object. More... | |
static constexpr unsigned int | num_arguments_per_4D_tensor () |
Returns the number of arguments enqueued per 4D tensor object. More... | |
static cl::NDRange | gws_from_window (const Window &window) |
Get the global work size given an execution window. More... | |
OpenCL kernel to reshape the RHS matrix when performing the matrix multiplication In particular, this kernel splits the input matrix in blocks of size K0xN0 and stores each one in the output matrix unrolling the values.
Definition at line 36 of file CLGEMMReshapeRHSMatrixKernel.h.
Default constructor.
Definition at line 109 of file CLGEMMReshapeRHSMatrixKernel.cpp.
|
delete |
Prevent instances of this class from being copied (As this class contains pointers)
|
default |
Allow instances of this class to be moved.
|
default |
Default destructor.
void configure | ( | const ICLTensor * | input, |
ICLTensor * | output, | ||
const GEMMRHSMatrixInfo & | rhs_info | ||
) |
Initialise the kernel's input and output.
[in] | input | Input tensor. Data types supported: All |
[out] | output | Output tensor. Data type supported: same as input |
[in] | rhs_info | RHS matrix information to be used for reshaping. This object contains all the necessary information to reshape the input tensor. Only the following values are supported: rhs_info.n0: 2,3,4,8,16 (only 4, 8 and 16 if rhs_info.export_to_cl_image == true) rhs_info.k0: 1,2,3,4,8,16 (k0 = 1 only if rhs_info.transpose = false), (only 4, 8 and 16 if rhs_info.export_to_cl_image == true) rhs_info.h0: greater than 0 rhs_info.transpose: true, false rhs_info.interleave: true, false |
Definition at line 114 of file CLGEMMReshapeRHSMatrixKernel.cpp.
References CLKernelLibrary::get().
Referenced by arm_compute::test::validation::DATA_TEST_CASE().
void configure | ( | const CLCompileContext & | compile_context, |
const ICLTensor * | input, | ||
ICLTensor * | output, | ||
const GEMMRHSMatrixInfo & | rhs_info | ||
) |
Initialise the kernel's input and output.
[in] | compile_context | The compile context to be used. |
[in] | input | Input tensor. Data types supported: All |
[out] | output | Output tensor. Data type supported: same as input |
[in] | rhs_info | RHS matrix information to be used for reshaping. This object contains all the necessary information to reshape the input tensor. Only the following values are supported: rhs_info.n0: 2,3,4,8,16 (only 4, 8 and 16 if rhs_info.export_to_cl_image == true) rhs_info.k0: 1,2,3,4,8,16 (k0 = 1 only if rhs_info.transpose = false), (only 4, 8 and 16 if rhs_info.export_to_cl_image == true) rhs_info.h0: greater than 0 rhs_info.transpose: true, false rhs_info.interleave: true, false |
Definition at line 119 of file CLGEMMReshapeRHSMatrixKernel.cpp.
References CLBuildOptions::add_option(), CLBuildOptions::add_option_if(), ARM_COMPUTE_ERROR_ON_NULLPTR, ARM_COMPUTE_ERROR_THROW_ON, arm_compute::create_kernel(), ITensorInfo::dimension(), ITensorInfo::element_size(), arm_compute::get_cl_unsigned_type_from_element_size(), GEMMRHSMatrixInfo::h0, ITensor::info(), arm_compute::test::validation::input, GEMMRHSMatrixInfo::interleave, GEMMRHSMatrixInfo::k0, kernel_name, GEMMRHSMatrixInfo::n0, CLBuildOptions::options(), arm_compute::support::cpp11::to_string(), GEMMRHSMatrixInfo::transpose, and arm_compute::validate_arguments().
|
delete |
Prevent instances of this class from being copied (As this class contains pointers)
|
default |
Allow instances of this class to be moved.
|
overridevirtual |
Enqueue the OpenCL kernel to process the given window on the passed OpenCL command queue.
[in] | window | Region on which to execute the kernel. (Must be a valid region of the window returned by window()). |
[in,out] | queue | Command queue on which to enqueue the kernel. |
Reimplemented from ICLKernel.
Definition at line 159 of file CLGEMMReshapeRHSMatrixKernel.cpp.
References ICLKernel::add_3D_tensor_argument(), ARM_COMPUTE_ERROR_ON_INVALID_SUBWINDOW, ARM_COMPUTE_ERROR_ON_UNCONFIGURED_KERNEL, arm_compute::enqueue(), Window::first_slice_window_3D(), ICLKernel::lws_hint(), arm_compute::test::validation::reference::slice(), Window::slide_window_slice_3D(), and IKernel::window().
|
static |
Static function to check if given info will lead to a valid configuration of CLGEMMReshapeRHSMatrixKernel.
[in] | input | Input tensor info. Data types supported: All |
[in] | output | Output tensor info which stores the interleaved matrix. Data type supported: same as input . |
[in] | rhs_info | RHS matrix information to be used for reshaping. This object contains all the necessary information to reshape the input tensor. Only the following values are supported: rhs_info.n0: 2,3,4,8,16 (only 4, 8 and 16 if rhs_info.export_to_cl_image == true) rhs_info.k0: 1,2,3,4,8,16 (k0 = 1 only if rhs_info.transpose = false),(only 4, 8 and 16 if rhs_info.export_to_cl_image == true) rhs_info.h0: greater than 0 rhs_info.transpose: true, false rhs_info.interleave: true, false |
Definition at line 151 of file CLGEMMReshapeRHSMatrixKernel.cpp.
References ARM_COMPUTE_RETURN_ON_ERROR, ICloneable< T >::clone(), and arm_compute::validate_arguments().
Referenced by CLGEMMReshapeRHSMatrixKernelManaged::configure(), arm_compute::test::validation::DATA_TEST_CASE(), and CLGEMMLowpMatrixMultiplyCore::validate().