mindspore 2.0.0a0__cp37-cp37m-win_amd64.whl → 2.0.0rc1__cp37-cp37m-win_amd64.whl

mindspore/context.py

@@ -1,4 +1,4 @@
- # Copyright 2020-2022 Huawei Technologies Co., Ltd
+# Copyright 2020-2022 Huawei Technologies Co., Ltd
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -27,15 +27,17 @@ from types import FunctionType
 
 from mindspore import log as logger
 from mindspore._c_expression import MSContext, ms_ctx_param
-from mindspore._checkparam import args_type_check, Validator, args_unreset_check
+from mindspore import _checkparam as Validator
+from mindspore._checkparam import args_type_check
 from mindspore.parallel._auto_parallel_context import _set_auto_parallel_context, _get_auto_parallel_context, \
     _reset_auto_parallel_context
 from mindspore.parallel._ps_context import _set_ps_context, _get_ps_context, _reset_ps_context, \
     _need_reset_device_target_for_ps
+from mindspore.parallel._offload_context import _set_offload_context, _get_offload_context
 
 __all__ = ['GRAPH_MODE', 'PYNATIVE_MODE', 'set_context', 'get_context', 'set_auto_parallel_context',
            'get_auto_parallel_context', 'reset_auto_parallel_context', 'ParallelMode', 'set_ps_context',
-           'get_ps_context', 'reset_ps_context']
+           'get_ps_context', 'reset_ps_context', 'set_offload_context', 'get_offload_context']
 
 GRAPH_MODE = 0
 PYNATIVE_MODE = 1
@@ -231,6 +233,51 @@ class _Context:
         else:
             self.set_param(ms_ctx_param.memory_offload, False)
 
+    def set_deterministic(self, deterministic):
+        """
+        Enable model run in deterministic, and support the values "ON" and "OFF".
+
+        Args:
+            deterministic (str): "ON", "OFF"
+        """
+        deterministic_options = ["ON", "OFF"]
+        if deterministic not in deterministic_options:
+            raise ValueError(f"For 'context.set_context', the argument 'deterministic' must be one of "
+                             f"{deterministic_options}, but got {deterministic}.")
+        self.set_param(ms_ctx_param.deterministic, deterministic)
+
+    def set_ascend_config(self, ascend_config):
+        """
+        Enable ascend config.
+
+        Args:
+            ascend_config (dict): 'precision_mode'
+                - precision_mode (str): "force_fp16", "allow_fp32_to_fp16", "allow_mix_precision",
+                            "must_keep_origin_dtype", "force_fp32", "force_lowerprecision", "allow_fp32_to_bf16",
+                            "allow_fp32_to_lowprecision", "allow_mix_precision_fp16" and "allow_mix_precision_bf16".
+        """
+
+        ascend_cfgs = {'precision_mode': ["force_fp16", "allow_fp32_to_fp16", "allow_mix_precision",
+                                          "must_keep_origin_dtype", "force_fp32", "force_lowerprecision",
+                                          "allow_fp32_to_bf16", "allow_fp32_to_lowprecision",
+                                          "allow_mix_precision_fp16", "allow_mix_precision_bf16"],
+                       'jit_compile': [True, False]}
+        for ascend_key in ascend_config:
+            if ascend_key not in ascend_cfgs:
+                raise ValueError(f"For 'context.set_context', the key of argument 'ascend_config' must be one of "
+                                 f"{ascend_cfgs}, but got {ascend_key}.")
+            supported_modes = ascend_cfgs.get(ascend_key)
+            if ascend_config[ascend_key] not in supported_modes:
+                raise ValueError(f"For 'ascend_config', the value of argument {ascend_key} must be one of "
+                                 f"{supported_modes}, but got {ascend_config[ascend_key]}.")
+            if ascend_key == 'precision_mode':
+                self.set_param(ms_ctx_param.precision_mode, ascend_config[ascend_key])
+            if ascend_key == 'jit_compile':
+                if ascend_config[ascend_key] is True:
+                    self.set_param(ms_ctx_param.jit_compile, "1")
+                else:
+                    self.set_param(ms_ctx_param.jit_compile, "0")
+
     def set_backend_policy(self, policy):
         success = self._context_handle.set_backend_policy(policy)
         if not success:
