bmcv_calc_hist
==================

直方图
_______

**处理器型号支持：**

该接口支持BM1684/BM1684X。


**接口形式：**

    .. code-block:: c

        bm_status_t bmcv_calc_hist(
                bm_handle_t handle,
                bm_device_mem_t input,
                bm_device_mem_t output,
                int C,
                int H,
                int W,
                const int *channels,
                int dims,
                const int *histSizes,
                const float *ranges,
                int inputDtype);


**参数说明：**

* bm_handle_t handle

  输入参数。 bm_handle 句柄。

* bm_device_mem_t input

  输入参数。该device memory空间存储了输入数据，类型可以是float32或者uint8，由参数inputDtype决定。其大小为C*H*W*sizeof(Dtype)。

* bm_device_mem_t output

  输出参数。该device memory空间存储了输出结果，类型为float，其大小为histSizes[0]\*histSizes[1]\*……\*histSizes[n]\*sizeof(float)。

* int C

  输入参数。输入数据的通道数量。

* int H

  输入参数。输入数据每个通道的高度。

* int W

  输入参数。输入数据每个通道的宽度。

* const int \*channels

  输入参数。需要计算直方图的channel列表，其长度为dims，每个元素的值必须小于C。

* int dims

  输入参数。输出的直方图维度，要求不大于3。

* const int \*histSizes

  输入参数。对应每个channel统计直方图的份数，其长度为dims。

* const float \*ranges

  输入参数。每个通道参与统计的范围，其长度为2*dims。

* int inputDtype

  输入参数。输入数据的类型：0表示float，1表示uint8。


**返回值说明：**

* BM_SUCCESS: 成功

* 其他:失败


**代码示例：**

    .. code-block:: c

        int H = 1024;
        int W = 1024;
        int C = 3;
        int dim = 3;
        int channels[3] = {0, 1, 2};
        int histSizes[] = {15000, 32, 32};
        float ranges[] = {0, 1000000, 0, 256, 0, 256};
        int totalHists = 1;
        for (int i = 0; i < dim; ++i)
            totalHists *= histSizes[i];
        bm_handle_t handle = nullptr;
        bm_status_t ret = bm_dev_request(&handle, 0);
        float *inputHost = new float[C * H * W];
        float *outputHost = new float[totalHists];
        for (int i = 0; i < C; ++i)
            for (int j = 0; j < H * W; ++j)
                inputHost[i * H * W + j] = static_cast<float>(rand() % 1000000);
        if (ret != BM_SUCCESS) {
            printf("bm_dev_request failed. ret = %d\n", ret);
            exit(-1);
        }
        bm_device_mem_t input, output;
        ret = bm_malloc_device_byte(handle, &input, C * H * W * 4);
        if (ret != BM_SUCCESS) {
            printf("bm_malloc_device_byte failed. ret = %d\n", ret);
            exit(-1);
        }
        ret = bm_memcpy_s2d(handle, input, inputHost);
        if (ret != BM_SUCCESS) {
            printf("bm_memcpy_s2d failed. ret = %d\n", ret);
            exit(-1);
        }
        ret = bm_malloc_device_byte(handle, &output, totalHists * 4);
        if (ret != BM_SUCCESS) {
            printf("bm_malloc_device_byte failed. ret = %d\n", ret);
            exit(-1);
        }
        ret = bmcv_calc_hist(handle,
                             input,
                             output,
                             C,
                             H,
                             W,
                             channels,
                             dim,
                             histSizes,
                             ranges,
                             0);
        if (ret != BM_SUCCESS) {
            printf("bmcv_calc_hist failed. ret = %d\n", ret);
            exit(-1);
        }
        ret = bm_memcpy_d2s(handle, outputHost, output);
        if (ret != BM_SUCCESS) {
            printf("bm_memcpy_d2s failed. ret = %d\n", ret);
            exit(-1);
        }
        bm_free_device(handle, input);
        bm_free_device(handle, output);
        bm_dev_free(handle);
        delete [] inputHost;
        delete [] outputHost;


带权重的直方图
_______________

**处理器型号支持：**

该接口支持BM1684/BM1684X。


**接口形式：**

    .. code-block:: c

        bm_status_t bmcv_calc_hist_with_weight(
                bm_handle_t handle,
                bm_device_mem_t input,
                bm_device_mem_t output,
                const float *weight,
                int C,
                int H,
                int W,
                const int *channels,
                int dims,
                const int *histSizes,
                const float *ranges,
                int inputDtype);


**参数说明：**

* bm_handle_t handle

  输入参数。 bm_handle 句柄。

* bm_device_mem_t input

  输入参数。该device memory空间存储了输入数据，其大小为C*H*W*sizeof(Dtype)。

* bm_device_mem_t output

  输出参数。该device memory空间存储了输出结果，类型为float，其大小为histSizes[0]\*histSizes[1]\*……\*histSizes[n]\*sizeof(float)。

* const float \*weight

  输入参数。channel内部每个元素在统计直方图时的权重，其大小为H*W*sizeof(float)，如果所有值全为1则与普通直方图功能相同。

* int C

  输入参数。输入数据的通道数量。

* int H

 输入参数。输入数据每个通道的高度。

* int W

  输入参数。输入数据每个通道的宽度。

* const int \*channels

  输入参数。需要计算直方图的channel列表，其长度为dims，每个元素的值必须小于C。

* int dims

  输入参数。输出的直方图维度，要求不大于3。

* const int \*histSizes

  输入参数。对应每个channel统计直方图的份数，其长度为dims。

* const float \*ranges

  输入参数。每个通道参与统计的范围，其长度为2*dims。

* int inputDtype

  输入参数。输入数据的类型：0表示float，1表示uint8。


**返回值说明：**

* BM_SUCCESS: 成功

* 其他:失败