.. _oneapi-mkl-rng-niederreiter:

oneapi::mkl::rng::niederreiter
==============================

.. contents::
    :local:
    :depth: 1

Description
***********

Niederreiter quasi-random number generator :ref:`[Bratley92] <bibliography>`, which works in arbitrary dimension.


API
***


Syntax
------

.. code-block:: cpp

   class niederreiter {
   public:
       static constexpr std::uint32_t default_dimensions_number = 1;
       niederreiter(sycl::queue queue, std::uint32_t dimensions = default_dimensions_number);
       niederreiter(sycl::queue queue, std::vector<std::uint32_t>& irred_polynomials);
       niederreiter(const niederreiter& other);
       niederreiter(niederreiter&& other);
       niederreiter& operator=(const niederreiter& other);
       niederreiter& operator=(niederreiter&& other);
       ~niederreiter();
   };


Devices supported: Host and CPU.


Include Files
-------------
- ``oneapi/mkl/rng.hpp``


Input Parameters
----------------

.. list-table::
   :header-rows: 1

   * - Name
     - Type
     - Description
   * - queue
     - ``sycl::queue``
     - Valid ``sycl::queue``, calls of ``oneapi::mkl::rng::generate()`` routine submit kernels in this queue.
   * - dimensions
     - ``std::uint32_t``
     - Number of dimensions.
   * - irred_polynomials
     - ``std::vector<std::uint32_t>``
     - User-defined direction numbers.


See :ref:`VS Notes <bibliography>` for the detailed descriptions.