oneapi::mkl::rng::device::engine

Intel® oneAPI Math Kernel Library (oneMKL) - Data Parallel C++ Developer Reference

Download PDF

ID 772045

Date 12/16/2022

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-580B18AE-6681-4C1D-A37A-3A2FA10A3DF4

View Details

oneapi::mkl::rng::device::engine_descriptor

Host side helper to provide an abstraction over sycl::buffer to initialize and store engines’ states between DPC++ 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

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

Intel® oneAPI Math Kernel Library (oneMKL) - Data Parallel C++ Developer Reference

oneapi::mkl::rng::device::engine_descriptor

Description

API