@@ -368,8 +415,8 @@ class _Context:
                 json.load(f)
         except (TypeError, ValueError) as exo:
             raise ValueError(str(exo) + "\nFor 'context.set_context', open or load the 'env_config_path' file {} "
-                             "failed, please check whether 'env_config_path' is json file and correct, or may not "
-                             "have permission to read it.".format(env_config_path))
+                                        "failed, please check whether 'env_config_path' is json file and correct, "
+                                        "or may not have permission to read it.".format(env_config_path))
         self.set_param(ms_ctx_param.env_config_path, env_config_path)
 
     def set_runtime_num_threads(self, runtime_num_threads):
@@ -383,6 +430,7 @@ class _Context:
         if op_timeout < 0:
             raise ValueError("The num of op exe timeout must bigger than or equal to 0.")
         self.set_param(ms_ctx_param.op_timeout, op_timeout)
+
     def set_inter_op_parallel_num(self, inter_op_parallel_num):
         """Check and set inter_op_parallel_num."""
         if inter_op_parallel_num < 0:
@@ -406,7 +454,9 @@ class _Context:
         'runtime_num_threads': set_runtime_num_threads,
         'memory_optimize_level': set_memory_optimize_level,
         'op_timeout': set_op_timeout,
-        'memory_offload': set_memory_offload
+        'memory_offload': set_memory_offload,
+        'deterministic': set_deterministic,
+        'ascend_config': set_ascend_config
     }
 
     @property
@@ -447,7 +497,6 @@ class _Context:
         self._support_binary = support
 
 
-
 def _context():
     """
     Get the global _context, if context is not created, create a new one.
@@ -476,7 +525,7 @@ def _context():
                  auto_parallel_search_mode=str, search_mode=str, parameter_broadcast=bool, strategy_ckpt_load_file=str,
                  strategy_ckpt_save_file=str, full_batch=bool, enable_parallel_optimizer=bool, enable_alltoall=bool,
                  all_reduce_fusion_config=list, pipeline_stages=int, grad_accumulation_step=int,
-                 parallel_optimizer_config=dict, comm_fusion=dict)
+                 parallel_optimizer_config=dict, comm_fusion=dict, strategy_ckpt_config=dict)
 def set_auto_parallel_context(**kwargs):
     r"""
     Set auto parallel context, only data parallel supported on CPU.
@@ -504,6 +553,7 @@ def set_auto_parallel_context(**kwargs):
     enable_alltoall              grad_accumulation_step
                \                 auto_parallel_search_mode
                \                 comm_fusion
+               \                 strategy_ckpt_config
     ===========================  ===========================
 
     Args:
@@ -542,15 +592,18 @@ def set_auto_parallel_context(**kwargs):
                      data_parallel mode, all parameters are broadcast except for the parameter whose attribute
                      layerwise_parallel is True. Hybrid_parallel, semi_auto_parallel and auto_parallel mode, the
                      segmented parameters do not participate in broadcasting. Default: False.
-        strategy_ckpt_load_file (str): The path to load parallel strategy checkpoint. Default: ''
-        strategy_ckpt_save_file (str): The path to save parallel strategy checkpoint. Default: ''
+        strategy_ckpt_load_file (str): The path to load parallel strategy checkpoint. The parameter is not to be
+                       recommended currently, it is better using 'strategy_ckpt_config' to replace it. Default: ''
+        strategy_ckpt_save_file (str): The path to save parallel strategy checkpoint. The parameter is not to be
+                       recommended currently, it is better using 'strategy_ckpt_config' to replace it. Default: ''
         full_batch (bool): If you load whole batch datasets in auto_parallel mode, this parameter
                        should be set as True. Default: False. The interface is not to be recommended currently,
                        it is better using 'dataset_strategy' to replace it.
         dataset_strategy (Union[str, tuple]): Dataset sharding strategy. Default: "data_parallel".
                        dataset_strategy="data_parallel" is equal to full_batch=False, dataset_strategy="full_batch" is
