Cos
=================



对输入数组逐元素计算余弦值（cosine）。

.. math::

    dst_i = \cos(src_i)

其中输入角度以弧度（radian）为单位。

输入：
    - **src_data** - 输入数据地址。
    - **length** - 计算长度。
    - **core_mask** - 核掩码（仅适用于共享存储版本）。

输出：
    - **dst_data** - 计算结果地址。

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

.. note::
    - FT78NE 支持 fp, dp, int8, int16, int32 类型
    - MT7004 支持 hp, fp, int16, int32 类型
    - 当输入类型为 int8 / int16 / int32 时，输出类型统一为 fp（float）
    - 输入数值将被解释为弧度值

**共享存储版本:**

.. c:function:: void i8_cos_s(int8_t* src_data, float* dst_data, int length, int core_mask)
.. c:function:: void i16_cos_s(int16_t* src_data, float* dst_data, int length, int core_mask)
.. c:function:: void i32_cos_s(int* src_data, float* dst_data, int length, int core_mask)
.. c:function:: void hp_cos_s(half* src_data, half* dst_data, int length, int core_mask)
.. c:function:: void fp_cos_s(float* src_data, float* dst_data, int length, int core_mask)
.. c:function:: void dp_cos_s(double* src_data, double* dst_data, int length, int core_mask)

**C调用示例：**

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

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

    int main(int argc, char* argv[]) {
        float *input0 = (float *)0xA0000000;   // input在DDR空间
        float *output = (float *)0xC0000000;
        int length = 1024;
        int core_mask = 0xff;

        fp_cos_s(input0, output, length, core_mask);
        return 0;
    }


**私有存储版本:**

.. c:function:: void i8_cos_p(int8_t* src_data, float* dst_data, int length)
.. c:function:: void i16_cos_p(int16_t* src_data, float* dst_data, int length)
.. c:function:: void i32_cos_p(int* src_data, float* dst_data, int length)
.. c:function:: void hp_cos_p(half* src_data, half* dst_data, int length)
.. c:function:: void fp_cos_p(float* src_data, float* dst_data, int length)
.. c:function:: void dp_cos_p(double* src_data, double* dst_data, int length)

**C调用示例：**

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

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

    int main(int argc, char* argv[]) {
        float *input0 = (float *)0x10810000;   // input在L2空间
        float *output = (float *)0x10820000;
        int length = 1024;

        fp_cos_p(input0, output, length);
        return 0;
    }
