Method: BOAST::CKernel#run

Defined in:
lib/BOAST/Runtime/CKernel.rb

#run(*args, options = {}) ⇒ Hash

Runs the computing kernel using the given arguments.

Parameters:

  • args

    the arguments corresponding to the list of parameters of the #procedure attribute

  • options (Hash) (defaults to: {})

    contains runtime options.

Options Hash (options):

  • :global_work_size (Array)

    only considered for CUDA and OpenCL kernels. See corresponding OpenCL documentation

  • :local_work_size (Array)

    only considered for CUDA and OpenCL kernels. See corresponding OpenCL documentation

  • :block_number (Array)

    only considered for CUDA and OpenCL kernels. See corresponding CUDA documentation

  • :block_size (Array)

    only considered for CUDA and OpenCL kernels. See corresponding CUDA documentation

  • :PAPI (Array)

    list of PAPI counters to monitor. ( ex: [‘PAPI_L1_DCM’, ‘PAPI_L2_DCM’], see PAPI documentation.

Returns:

  • (Hash)

    contains at least the :duration entry which is the runtime of the kernel in seconds. If the kernel is a function then the :return field will contain the returned value. For :inout or :out scalars the :reference_return field will be a Hash with each parameter name associated to the corresponding value. If :PAPI options was given will contain a :PAPI entry with the corresponding counters value.



# File 'lib/BOAST/Runtime/CKernel.rb', line 133