-                       equal to full_batch=True. For dataset load into net by model parallel strategy likes
-                       ds_stra ((1, 8), (1, 8)), it requires using set_auto_parallel_context(dataset_strategy=ds_stra).
+                       equal to full_batch=True. For execution mode is 'GRAPH_MODE' and dataset load into net by model
+                       parallel strategy likes ds_stra ((1, 8), (1, 8)), it requires using
+                       set_auto_parallel_context(dataset_strategy=ds_stra).
         enable_parallel_optimizer (bool): This is a developing feature, which shards the weight update computation for
                        data parallel training in the benefit of time and memory saving. Currently, auto and semi auto
                        parallel mode support all optimizers in both Ascend and GPU. Data parallel mode only supports
@@ -591,6 +644,9 @@ def set_auto_parallel_context(**kwargs):
                         communication fusion config has two keys: "mode" and "config".
                         It supports following communication fusion types and configurations:
 
+                        - openstate: Whether turn on the communication fusion or not. If `openstate` is `True`, turn on
+                          the communication fusion, otherwise, turn off the communication fusion. Default: `True`.
+
                         - allreduce: If communication fusion type is `allreduce`. The `mode` contains: `auto`, `size`
                           and `index`. In `auto` mode, AllReduce fusion is configured by gradients size and the default
                           fusion threshold is `64` MB. In 'size' mode, AllReduce fusion is configured by gradients size
@@ -605,6 +661,24 @@ def set_auto_parallel_context(**kwargs):
                         - reducescatter: If communication fusion type is `reducescatter`. The `mode` contains: `auto`
                           and `size`. Config is same as `allgather`.
 
+        strategy_ckpt_config (dict): A dict contains the configurations for setting the parallel strategy file. This
+                        interface contains the functions of parameter `strategy_ckpt_load_file` and
+                        `strategy_ckpt_save_file`, it is recommonded to use this parameter to replace those two
+                        parameters.
+                        It contains following configurations:
+
+                        - load_file (str): The path to load parallel strategy checkpoint. If the file name extension is
+                          `.json`, the file is loaded in JSON format. Otherwise, the file is loaded in ProtoBuf
+                          format.
+                          Default: ''
+
+                        - save_file (str): The path to save parallel strategy checkpoint. If the file name extension is
+                          `.json`, the file is saved in JSON format. Otherwise, the file is saved in ProtoBuf format.
+                          Default: ''
+
+                        - only_trainable_params (bool): Only save/load the strategy information for trainable parameter.
+                          Default: True.
+
     Raises:
         ValueError: If input key is not attribute in auto parallel context.
 
@@ -629,6 +703,8 @@ def set_auto_parallel_context(**kwargs):
         >>> ms.set_auto_parallel_context(parallel_optimizer_config=parallel_config, enable_parallel_optimizer=True)
         >>> config = {"allreduce": {"mode": "size", "config": 32}, "allgather": {"mode": "size", "config": 32}}
         >>> ms.set_auto_parallel_context(comm_fusion=config)
