:mod:`mkl_random`: random numbers fast
======================================

:mod:`mkl_random` is Python package exposing :ref:`pseudo-random <pseudorandom_vs_truerandom>` and 
:ref:`non-deterministic <pseudorandom_vs_truerandom>` 
random  number generators and sampling from continuous and discrete distribution available in 
Intel(R) oneAPI Math Kernel Library 
(`oneMKL <https://www.intel.com/content/www/us/en/developer/tools/oneapi/onemkl.html>`_).

.. grid:: 2
    :gutter: 3

    .. grid-item-card:: Beginner Guides

        New to :mod:`mkl_random`? Check out the Tutorials.
        They are a hands-on introduction for beginners.

        +++

        .. button-ref:: tutorials
            :expand:
            :color: secondary
            :click-parent:

            To the beginner guides

    .. grid-item-card:: User Guides

        The user guides are recipes for key tasks and common problems.

        +++

        .. button-ref:: how_to
            :expand:
            :color: secondary
            :click-parent:

            To the user guides

    .. grid-item-card:: Reference Guide

        The reference guide contains a detailed description of class :class:`mkl_random.RandomState` and its methods.

        +++

        .. button-ref:: reference/index
            :expand:
            :color: secondary
            :click-parent:

            To the reference guide

    .. grid-item-card:: Contributor Guides

        Want to add to the codebase?
        The contributing guidelines will guide you through the
        process of improving :mod:`mkl_random`.

        +++

        .. button-ref:: maintenance/index
            :expand:
            :color: secondary
            :click-parent:

            To the contributor guides


.. toctree::
    :hidden:

    tutorials
    how_to
    reference/index
    maintenance/index