engine_descriptor

oneMKL - Data Parallel C++ Developer Reference

Download PDF

ID 772045

Date 11/07/2023

Version

Public

A newer version of this document is available. Customers should click here to go to the newest version.

Visible to Intel only — GUID: GUID-C1B78991-8440-44A4-BF68-6DE073D69E05

View Details

engine_descriptor

Host side helper to provide an abstraction over sycl::buffer to initialize and store engines’ states between SYCL kernels.

Description
API

Description

engine_descriptor provides an abstraction over sycl::buffer to initialize and store engines’ states between SYCL kernels.

NOTE:

The constructor of the engine descriptor submits a parallel_for task to a given queue to initialize engines’ states: Each engine is initialized as Engine {seed, id * offset} for scalar offset case, where id is a value from 0 to range.size().

API

Syntax

namespace oneapi::mkl::rng::device {
  template<Engine>
  class engine_descriptor {
  public:
    engine_descriptor(sycl::queue& queue, sycl::range<1> range, std::uint64_t seed, std::uint64_t offset);
    template<typename InitEngineFunc>
    engine_descriptor(sycl::queue& queue, sycl::range<1> range, InitEngineFunc func);
    engine_accessor<Engine> get_access(sycl::handler& cgh);
  };
}

Include Files

oneapi/mkl/rng/device.hpp

Template Parameters

Type	Description
`Engine`	Specify an engine which state is hold by engine descriptor.

Constructors Input Parameters

Name	Type	Description
queue	`sycl::queue&`	`sycl::queue` object. Task is submitted to this queue to inlize engines’ states directly on the device which is associated wiueue.
range	`sycl::range<1>`	Describes number of engines which are hold by this en_descriptor object.
seed	`std::uint64_tstd::initializer_list<std::uint64_t>`	Initial conditions of the engine state.
offset	`std::uint64_tstd::initializer_list<std::uint64_t>`	Number of skipped elements, for `initializer_list` offset is calculated as `num_to_skip` [0]+ `num_to_skip` [1]2⁶⁴ + `num_to_skip` [2] 2¹²⁸ + … + `num_to_skip` [`n`-1]2⁶⁴ (`n`-1).
func	InitEngineFunc	Functor which would be used to initialize engines. This functor should take `sycl::item<1>` as an argument and return object of type `Engine`.

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

oneMKL - Data Parallel C++ Developer Reference

engine_descriptor

Description

API