+        >>> stra_ckpt_dict = {"load_file": "./stra0.ckpt", "save_file": "./stra1.ckpt", "only_trainable_params": False}
+        >>> ms.set_auto_parallel_context(strategy_ckpt_config=stra_ckpt_dict)
     """
     _set_auto_parallel_context(**kwargs)
 
@@ -677,6 +753,46 @@ def reset_auto_parallel_context():
     _reset_auto_parallel_context()
 
 
+@args_type_check(offload_config=dict)
+def set_offload_context(offload_config):
+    r"""
+    Set offload context.
+    Some configurations are offload specific, see the below table for details:
+
+    Args:
+        offload_config (dict): A dict contains the keys and values for setting the offload context
+                        configure.It supports the following keys.
+            enable_offload (bool):  The flag of whether enabling offload. Default: False.
+            offload_param (str):  The param for offload destination, cpu or disk.
+            offload_path (str):  The path of offload.
+            offload_checkpoint (str):  The checkpoint for offload destination, cpu or disk.
+            offload_ddr_size (int):  The ddr size for offload.
+            offload_disk_size (int): The disk size for offload.
+            enable_aio (bool): The flag of whether enabling aio. Default: True.
+            aio_block_size (int): The size of aio block.
+            aio_queue_depth (int): The depth of aio queue.
+            enable_pinned_mem (bool): The flag of whether enabling pinned memory.
+
+    Raises:
+        ValueError: If input key is not attribute in auto parallel context.
+
+    Examples:
+        >>> from mindspore import context
+        >>> context.set_offload_context(offload_config={"offload_param"="cpu"})
+    """
+    _set_offload_context(offload_config)
+
+
+def get_offload_context():
+    """
+    Get offload context.
+    Examples:
+        >>> from mindspore import context
+        >>> offload_config = context.get_offload_context()
+    """
+    return _get_offload_context()
+
+
 def _check_target_specific_cfgs(device, arg_key):
     """Checking whether a config is suitable for a specified device"""
     device_cfgs = {
@@ -688,7 +804,8 @@ def _check_target_specific_cfgs(device, arg_key):
         'auto_tune_mode': ['Ascend'],
         'max_device_memory': ['Ascend', 'GPU'],
         'mempool_block_size': ['GPU', 'Ascend'],
-        'disable_format_transform': ['GPU']
+        'disable_format_transform': ['GPU'],
+        'ascend_config': ['Ascend']
     }
     # configs not in map device_cfgs are supposed to be suitable for all devices
     if arg_key not in device_cfgs:
@@ -702,8 +819,7 @@ def _check_target_specific_cfgs(device, arg_key):
     return False
 
 
-@args_unreset_check(device_id=int, variable_memory_max_size=str, max_device_memory=str, mempool_block_size=str)
-@args_type_check(mode=int, precompile_only=bool, device_target=str, device_id=int, save_graphs=bool,
+@args_type_check(mode=int, precompile_only=bool, device_target=str, device_id=int, save_graphs=(bool, int),
                  save_graphs_path=str, enable_dump=bool, auto_tune_mode=str,
                  save_dump_path=str, enable_reduce_precision=bool, variable_memory_max_size=str,
                  enable_auto_mixed_precision=bool, inter_op_parallel_num=int,
@@ -711,7 +827,7 @@ def _check_target_specific_cfgs(device, arg_key):
                  max_device_memory=str, print_file_path=str, max_call_depth=int, env_config_path=str,
                  graph_kernel_flags=str, save_compile_cache=bool, runtime_num_threads=int, load_compile_cache=bool,
                  grad_for_scalar=bool, pynative_synchronize=bool, mempool_block_size=str, disable_format_transform=bool,
-                 op_timeout=int, save_graph_dot=bool)
+                 op_timeout=int, deterministic=str, ascend_config=dict)
 def set_context(**kwargs):
     """
     Set context for running environment.
@@ -749,6 +865,8 @@ def set_context(**kwargs):
     |                         +------------------------------+----------------------------+
     |                         |  save_dump_path              |  Ascend                    |
     |                         +------------------------------+----------------------------+
+    |                         |  deterministic               |  Ascend                    |
+    |                         +------------------------------+----------------------------+
     |                         |  print_file_path             |  Ascend                    |
     |                         +------------------------------+----------------------------+
     |                         |  env_config_path             |  CPU/GPU/Ascend            |
@@ -790,6 +908,8 @@ def set_context(**kwargs):
     |                         |  memory_optimize_level       |  CPU/GPU/Ascend            |
     |                         +------------------------------+----------------------------+
     |                         |  memory_offload              |  GPU/Ascend                |
+    |                         +------------------------------+----------------------------+
+    |                         |  ascend_config               |  Ascend                    |
     +-------------------------+------------------------------+----------------------------+
 
     Args:
@@ -806,14 +926,31 @@ def set_context(**kwargs):
             of the available memory of the device and mempool_block_size.
         op_timeout (int): Set the maximum duration of executing an operator in seconds.
             If the execution time exceeds this value, system will terminate the task. 0 means endless wait.
