mindspore.dataset.vision.CutOut
============================================

.. 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/dataset_vision/mindspore.dataset.vision.CutOut.rst
    :alt: 查看源文件


.. py:class:: mindspore.dataset.vision.CutOut(length, num_patches=1, is_hwc=True)

    从输入图像数组中随机裁剪出给定数量的正方形区域。

    参数：
        - **length** (int) - 每个正方形区域的边长，必须大于 0。
        - **num_patches** (int, 可选) - 要从图像中切出的正方形区域数，必须大于0。默认值： ``1`` 。
        - **is_hwc** (bool, 可选) - 表示输入图像是否为HWC格式， ``True`` 为HWC格式， ``False`` 为CHW格式。默认值： ``True`` 。

    异常：
        - **TypeError** - 如果 `length` 不是int类型。
        - **TypeError** - 如果 `num_patches` 不是int类型。
        - **TypeError** - 如果 `is_hwc` 不是bool类型。
        - **ValueError** - 如果 `length` 小于或等于 0。
        - **ValueError** - 如果 `num_patches` 小于或等于 0。
        - **RuntimeError** - 如果输入图像的shape不是 <H, W, C>。

    教程样例：
        - `视觉变换样例库
          <https://www.mindspore.cn/docs/zh-CN/master/api_python/samples/dataset/vision_gallery.html>`_