mindspore 1.10.0__cp38-cp38-win_amd64.whl → 2.0.0rc1__cp38-cp38-win_amd64.whl

mindspore/dataset/vision/c_transforms.py

@@ -151,7 +151,7 @@ class AdjustGamma(ImageTensorOperation):
             The output image pixel value is exponentially related to the input image pixel value.
             gamma larger than 1 make the shadows darker,
             while gamma smaller than 1 make dark regions lighter.
-        gain (float, optional): The constant multiplier (default=1).
+        gain (float, optional): The constant multiplier. Default: 1.0.
 
     Raises:
         TypeError: If `gain` is not of type float.
@@ -181,12 +181,12 @@ class AdjustGamma(ImageTensorOperation):
 class AutoAugment(ImageTensorOperation):
     """
     Apply AutoAugment data augmentation method based on
-    `AutoAugment: Learning Augmentation Strategies from Data <https://arxiv.org/pdf/1805.09501.pdf>`_.
+    `AutoAugment: Learning Augmentation Strategies from Data <https://arxiv.org/pdf/1805.09501.pdf>`_ .
     This operation works only with 3-channel RGB images.
 
     Args:
-        policy (AutoAugmentPolicy, optional): AutoAugment policies learned on different datasets
-            (default=AutoAugmentPolicy.IMAGENET).
+        policy (AutoAugmentPolicy, optional): AutoAugment policies learned on different datasets.
+            Default: AutoAugmentPolicy.IMAGENET.
             It can be any of [AutoAugmentPolicy.IMAGENET, AutoAugmentPolicy.CIFAR10, AutoAugmentPolicy.SVHN].
             Randomly apply 2 operations from a candidate set. See auto augmentation details in AutoAugmentPolicy.
 
@@ -196,7 +196,7 @@ class AutoAugment(ImageTensorOperation):
 
             - AutoAugmentPolicy.SVHN, means to apply AutoAugment learned on SVHN dataset.
 
-        interpolation (Inter, optional): Image interpolation mode for Resize operator (default=Inter.NEAREST).
+        interpolation (Inter, optional): Image interpolation mode for Resize operation. Default: Inter.NEAREST.
             It can be any of [Inter.NEAREST, Inter.BILINEAR, Inter.BICUBIC, Inter.AREA].
 
             - Inter.NEAREST: means interpolation method is nearest-neighbor interpolation.
@@ -205,12 +205,12 @@ class AutoAugment(ImageTensorOperation):
 
             - Inter.BICUBIC: means the interpolation method is bicubic interpolation.
 
-            - Inter.AREA: means the interpolation method is area interpolation.
+            - Inter.AREA: means the interpolation method is pixel area interpolation.
 
         fill_value (Union[int, tuple], optional): Pixel fill value for the area outside the transformed image.
             It can be an int or a 3-tuple. If it is a 3-tuple, it is used to fill R, G, B channels respectively.
-            If it is an integer, it is used for all RGB channels. The fill_value values must be in range [0, 255]
-            (default=0).
+            If it is an integer, it is used for all RGB channels. The fill_value values must be in range [0, 255].
+            Default: 0.
 
     Raises:
         TypeError: If `policy` is not of type AutoAugmentPolicy.
@@ -247,14 +247,14 @@ class AutoAugment(ImageTensorOperation):
 
 class AutoContrast(ImageTensorOperation):
     """
-    Apply automatic contrast on input image. This operator calculates histogram of image, reassign cutoff percent
+    Apply automatic contrast on input image. This operation calculates histogram of image, reassign cutoff percent
     of the lightest pixels from histogram to 255, and reassign cutoff percent of the darkest pixels from histogram to 0.
 
     Args:
         cutoff (float, optional): Percent of lightest and darkest pixels to cut off from
-            the histogram of input image. The value must be in the range [0.0, 50.0) (default=0.0).
+            the histogram of input image. The value must be in the range [0.0, 50.0). Default: 0.0.
         ignore (Union[int, sequence], optional): The background pixel values to ignore,
-            The ignore values must be in range [0, 255] (default=None).
+            The ignore values must be in range [0, 255]. Default: None.
 
     Raises:
         TypeError: If `cutoff` is not of type float.
@@ -294,11 +294,11 @@ class BoundingBoxAugment(ImageTensorOperation):
         transform (TensorOperation): C++ transformation operation to be applied on random selection
             of bounding box regions of a given image.
         ratio (float, optional): Ratio of bounding boxes to apply augmentation on.
-            Range: [0.0, 1.0] (default=0.3).
+            Range: [0.0, 1.0]. Default: 0.3.
 
     Raises:
         TypeError: If `transform` is not an image processing operation
-            in :class:`mindspore.dataset.vision.c_transforms`.
+            in :class:`mindspore.dataset.vision.c_transforms` .
         TypeError: If `ratio` is not of type float.
         ValueError: If `ratio` is not in range [0.0, 1.0].
         RuntimeError: If given bounding box is invalid.
@@ -312,8 +312,7 @@ class BoundingBoxAugment(ImageTensorOperation):
         >>> # map to apply ops
         >>> image_folder_dataset = image_folder_dataset.map(operations=[bbox_aug_op],
         ...                                                 input_columns=["image", "bbox"],
-        ...                                                 output_columns=["image", "bbox"],
-        ...                                                 column_order=["image", "bbox"])
+        ...                                                 output_columns=["image", "bbox"])
     """
 
     @deprecated_c_vision()
@@ -344,7 +343,7 @@ class CenterCrop(ImageTensorOperation):
     Raises:
         TypeError: If `size` is not of type int or sequence.
         ValueError: If `size` is less than or equal to 0.
-        RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
+        RuntimeError: If given tensor shape is not <H, W> or <..., H, W, C>.
 
     Supported Platforms:
         ``CPU``
@@ -419,7 +418,7 @@ class ConvertColor(ImageTensorOperation):
             - ConvertMode.COLOR_RGBA2GRAY, Convert RGBA image to GRAY image.
 
     Raises:
-        TypeError: If `convert_mode` is not of type :class:`mindspore.dataset.vision.c_transforms.ConvertMode`.
+        TypeError: If `convert_mode` is not of type :class:`mindspore.dataset.vision.c_transforms.ConvertMode` .
         RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
 
     Supported Platforms:
@@ -491,16 +490,16 @@ class Crop(ImageTensorOperation):
 class CutMixBatch(ImageTensorOperation):
     """
     Apply CutMix transformation on input batch of images and labels.