-            Default: 0.
-        save_graphs (bool): Whether to save graphs. Default: False.
-            When the `save_graphs` attribute is set as True, attribute of `save_graphs_path` is used to set the
-            intermediate compilation graph storage path. By default, the graphs are saved in the current directory.
+            Default: 1900.
+        save_graphs (bool or int): Whether to save intermediate compilation graphs. Default: 0.
+            Available values are:
+
+            - False or 0: disable saving of intermediate compilation graphs.
+            - 1: some intermediate files will be generated during graph compliation.
+            - True or 2: Generate more ir files related to backend process.
+            - 3: Generate visualization computing graphs and detailed frontend ir graphs.
+
+            When the `save_graphs` attribute is set as True, 1, 2 or 3, attribute of `save_graphs_path` is used
+            to set the intermediate compilation graph storage path. By default, the graphs are saved in the current
+            directory.
         save_graphs_path (str): Path to save graphs. Default: ".".
             If the specified directory does not exist, the system will automatically create the directory.
             During distributed training, graphs will be saved to the directory of
             `save_graphs_path/rank_${rank_id}/`. `rank_id` is the ID of the current device in the cluster.
+        deterministic (str): Whether to enable op run in deterministic mode. The value must be in the
+            range of ['ON', 'OFF'], and the default value is 'OFF'.
+
+            - "ON": Enable operator deterministic running mode.
+            - "OFF": Disable operator deterministic running mode.
+
+            When deterministic mode is on, model ops will be deterministic in Ascend. This means that if op run multiple
+            times with the same inputs on the same hardware, it will have the exact same outputs each time. This is
+            useful for debugging models.
         enable_dump (bool): This parameters is deprecated, and will be deleted in the next version.
         save_dump_path (str): This parameters is deprecated, and will be deleted in the next version.
         print_file_path (str): The path of saving print data. If this parameter is set, print data is saved to
@@ -864,7 +1001,7 @@ def set_context(**kwargs):
             If enable_graph_kernel is set to True, acceleration can be enabled.
             For details of graph kernel fusion, please check
             `Enabling Graph Kernel Fusion
-            <https://www.mindspore.cn/tutorials/experts/en/r2.0.0-alpha/debug/graph_fusion_engine.html>`_.
+            <https://www.mindspore.cn/tutorials/experts/en/r2.0/debug/graph_fusion_engine.html>`_.
         graph_kernel_flags (str):
             Optimization options of graph kernel fusion, and the priority is higher when it conflicts
             with enable_graph_kernel. Only for experienced users.
@@ -899,7 +1036,7 @@ def set_context(**kwargs):
 
             For more information about the enable operator tuning tool settings, please check
             `Enable the operator optimization tool
-            <https://www.mindspore.cn/tutorials/experts/en/r2.0.0-alpha/debug/auto_tune.html>`_.
+            <https://www.mindspore.cn/tutorials/experts/en/r2.0/debug/auto_tune.html>`_.
         check_bprop (bool): Whether to check back propagation nodes. The checking ensures that the shape and dtype
             of back propagation node outputs is the same as input parameters. Default: False.
         max_call_depth (int): Specify the maximum depth of function call. Must be positive integer. Default: 1000.
@@ -917,7 +1054,7 @@ def set_context(**kwargs):
             the compile cache is loaded. Note that only limited automatic detection for the changes of
             python scripts is supported by now, which means that there is a correctness risk. Default: False.
             This is an experimental prototype that is subject to change and/or deletion.
-        compile_cache_path (str): Path to save the cache of the graph compiled by front-end. Default: ".".
+        compile_cache_path (str): Path to save the compile cache. Default: ".".
             If the specified directory does not exist, the system will automatically create the directory.
             The cache will be saved to the directory of `compile_cache_path/rank_${rank_id}/`. The `rank_id` is
             the ID of the current device in the cluster.
@@ -946,6 +1083,36 @@ def set_context(**kwargs):
               when the environment variable "GRAPH_OP_RUN=1" is not set; This parameter does not take effect when
               memory_optimize_level is set 'O1'.
             - OFF: Turn off the memory Offload function.
