mindspore.mint.bincount
=======================

.. image:: https://mindspore-website.obs.cn-north-4.myhuaweicloud.com/website-images/br_base/resource/_static/logo_source.svg
    :target: https://gitee.com/mindspore/mindspore/blob/br_base/docs/api/api_python/mint/mindspore.mint.func_bincount.rst
    :alt: 查看源文件


.. py:function:: mindspore.mint.bincount(input, weights=None, minlength=0)

    统计 `input` 中每个值的出现次数。

    如果不指定 `minlength` ，输出Tensor的长度为输入 `input` 中最大值加1。如果指定了 `minlength` ，则输出Tensor的长度为 `input` 中最大值加1和 `minlength` 之间的最大值。

    输出Tensor中每个值标记了该索引值在 `input` 中的出现次数。如果指定了 `weights` ，对输出的结果进行加权处理，即 :math:`out[n]+=weight[i]` 而不是 :math:`out[n]+=1`。

    .. warning::
        这是一个实验性API，后续可能修改或删除。

    参数：
        - **input** (Tensor) - 一维的Tensor。
        - **weights** (Tensor，可选) - 权重，与 input shape相同。默认值： ``None`` 。
        - **minlength** (int，可选) - 输出Tensor的最小长度，应为非负数。默认值： ``0`` 。

    返回：
        Tensor，如果输入为非空，输出shape为 :math:`(max(max(input)+1, minlength), )`，否则shape为 :math:`(0, )`。

    异常：
        - **TypeError** - 如果 `input` 或 `weights` 不是Tensor。
        - **ValueError** - 如果 `input` 中存在负数。
        - **ValueError** - 如果 `input` 不是一维的，或者 `input` 和 `weights` 不具有相同的shape。