mindspore.Tensor.to_coo
=======================

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


.. py:method:: mindspore.Tensor.to_coo()

    将常规Tensor转为稀疏化的COOTensor。

    .. note::
        现在只支持二维Tensor。

    返回：
        返回一个二维的COOTensor，是原稠密Tensor的稀疏化表示。其中数据分别为：

        - **indices** (Tensor) - 二维整数张量，表示稀疏张量中 `values` 所处的位置索引。
        - **values** (Tensor) - 一维张量，用来给 `indices` 中的每个元素提供数值。
        - **shape** (tuple(int)) - 整数元组，用来指定稀疏矩阵的稠密形状。

    异常：
        - **ValueError** - Tensor的shape不是二维。