RandomNormal
=================

生成服从指定均值和标准差的正态分布随机数序列。

.. math::

    output_i \sim \mathcal{N}(\text{mean}, \text{scale}^2)

输入：
    - **length** - 输出数据长度。  
    - **mean** - 正态分布的均值。  
    - **scale** - 正态分布的标准差。  
    - **seed** - 随机数种子，用于控制生成序列的随机性。  
    - **core_mask(int, 可选)** - 核掩码（仅适用于共享存储版本）。

输出：
    - **output** - 生成的随机数结果地址。  

支持平台：  
    ``FT78NE``  
    ``MT7004``  

.. note::
    - FT78NE 支持 fp32  
    - MT7004 支持 fp32, fp16  
    - 输出服从 :math:`\mathcal{N}(\text{mean}, \text{scale}^2)` 分布。  
    - 相同的随机种子会生成确定性一致的输出序列。  


**共享存储版本:**

.. c:function:: void fp_random_normal_s(float* output, int length, float mean, float scale, unsigned int seed, int core_mask)
.. c:function:: void hp_random_normal_s(half* output, int length, float mean, float scale, unsigned int seed, int core_mask)

    **C 调用示例：**

    .. code-block:: c
        :linenos:
        :emphasize-lines: 11

        // FT78NE 示例
        #include <stdio.h>

        int main(int argc, char* argv[]) {
            float *output = (float *)0xA0000000;   // output 在 DDR 空间
            int length = 1024;
            float mean = 0.0f;
            float scale = 1.0f;
            unsigned int seed = 1234;
            int core_mask = 0xff;
            fp_random_normal_s(output, length, mean, scale, seed, core_mask);
            return 0;
        }


**私有存储版本:**

.. c:function:: void fp_random_normal_p(float* output, int length, float mean, float scale, unsigned int seed)
.. c:function:: void hp_random_normal_p(half* output, int length, float mean, float scale, unsigned int seed)

    **C 调用示例：**

    .. code-block:: c
        :linenos:
        :emphasize-lines: 10

        // MT7004 示例
        #include <stdio.h>

        int main(int argc, char* argv[]) {
            float *output = (float *)0x10010000;  
            int length = 1024;
            float mean = 0.0f;
            float scale = 1.0f;
            unsigned int seed = 1234;
            fp_random_normal_p(output, length, mean, scale, seed);
            return 0;
        }