-    Note that you need to make labels into one-hot format and batched before calling this operator.
+    Note that you need to make labels into one-hot format and batched before calling this operation.
 
     Args:
         image_batch_format (ImageBatchFormat): The method of padding. Can be any of
             [ImageBatchFormat.NHWC, ImageBatchFormat.NCHW].
-        alpha (float, optional): Hyperparameter of beta distribution, must be larger than 0 (default = 1.0).
-        prob (float, optional): The probability by which CutMix is applied to each image, range: [0, 1] (default = 1.0).
+        alpha (float, optional): Hyperparameter of beta distribution, must be larger than 0. Default: 1.0.
+        prob (float, optional): The probability by which CutMix is applied to each image, range: [0, 1]. Default: 1.0.
 
     Raises:
-        TypeError: If `image_batch_format` is not of type :class:`mindspore.dataset.vision.ImageBatchFormat`.
+        TypeError: If `image_batch_format` is not of type :class:`mindspore.dataset.vision.ImageBatchFormat` .
         TypeError: If `alpha` is not of type float.
         TypeError: If `prob` is not of type float.
         ValueError: If `alpha` is less than or equal 0.
@@ -538,7 +537,7 @@ class CutOut(ImageTensorOperation):
 
     Args:
         length (int): The side length of each square patch, must be larger than 0.
-        num_patches (int, optional): Number of patches to be cut out of an image, must be larger than 0. (default=1).
+        num_patches (int, optional): Number of patches to be cut out of an image, must be larger than 0. Default: 1.
 
     Raises:
         TypeError: If `length` is not of type int.
@@ -571,7 +570,7 @@ class Decode(ImageTensorOperation):
     Decode the input image.
 
     Args:
-        rgb (bool, optional): Mode of decoding input image (default=True).
+        rgb (bool, optional): Mode of decoding input image. Default: True.
             If True means format of decoded image is RGB else BGR (deprecated).
 
     Raises:
@@ -644,8 +643,8 @@ class GaussianBlur(ImageTensorOperation):
         kernel_size (Union[int, Sequence[int]]): Size of the Gaussian kernel to use. The value must be positive and odd.
             If only an integer is provided, the kernel size will be (kernel_size, kernel_size). If a sequence of integer
             is provided, it must be a sequence of 2 values which represents (width, height).
-        sigma (Union[float, Sequence[float]], optional): Standard deviation of the Gaussian kernel to use
-            (default=None). The value must be positive. If only a float is provided, the sigma will be (sigma, sigma).
+        sigma (Union[float, Sequence[float]], optional): Standard deviation of the Gaussian kernel to use.
+            Default: None. The value must be positive. If only a float is provided, the sigma will be (sigma, sigma).
             If a sequence of float is provided, it must be a sequence of 2 values which represents (width, height).
             If None is provided, the sigma will be calculated as ((kernel_size - 1) * 0.5 - 1) * 0.3 + 0.8.
 
@@ -686,7 +685,7 @@ class HorizontalFlip(ImageTensorOperation):
     Flip the input image horizontally.
 
     Raises:
-        RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
+        RuntimeError: If given tensor shape is not <H, W> or <..., H, W, C>.
 
     Supported Platforms:
         ``CPU``
@@ -717,7 +716,7 @@ class HWC2CHW(ImageTensorOperation):
         RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
 
     Supported Platforms:
-        ``CPU`` ``Ascend`` ``GPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> transforms_list = [c_vision.Decode(),
@@ -738,7 +737,7 @@ class HWC2CHW(ImageTensorOperation):
 
 class Invert(ImageTensorOperation):
     """
-    Apply invert on input image in RGB mode. This operator will reassign every pixel to (255 - pixel).
+    Apply invert on input image in RGB mode. This operation will reassign every pixel to (255 - pixel).
 
     Raises:
         RuntimeError: If given tensor shape is not <H, W, C>.
@@ -769,10 +768,10 @@ class MixUpBatch(ImageTensorOperation):
     The lambda is generated based on the specified alpha value. Two coefficients x1, x2 are randomly generated
     in the range [alpha, 1], and lambda = (x1 / (x1 + x2)).
 
-    Note that you need to make labels into one-hot format and batched before calling this operator.
+    Note that you need to make labels into one-hot format and batched before calling this operation.
 
     Args:
-        alpha (float, optional): Hyperparameter of beta distribution. The value must be positive (default = 1.0).
+        alpha (float, optional): Hyperparameter of beta distribution. The value must be positive. Default: 1.0.
 
     Raises:
         TypeError: If `alpha` is not of type float.
@@ -803,7 +802,7 @@ class MixUpBatch(ImageTensorOperation):
 
 class Normalize(ImageTensorOperation):
     """
-    Normalize the input image with respect to mean and standard deviation. This operator will normalize
+    Normalize the input image with respect to mean and standard deviation. This operation will normalize
     the input image with: output[channel] = (input[channel] - mean[channel]) / std[channel], where channel >= 1.
 
     Note:
@@ -823,7 +822,7 @@ class Normalize(ImageTensorOperation):
         RuntimeError: If given tensor shape is not <H, W> or <...,H, W, C>.
 
     Supported Platforms:
-        ``CPU`` ``Ascend`` ``GPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> decode_op = c_vision.Decode()
@@ -852,7 +851,7 @@ class NormalizePad(ImageTensorOperation):
             The mean values must be in range (0.0, 255.0].
         std (sequence): List or tuple of standard deviations for each channel, with respect to channel order.
             The standard deviation values must be in range (0.0, 255.0].
-        dtype (str, optional): Set the dtype of the output image (default is "float32").
+        dtype (str, optional): Set the dtype of the output image. Default: "float32".
 
     Raises:
         TypeError: If `mean` is not of type sequence.
@@ -900,8 +899,8 @@ class Pad(ImageTensorOperation):
         fill_value (Union[int, tuple[int]], optional): The pixel intensity of the borders, only valid for
             padding_mode Border.CONSTANT. If it is a 3-tuple, it is used to fill R, G, B channels respectively.
             If it is an integer, it is used for all RGB channels.
-            The fill_value values must be in range [0, 255] (default=0).
-        padding_mode (Border, optional): The method of padding (default=Border.CONSTANT). Can be any of
+            The fill_value values must be in range [0, 255]. Default: 0.
+        padding_mode (Border, optional): The method of padding. Default: Border.CONSTANT. Can be any of
             [Border.CONSTANT, Border.EDGE, Border.REFLECT, Border.SYMMETRIC].
 
             - Border.CONSTANT, means it fills the border with constant values.
@@ -923,7 +922,7 @@ class Pad(ImageTensorOperation):
     Raises:
         TypeError: If `padding` is not of type int or Sequence[int].
         TypeError: If `fill_value` is not of type int or tuple[int].
-        TypeError: If `padding_mode` is not of type :class:`mindspore.dataset.vision.Border`.
+        TypeError: If `padding_mode` is not of type :class:`mindspore.dataset.vision.Border` .
         ValueError: If `padding` is negative.
         ValueError: If `fill_value` is not in range [0, 255].
         RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
@@ -960,7 +959,7 @@ class RandomAdjustSharpness(ImageTensorOperation):
             Degree of 0.0 gives a blurred image, degree of 1.0 gives the original image,
             and degree of 2.0 increases the sharpness by a factor of 2.
         prob (float, optional): Probability of the image being sharpness adjusted, which
-            must be in range of [0, 1] (default=0.5).
+            must be in range of [0, 1]. Default: 0.5.
 
     Raises:
         TypeError: If `degree` is not of type float.
@@ -997,7 +996,7 @@ class RandomAffine(ImageTensorOperation):
             If `degrees` is a number, the range will be (-degrees, degrees).
             If `degrees` is a sequence, it should be (min, max).
         translate (sequence, optional): Sequence (tx_min, tx_max, ty_min, ty_max) of minimum/maximum translation in
-            x(horizontal) and y(vertical) directions, range [-1.0, 1.0] (default=None).
+            x(horizontal) and y(vertical) directions, range [-1.0, 1.0]. Default: None.
             The horizontal and vertical shift is selected randomly from the range:
             (tx_min*width, tx_max*width) and (ty_min*height, ty_max*height), respectively.
             If a tuple or list of size 2, then a translate parallel to the X axis in the range of
@@ -1006,16 +1005,16 @@ class RandomAffine(ImageTensorOperation):
             (translate[0], translate[1]) and a translate parallel to the Y axis in the range of
             (translate[2], translate[3]) are applied.
             If None, no translation is applied.
-        scale (sequence, optional): Scaling factor interval, which must be non negative
-            (default=None, original scale is used).
-        shear (Union[int, float, sequence], optional): Range of shear factor, which must be positive (default=None).
+        scale (sequence, optional): Scaling factor interval, which must be non negative.
+            Default: None, original scale is used.
+        shear (Union[int, float, sequence], optional): Range of shear factor, which must be positive. Default: None.
             If a number, then a shear parallel to the X axis in the range of (-shear, +shear) is applied.
             If a tuple or list of size 2, then a shear parallel to the X axis in the range of (shear[0], shear[1])
             is applied.
             If a tuple or list of size 4, then a shear parallel to X axis in the range of (shear[0], shear[1])
             and a shear parallel to Y axis in the range of (shear[2], shear[3]) is applied.
             If None, no shear is applied.
-        resample (Inter, optional): An optional resampling filter (default=Inter.NEAREST).
+        resample (Inter, optional): An optional resampling filter. Default: Inter.NEAREST.
             It can be any of [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.AREA].
 
             - Inter.BILINEAR, means resample method is bilinear interpolation.
@@ -1028,14 +1027,14 @@ class RandomAffine(ImageTensorOperation):
 
         fill_value (Union[int, tuple[int]], optional): Optional fill_value to fill the area outside the transform
             in the output image. There must be three elements in tuple and the value of single element is [0, 255].
-            (default=0, filling is performed).
+            Default: 0, filling is performed.
 
     Raises:
         TypeError: If `degrees` is not of type int, float or sequence.
         TypeError: If `translate` is not of type sequence.
         TypeError: If `scale` is not of type sequence.
         TypeError: If `shear` is not of type int, float or sequence.
-        TypeError: If `resample` is not of type :class:`mindspore.dataset.vision.Inter`.
+        TypeError: If `resample` is not of type :class:`mindspore.dataset.vision.Inter` .
         TypeError: If `fill_value` is not of type int or tuple[int].
         ValueError: If `degrees` is negative.
         ValueError: If `translate` is not in range [-1.0, 1.0].
@@ -1107,11 +1106,11 @@ class RandomAutoContrast(ImageTensorOperation):
 
     Args:
         cutoff (float, optional): Percent of the lightest and darkest pixels to be cut off from
-            the histogram of the input image. The value must be in range of [0.0, 50.0) (default=0.0).
+            the histogram of the input image. The value must be in range of [0.0, 50.0). Default: 0.0.
         ignore (Union[int, sequence], optional): The background pixel values to be ignored, each of
-            which must be in range of [0, 255] (default=None).
+            which must be in range of [0, 255]. Default: None.
         prob (float, optional): Probability of the image being automatically contrasted, which
-            must be in range of [0, 1] (default=0.5).
+            must be in range of [0, 1]. Default: 0.5.
 
     Raises:
         TypeError: If `cutoff` is not of type float.
@@ -1154,7 +1153,7 @@ class RandomColor(ImageTensorOperation):
     Args:
          degrees (Sequence[float], optional): Range of random color adjustment degrees, which must be non-negative.
             It should be in (min, max) format. If min=max, then it is a
-            single fixed magnitude operation (default=(0.1, 1.9)).
+            single fixed magnitude operation. Default: (0.1, 1.9).
 
     Raises:
         TypeError: If `degrees` is not of type Sequence[float].
@@ -1187,19 +1186,19 @@ class RandomColorAdjust(ImageTensorOperation):
         This operation supports running on Ascend or GPU platforms by Offload.
 
     Args:
-        brightness (Union[float, Sequence[float]], optional): Brightness adjustment factor (default=(1, 1)).
+        brightness (Union[float, Sequence[float]], optional): Brightness adjustment factor. Default: (1, 1).
             Cannot be negative.
             If it is a float, the factor is uniformly chosen from the range [max(0, 1-brightness), 1+brightness].
             If it is a sequence, it should be [min, max] for the range.
-        contrast (Union[float, Sequence[float]], optional): Contrast adjustment factor (default=(1, 1)).
+        contrast (Union[float, Sequence[float]], optional): Contrast adjustment factor. Default: (1, 1).
             Cannot be negative.
             If it is a float, the factor is uniformly chosen from the range [max(0, 1-contrast), 1+contrast].
             If it is a sequence, it should be [min, max] for the range.
-        saturation (Union[float, Sequence[float]], optional): Saturation adjustment factor (default=(1, 1)).
+        saturation (Union[float, Sequence[float]], optional): Saturation adjustment factor. Default: (1, 1).
             Cannot be negative.
             If it is a float, the factor is uniformly chosen from the range [max(0, 1-saturation), 1+saturation].
             If it is a sequence, it should be [min, max] for the range.
-        hue (Union[float, Sequence[float]], optional): Hue adjustment factor (default=(0, 0)).
+        hue (Union[float, Sequence[float]], optional): Hue adjustment factor. Default: (0, 0).
             If it is a float, the range will be [-hue, hue]. Value should be 0 <= hue <= 0.5.
             If it is a sequence, it should be [min, max] where -0.5 <= min <= max <= 0.5.
 
@@ -1215,7 +1214,7 @@ class RandomColorAdjust(ImageTensorOperation):
         RuntimeError: If given tensor shape is not <H, W, C>.
 
     Supported Platforms:
-        ``CPU`` ``Ascend`` ``GPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> decode_op = c_vision.Decode()
@@ -1267,7 +1266,7 @@ class RandomCrop(ImageTensorOperation):
             If size is an integer, a square crop of size (size, size) is returned.
             If size is a sequence of length 2, an image of size (height, width) will be cropped.
         padding (Union[int, Sequence[int]], optional): The number of pixels to pad each border of the image.
-            The padding value(s) must be non-negative (default=None).
+            The padding value(s) must be non-negative. Default: None.
             If padding is not None, pad image first with padding values.
             If a single number is provided, pad all borders with this value.
             If a tuple or lists of 2 values are provided, pad the (left and top)
@@ -1275,12 +1274,12 @@ class RandomCrop(ImageTensorOperation):
             If 4 values are provided as a list or tuple,
             pad the left, top, right and bottom respectively.
         pad_if_needed (bool, optional): Pad the image if either side is smaller than
-            the given output size (default=False).
+            the given output size. Default: False.
         fill_value (Union[int, tuple[int]], optional): The pixel intensity of the borders, only valid for
             padding_mode Border.CONSTANT. If it is a 3-tuple, it is used to fill R, G, B channels respectively.
             If it is an integer, it is used for all RGB channels.
-            The fill_value values must be in range [0, 255] (default=0).
-        padding_mode (Border, optional): The method of padding (default=Border.CONSTANT). It can be any of
+            The fill_value values must be in range [0, 255]. Default: 0.
+        padding_mode (Border, optional): The method of padding. Default: Border.CONSTANT. It can be any of
             [Border.CONSTANT, Border.EDGE, Border.REFLECT, Border.SYMMETRIC].
 
             - Border.CONSTANT, means it fills the border with constant values.
@@ -1304,11 +1303,11 @@ class RandomCrop(ImageTensorOperation):
         TypeError: If `padding` is not of type int or Sequence[int].
         TypeError: If `pad_if_needed` is not of type boolean.
         TypeError: If `fill_value` is not of type int or tuple[int].
-        TypeError: If `padding_mode` is not of type :class:`mindspore.dataset.vision.Border`.
+        TypeError: If `padding_mode` is not of type :class:`mindspore.dataset.vision.Border` .
         ValueError: If `size` is not positive.
         ValueError: If `padding` is negative.
         ValueError: If `fill_value` is not in range [0, 255].
-        RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
+        RuntimeError: If given tensor shape is not <H, W> or <..., H, W, C>.
 
     Supported Platforms:
         ``CPU``
@@ -1347,7 +1346,7 @@ class RandomCrop(ImageTensorOperation):
 
 class RandomCropDecodeResize(ImageTensorOperation):
     """
-    A combination of `Crop`, `Decode` and `Resize`. It will get better performance for JPEG images. This operator
+    A combination of `Crop` , `Decode` and `Resize` . It will get better performance for JPEG images. This operation
     will crop the input image at a random location, decode the cropped image in RGB mode, and resize the decoded image.
 
     Args:
@@ -1355,10 +1354,10 @@ class RandomCropDecodeResize(ImageTensorOperation):
             If size is an integer, a square crop of size (size, size) is returned.
             If size is a sequence of length 2, an image of size (height, width) will be cropped.
         scale (Union[list, tuple], optional): Range [min, max) of respective size of the
-            original size to be cropped, which must be non-negative (default=(0.08, 1.0)).
+            original size to be cropped, which must be non-negative. Default: (0.08, 1.0).
         ratio (Union[list, tuple], optional): Range [min, max) of aspect ratio to be
-            cropped, which must be non-negative (default=(3. / 4., 4. / 3.)).
-        interpolation (Inter, optional): Image interpolation mode for resize operator(default=Inter.BILINEAR).
+            cropped, which must be non-negative. Default: (3. / 4., 4. / 3.).
+        interpolation (Inter, optional): Image interpolation mode for resize operation. Default: Inter.BILINEAR.
             It can be any of [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.AREA, Inter.PILCUBIC].
 
             - Inter.BILINEAR, means interpolation method is bilinear interpolation.
@@ -1372,14 +1371,14 @@ class RandomCropDecodeResize(ImageTensorOperation):
             - Inter.PILCUBIC, means interpolation method is bicubic interpolation like implemented in pillow, input
               should be in 3 channels format.
 
-        max_attempts (int, optional): The maximum number of attempts to propose a valid crop_area (default=10).
+        max_attempts (int, optional): The maximum number of attempts to propose a valid crop_area. Default: 10.
             If exceeded, fall back to use center_crop instead. The max_attempts value must be positive.
 
     Raises:
         TypeError: If `size` is not of type int or Sequence[int].
         TypeError: If `scale` is not of type tuple or list.
         TypeError: If `ratio` is not of type tuple or list.
-        TypeError: If `interpolation` is not of type :class:`mindspore.dataset.vision.Inter`.
+        TypeError: If `interpolation` is not of type :class:`mindspore.dataset.vision.Inter` .
         TypeError: If `max_attempts` is not of type int.
         ValueError: If `size` is not positive.
         ValueError: If `scale` is negative.
@@ -1437,19 +1436,19 @@ class RandomCropWithBBox(ImageTensorOperation):
             If size is an integer, a square crop of size (size, size) is returned.
             If size is a sequence of length 2, an image of size (height, width) will be cropped.
         padding (Union[int, Sequence[int]], optional): The number of pixels to pad the image
-            The padding value(s) must be non-negative (default=None).
+            The padding value(s) must be non-negative. Default: None.
             If padding is not None, first pad image with padding values.
             If a single number is provided, pad all borders with this value.
             If a tuple or lists of 2 values are provided, pad the (left and top)
             with the first value and (right and bottom) with the second value.
             If 4 values are provided as a list or tuple, pad the left, top, right and bottom respectively.
         pad_if_needed (bool, optional): Pad the image if either side is smaller than
-            the given output size (default=False).
+            the given output size. Default: False.
         fill_value (Union[int, tuple[int]], optional): The pixel intensity of the borders, only valid for
             padding_mode Border.CONSTANT. If it is a 3-tuple, it is used to fill R, G, B channels respectively.
             If it is an integer, it is used for all RGB channels.
-            The fill_value values must be in range [0, 255] (default=0).
-        padding_mode (Border, optional): The method of padding (default=Border.CONSTANT). It can be any of
+            The fill_value values must be in range [0, 255]. Default: 0.
+        padding_mode (Border, optional): The method of padding. Default: Border.CONSTANT. It can be any of
             [Border.CONSTANT, Border.EDGE, Border.REFLECT, Border.SYMMETRIC].
 
             - Border.CONSTANT, means it fills the border with constant values.
@@ -1473,7 +1472,7 @@ class RandomCropWithBBox(ImageTensorOperation):
         TypeError: If `padding` is not of type int or Sequence[int].
         TypeError: If `pad_if_needed` is not of type boolean.
         TypeError: If `fill_value` is not of type int or tuple[int].
-        TypeError: If `padding_mode` is not of type :class:`mindspore.dataset.vision.Border`.
+        TypeError: If `padding_mode` is not of type :class:`mindspore.dataset.vision.Border` .
         ValueError: If `size` is not positive.
         ValueError: If `padding` is negative.
         ValueError: If `fill_value` is not in range [0, 255].
@@ -1521,7 +1520,7 @@ class RandomEqualize(ImageTensorOperation):
 
     Args:
         prob (float, optional): Probability of the image being equalized, which
-            must be in range of [0, 1] (default=0.5).
+            must be in range of [0, 1]. Default: 0.5.
 
     Raises:
         TypeError: If `prob` is not of type float.
@@ -1554,7 +1553,7 @@ class RandomHorizontalFlip(ImageTensorOperation):
         This operation supports running on Ascend or GPU platforms by Offload.
 
     Args:
-        prob (float, optional): Probability of the image being flipped, which must be in range of [0, 1] (default=0.5).
+        prob (float, optional): Probability of the image being flipped, which must be in range of [0, 1]. Default: 0.5.
 
     Raises:
         TypeError: If `prob` is not of type float.
@@ -1562,7 +1561,7 @@ class RandomHorizontalFlip(ImageTensorOperation):
         RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
 
     Supported Platforms:
-        ``CPU`` ``Ascend`` ``GPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> transforms_list = [c_vision.Decode(), c_vision.RandomHorizontalFlip(0.75)]
@@ -1584,7 +1583,7 @@ class RandomHorizontalFlipWithBBox(ImageTensorOperation):
     Flip the input image horizontally randomly with a given probability and adjust bounding boxes accordingly.
 
     Args:
-        prob (float, optional): Probability of the image being flipped, which must be in range of [0, 1] (default=0.5).
+        prob (float, optional): Probability of the image being flipped, which must be in range of [0, 1]. Default: 0.5.
 
     Raises:
         TypeError: If `prob` is not of type float.
@@ -1614,7 +1613,7 @@ class RandomInvert(ImageTensorOperation):
     Randomly invert the colors of image with a given probability.
 
     Args:
-        prob (float, optional): Probability of the image being inverted, which must be in range of [0, 1] (default=0.5).
+        prob (float, optional): Probability of the image being inverted, which must be in range of [0, 1]. Default: 0.5.
 
     Raises:
         TypeError: If `prob` is not of type float.
@@ -1645,7 +1644,7 @@ class RandomLighting(ImageTensorOperation):
     calculated from the imagenet dataset.
 
     Args:
-        alpha (float, optional): Intensity of the image, which must be non-negative (default=0.05).
+        alpha (float, optional): Intensity of the image, which must be non-negative. Default: 0.05.
 
     Raises:
         TypeError: If `alpha` is not of type float.
@@ -1679,7 +1678,7 @@ class RandomPosterize(ImageTensorOperation):
             Bits values must be in range of [1,8], and include at
             least one integer value in the given range. It must be in
             (min, max) or integer format. If min=max, then it is a single fixed
-            magnitude operation (default=(8, 8)).
+            magnitude operation. Default: (8, 8).
 
     Raises:
         TypeError: If `bits` is not of type int or sequence of int.
@@ -1709,7 +1708,7 @@ class RandomPosterize(ImageTensorOperation):
 
 class RandomResizedCrop(ImageTensorOperation):
     """
-    This operator will crop the input image randomly, and resize the cropped image using a selected interpolation mode.
+    This operation will crop the input image randomly, and resize the cropped image using a selected interpolation mode.
 
     Note:
         If the input image is more than one, then make sure that the image size is the same.
@@ -1719,10 +1718,10 @@ class RandomResizedCrop(ImageTensorOperation):
             If size is an integer, a square of size (size, size) will be cropped with this value.
             If size is a sequence of length 2, an image of size (height, width) will be cropped.
         scale (Union[list, tuple], optional): Range [min, max) of respective size of the original
-            size to be cropped, which must be non-negative (default=(0.08, 1.0)).
+            size to be cropped, which must be non-negative. Default: (0.08, 1.0).
         ratio (Union[list, tuple], optional): Range [min, max) of aspect ratio to be
-            cropped, which must be non-negative (default=(3. / 4., 4. / 3.)).
-        interpolation (Inter, optional): Method of interpolation (default=Inter.BILINEAR).
+            cropped, which must be non-negative. Default: (3. / 4., 4. / 3.).
+        interpolation (Inter, optional): Method of interpolation. Default: Inter.BILINEAR.
             It can be any of [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.AREA, Inter.PILCUBIC].
 
             - Inter.BILINEAR, means interpolation method is bilinear interpolation.
@@ -1737,19 +1736,19 @@ class RandomResizedCrop(ImageTensorOperation):
               should be in 3 channels format.
 
         max_attempts (int, optional): The maximum number of attempts to propose a valid
-            crop_area (default=10). If exceeded, fall back to use center_crop instead.
+            crop_area. Default: 10. If exceeded, fall back to use center_crop instead.
 
     Raises:
         TypeError: If `size` is not of type int or Sequence[int].
         TypeError: If `scale` is not of type tuple or list.
         TypeError: If `ratio` is not of type tuple or list.
-        TypeError: If `interpolation` is not of type :class:`mindspore.dataset.vision.Inter`.
+        TypeError: If `interpolation` is not of type :class:`mindspore.dataset.vision.Inter` .
         TypeError: If `max_attempts` is not of type int.
         ValueError: If `size` is not positive.
         ValueError: If `scale` is negative.
         ValueError: If `ratio` is negative.
         ValueError: If `max_attempts` is not positive.
-        RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
+        RuntimeError: If given tensor shape is not <H, W> or <..., H, W, C>.
 
     Supported Platforms:
         ``CPU``
@@ -1790,10 +1789,10 @@ class RandomResizedCropWithBBox(ImageTensorOperation):
             If size is an integer, a square of size (size, size) will be cropped with this value.
             If size is a sequence of length 2, an image of size (height, width) will be cropped.
         scale (Union[list, tuple], optional): Range (min, max) of respective size of the original
-            size to be cropped, which must be non-negative (default=(0.08, 1.0)).
+            size to be cropped, which must be non-negative. Default: (0.08, 1.0).
         ratio (Union[list, tuple], optional): Range (min, max) of aspect ratio to be
-            cropped, which must be non-negative (default=(3. / 4., 4. / 3.)).
-        interpolation (Inter mode, optional): Method of interpolation (default=Inter.BILINEAR).
+            cropped, which must be non-negative. Default: (3. / 4., 4. / 3.).
+        interpolation (Inter mode, optional): Method of interpolation. Default: Inter.BILINEAR.
             It can be any of [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC] .
 
             - Inter.BILINEAR, means interpolation method is bilinear interpolation.
@@ -1803,13 +1802,13 @@ class RandomResizedCropWithBBox(ImageTensorOperation):
             - Inter.BICUBIC, means interpolation method is bicubic interpolation.
 
         max_attempts (int, optional): The maximum number of attempts to propose a valid
-            crop area (default=10). If exceeded, fall back to use center crop instead.
+            crop area. Default: 10. If exceeded, fall back to use center crop instead.
 
     Raises:
         TypeError: If `size` is not of type int or Sequence[int].
         TypeError: If `scale` is not of type tuple or list.
         TypeError: If `ratio` is not of type tuple or list.
-        TypeError: If `interpolation` is not of type :class:`mindspore.dataset.vision.Inter`.
+        TypeError: If `interpolation` is not of type :class:`mindspore.dataset.vision.Inter` .
         TypeError: If `max_attempts` is not of type int.
         ValueError: If `size` is not positive.
         ValueError: If `scale` is negative.
@@ -1935,7 +1934,7 @@ class RandomRotation(ImageTensorOperation):
         degrees (Union[int, float, sequence]): Range of random rotation degrees.
             If `degrees` is a number, the range will be converted to (-degrees, degrees).
             If `degrees` is a sequence, it should be (min, max).
-        resample (Inter, optional): An optional resampling filter (default=Inter.NEAREST).
+        resample (Inter, optional): An optional resampling filter. Default: Inter.NEAREST.
             It can be any of [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.AREA].
 
             - Inter.BILINEAR, means resample method is bilinear interpolation.
@@ -1944,22 +1943,22 @@ class RandomRotation(ImageTensorOperation):
 
             - Inter.BICUBIC, means resample method is bicubic interpolation.
 
-            - Inter.AREA: means the interpolation method is area interpolation.
+            - Inter.AREA: means the interpolation method is pixel area interpolation.
 
-        expand (bool, optional):  Optional expansion flag (default=False). If set to True, expand the output
+        expand (bool, optional):  Optional expansion flag. Default: False. If set to True, expand the output
             image to make it large enough to hold the entire rotated image.
             If set to False or omitted, make the output image the same size as the input.
             Note that the expand flag assumes rotation around the center and no translation.
-        center (tuple, optional): Optional center of rotation (a 2-tuple) (default=None).
+        center (tuple, optional): Optional center of rotation (a 2-tuple). Default: None.
             Origin is the top left corner. None sets to the center of the image.
         fill_value (Union[int, tuple[int]], optional): Optional fill color for the area outside the rotated image.
             If it is a 3-tuple, it is used to fill R, G, B channels respectively.
             If it is an integer, it is used for all RGB channels.
-            The fill_value values must be in range [0, 255] (default=0).
+            The fill_value values must be in range [0, 255]. Default: 0.
 
     Raises:
         TypeError: If `degrees` is not of type int, float or sequence.
-        TypeError: If `resample` is not of type :class:`mindspore.dataset.vision.Inter`.
+        TypeError: If `resample` is not of type :class:`mindspore.dataset.vision.Inter` .
         TypeError: If `expand` is not of type boolean.
         TypeError: If `center` is not of type tuple.
         TypeError: If `fill_value` is not of type int or tuple[int].
@@ -2063,7 +2062,7 @@ class RandomSharpness(ImageTensorOperation):
     Args:
         degrees (Union[list, tuple], optional): Range of random sharpness adjustment degrees,
             which must be non-negative. It should be in (min, max) format. If min=max, then
-            it is a single fixed magnitude operation (default = (0.1, 1.9)).
+            it is a single fixed magnitude operation. Default: (0.1, 1.9).
 
     Raises:
         TypeError : If `degrees` is not of type list or tuple.
@@ -2071,7 +2070,7 @@ class RandomSharpness(ImageTensorOperation):
         ValueError: If `degrees` is in (max, min) format instead of (min, max).
 
     Supported Platforms:
-        ``CPU`` ``Ascend`` ``GPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> transforms_list = [c_vision.Decode(), c_vision.RandomSharpness(degrees=(0.2, 1.9))]
@@ -2094,7 +2093,7 @@ class RandomSolarize(ImageTensorOperation):
     the subrange to (255 - pixel).
 
     Args:
-        threshold (tuple, optional): Range of random solarize threshold (default=(0, 255)).
+        threshold (tuple, optional): Range of random solarize threshold. Default: (0, 255).
             Threshold values should always be in (min, max) format,
             where min and max are integers in the range [0, 255], and min <= max.
             If min=max, then invert all pixel values above min(max).
@@ -2129,7 +2128,7 @@ class RandomVerticalFlip(ImageTensorOperation):
         This operation supports running on Ascend or GPU platforms by Offload.
 
     Args:
-        prob (float, optional): Probability of the image being flipped (default=0.5).
+        prob (float, optional): Probability of the image being flipped. Default: 0.5.
 
     Raises:
         TypeError: If `prob` is not of type float.
@@ -2137,7 +2136,7 @@ class RandomVerticalFlip(ImageTensorOperation):
         RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
 
     Supported Platforms:
-        ``CPU`` ``Ascend`` ``GPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> transforms_list = [c_vision.Decode(), c_vision.RandomVerticalFlip(0.25)]
@@ -2159,7 +2158,7 @@ class RandomVerticalFlipWithBBox(ImageTensorOperation):
     Flip the input image vertically, randomly with a given probability and adjust bounding boxes accordingly.
 
     Args:
-        prob (float, optional): Probability of the image being flipped (default=0.5).
+        prob (float, optional): Probability of the image being flipped. Default: 0.5.
 
     Raises:
         TypeError: If `prob` is not of type float.
@@ -2186,7 +2185,7 @@ class RandomVerticalFlipWithBBox(ImageTensorOperation):
 
 class Rescale(ImageTensorOperation):
     """
-    Rescale the input image with the given rescale and shift. This operator will rescale the input image
+    Rescale the input image with the given rescale and shift. This operation will rescale the input image
     with: output = image * rescale + shift.
 
     Note:
@@ -2201,7 +2200,7 @@ class Rescale(ImageTensorOperation):
         TypeError: If `shift` is not of type float.
 
     Supported Platforms:
-        ``CPU`` ``Ascend`` ``GPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> transforms_list = [c_vision.Decode(), c_vision.Rescale(1.0 / 255.0, -1.0)]
@@ -2228,7 +2227,7 @@ class Resize(ImageTensorOperation):
             If size is an integer, the smaller edge of the image will be resized to this value with
             the same image aspect ratio.
             If size is a sequence of length 2, it should be (height, width).
-        interpolation (Inter, optional): Image interpolation mode (default=Inter.LINEAR).
+        interpolation (Inter, optional): Image interpolation mode. Default: Inter.LINEAR.
             It can be any of [Inter.LINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.AREA, Inter.PILCUBIC].
 
             - Inter.LINEAR, means interpolation method is bilinear interpolation.
@@ -2244,7 +2243,7 @@ class Resize(ImageTensorOperation):
 
     Raises:
         TypeError: If `size` is not of type int or Sequence[int].
-        TypeError: If `interpolation` is not of type :class:`mindspore.dataset.vision.Inter`.
+        TypeError: If `interpolation` is not of type :class:`mindspore.dataset.vision.Inter` .
         ValueError: If `size` is not positive.
         RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
 
@@ -2281,7 +2280,7 @@ class ResizeWithBBox(ImageTensorOperation):
             If size is an integer, smaller edge of the image will be resized to this value with
             the same image aspect ratio.
             If size is a sequence of length 2, it should be (height, width).
-        interpolation (Inter, optional): Image interpolation mode (default=Inter.LINEAR).
+        interpolation (Inter, optional): Image interpolation mode. Default: Inter.LINEAR.
             It can be any of [Inter.LINEAR, Inter.NEAREST, Inter.BICUBIC].
 
             - Inter.LINEAR, means interpolation method is bilinear interpolation.
@@ -2292,7 +2291,7 @@ class ResizeWithBBox(ImageTensorOperation):
 
     Raises:
         TypeError: If `size` is not of type int or Sequence[int].
-        TypeError: If `interpolation` is not of type :class:`mindspore.dataset.vision.Inter`.
+        TypeError: If `interpolation` is not of type :class:`mindspore.dataset.vision.Inter` .
         ValueError: If `size` is not positive.
         RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
 
@@ -2356,32 +2355,32 @@ class Rotate(ImageTensorOperation):
     Args:
         degrees (Union[int, float]): Rotation degrees.
 
-        resample (Inter, optional): An optional resampling filter (default=Inter.NEAREST).
+        resample (Inter, optional): An optional resampling filter. Default: Inter.NEAREST.
             It can be any of [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC].
 
             - Inter.BILINEAR, means resample method is bilinear interpolation.
             - Inter.NEAREST, means resample method is nearest-neighbor interpolation.
             - Inter.BICUBIC, means resample method is bicubic interpolation.
 
-        expand (bool, optional):  Optional expansion flag (default=False). If set to True, expand the output
+        expand (bool, optional):  Optional expansion flag. Default: False. If set to True, expand the output
             image to make it large enough to hold the entire rotated image.
             If set to False or omitted, make the output image the same size as the input.
             Note that the expand flag assumes rotation around the center and no translation.
-        center (tuple, optional): Optional center of rotation (a 2-tuple) (default=None).
+        center (tuple, optional): Optional center of rotation (a 2-tuple). Default: None.
             Origin is the top left corner. None sets to the center of the image.
         fill_value (Union[int, tuple[int]], optional): Optional fill color for the area outside the rotated image.
             If it is a 3-tuple, it is used to fill R, G, B channels respectively.
             If it is an integer, it is used for all RGB channels.
-            The fill_value values must be in range [0, 255] (default=0).
+            The fill_value values must be in range [0, 255]. Default: 0.
 
     Raises:
         TypeError: If `degrees` is not of type int or float.
-        TypeError: If `resample` is not of type :class:`mindspore.dataset.vision.Inter`.
+        TypeError: If `resample` is not of type :class:`mindspore.dataset.vision.Inter` .
         TypeError: If `expand` is not of type bool.
         TypeError: If `center` is not of type tuple.
         TypeError: If `fill_value` is not of type int or tuple[int].
         ValueError: If `fill_value` is not in range [0, 255].
-        RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
+        RuntimeError: If given tensor shape is not <H, W> or <..., H, W, C>.
 
     Supported Platforms:
         ``CPU``
@@ -2425,18 +2424,18 @@ class SlicePatches(ImageTensorOperation):
     number of output tensors is equal to num_height*num_width.
 
     Args:
-        num_height (int, optional): The number of patches in vertical direction, which must be positive (default=1).
-        num_width (int, optional): The number of patches in horizontal direction, which must be positive (default=1).
-        slice_mode (Inter, optional): A mode represents pad or drop (default=SliceMode.PAD).
+        num_height (int, optional): The number of patches in vertical direction, which must be positive. Default: 1.
+        num_width (int, optional): The number of patches in horizontal direction, which must be positive. Default: 1.
+        slice_mode (Inter, optional): A mode represents pad or drop. Default: SliceMode.PAD.
             It can be any of [SliceMode.PAD, SliceMode.DROP].
         fill_value (int, optional): The border width in number of pixels in
             right and bottom direction if slice_mode is set to be SliceMode.PAD.
-            The fill_value must be in range [0, 255] (default=0).
+            The fill_value must be in range [0, 255]. Default: 0.
 
     Raises:
         TypeError: If `num_height` is not of type int.
         TypeError: If `num_width` is not of type int.
-        TypeError: If `slice_mode` is not of type :class:`mindspore.dataset.vision.Inter`.
+        TypeError: If `slice_mode` is not of type :class:`mindspore.dataset.vision.Inter` .
         TypeError: If `fill_value` is not of type int.
         ValueError: If `num_height` is not positive.
         ValueError: If `num_width` is not positive.
@@ -2455,7 +2454,7 @@ class SlicePatches(ImageTensorOperation):
         >>> cols = ['img' + str(x) for x in range(num_h*num_w)]
         >>> image_folder_dataset = image_folder_dataset.map(operations=transforms_list,
         ...                                                 input_columns=["image"],
-        ...                                                 output_columns=cols, column_order=cols)
+        ...                                                 output_columns=cols)
     """
 
     @deprecated_c_vision()
@@ -2473,7 +2472,7 @@ class SlicePatches(ImageTensorOperation):
 
 class SoftDvppDecodeRandomCropResizeJpeg(ImageTensorOperation):
     """
-    A combination of `Crop`, `Decode` and `Resize` using the simulation algorithm of Ascend series chip DVPP module.
+    A combination of `Crop` , `Decode` and `Resize` using the simulation algorithm of Ascend series chip DVPP module.
 
     The usage scenario is consistent with SoftDvppDecodeResizeJpeg.
     The input image size should be in range [32*32, 8192*8192].
@@ -2489,10 +2488,10 @@ class SoftDvppDecodeRandomCropResizeJpeg(ImageTensorOperation):
             If size is an integer, a square crop of size (size, size) is returned.
             If size is a sequence of length 2, an image of size (height, width) will be cropped.
         scale (Union[list, tuple], optional): Range [min, max) of respective size of the
-            original size to be cropped, which must be non-negative (default=(0.08, 1.0)).
+            original size to be cropped, which must be non-negative. Default: (0.08, 1.0).
         ratio (Union[list, tuple], optional): Range [min, max) of aspect ratio to be
-            cropped, which must be non-negative (default=(3. / 4., 4. / 3.)).
-        max_attempts (int, optional): The maximum number of attempts to propose a valid crop_area (default=10).
+            cropped, which must be non-negative. Default: (3. / 4., 4. / 3.).
+        max_attempts (int, optional): The maximum number of attempts to propose a valid crop_area. Default: 10.
             If exceeded, fall back to use center_crop instead. The max_attempts value must be positive.
 
     Raises:
@@ -2565,11 +2564,11 @@ class UniformAugment(ImageTensorOperation):
     Args:
         transforms (TensorOperation): C++ transformation operation to be applied on random selection
             of bounding box regions of a given image (Python operations are not accepted).
-        num_ops (int, optional): Number of operations to be selected and applied, which must be positive (default=2).
+        num_ops (int, optional): Number of operations to be selected and applied, which must be positive. Default: 2.
 
     Raises:
         TypeError: If `transform` is not an image processing operation
-            in :class:`mindspore.dataset.vision.c_transforms`.
+            in :class:`mindspore.dataset.vision.c_transforms` .
         TypeError: If `num_ops` is not of type int.
         ValueError: If `num_ops` is not positive.
 
@@ -2611,7 +2610,7 @@ class VerticalFlip(ImageTensorOperation):
     Flip the input image vertically.
 
     Raises:
-        RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
+        RuntimeError: If given tensor shape is not <H, W> or <..., H, W, C>.
 
     Supported Platforms:
         ``CPU``