+        ascend_config (dict): Set the parameters specific to Ascend hardware platform. It is not set by default.
+            Currently, only setting `precision_mode` and `jit_compile` are supported on Ascend910B hardware platform.
+            The default value of `precision_mode` and `jit_compile` are experimental parameters, may change
+            in the future.
+
+            - precision_mode (str): Mixed precision mode setting, on Ascend910B hardware platform, the default
+              value of training network is based on the value of CANN, and the default value of inference network
+              is force_fp16. The value range is as follows:
+
+              - force_fp16: When the operator supports both float16 and float32, select float16 directly.
+              - allow_fp32_to_fp16: When the operator does not support the float32 data type, directly reduce
+                the precision of float16.
+              - allow_mix_precision: Automatic mixing precision, facing the whole network operator, according
+                to the built-in optimization strategy, automatically reduces the precision of some operators
+                to float16 or bfloat16.
+              - must_keep_origin_dtype: Keep the accuracy of the original drawing.
+              - force_fp32: When the input of the matrix calculation operator is float16 and the output supports
+                float16 and float32, output is forced to float32.
+              - force_lowerprecision: When the operator supports both float16 or bfloat16 and float32, select
+                float16 or bfloat16 directly.
+              - allow_fp32_to_bf16: When the operator does not support the float32 data type, directly reduce
+                the precision of bfloat16.
+              - allow_fp32_to_lowprecision: When the operator does not support the float32 data type, directly
+                reduce the precision of float16 or bfloat16.
+              - allow_mix_precision_fp16: Automatic mixing precision, facing the whole network operator, automatically
+                reduces the precision of some operators to float16 according to the built-in optimization strategy.
+              - allow_mix_precision_bf16: Automatic mixing precision, facing the whole network operator, according to
+                the built-in optimization strategy, automatically reduces the precision of some operators to bfloat16.
+
+            - jit_compile (bool): Whether to select online compilation. the default value is based on CANN.
 
     Raises:
         ValueError: If input key is not an attribute in context.
@@ -977,6 +1144,8 @@ def set_context(**kwargs):
         >>> ms.set_context(disable_format_transform=True)
         >>> ms.set_context(memory_optimize_level='O0')
         >>> ms.set_context(memory_offload='ON')
