mindspore.dataset.Dataset.shuffle
=================================

.. 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/dataset_method/operation/mindspore.dataset.Dataset.shuffle.rst
    :alt: 查看源文件


.. py:method:: mindspore.dataset.Dataset.shuffle(buffer_size)

    通过创建 `buffer_size` 大小的缓存来混洗该数据集。

    1. 生成一个混洗缓冲区包含 `buffer_size` 条数据行。

    2. 从混洗缓冲区中随机选择一个数据行，传递给下一个操作。

    3. 从上一个操作获取下一个数据行（如果有的话），并将其放入混洗缓冲区中。

    4. 重复步骤2和3，直到混洗缓冲区中没有数据行为止。

    在第一个epoch中可以通过 `dataset.config.set_seed` 来设置随机种子。在随后的每个epoch，种子都会被设置成一个新产生的随机值。

    参数：
        - **buffer_size** (int) - 用于混洗的缓冲区大小（必须大于1）。将 `buffer_size` 设置为数据集大小将进行全局混洗。

    返回：
        Dataset，应用了上述操作的新数据集对象。

    异常：
        - **RuntimeError** - 混洗前存在通过 `dataset.sync_wait` 进行同步操作。