mindspore 2.7.0rc1__cp311-cp311-win_amd64.whl → 2.7.1__cp311-cp311-win_amd64.whl

mindspore/include/api/model.h

@@ -40,7 +40,9 @@ class Dataset;
 /// \brief The Model class is used to define a MindSpore model, facilitating computational graph management.
 class MS_API Model {
  public:
+  /// \brief Constructor of Model.
   Model();
+  /// \brief Destructor of Model.
   ~Model();
 
   /// \brief Build a model from model buffer so that it can run on a device.
@@ -361,6 +363,9 @@ class MS_API Model {
   /// \return Status of operation.
   Status Evaluate(std::shared_ptr<dataset::Dataset> ds, std::vector<TrainCallBack *> cbs);
 
+  /// \brief Performs the implication.
+  ///
+  /// \return the implication of the model.
   const std::shared_ptr<ModelImpl> impl() const { return impl_; }
 
   /// \brief Get model info by key
@@ -369,7 +374,6 @@ class MS_API Model {
   ///
   /// \return The value of the model info associated with the given key.
   inline std::string GetModelInfo(const std::string &key);
-
   /// \brief Finish the model. (Only used for mindspore_lite's ascend backend.)
   ///
   /// \return Status of the operation.

mindspore/include/api/model_group.h

@@ -41,7 +41,11 @@ enum class ModelGroupFlag : int {
 
 class MS_API ModelGroup {
  public:
+  /// \brief Constructor of ModelGroup.
+  ///
+  /// \param[in] flags The flags of model group.
   explicit ModelGroup(ModelGroupFlag flags = ModelGroupFlag::kShareWorkspace);
+  /// \brief Destructor of ModelGroup.
   ~ModelGroup() = default;
 
   /// \brief Add models that require shared workspace memory.

mindspore/include/api/model_parallel_runner.h

@@ -28,7 +28,9 @@ namespace mindspore {
 class MS_API RunnerConfig {
  public:
   struct Data;
+  /// \brief Constructor of RunnerConfig.
   RunnerConfig();
+  /// \brief Destructor of RunnerConfig.
   ~RunnerConfig();
 
   /// \brief Set the number of workers at runtime. Only valid for ModelParallelRunner.

mindspore/include/api/status.h

@@ -128,37 +128,75 @@ enum StatusCode : uint32_t {
 
 class MS_API Status {
  public:
+  /// \brief Constructor of Status.
   Status();
+  /// \brief Constructor of Status.
+  ///
+  /// \param[in] status_code Status code.
+  ///
+  /// \param[in] status_msg Status message.
   inline Status(enum StatusCode status_code, const std::string &status_msg = "");  // NOLINT(runtime/explicit)
+  /// \brief Constructor of Status.
   inline Status(const StatusCode code, int line_of_code, const char *file_name, const std::string &extra = "");
-
+  /// \brief Destructor of Status.
   ~Status() = default;
-
+  /// \brief Status code of status.
+  ///
+  /// \return Enum of status code.
   enum StatusCode StatusCode() const;
+  /// \brief Exchange status to string.
+  ///
+  /// \return Status code exchanged to string.
   inline std::string ToString() const;
-
+  /// \brief Get line of status code.
+  ///
+  /// \return Line of code to get.
   int GetLineOfCode() const;
+  /// \brief Get file name of status.
+  ///
+  /// \return File name to get.
   inline std::string GetFileName() const;
+  /// \brief Get error description of status.
+  ///
+  /// \return Error description to get.
   inline std::string GetErrDescription() const;
+  /// \brief Get error description of status.
+  ///
+  /// \param[in] err_description Error description to be set.
   inline std::string SetErrDescription(const std::string &err_description);
+  /// \brief Status message to be set.
+  ///
+  /// \param[in] status_msg Status message to be set.
   inline void SetStatusMsg(const std::string &status_msg);
-
+  /// \brief Operator <<.
   MS_API friend std::ostream &operator<<(std::ostream &os, const Status &s);
-
+  /// \brief Operator ==.
   bool operator==(const Status &other) const;
+  /// \brief Operator ==.
   bool operator==(enum StatusCode other_code) const;
+  /// \brief Operator !=.
   bool operator!=(const Status &other) const;
+  /// \brief Operator !=.
   bool operator!=(enum StatusCode other_code) const;
-
+  /// \brief Operator bool().
   explicit operator bool() const;
+  /// \brief Operator int().
   explicit operator int() const;
-
+  /// \brief Getting back the status of OK.
+  ///
+  /// \return Status Code of ok.
   static Status OK();
-
+  /// \brief Getting back if it is ok.
+  ///
+  /// \return True if it is ok.
   bool IsOk() const;
-
+  /// \brief Getting back if it is error.
+  ///
+  /// \return True if it is error.
   bool IsError() const;
-
+  /// \brief Getting back the code as string.
+  ///
+  /// \return The code name as string type.
   static inline std::string CodeAsString(enum StatusCode c);
 
  private:

mindspore/include/api/types.h

@@ -74,6 +74,7 @@ class Allocator;
 /// \brief The MSTensor class defines a tensor in MindSpore.
 class MS_API MSTensor {
  public:
+  /// \brief Impl class of MSTensor.
   class Impl;
   /// \brief Creates a MSTensor object, whose data need to be copied before accessed by Model, must be used in pairs
   /// with DestroyTensorPtr.
@@ -161,13 +162,17 @@ class MS_API MSTensor {
   ///
   /// \param[in] tensor A MSTensor object.
   static void DestroyTensorPtr(MSTensor *tensor) noexcept;
-
+  /// \brief Constructor of MSTensor.
   MSTensor();
+  /// \brief Constructor of MSTensor.
   explicit MSTensor(const std::shared_ptr<Impl> &impl);
+  /// \brief Constructor of MSTensor.
   // if malloc data, user need to free after constructing MSTensor, else memory leak.
   inline MSTensor(const std::string &name, DataType type, const std::vector<int64_t> &shape, const void *data,
                   size_t data_len);
+  /// \brief Constructor of MSTensor.
   explicit MSTensor(std::nullptr_t);
+  /// \brief Destructor of MSTensor.
   ~MSTensor();
 
   /// \brief Obtains the name of the MSTensor.

mindspore/include/dataset/constants.h

@@ -356,6 +356,15 @@ constexpr int32_t kMaxLegalPort = 65535;
 // Invalid OpenCV type should not be from 0 to 7 (opencv4/opencv2/core/hal/interface.h)
 constexpr uint8_t kCVInvalidType = 255;
 
+constexpr size_t dimension_zero = 0;
+constexpr size_t dimension_one = 1;
+constexpr size_t dimension_two = 2;
+constexpr size_t dimension_three = 3;
+constexpr size_t size_one = 1;
+constexpr size_t size_two = 2;
+constexpr size_t size_three = 3;
+constexpr size_t size_four = 4;
+
 using connection_id_type = uint64_t;
 using session_id_type = uint32_t;
 using row_id_type = int64_t;

mindspore/include/dataset/execute.h

@@ -27,8 +27,8 @@
 #include "include/dataset/constants.h"
 #include "include/dataset/transforms.h"
 #if defined(ENABLE_D)
-#include "runtime/hardware/device_context.h"
-#include "runtime/hardware/device_context_manager.h"
+#include "runtime/hardware_abstract/device_context/device_context.h"
+#include "runtime/hardware_abstract/device_context/device_context_manager.h"
 #endif
 
 namespace mindspore {

mindspore/mindrecord/__init__.py

@@ -31,8 +31,8 @@ datasets using `mindspore.dataset.MindDataset <https://www.mindspore.cn/docs/en/
 mindspore.dataset.MindDataset.html>`_ .
 
 Users can also convert datasets from other formats to the MindRecord format.
-For more details, please refer to `Converting Dataset to MindRecord <https://www.mindspore.cn/docs/en/master/
-model_train/dataset/record.html>`_ .
+For more details, please refer to
+`Converting Dataset to MindRecord <https://www.mindspore.cn/tutorials/en/master/dataset/record.html>`_ .
 Additionally, MindRecord supports file encryption, decryption,
 and integrity checks to ensure the security of MindRecord format datasets.
 """
@@ -41,7 +41,7 @@ from .filewriter import FileWriter
 from .filereader import FileReader
 from .mindpage import MindPage
 from .common.exceptions import *
-from .shardutils import SUCCESS, FAILED
+from .core.shardutils import SUCCESS, FAILED
 from .tools.cifar10_to_mr import Cifar10ToMR
 from .tools.cifar100_to_mr import Cifar100ToMR
 from .tools.csv_to_mr import CsvToMR

mindspore/mindrecord/common/exceptions.py

@@ -26,6 +26,7 @@ Error rule:
 """
 from .enums import LogRuntime, ErrorCodeType, ErrorLevel
 from .constant import SYS_ID
+
 EXCEPTIONS = dict(
     # the format of list is [exception No, base error message]
     UnknownError=[0, 'Unknown Error.'],

mindspore/mindrecord/config.py

@@ -30,7 +30,7 @@ import time
 
 from mindspore import log as logger
 from mindspore._c_expression import _encrypt, _decrypt_data
-from .shardutils import MIN_FILE_SIZE
+from .core.shardutils import MIN_FILE_SIZE
 
 
 __all__ = ['set_enc_key',

mindspore/{parallel/mpi → mindrecord/core}/__init__.py

@@ -1,4 +1,4 @@
-# Copyright 2023 Huawei Technologies Co., Ltd
+# Copyright 2025 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.
@@ -12,3 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 # ============================================================================
+"""
+init core
+"""

mindspore/mindrecord/{shardheader.py → core/shardheader.py}

@@ -17,7 +17,8 @@ This module is to write data into mindrecord.
 """
 import mindspore._c_mindrecord as ms
 from mindspore import log as logger
-from .common.exceptions import MRMAddSchemaError, MRMAddIndexError, MRMBuildSchemaError, MRMGetMetaError
+from mindspore.mindrecord.common.exceptions import MRMAddSchemaError, MRMAddIndexError, MRMBuildSchemaError, \
+    MRMGetMetaError
 
 __all__ = ['ShardHeader']
 

mindspore/mindrecord/{shardindexgenerator.py → core/shardindexgenerator.py}

@@ -17,7 +17,7 @@ This module is to  write data into mindrecord.
 """
 import mindspore._c_mindrecord as ms
 from mindspore import log as logger
-from .common.exceptions import MRMIndexGeneratorError, MRMGenerateIndexError
+from mindspore.mindrecord.common.exceptions import MRMIndexGeneratorError, MRMGenerateIndexError
 
 __all__ = ['ShardIndexGenerator']
 

mindspore/mindrecord/{shardreader.py → core/shardreader.py}

@@ -17,7 +17,8 @@ This module is to read data from mindrecord.
 """
 import mindspore._c_mindrecord as ms
 from mindspore import log as logger
-from .common.exceptions import MRMOpenError, MRMLaunchError
+from mindspore.mindrecord.common.exceptions import MRMOpenError, MRMLaunchError
+
 __all__ = ['ShardReader']
 
 

mindspore/mindrecord/{shardsegment.py → core/shardsegment.py}

@@ -17,8 +17,8 @@ This module is to read page from mindrecord.
 """
 import mindspore._c_mindrecord as ms
 from mindspore import log as logger
-from .shardutils import populate_data, SUCCESS
-from .shardheader import ShardHeader
+from mindspore.mindrecord.core.shardutils import populate_data, SUCCESS
+from mindspore.mindrecord.core.shardheader import ShardHeader
 
 __all__ = ['ShardSegment']
 

mindspore/mindrecord/{shardutils.py → core/shardutils.py}

@@ -25,7 +25,7 @@ from functools import wraps
 
 import numpy as np
 import mindspore._c_mindrecord as ms
-from .common.exceptions import ParamValueError, MRMUnsupportedSchemaError
+from mindspore.mindrecord.common.exceptions import ParamValueError, MRMUnsupportedSchemaError
 
 SUCCESS = ms.MSRStatus.SUCCESS
 FAILED = ms.MSRStatus.FAILED

mindspore/mindrecord/{shardwriter.py → core/shardwriter.py}

@@ -18,7 +18,7 @@ This module is to write data into mindrecord.
 import numpy as np
 import mindspore._c_mindrecord as ms
 from mindspore import log as logger
-from .common.exceptions import MRMOpenError, MRMOpenForAppendError, MRMInvalidHeaderSizeError, \
+from mindspore.mindrecord.common.exceptions import MRMOpenError, MRMOpenForAppendError, MRMInvalidHeaderSizeError, \
     MRMInvalidPageSizeError, MRMSetHeaderError, MRMWriteDatasetError, MRMCommitError
 
 __all__ = ['ShardWriter']

mindspore/mindrecord/filereader.py

@@ -18,10 +18,10 @@ This module is to read data from MindRecord.
 import platform
 from mindspore import log as logger
 
-from .shardreader import ShardReader
-from .shardheader import ShardHeader
-from .shardutils import populate_data
-from .shardutils import check_parameter
+from .core.shardreader import ShardReader
+from .core.shardheader import ShardHeader
+from .core.shardutils import populate_data
+from .core.shardutils import check_parameter
 from .common.exceptions import ParamTypeError
 from .config import _get_enc_key, _get_dec_mode, decrypt
 

mindspore/mindrecord/filewriter.py

@@ -25,11 +25,11 @@ import time
 import multiprocessing as mp
 import numpy as np
 from mindspore import log as logger
-from .shardwriter import ShardWriter
-from .shardreader import ShardReader
-from .shardheader import ShardHeader
-from .shardindexgenerator import ShardIndexGenerator
-from .shardutils import MIN_SHARD_COUNT, MAX_SHARD_COUNT, VALID_ATTRIBUTES, VALID_ARRAY_ATTRIBUTES, \
+from .core.shardwriter import ShardWriter
+from .core.shardreader import ShardReader
+from .core.shardheader import ShardHeader
+from .core.shardindexgenerator import ShardIndexGenerator
+from .core.shardutils import MIN_SHARD_COUNT, MAX_SHARD_COUNT, VALID_ATTRIBUTES, VALID_ARRAY_ATTRIBUTES, \
     check_filename, VALUE_TYPE_MAP, SUCCESS
 from .common.exceptions import ParamValueError, ParamTypeError, MRMInvalidSchemaError, MRMDefineIndexError
 from .config import _get_enc_key, _get_enc_mode, _get_dec_mode, encrypt, decrypt

mindspore/mindrecord/mindpage.py

@@ -16,8 +16,8 @@
 This module is to support reading page from MindRecord.
 """
 
-from .shardsegment import ShardSegment
-from .shardutils import check_parameter
+from .core.shardsegment import ShardSegment
+from .core.shardutils import check_parameter
 from .common.exceptions import ParamValueError, ParamTypeError, MRMDefineCategoryError
 from .config import _get_enc_key, _get_dec_mode, decrypt
 

mindspore/mindrecord/tools/cifar10.py

@@ -23,7 +23,7 @@ import re
 import numpy as np
 
 from mindspore import log as logger
-from ..shardutils import check_filename
+from ..core.shardutils import check_filename
 
 __all__ = ['Cifar10']
 
@@ -40,7 +40,8 @@ class CifarMD5Validator:
                         'data_batch_5': '482c414d41f54cd18b22e5b47cb7c3cb',
                         'test_batch': '40351d587109b95175f43aff81a1287e'}
 
-    def calculate_md5(self, file_path):
+    @staticmethod
+    def calculate_md5(file_path):
         """
         Calculate MD5 hash of a file.
 
@@ -76,7 +77,7 @@ class CifarMD5Validator:
             KeyError: If file_name is not found in md5_map.
         """
         expected_md5 = self.md5_map.get(file_name)
-        actual_md5 = self.calculate_md5(os.path.join(file_path, file_name))
+        actual_md5 = CifarMD5Validator.calculate_md5(os.path.join(file_path, file_name))
 
         if actual_md5 is None or expected_md5 is None or actual_md5 != expected_md5:
             logger.warning(f"The MD5 value of {file_name} does not match the official CIFAR10 file."

mindspore/mindrecord/tools/cifar100.py

@@ -21,7 +21,7 @@ import pickle
 import os
 import numpy as np
 
-from ..shardutils import check_filename
+from ..core.shardutils import check_filename
 
 __all__ = ['Cifar100']
 

mindspore/mindrecord/tools/cifar100_to_mr.py

@@ -23,7 +23,7 @@ from mindspore import log as logger
 from .cifar100 import Cifar100
 from ..common.exceptions import PathNotExistsError
 from ..filewriter import FileWriter
-from ..shardutils import check_filename, ExceptionThread, SUCCESS
+from ..core.shardutils import check_filename, ExceptionThread, SUCCESS
 
 
 __all__ = ['Cifar100ToMR']

mindspore/mindrecord/tools/cifar10_to_mr.py

@@ -23,7 +23,7 @@ from mindspore import log as logger
 from .cifar10 import Cifar10
 from ..common.exceptions import PathNotExistsError
 from ..filewriter import FileWriter
-from ..shardutils import check_filename, ExceptionThread, SUCCESS
+from ..core.shardutils import check_filename, ExceptionThread, SUCCESS
 
 
 __all__ = ['Cifar10ToMR']
@@ -49,11 +49,6 @@ class Cifar10ToMR:
         >>> mindrecord_file = "/path/to/mindrecord/file"
         >>> cifar10_to_mr = Cifar10ToMR(cifar10_dir, mindrecord_file)
         >>> cifar10_to_mr.transform()
-
-    .. warning::
-        Cifar10ToMR.transform() uses `pickle` module implicitly, which is known to be insecure.
-        It is possible to construct malicious pickle data which will execute arbitrary code during unpickling.
-        Never load data that could have come from an untrusted source, or that could have been tampered with.
     """
 
     def __init__(self, source, destination):
@@ -112,6 +107,11 @@ class Cifar10ToMR:
         Note:
             Please refer to the Examples of :class:`mindspore.mindrecord.Cifar10ToMR` .
 
+        .. warning::
+            `Cifar10ToMR.transform()` uses `pickle` module implicitly, which is known to be insecure.
+            It is possible to construct malicious pickle data which will execute arbitrary code during unpickling.
+            Never load data that could have come from an untrusted source, or that could have been tampered with.
+
         Args:
             fields (list[str], optional): A list of index fields. Default: ``None`` . For index field settings,
                 please refer to :func:`mindspore.mindrecord.FileWriter.add_index` .

mindspore/mindrecord/tools/csv_to_mr.py

@@ -20,7 +20,7 @@ import os
 
 from mindspore import log as logger
 from ..filewriter import FileWriter
-from ..shardutils import check_filename, ExceptionThread
+from ..core.shardutils import check_filename, ExceptionThread
 
 
 __all__ = ['CsvToMR']

mindspore/mindrecord/tools/imagenet_to_mr.py

@@ -21,7 +21,7 @@ import time
 from mindspore import log as logger
 from ..common.exceptions import PathNotExistsError
 from ..filewriter import FileWriter
-from ..shardutils import check_filename, ExceptionThread
+from ..core.shardutils import check_filename, ExceptionThread
 
 __all__ = ['ImageNetToMR']
 

mindspore/mindrecord/tools/mnist_to_mr.py

@@ -23,7 +23,7 @@ import numpy as np
 
 from mindspore import log as logger
 from ..filewriter import FileWriter
-from ..shardutils import check_filename, ExceptionThread, SUCCESS, FAILED
+from ..core.shardutils import check_filename, ExceptionThread, SUCCESS, FAILED
 
 
 __all__ = ['MnistToMR']

mindspore/mindrecord/tools/tfrecord_to_mr.py

@@ -21,7 +21,7 @@ import numpy as np
 
 from mindspore import log as logger
 from ..filewriter import FileWriter
-from ..shardutils import check_filename, ExceptionThread
+from ..core.shardutils import check_filename, ExceptionThread
 
 __all__ = ['TFRecordToMR']
 

mindspore/mint/__init__.py

@@ -486,6 +486,11 @@ from mindspore.ops.auto_generate.pyboost_inner_prim import squeeze_impl
 from mindspore.ops.auto_generate.gen_ops_prim import equal_ext_op
 
 
+# 1101
+from mindspore.ops.functional_overload import real
+# 1102
+from mindspore.ops.functional_overload import imag
+
 # 1023
 from mindspore.ops.function.array_func import unbind_ext as unbind
 
@@ -609,6 +614,9 @@ def cat(tensors, dim=0):
 
         (x_1, x_2, ..., \sum_{i=1}^Nx_{mi}, ..., x_R)
 
+    .. warning::
+        Input tensor of inconsistent types are not supported in Graph Mode under Dynamic Shape.
+
     Args:
         tensors (Union[tuple, list]): A tuple or a list of input tensors.
             Suppose there are two tensors in this tuple or list, namely t1 and t2.
@@ -620,7 +628,6 @@ def cat(tensors, dim=0):
 
     Returns:
         Tensor, the shape is :math:`(x_1, x_2, ..., \sum_{i=1}^Nx_{mi}, ..., x_R)`.
-        The data type is the same with `tensors`.
 
     Raises:
         TypeError: If `dim` is not an int.
@@ -658,7 +665,7 @@ def concat(tensors, dim=0):
     Alias for :func:`mindspore.mint.cat`.
 
     .. warning::
-        This is an experimental API that is subject to change or deletion.
+        Input tensor of inconsistent types are not supported in Graph Mode under Dynamic Shape.
 
     Supported Platforms:
         ``Ascend`` ``GPU`` ``CPU``
@@ -744,9 +751,6 @@ def equal(input, other):
     Note:
         `input` and `other` comply with the implicit type conversion rules to make the data types consistent.
 
-    .. warning::
-        This is an experimental API that is subject to change or deletion.
-
     Args:
         input (Tensor): The first input.
         other (Tensor): The second input.
@@ -1323,8 +1327,6 @@ def swapaxes(input, axis0, axis1):
     Alias for :func:`mindspore.mint.transpose` . The `input` corresponds to the `input` in the reference interface,
     and the parameters `axis0` and `axis1` correspond to `dim0` and `dim1` in the reference interface respectively.
 
-    For more details, see :func:`mindspore.mint.transpose` .
-
     .. warning::
         This is an experimental API that is subject to change or deletion.
 
@@ -1438,8 +1440,6 @@ def fix(input):
     """
     Alias for :func:`mindspore.mint.trunc` .
 
-    For more details, see :func:`mindspore.mint.trunc` .
-
     Supported Platforms:
         ``Ascend``
     """
@@ -1535,7 +1535,7 @@ def cdist(x1, x2, p=2.0, compute_mode='use_mm_for_euclid_dist_if_necessary'):
         x2 (Tensor): Input tensor of shape :math:`(B, R, M)`, has the same dtype as `x1`.
         p (float, optional): P value for the p-norm distance to calculate between each
             vector pair, P >= 0. Default: ``2.0`` .
-        compute_mode (string, optional): Specify the cumpute mode. Setting this parameter currently has no effect.
+        compute_mode (str, optional): Specify the cumpute mode. Setting this parameter currently has no effect.
             Default: ``'use_mm_for_euclid_dist_if_necessary'`` .
 
     Returns:
@@ -2061,6 +2061,11 @@ __all__ = [
 
     # 1100
     'diff',
+
+    # 1101
+    'real',
+    # 1102
+    'imag',
 ]
 
 __all__.extend(functional.__all__)

mindspore/mint/distributed/__init__.py

@@ -37,9 +37,11 @@ from mindspore.mint.distributed.distributed import (
     get_group_rank,
     all_reduce,
     all_gather_into_tensor,
+    all_gather_into_tensor_uneven,
     all_to_all,
     all_to_all_single,
     reduce_scatter_tensor,
+    reduce_scatter_tensor_uneven,
     isend,
     irecv,
     send,
@@ -73,9 +75,11 @@ __all__ = [
     "get_group_rank",
     "all_reduce",
     "all_gather_into_tensor",
+    "all_gather_into_tensor_uneven",
     "all_to_all",
     "all_to_all_single",
     "reduce_scatter_tensor",
+    "reduce_scatter_tensor_uneven",
     "isend",
     "irecv",
     "send",