+        >>> ms.set_context(deterministic='ON')
+        >>> ms.set_context(ascend_config={"precision_mode": "force_fp16", "jit_compile": True})
     """
     ctx = _context()
     # set device target first
@@ -992,6 +1161,15 @@ def set_context(**kwargs):
             logger.warning(f"For 'context.set_context', '{key}' parameter is deprecated. "
                            "For details, please see the interface parameter API comments")
             continue
+        if key in ('precision_mode', 'jit_compile'):
+            raise ValueError(f"Please set '{key}' through parameter ascend_config")
+        if key == 'save_graphs':
+            if value is True:
+                value = 2
+            if value is False:
+                value = 0
+            if value > 3:
+                raise ValueError(f"value for save_graphs should be 0-3 but got '{value}'")
         if not _check_target_specific_cfgs(device, key):
             continue
         if hasattr(ctx, key):

mindspore/dataset/__init__.py

@@ -21,7 +21,7 @@ Besides, this module provides APIs to sample data while loading.
 
 We can enable cache in most of the dataset with its key arguments 'cache'. Please notice that cache is not supported
 on Windows platform yet. Do not use it while loading and processing data on Windows. More introductions and limitations
-can refer `Single-Node Tensor Cache <https://www.mindspore.cn/tutorials/experts/en/r2.0.0-alpha/dataset/cache.html>`_ .
+can refer `Single-Node Tensor Cache <https://www.mindspore.cn/tutorials/experts/en/r2.0/dataset/cache.html>`_ .
 
 Common imported modules in corresponding API examples are as follows:
 
@@ -55,11 +55,11 @@ The specific steps are as follows:
 - Dataset operation: The user uses the dataset object method `.shuffle` / `.filter` / `.skip` / `.split` /
   `.take` / ... to further shuffle, filter, skip, and obtain the maximum number of samples of datasets;
 - Dataset sample transform operation: The user can add data transform operations
-  ( `vision transform <https://mindspore.cn/docs/en/r2.0.0-alpha/api_python/mindspore.\
+  ( `vision transform <https://mindspore.cn/docs/en/r2.0/api_python/mindspore.\
   dataset.transforms.html#module-mindspore.dataset.vision>`_ ,
-  `NLP transform <https://mindspore.cn/docs/en/r2.0.0-alpha/api_python/mindspore.\
+  `NLP transform <https://mindspore.cn/docs/en/r2.0/api_python/mindspore.\
   dataset.transforms.html#module-mindspore.dataset.text>`_ ,
-  `audio transform <https://mindspore.cn/docs/en/r2.0.0-alpha/api_python/mindspore.\
+  `audio transform <https://mindspore.cn/docs/en/r2.0/api_python/mindspore.\
   dataset.transforms.html#module-mindspore.dataset.audio>`_ ) to the map
   operation to perform transformations. During data preprocessing, multiple map operations can be defined to
   perform different transform operations to different fields. The data transform operation can also be a
@@ -70,8 +70,7 @@ The specific steps are as follows:
   iterator, which can output the preprocessed data cyclically.
 
 The data processing pipeline example is as follows. Please refer to
-`datasets_example.py <https://gitee.com/mindspore/mindspore/tree/r2.0.0-alpha/docs/api/api_python_en
-/datasets_example.py>`_
+`datasets_example.py <https://gitee.com/mindspore/mindspore/tree/r2.0/docs/api/api_python_en/datasets_example.py>`_
 for complete example.
 
 .. code-block::
@@ -122,6 +121,7 @@ from .engine.datasets import *
 from .engine.graphdata import GraphData, SamplingStrategy, OutputFormat
 from .engine.samplers import *
 from .engine.serializer_deserializer import compare, deserialize, serialize, show
+from .utils.line_reader import LineReader
 
 __all__ = []
 __all__.extend(engine.__all__)

mindspore/dataset/audio/__init__.py

@@ -40,7 +40,7 @@ Descriptions of common data processing terms are as follows:
 The data transform operation can be executed in the data processing pipeline or in the eager mode:
 
 - Pipeline mode is generally used to process datasets. For examples, please refer to
-  `introduction to data processing pipeline <https://www.mindspore.cn/docs/en/r2.0.0-alpha/api_python/
+  `introduction to data processing pipeline <https://www.mindspore.cn/docs/en/r2.0/api_python/
   mindspore.dataset.html#introduction-to-data-processing-pipeline>`_ .
 - Eager mode is generally used for scattered samples. Examples of audio preprocessing are as follows:
 
@@ -65,12 +65,12 @@ from __future__ import absolute_import
 from mindspore.dataset.audio import transforms
 from mindspore.dataset.audio import utils
 from mindspore.dataset.audio.transforms import AllpassBiquad, AmplitudeToDB, Angle, BandBiquad, \
-    BandpassBiquad, BandrejectBiquad, BassBiquad, Biquad, \
-    ComplexNorm, ComputeDeltas, Contrast, DBToAmplitude, DCShift, DeemphBiquad, DetectPitchFrequency, Dither, \
-    EqualizerBiquad, Fade, Flanger, FrequencyMasking, Gain, GriffinLim, HighpassBiquad, InverseMelScale, LFilter, \
-    LowpassBiquad, Magphase, MaskAlongAxis, MaskAlongAxisIID, MelScale, MuLawDecoding, MuLawEncoding, Overdrive, \
-    Phaser, PhaseVocoder, Resample, RiaaBiquad, SlidingWindowCmn, SpectralCentroid, Spectrogram, TimeMasking, \
-    TimeStretch, TrebleBiquad, Vad, Vol
+    BandpassBiquad, BandrejectBiquad, BassBiquad, Biquad, ComplexNorm, ComputeDeltas, Contrast, DBToAmplitude, \
+    DCShift, DeemphBiquad, DetectPitchFrequency, Dither, EqualizerBiquad, Fade, Filtfilt, Flanger, FrequencyMasking, \
+    Gain, GriffinLim, HighpassBiquad, InverseMelScale, InverseSpectrogram, LFCC, LFilter, LowpassBiquad, Magphase, \
+    MaskAlongAxis, MaskAlongAxisIID, MelScale, MelSpectrogram, MFCC, MuLawDecoding, MuLawEncoding, Overdrive, \
+    Phaser, PhaseVocoder, PitchShift, Resample, RiaaBiquad, SlidingWindowCmn, SpectralCentroid, Spectrogram, \
+    TimeMasking, TimeStretch, TrebleBiquad, Vad, Vol
 from mindspore.dataset.audio.utils import BorderType, DensityFunction, FadeShape, GainType, Interpolation, \
     MelType, Modulation, NormMode, NormType, ResampleMethod, ScaleType, WindowType, create_dct, linear_fbanks, \
     melscale_fbanks