mindspore 1.10.0__cp37-cp37m-win_amd64.whl → 2.0.0rc1__cp37-cp37m-win_amd64.whl

mindspore/dataset/vision/transforms.py

@@ -98,18 +98,18 @@ class ImageTensorOperation(TensorOperation):
 
 
 class AdjustBrightness(ImageTensorOperation, PyTensorOperation):
-    r"""
-    Apdjust brightness of input image. Input image is expected to be in [H, W, C] format.
+    """
+    Adjust the brightness of the input image.
 
     Args:
-        brightness_factor (float): How much to adjust the brightness. Can be any non negative number.
+        brightness_factor (float): How much to adjust the brightness, must be non negative.
             0 gives a black image, 1 gives the original image,
             while 2 increases the brightness by a factor of 2.
 
     Raises:
         TypeError: If `brightness_factor` is not of type float.
         ValueError: If `brightness_factor` is less than 0.
-        RuntimeError: If given tensor shape is not <H, W, C>.
+        RuntimeError: If shape of the input image is not <H, W, C>.
 
     Supported Platforms:
         ``CPU``
@@ -142,18 +142,18 @@ class AdjustBrightness(ImageTensorOperation, PyTensorOperation):
 
 
 class AdjustContrast(ImageTensorOperation, PyTensorOperation):
-    r"""
-    Adjust contrast of input image. Input image is expected to be in [H, W, C] format.
+    """
+    Adjust the contrast of the input image.
 
     Args:
-        contrast_factor (float): How much to adjust the contrast. Can be any non negative number.
+        contrast_factor (float): How much to adjust the contrast, must be non negative.
             0 gives a solid gray image, 1 gives the original image,
             while 2 increases the contrast by a factor of 2.
 
     Raises:
         TypeError: If `contrast_factor` is not of type float.
         ValueError: If `contrast_factor` is less than 0.
-        RuntimeError: If given tensor shape is not <H, W, C>.
+        RuntimeError: If shape of the input image is not <H, W, C>.
 
     Supported Platforms:
         ``CPU``
@@ -187,7 +187,7 @@ class AdjustContrast(ImageTensorOperation, PyTensorOperation):
 
 class AdjustGamma(ImageTensorOperation, PyTensorOperation):
     r"""
-    Apply gamma correction on input image. Input image is expected to be in [..., H, W, C] or [H, W] format.
+    Apply gamma correction on input image. Input image is expected to be in <..., H, W, C> or <H, W> format.
 
     .. math::
         I_{\text{out}} = 255 \times \text{gain} \times \left(\frac{I_{\text{in}}}{255}\right)^{\gamma}
@@ -201,7 +201,7 @@ class AdjustGamma(ImageTensorOperation, PyTensorOperation):
             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.
@@ -242,17 +242,17 @@ class AdjustGamma(ImageTensorOperation, PyTensorOperation):
 
 
 class AdjustHue(ImageTensorOperation, PyTensorOperation):
-    r"""
-    Adjust hue of input image. Input image is expected to be in [H, W, C] format.
+    """
+    Adjust the hue of the input image.
 
     Args:
         hue_factor (float): How much to add to the hue channel,
-            must be in the interval [-0.5, 0.5].
+            must be in range of [-0.5, 0.5].
 
     Raises:
         TypeError: If `hue_factor` is not of type float.
         ValueError: If `hue_factor` is not in the interval [-0.5, 0.5].
-        RuntimeError: If given tensor shape is not <H, W, C>.
+        RuntimeError: If shape of the input image is not <H, W, C>.
 
     Supported Platforms:
         ``CPU``
@@ -285,17 +285,18 @@ class AdjustHue(ImageTensorOperation, PyTensorOperation):
 
 
 class AdjustSaturation(ImageTensorOperation, PyTensorOperation):
-    r"""
-    Adjust saturation of input image. Input image is expected to be in [H, W, C] format.
+    """
+    Adjust the saturation of the input image.
 
     Args:
-        saturation_factor (float): How much to adjust the saturation. Can be any non negative number.
+        saturation_factor (float): How much to adjust the saturation, must be non negative.
             0 gives a black image, 1 gives the original image while 2 increases the saturation by a factor of 2.
 
     Raises:
         TypeError: If `saturation_factor` is not of type float.
         ValueError: If `saturation_factor` is less than 0.
-        RuntimeError: If given tensor shape is not <H, W, C> or channel is not 3.
+        RuntimeError: If shape of the input image is not <H, W, C>.
+        RuntimeError: If channel of the input image is not 3.
 
     Supported Platforms:
         ``CPU``
@@ -328,18 +329,18 @@ class AdjustSaturation(ImageTensorOperation, PyTensorOperation):
 
 
 class AdjustSharpness(ImageTensorOperation):
-    r"""
-    Adjust sharpness of input image. Input image is expected to be in [H, W, C] or [H, W] format.
+    """
+    Adjust the sharpness of the input image.
 
     Args:
-        sharpness_factor (float): How much to adjust the sharpness, should be a
-            non negative number. 0 gives a blurred image, 1 gives the
-            original image while 2 increases the Sharpness by a factor of 2.
+        sharpness_factor (float): How much to adjust the sharpness, must be
+            non negative. 0 gives a blurred image, 1 gives the
+            original image while 2 increases the sharpness by a factor of 2.
 
     Raises:
         TypeError: If `sharpness_factor` is not of type float.
         ValueError: If `sharpness_factor` is less than 0.
-        RuntimeError: If given tensor shape is not <H, W, C> or <H, W>.
+        RuntimeError: If shape of the input image is not <H, W> or <H, W, C>.
 
     Supported Platforms:
         ``CPU``
@@ -366,13 +367,11 @@ class Affine(ImageTensorOperation):
 
     Args:
         degrees (float): Rotation angle in degrees between -180 and 180, clockwise direction.
-        translate (Sequence): The horizontal and vertical translations, must be a sequence of size 2.
+        translate (Sequence[float, float]): The horizontal and vertical translations, must be a sequence of size 2.
         scale (float): Scaling factor, which must be positive.
-        shear (Union[float, Sequence]): Shear angle value in degrees between -180 to 180.
-            If a number is provided, a shearing parallel to X axis with a factor selected from
-            (- `shear` , `shear` ) will be applied.
-            If a sequence is provided, a shearing parallel to X axis with a factor selected
-            from ( `shear` [0], `shear` [1]) will be applied.
+        shear (Union[float, Sequence[float, float]]): Shear angle value in degrees between -180 to 180.
+            If float is provided, shear along the x axis with this value, without shearing along the y axis;
+            If Sequence[float, float] is provided, shear along the x axis and y axis with these two values separately.
         resample (Inter, optional): An optional resampling filter. Default: Inter.NEAREST.
             It can be any of [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.AREA].
 
@@ -392,11 +391,11 @@ class Affine(ImageTensorOperation):
         TypeError: If `degrees` is not of type float.
         TypeError: If `translate` is not of type Sequence[float, float].
         TypeError: If `scale` is not of type float.
+        ValueError: If `scale` is non positive.
         TypeError: If `shear` is not of float or Sequence[float, float].
         TypeError: If `resample` is not of type :class:`mindspore.dataset.vision.Inter` .
         TypeError: If `fill_value` is not of type int or tuple[int, int, int].
-        ValueError: If `scale` is non positive.
-        RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
+        RuntimeError: If shape of the input image is not <H, W> or <H, W, C>.
 
     Supported Platforms:
         ``CPU``
@@ -437,12 +436,12 @@ class Affine(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.
 
@@ -452,7 +451,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.
@@ -461,16 +460,16 @@ 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.
+        fill_value (Union[int, tuple[int]], 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.
-        TypeError: If `interpolation` is not of type Inter.
+        TypeError: If `policy` is not of type :class:`mindspore.dataset.vision.AutoAugmentPolicy` .
+        TypeError: If `interpolation` is not of type :class:`mindspore.dataset.vision.Inter` .
         TypeError: If `fill_value` is not an integer or a tuple of length 3.
         RuntimeError: If given tensor shape is not <H, W, C>.
 
@@ -504,14 +503,14 @@ class AutoAugment(ImageTensorOperation):
 
 class AutoContrast(ImageTensorOperation, PyTensorOperation):
     """
-    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.
@@ -564,12 +563,12 @@ class BoundingBoxAugment(ImageTensorOperation):
         transform (TensorOperation): 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, 1] (default=0.3).
+            Range: [0.0, 1.0]. Default: 0.3.
 
     Raises:
-        TypeError: If `transform` is an image processing operation in :class:`mindspore.dataset.vision.transforms`.
+        TypeError: If `transform` is an image processing operation in `mindspore.dataset.vision` .
         TypeError: If `ratio` is not of type float.
-        ValueError: If `ratio` is not in range [0, 1].
+        ValueError: If `ratio` is not in range [0.0, 1.0].
         RuntimeError: If given bounding box is invalid.
 
     Supported Platforms:
@@ -581,8 +580,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"])
     """
 
     @check_bounding_box_augment_cpp
@@ -614,7 +612,7 @@ class CenterCrop(ImageTensorOperation, PyTensorOperation):
     Raises:
         TypeError: If `size` is not of type integer 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``
@@ -702,7 +700,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.transforms.ConvertMode`.
+        TypeError: If `convert_mode` is not of type :class:`mindspore.dataset.vision.ConvertMode` .
         RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
 
     Supported Platforms:
@@ -776,20 +774,21 @@ 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,
+            which must be in range: [0.0, 1.0]. 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.
-        ValueError: If `prob` is not in range [0, 1].
+        ValueError: If `prob` is not in range [0.0, 1.0].
         RuntimeError: If given tensor shape is not <H, W, C>.
 
     Supported Platforms:
@@ -824,7 +823,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.
         is_hwc (bool, optional): Whether the input image is in HWC format.
             True - HWC format, False - CHW format. Default: True.
 
@@ -861,10 +860,11 @@ class CutOut(ImageTensorOperation):
 class Decode(ImageTensorOperation, PyTensorOperation):
     """
     Decode the input image in RGB mode.
-    Supported image formats: JPEG, BMP, PNG, TIFF, GIF(need `to_pil=True`), WEBP(need `to_pil=True`).
+    Supported image formats: JPEG, BMP, PNG, TIFF, GIF(need `to_pil=True` ), WEBP(need `to_pil=True` ).
 
     Args:
-        to_pil (bool, optional): decode to PIL Image (default=False).
+        to_pil (bool, optional): Whether to decode the image to the PIL data type. If True, the image will be decoded
+            to the PIL data type, otherwise it will be decoded to the NumPy data type. Default: False.
 
     Raises:
         RuntimeError: If given tensor is not a 1D sequence.
@@ -972,20 +972,24 @@ class Erase(ImageTensorOperation):
         left (int): Horizontal ordinate of the upper left corner of erased region.
         height (int): Height of erased region.
         width (int): Width of erased region.
-        value (Union[int, Sequence[int]], optional): Pixel value used to pad the erased area.
-            If a single integer is provided, it will be used for all RGB channels.
-            If a sequence of length 3 is provided, it will be used for R, G, B channels respectively.
-            Default: 0.
+        value (Union[int, Sequence[int, int, int]], optional): Pixel value used to pad the erased area. Default: 0.
+            If int is provided, it will be used for all RGB channels.
+            If Sequence[int, int, int] is provided, it will be used for R, G, B channels respectively.
         inplace (bool, optional): Whether to apply erasing inplace. Default: False.
 
     Raises:
         TypeError: If `top` is not of type int.
+        ValueError: If `top` is negative.
         TypeError: If `left` is not of type int.
+        ValueError: If `left` is negative.
         TypeError: If `height` is not of type int.
+        ValueError: If `height` is not positive.
         TypeError: If `width` is not of type int.
-        TypeError: If `value` is not of type int or Sequence[int].
+        ValueError: If `width` is not positive.
+        TypeError: If `value` is not of type int or Sequence[int, int, int].
+        ValueError: If `value` is not in range of [0, 255].
         TypeError: If `inplace` is not of type bool.
-        RuntimeError: If given tensor shape is not <H, W, C>.
+        RuntimeError: If shape of the input image is not <H, W, C>.
 
     Supported Platforms:
         ``CPU``
@@ -1069,8 +1073,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.
 
@@ -1158,7 +1162,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``
@@ -1182,8 +1186,8 @@ class HsvToRgb(PyTensorOperation):
     Convert the input numpy.ndarray images from HSV to RGB.
 
     Args:
-        is_hwc (bool): If True, means the input image is in shape of (H, W, C) or (N, H, W, C).
-            Otherwise, it is in shape of (C, H, W) or (N, C, H, W). Default: False.
+        is_hwc (bool): If True, means the input image is in shape of <H, W, C> or <N, H, W, C>.
+            Otherwise, it is in shape of <C, H, W> or <N, C, H, W>. Default: False.
 
     Raises:
         TypeError: If `is_hwc` is not of type bool.
@@ -1225,7 +1229,7 @@ class HsvToRgb(PyTensorOperation):
 
 class HWC2CHW(ImageTensorOperation):
     """
-    Transpose the input image from shape (H, W, C) to (C, H, W).
+    Transpose the input image from shape <H, W, C> to <C, H, W>.
     If the input image is of shape <H, W>, it will remain unchanged.
 
     Note:
@@ -1257,7 +1261,7 @@ class HWC2CHW(ImageTensorOperation):
 
 class Invert(ImageTensorOperation, PyTensorOperation):
     """
-    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>.
@@ -1301,12 +1305,12 @@ class LinearTransformation(PyTensorOperation):
 
     Args:
         transformation_matrix (numpy.ndarray): A square transformation matrix in shape of (D, D), where
-            :math:`D = C \times H \times W`.
-        mean_vector (numpy.ndarray): A mean vector in shape of (D,), where :math:`D = C \times H \times W`.
+            :math:`D = C \times H \times W` .
+        mean_vector (numpy.ndarray): A mean vector in shape of (D,), where :math:`D = C \times H \times W` .
 
     Raises:
-        TypeError: If `transformation_matrix` is not of type :class:`numpy.ndarray`.
-        TypeError: If `mean_vector` is not of type :class:`numpy.ndarray`.
+        TypeError: If `transformation_matrix` is not of type :class:`numpy.ndarray` .
+        TypeError: If `mean_vector` is not of type :class:`numpy.ndarray` .
 
     Supported Platforms:
         ``CPU``
@@ -1341,7 +1345,7 @@ class LinearTransformation(PyTensorOperation):
         Execute method.
 
         Args:
-            np_img (numpy.ndarray): Image in shape of (C, H, W) to be linearly transformed.
+            np_img (numpy.ndarray): Image in shape of <C, H, W> to be linearly transformed.
 
         Returns:
             numpy.ndarray, linearly transformed image.
@@ -1353,9 +1357,9 @@ class MixUp(PyTensorOperation):
     """
     Randomly mix up a batch of numpy.ndarray images together with its labels.
 
-    Each image will be multiplied by a random weight lambda generated from the Beta distribution and then added
-    to another image multiplied by 1 - lambda. The same transformation will be applied to their labels with the
-    same value of lambda. Make sure that the labels are one-hot encoded in advance.
+    Each image will be multiplied by a random weight :math:`lambda` generated from the Beta distribution and then added
+    to another image multiplied by :math:`1 - lambda`. The same transformation will be applied to their labels with the
+    same value of :math:`lambda`. Make sure that the labels are one-hot encoded in advance.
 
     Args:
         batch_size (int): The number of images in a batch.
@@ -1430,10 +1434,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.
@@ -1465,7 +1469,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:
@@ -1485,7 +1489,7 @@ class Normalize(ImageTensorOperation):
         TypeError: If `is_hwc` is not of type bool.
         ValueError: If `mean` is not in range [0.0, 255.0].
         ValueError: If `std` is not in range (0.0, 255.0].
-        RuntimeError: If given tensor format is not <H, W> or <...,H, W, C>.
+        RuntimeError: If given tensor format is not <H, W> or <..., H, W, C>.
 
     Supported Platforms:
         ``CPU``
@@ -1520,7 +1524,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 output data type of normalized image (default is "float32").
+        dtype (str, optional): Set the output data type of normalized image. Default: "float32".
         is_hwc (bool, optional): Whether the input image is HWC.
             True - HWC format, False - CHW format. Default: True.
 
@@ -1568,15 +1572,15 @@ class Pad(ImageTensorOperation, PyTensorOperation):
         padding (Union[int, Sequence[int, int], Sequence[int, int, int, int]]): The number of pixels
             to pad each border of the image.
             If a single number is provided, it pads all borders with this value.
-            If a tuple or lists of 2 values are provided, it pads the (left and top)
-            with the first value and (right and bottom) with the second value.
+            If a tuple or lists of 2 values are provided, it pads the (left and right)
+            with the first value and (top and bottom) with the second value.
             If 4 values are provided as a list or tuple, it pads the left, top, right and bottom respectively.
             The pad values must be non-negative.
         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.
@@ -1589,16 +1593,10 @@ class Pad(ImageTensorOperation, PyTensorOperation):
             - Border.SYMMETRIC, means it reflects the values on the edge repeating the last
               value of edge.
 
-    Note:
-        The behavior when `padding` is a sequence of length 2 will change from padding left/top with
-        the first value and right/bottom with the second, to padding left/right with the first one
-        and top/bottom with the second in the future. Or you can pass in a 4-element sequence to specify
-        left, top, right and bottom respectively.
-
     Raises:
-        TypeError: If `padding` is not of type int or Sequence[int, int], Sequence[int, int, int, int]].
+        TypeError: If `padding` is not of type int or Sequence[int, int], Sequence[int, int, int, 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>.
@@ -1656,7 +1654,7 @@ class PadToSize(ImageTensorOperation):
             If int is provided, it will be used for all RGB channels.
             If tuple[int, int, int] is provided, it will be used for R, G, B channels respectively. Default: 0.
         padding_mode (Border, optional): Method of padding. It can be Border.CONSTANT, Border.EDGE, Border.REFLECT
-            or Border.SYMMETRIC. Default: Border.CONSTANT. Default: Border.CONSTANT.
+            or Border.SYMMETRIC. Default: Border.CONSTANT.
 
             - Border.CONSTANT, pads with a constant value.
             - Border.EDGE, pads with the last value at the edge of the image.
@@ -1667,7 +1665,7 @@ class PadToSize(ImageTensorOperation):
         TypeError: If `size` is not of type int or Sequence[int, int].
         TypeError: If `offset` is not of type int or Sequence[int, int].
         TypeError: If `fill_value` is not of type int or tuple[int, int, 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 `offset` is negative.
         ValueError: If `fill_value` is not in range of [0, 255].
@@ -1703,29 +1701,29 @@ class Perspective(ImageTensorOperation, PyTensorOperation):
     Apply perspective transformation on input image.
 
     Args:
-        start_points (Sequence[Sequence[int, int]]): List containing four lists of two integers corresponding to four
-            corners [top-left, top-right, bottom-right, bottom-left] of the original image.
-        end_points (Sequence[Sequence[int, int]]): List containing four lists of two integers corresponding to four
-            corners [top-left, top-right, bottom-right, bottom-left] of the transformed image.
+        start_points (Sequence[Sequence[int, int]]): Sequence of the starting point coordinates, containing four
+            two-element subsequences, corresponding to [top-left, top-right, bottom-right, bottom-left] of the
+            quadrilateral in the original image.
+        end_points (Sequence[Sequence[int, int]]): Sequence of the ending point coordinates, containing four
+            two-element subsequences, corresponding to [top-left, top-right, bottom-right, bottom-left] of the
+            quadrilateral in the target image.
         interpolation (Inter, optional): Method of interpolation. It can be Inter.BILINEAR, Inter.LINEAR,
             Inter.NEAREST, Inter.AREA, Inter.PILCUBIC, Inter.CUBIC or Inter.BICUBIC. Default: Inter.BILINEAR.
 
             - Inter.BILINEAR, bilinear interpolation.
-            - Inter.LINEAR, bilinear interpolation, here is the same as Inter.BILINEAR.
+            - Inter.LINEAR, linear interpolation, the same as Inter.BILINEAR.
             - Inter.NEAREST, nearest-neighbor interpolation.
             - Inter.BICUBIC, bicubic interpolation.
-            - Inter.CUBIC: means the interpolation method is bicubic interpolation, here is the same as Inter.BICUBIC.
-            - Inter.PILCUBIC, means interpolation method is bicubic interpolation like implemented in pillow, input
-              should be in 3 channels format.(PIL input is not supported)
-            - Inter.AREA, area interpolation.(PIL input is not supported)
+            - Inter.CUBIC, cubic interpolation, the same as Inter.BICUBIC.
+            - Inter.PILCUBIC, cubic interpolation based on the implementation of Pillow,
+              only numpy.ndarray input is supported.
+            - Inter.AREA, pixel area interpolation, only numpy.ndarray input is supported.
 
     Raises:
-        TypeError: If `start_points` is not of type Sequence[Sequence[int, int]] of length 4.
-        TypeError: If element in `start_points` is not of type Sequence[int, int] of length 2.
-        TypeError: If `end_points` is not of type Sequence[Sequence[int, int]] of length 4.
-        TypeError: If element in `end_points` is not of type Sequence[int, int] of length 2.
-        TypeError: If `interpolation` is not of type :class:`mindspore.dataset.vision.Inter`.
-        RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
+        TypeError: If `start_points` is not of type Sequence[Sequence[int, int]].
+        TypeError: If `end_points` is not of type Sequence[Sequence[int, int]].
+        TypeError: If `interpolation` is not of type :class:`mindspore.dataset.vision.Inter` .
+        RuntimeError: If shape of the input image is not <H, W> or <H, W, C>.
 
     Supported Platforms:
         ``CPU``
@@ -1760,7 +1758,7 @@ class Perspective(ImageTensorOperation, PyTensorOperation):
             raise TypeError("Current Interpolation is not supported with NumPy input.")
         return cde.PerspectiveOperation(self.start_points, self.end_points, Inter.to_c_type(self.interpolation))
 
-    def execute_py(self, img):
+    def _execute_py(self, img):
         """
         Execute method.
 
@@ -1777,7 +1775,8 @@ class Perspective(ImageTensorOperation, PyTensorOperation):
 
 class Posterize(ImageTensorOperation):
     """
-    Posterize an image by reducing the number of bits for each color channel.
+    Reduce the bit depth of the color channels of image to create a high contrast and vivid color effect,
+    similar to that seen in posters or printed materials.
 
     Args:
         bits (int): The number of bits to keep for each channel, should be in range of [0, 8].
@@ -1785,7 +1784,7 @@ class Posterize(ImageTensorOperation):
     Raises:
         TypeError: If `bits` is not of type int.
         ValueError: If `bits` is not in range [0, 8].
-        RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
+        RuntimeError: If shape of the input image is not <H, W> or <H, W, C>.
     """
 
     @check_posterize
@@ -1800,39 +1799,42 @@ class Posterize(ImageTensorOperation):
 
 class RandAugment(ImageTensorOperation):
     """
-    Apply RandAugment data augmentation method based on
-    `RandAugment: Learning Augmentation Strategies from Data <https://arxiv.org/pdf/1909.13719.pdf>`.
-    This operation works only with 3-channel RGB images.
-
-    Args:
-        num_ops (int, optional): Number of augmentation transformations to apply sequentially. Default: 2.
-        magnitude (int, optional): Magnitude for all the transformations and its value should be smaller than the value
-            of num_magnitude_bins. Default: 9.
-        num_magnitude_bins (int, optional): The number of different magnitude values. The number of different magnitude
-            values, must be greater than or equal to 2. Default: 31.
-        interpolation (Inter, optional): Image interpolation mode for Resize operator.
-            It can be any of [Inter.NEAREST, Inter.BILINEAR, Inter.BICUBIC, Inter.AREA]. Default: Inter.NEAREST.
+    Apply RandAugment data augmentation method on the input image.
 
-            - Inter.NEAREST: means interpolation method is nearest-neighbor interpolation.
+    Refer to `RandAugment: Learning Augmentation Strategies from Data <https://arxiv.org/pdf/1909.13719.pdf>`_ .
 
-            - Inter.BILINEAR: means interpolation method is bilinear interpolation.
+    Only support 3-channel RGB image.
 
-            - Inter.BICUBIC: means the interpolation method is bicubic interpolation.
+    Args:
+        num_ops (int, optional): Number of augmentation transformations to apply sequentially. Default: 2.
+        magnitude (int, optional): Magnitude for all the transformations, must be smaller than
+            `num_magnitude_bins`. Default: 9.
+        num_magnitude_bins (int, optional): The number of different magnitude values,
+            must be no less than 2. Default: 31.
+        interpolation (Inter, optional): Image interpolation method. Default: Inter.NEAREST.
+            It can be Inter.NEAREST, Inter.BILINEAR, Inter.BICUBIC or Inter.AREA.
 
-            - Inter.AREA: means the interpolation method is area interpolation.
+            - Inter.NEAREST, nearest-neighbor interpolation.
+            - Inter.BILINEAR, bilinear interpolation.
+            - Inter.BICUBIC, bicubic interpolation.
+            - Inter.AREA, pixel area interpolation.
 
-        fill_value (Union[int, tuple[int, int, int]], 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.
+        fill_value (Union[int, tuple[int, int, int]], optional): Pixel fill value for the area outside the
+            transformed image, must be in range of [0, 255]. Default: 0.
+            If int is provided, pad all RGB channels with this value.
+            If tuple[int, int, int] is provided, pad R, G, B channels respectively.
 
     Raises:
         TypeError: If `num_ops` is not of type int.
+        ValueError: If `num_ops` is negative.
         TypeError: If `magnitude` is not of type int.
+        ValueError: If `magnitude` is not positive.
         TypeError: If `num_magnitude_bins` is not of type int.
-        TypeError: If `interpolation` not of type int.
-        TypeError: If `fill_value` is not an int or a tuple of length 3.
-        RuntimeError: If given tensor shape is not <H, W, C>.
+        ValueError: If `num_magnitude_bins` is less than 2.
+        TypeError: If `interpolation` not of type :class:`mindspore.dataset.vision.Inter` .
+        TypeError: If `fill_value` is not of type int or tuple[int, int, int].
+        ValueError: If `fill_value` is not in range of [0, 255].
+        RuntimeError: If shape of the input image is not <H, W, C>.
 
     Supported Platforms:
         ``CPU``
@@ -1868,13 +1870,13 @@ 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.0, 1.0]. Default: 0.5.
 
     Raises:
         TypeError: If `degree` is not of type float.
         TypeError: If `prob` is not of type float.
         ValueError: If `degree` is negative.
-        ValueError: If `prob` is not in range [0, 1].
+        ValueError: If `prob` is not in range [0.0, 1.0].
         RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
 
     Supported Platforms:
@@ -1906,7 +1908,7 @@ class RandomAffine(ImageTensorOperation, PyTensorOperation):
             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
@@ -1915,18 +1917,18 @@ class RandomAffine(ImageTensorOperation, PyTensorOperation):
             (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).
+        scale (sequence, optional): Scaling factor interval, which must be non negative.
+            Default: None, original scale is used.
         shear (Union[float, Sequence[float, float], Sequence[float, float, float, float]], optional):
             Range of shear factor to select from.
             If float is provided, a shearing parallel to X axis with a factor selected from
-            (- `shear` , `shear` ) will be applied.
+            ( `-shear` , `shear` ) will be applied.
             If Sequence[float, float] is provided, a shearing parallel to X axis with a factor selected
             from ( `shear` [0], `shear` [1]) will be applied.
             If Sequence[float, float, float, float] is provided, a shearing parallel to X axis with a factor selected
             from ( `shear` [0], `shear` [1]) and a shearing parallel to Y axis with a factor selected from
             ( `shear` [2], `shear` [3]) will be applied. Default: None, means no shearing.
-        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.
@@ -1939,14 +1941,14 @@ class RandomAffine(ImageTensorOperation, PyTensorOperation):
 
         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].
@@ -2044,11 +2046,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.0, 1.0]. Default: 0.5.
 
     Raises:
         TypeError: If `cutoff` is not of type float.
@@ -2056,7 +2058,7 @@ class RandomAutoContrast(ImageTensorOperation):
         TypeError: If `prob` is not of type float.
         ValueError: If `cutoff` is not in range [0.0, 50.0).
         ValueError: If `ignore` is not in range [0, 255].
-        ValueError: If `prob` is not in range [0, 1].
+        ValueError: If `prob` is not in range [0.0, 1.0].
         RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
 
     Supported Platforms:
@@ -2092,7 +2094,7 @@ class RandomColor(ImageTensorOperation, PyTensorOperation):
     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].
@@ -2138,19 +2140,19 @@ class RandomColorAdjust(ImageTensorOperation, PyTensorOperation):
         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.
 
@@ -2231,20 +2233,20 @@ class RandomCrop(ImageTensorOperation, PyTensorOperation):
             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)
-            with the first value and (right and bottom) with the second value.
+            If a tuple or lists of 2 values are provided, pad the (left and right)
+            with the first value and (top 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.
@@ -2257,22 +2259,16 @@ class RandomCrop(ImageTensorOperation, PyTensorOperation):
             - Border.SYMMETRIC, means it reflects the values on the edge repeating the last
               value of edge.
 
-    Note:
-        The behavior when `padding` is a sequence of length 2 will change from padding left/top with
-        the first value and right/bottom with the second, to padding left/right with the first one
-        and top/bottom with the second in the future. Or you can pass in a 4-element sequence to specify
-        left, top, right and bottom respectively.
-
     Raises:
         TypeError: If `size` is not of type int or Sequence[int].
         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``
@@ -2324,7 +2320,7 @@ class RandomCrop(ImageTensorOperation, PyTensorOperation):
 
 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:
@@ -2332,10 +2328,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, it should be (height, width).
         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.
@@ -2349,14 +2345,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.
         TypeError: If `ratio` is not of type tuple.
-        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 integer.
         ValueError: If `size` is not positive.
         ValueError: If `scale` is negative.
@@ -2415,19 +2411,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 a tuple or lists of 2 values are provided, pad the (left and right)
+            with the first value and (top 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.
@@ -2441,18 +2437,12 @@ class RandomCropWithBBox(ImageTensorOperation):
 
               value of edge.
 
-    Note:
-        The behavior when `padding` is a sequence of length 2 will change from padding left/top with
-        the first value and right/bottom with the second, to padding left/right with the first one
-        and top/bottom with the second in the future. Or you can pass in a 4-element sequence to specify
-        left, top, right and bottom respectively.
-
     Raises:
         TypeError: If `size` is not of type int or Sequence[int].
         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].
@@ -2501,11 +2491,11 @@ 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.0, 1.0]. Default: 0.5.
 
     Raises:
         TypeError: If `prob` is not of type float.
-        ValueError: If `prob` is not in range [0, 1].
+        ValueError: If `prob` is not in range [0.0, 1.0].
         RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
 
     Supported Platforms:
@@ -2531,10 +2521,11 @@ class RandomErasing(PyTensorOperation):
     """
     Randomly erase pixels within a random selected rectangle erea on the input numpy.ndarray image.
 
-    See `Random Erasing Data Augmentation <https://arxiv.org/pdf/1708.04896.pdf>`_.
+    See `Random Erasing Data Augmentation <https://arxiv.org/pdf/1708.04896.pdf>`_ .
 
     Args:
-        prob (float, optional): Probability of performing erasing. Default: 0.5.
+        prob (float, optional): Probability of performing erasing, which
+            must be in range of [0.0, 1.0]. Default: 0.5.
         scale (Sequence[float, float], optional): Range of area scale of the erased area relative
             to the original image to select from, arranged in order of (min, max).
             Default: (0.02, 0.33).
@@ -2556,7 +2547,7 @@ class RandomErasing(PyTensorOperation):
         TypeError: If `value` is not of type integer, string, or sequence.
         TypeError: If `inplace` is not of type boolean.
         TypeError: If `max_attempts` is not of type integer.
-        ValueError: If `prob` is not in range of [0, 1].
+        ValueError: If `prob` is not in range of [0.0, 1.0].
         ValueError: If `scale` is negative.
         ValueError: If `ratio` is negative.
         ValueError: If `value` is not in range of [0, 255].
@@ -2592,7 +2583,7 @@ class RandomErasing(PyTensorOperation):
         Execute method.
 
         Args:
-            np_img (numpy.ndarray): image in shape of (C, H, W) to be randomly erased.
+            np_img (numpy.ndarray): image in shape of <C, H, W> to be randomly erased.
 
         Returns:
             numpy.ndarray, erased image.
@@ -2610,11 +2601,12 @@ class RandomGrayscale(PyTensorOperation):
     Randomly convert the input PIL Image to grayscale.
 
     Args:
-        prob (float, optional): Probability of performing grayscale conversion. Default: 0.1.
+        prob (float, optional): Probability of performing grayscale conversion,
+            which must be in range of [0.0, 1.0]. Default: 0.1.
 
     Raises:
         TypeError: If `prob` is not of type float.
-        ValueError: If `prob` is not in range of [0, 1].
+        ValueError: If `prob` is not in range of [0.0, 1.0].
 
     Supported Platforms:
         ``CPU``
@@ -2663,11 +2655,12 @@ class RandomHorizontalFlip(ImageTensorOperation, PyTensorOperation):
     Randomly flip the input image horizontally with a given probability.
 
     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.0, 1.0]. Default: 0.5.
 
     Raises:
         TypeError: If `prob` is not of type float.
-        ValueError: If `prob` is not in range [0, 1].
+        ValueError: If `prob` is not in range [0.0, 1.0].
         RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
 
     Supported Platforms:
@@ -2705,11 +2698,12 @@ 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.0, 1.0]. Default: 0.5.
 
     Raises:
         TypeError: If `prob` is not of type float.
-        ValueError: If `prob` is not in range [0, 1].
+        ValueError: If `prob` is not in range [0.0, 1.0].
         RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
 
     Supported Platforms:
@@ -2736,11 +2730,12 @@ 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.0, 1.0]. Default: 0.5.
 
     Raises:
         TypeError: If `prob` is not of type float.
-        ValueError: If `prob` is not in range [0, 1].
+        ValueError: If `prob` is not in range [0.0, 1.0].
         RuntimeError: If given tensor shape is not <H, W, C>.
 
     Supported Platforms:
@@ -2768,7 +2763,7 @@ class RandomLighting(ImageTensorOperation, PyTensorOperation):
     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.
@@ -2811,8 +2806,9 @@ class RandomPerspective(PyTensorOperation):
     Randomly apply perspective transformation to the input PIL Image with a given probability.
 
     Args:
-        distortion_scale (float, optional): Scale of distortion, in range of [0, 1]. Default: 0.5.
-        prob (float, optional): Probability of performing perspective transformation. Default: 0.5.
+        distortion_scale (float, optional): Scale of distortion, in range of [0.0, 1.0]. Default: 0.5.
+        prob (float, optional): Probability of performing perspective transformation, which
+            must be in range of [0.0, 1.0]. Default: 0.5.
         interpolation (Inter, optional): Method of interpolation. It can be Inter.BILINEAR,
             Inter.NEAREST or Inter.BICUBIC. Default: Inter.BICUBIC.
 
@@ -2823,9 +2819,9 @@ class RandomPerspective(PyTensorOperation):
     Raises:
         TypeError: If `distortion_scale` is not of type float.
         TypeError: If `prob` is not of type float.
-        TypeError: If `interpolation` is not of type :class:`mindspore.dataset.vision.Inter`.
-        ValueError: If `distortion_scale` is not in range of [0, 1].
-        ValueError: If `prob` is not in range of [0, 1].
+        TypeError: If `interpolation` is not of type :class:`mindspore.dataset.vision.Inter` .
+        ValueError: If `distortion_scale` is not in range of [0.0, 1.0].
+        ValueError: If `prob` is not in range of [0.0, 1.0].
 
     Supported Platforms:
         ``CPU``
@@ -2870,6 +2866,9 @@ class RandomPerspective(PyTensorOperation):
 
 class RandomPosterize(ImageTensorOperation):
     """
+    Reduce the bit depth of the color channels of image with a given probability
+    to create a high contrast and vivid color image.
+
     Reduce the number of bits for each color channel to posterize the input image randomly with a given probability.
 
     Args:
@@ -2877,7 +2876,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 integer or sequence of integer.
@@ -2908,8 +2907,8 @@ class RandomPosterize(ImageTensorOperation):
 
 class RandomResizedCrop(ImageTensorOperation, PyTensorOperation):
     """
-    This operator will crop the input image randomly,
-    and resize the cropped image using a selected interpolation mode :class:`mindspore.dataset.vision.Inter`.
+    This operation will crop the input image randomly,
+    and resize the cropped image using a selected interpolation mode :class:`mindspore.dataset.vision.Inter` .
 
     Note:
         If the input image is more than one, then make sure that the image size is the same.
@@ -2919,10 +2918,10 @@ class RandomResizedCrop(ImageTensorOperation, PyTensorOperation):
             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.
@@ -2939,19 +2938,18 @@ class RandomResizedCrop(ImageTensorOperation, PyTensorOperation):
             - Inter.ANTIALIAS, means the interpolation method is antialias 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.
         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>.
 
     Supported Platforms:
         ``CPU``
@@ -3013,10 +3011,10 @@ class RandomResizedCropWithBBox(ImageTensorOperation):
             If size is an integer, a square crop of size (size, size) is returned.
             If size is a sequence of length 2, it should be (height, width).
         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): Image interpolation mode (default=Inter.BILINEAR).
+            cropped, which must be non-negative. Default: (3. / 4., 4. / 3.).
+        interpolation (Inter, optional): Image interpolation mode. Default: Inter.BILINEAR.
             It can be any of [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC].
 
             - Inter.BILINEAR, means interpolation method is bilinear interpolation.
@@ -3026,7 +3024,7 @@ 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].
@@ -3072,7 +3070,7 @@ class RandomResizedCropWithBBox(ImageTensorOperation):
 
 class RandomResize(ImageTensorOperation):
     """
-    Resize the input image using :class:`mindspore.dataset.vision.Inter`, a randomly selected interpolation mode.
+    Resize the input image using :class:`mindspore.dataset.vision.Inter` , a randomly selected interpolation mode.
 
     Args:
         size (Union[int, Sequence[int]]): The output size of the resized image. The size value(s) must be positive.
@@ -3164,7 +3162,7 @@ class RandomRotation(ImageTensorOperation, PyTensorOperation):
         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.
@@ -3173,18 +3171,18 @@ class RandomRotation(ImageTensorOperation, PyTensorOperation):
 
             - 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 integer, float or sequence.
@@ -3265,7 +3263,7 @@ class RandomSelectSubpolicy(ImageTensorOperation):
     Args:
         policy (list[list[tuple[TensorOperation, float]]]): List of sub-policies to choose from.
             A sub-policy is a list of tuple[operation, prob], where operation is a data processing operation and prob
-            is the probability that this operation will be applied, and the prob values must be in range [0, 1].
+            is the probability that this operation will be applied, and the prob values must be in range [0.0, 1.0].
             Once a sub-policy is selected, each operation within the sub-policy with be applied in sequence according
             to its probability.
 
@@ -3312,7 +3310,7 @@ class RandomSharpness(ImageTensorOperation, PyTensorOperation):
     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 a list or a tuple.
@@ -3356,7 +3354,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).
@@ -3389,11 +3387,12 @@ class RandomVerticalFlip(ImageTensorOperation, PyTensorOperation):
     Randomly flip the input image vertically with a given probability.
 
     Args:
-        prob (float, optional): Probability of the image being flipped. Default=0.5.
+        prob (float, optional): Probability of the image being flipped, which
+            must be in range of [0.0, 1.0]. Default: 0.5.
 
     Raises:
         TypeError: If `prob` is not of type float.
-        ValueError: If `prob` is not in range [0, 1].
+        ValueError: If `prob` is not in range [0.0, 1.0].
         RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
 
     Supported Platforms:
@@ -3431,11 +3430,12 @@ 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,
+            which must be in range of [0.0, 1.0]. Default: 0.5.
 
     Raises:
         TypeError: If `prob` is not of type float.
-        ValueError: If `prob` is not in range [0, 1].
+        ValueError: If `prob` is not in range [0.0, 1.0].
         RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
 
     Supported Platforms:
@@ -3459,7 +3459,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:
@@ -3474,7 +3474,7 @@ class Rescale(ImageTensorOperation):
         TypeError: If `shift` is not of type float.
 
     Supported Platforms:
-        ``CPU`` ``Ascend`` ``GPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> transforms_list = [vision.Decode(), vision.Rescale(1.0 / 255.0, -1.0)]
@@ -3495,14 +3495,14 @@ class Rescale(ImageTensorOperation):
 
 class Resize(ImageTensorOperation, PyTensorOperation):
     """
-    Resize the input image to the given size with a given interpolation mode :class:`mindspore.dataset.vision.Inter`.
+    Resize the input image to the given size with a given interpolation mode :class:`mindspore.dataset.vision.Inter` .
 
     Args:
         size (Union[int, Sequence[int]]): The output size of the resized image. The size value(s) must be positive.
             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.BILINEAR).
+        interpolation (Inter, optional): Image interpolation mode. Default: Inter.BILINEAR.
             It can be any of [Inter.BILINEAR, Inter.LINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.AREA, Inter.PILCUBIC,
             Inter.ANTIALIAS].
 
@@ -3517,7 +3517,7 @@ class Resize(ImageTensorOperation, PyTensorOperation):
 
     Raises:
         TypeError: If `size` is not of type int or Sequence[int].
-        TypeError: If `interpolation` is not of type 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>.
 
@@ -3569,38 +3569,39 @@ class Resize(ImageTensorOperation, PyTensorOperation):
 
 class ResizedCrop(ImageTensorOperation):
     """
-    Crop the input image at a specific location, and resize the cropped image using a selected interpolation mode.
+    Crop the input image at a specific region and resize it to desired size.
 
     Args:
-        top (int): Horizontal ordinate of the upper left corner of the crop image.
-        left (int): Vertical ordinate of the upper left corner of the crop image.
-        height (int): Height of cropped image.
-        width (int): Width of cropped image.
-        size (Union[int, Sequence[int]]): The output size of the resized image. The size value(s) must be positive.
-            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.
-        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.
-
-            - Inter.NEAREST, means interpolation method is nearest-neighbor interpolation.
-
-            - Inter.BICUBIC, means interpolation method is bicubic interpolation.
-
-            - Inter.AREA, means interpolation method is pixel area interpolation.
-
-            - Inter.PILCUBIC, means interpolation method is bicubic interpolation like implemented in pillow, input
-              should be in 3 channels format.
+        top (int): Horizontal ordinate of the upper left corner of the crop region.
+        left (int): Vertical ordinate of the upper left corner of the crop region.
+        height (int): Height of the crop region.
+        width (int): Width of the cropp region.
+        size (Union[int, Sequence[int, int]]): The size of the output image.
+            If int is provided, the smaller edge of the image will be resized to this value,
+            keeping the image aspect ratio the same.
+            If Sequence[int, int] is provided, it should be (height, width).
+        interpolation (Inter, optional): Image interpolation method. Default: Inter.BILINEAR.
+            It can be Inter.LINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.AREA or Inter.PILCUBIC.
+
+            - Inter.LINEAR, bilinear interpolation.
+            - Inter.NEAREST, nearest-neighbor interpolation.
+            - Inter.BICUBIC, bicubic interpolation.
+            - Inter.AREA, pixel area interpolation.
+            - Inter.PILCUBIC, cubic interpolation based on the implementation of Pillow
 
     Raises:
         TypeError: If `top` is not of type int.
+        ValueError: If `top` is negative.
         TypeError: If `left` is not of type int.
+        ValueError: If `left` is negative.
         TypeError: If `height` is not of type int.
+        ValueError: If `height` is not positive.
         TypeError: If `width` is not of type int.
-        TypeError: If `size` is not of type int or Sequence[int].
-        TypeError: If `interpolation` is not of type :class:`mindspore.dataset.vision.Inter`.
-        RuntimeError: If given tensor shape is not <H, W> or <H, W, C>.
+        ValueError: If `width` is not positive.
+        TypeError: If `size` is not of type int or Sequence[int, int].
+        ValueError: If `size` is not posotive.
+        TypeError: If `interpolation` is not of type :class:`mindspore.dataset.vision.Inter` .
+        RuntimeError: If shape of the input image is not <H, W> or <H, W, C>.
 
     Supported Platforms:
         ``CPU``
@@ -3640,7 +3641,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.
@@ -3651,7 +3652,7 @@ class ResizeWithBBox(ImageTensorOperation):
 
     Raises:
         TypeError: If `size` is not of type int or Sequence[int].
-        TypeError: If `interpolation` is not of type 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>.
 
@@ -3686,8 +3687,8 @@ class RgbToHsv(PyTensorOperation):
     Convert the input numpy.ndarray images from RGB to HSV.
 
     Args:
-        is_hwc (bool): If True, means the input image is in shape of (H, W, C) or (N, H, W, C).
-            Otherwise, it is in shape of (C, H, W) or (N, C, H, W). Default: False.
+        is_hwc (bool): If True, means the input image is in shape of <H, W, C> or <N, H, W, C>.
+            Otherwise, it is in shape of <C, H, W> or <N, C, H, W>. Default: False.
 
     Raises:
         TypeError: If `is_hwc` is not of type bool.
@@ -3734,32 +3735,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 integer, float or sequence.
-        TypeError: If `resample` is not of type 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``
@@ -3804,13 +3805,13 @@ 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 (SliceMode, 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 integer.
@@ -3834,7 +3835,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)
     """
 
     @check_slice_patches
@@ -3856,12 +3857,12 @@ class Solarize(ImageTensorOperation):
     Solarize the image by inverting all pixel values within the threshold.
 
     Args:
-        threshold (Union[float, tuple[float, float]]): Range of solarize threshold, should always
+        threshold (Union[float, Sequence[float, float]]): Range of solarize threshold, should always
             be in (min, max) format, where min and max are integers in range of [0, 255], and min <= max.
-            If min=max, then invert all pixel values above min(max).
+            If a single value is provided or min=max, then invert all pixel values above min(max).
 
     Raises:
-        TypeError: If `threshold` is not of type float or tuple[float, float].
+        TypeError: If `threshold` is not of type float or Sequence[float, float].
         ValueError: If `threshold` is not in range of [0, 255].
 
     Supported Platforms:
@@ -3985,10 +3986,10 @@ class ToPIL(PyTensorOperation):
     Convert the input decoded numpy.ndarray image to PIL Image.
 
     Note:
-        The conversion mode will be determined by the data type using :class:`PIL.Image.fromarray`.
+        The conversion mode will be determined by the data type using `PIL.Image.fromarray` .
 
     Raises:
-        TypeError: If the input image is not of type :class:`numpy.ndarray` or :class:`PIL.Image.Image`.
+        TypeError: If the input image is not of type :class:`numpy.ndarray` or `PIL.Image.Image` .
 
     Supported Platforms:
         ``CPU``
@@ -4026,14 +4027,14 @@ class ToPIL(PyTensorOperation):
 class ToTensor(ImageTensorOperation):
     """
     Convert the input PIL Image or numpy.ndarray to numpy.ndarray of the desired dtype, rescale the pixel value
-    range from [0, 255] to [0.0, 1.0] and change the shape from (H, W, C) to (C, H, W).
+    range from [0, 255] to [0.0, 1.0] and change the shape from <H, W, C> to <C, H, W>.
 
     Args:
         output_type (Union[mindspore.dtype, numpy.dtype], optional): The desired dtype of the output image.
-            Default: :class:`numpy.float32`.
+            Default: `numpy.float32` .
 
     Raises:
-        TypeError: If the input image is not of type :class:`PIL.Image.Image` or :class:`numpy.ndarray`.
+        TypeError: If the input image is not of type `PIL.Image.Image` or :class:`numpy.ndarray` .
         TypeError: If dimension of the input image is not 2 or 3.
 
     Supported Platforms:
@@ -4070,20 +4071,20 @@ class ToType(TypeCast):
     """
     Cast the input to a given MindSpore data type or NumPy data type.
 
-    It is the same as that of :class:`mindspore.dataset.transforms.TypeCast`.
+    It is the same as that of :class:`mindspore.dataset.transforms.TypeCast` .
 
     Note:
         This operation supports running on Ascend or GPU platforms by Offload.
 
     Args:
         data_type (Union[mindspore.dtype, numpy.dtype]): The desired data type of the output image,
-            such as :class:`numpy.float32`.
+            such as `numpy.float32` .
 
     Raises:
-        TypeError: If `data_type` is not of type :class:`mindspore.dtype` or :class:`numpy.dtype`.
+        TypeError: If `data_type` is not of type :class:`mindspore.dtype` or :class:`numpy.dtype` .
 
     Supported Platforms:
-        ``CPU`` ``Ascend`` ``GPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> import numpy as np
@@ -4101,36 +4102,36 @@ class ToType(TypeCast):
 
 class TrivialAugmentWide(ImageTensorOperation):
     """
-    Apply TrivialAugmentWide data augmentation method based on
-    `TrivialAugmentWide: Tuning-free Yet State-of-the-Art Data Augmentation <https://arxiv.org/abs/2103.10158>`_.
-    This operation works only with 3-channel RGB images.
+    Apply TrivialAugmentWide data augmentation method on the input image.
+
+    Refer to
+    `TrivialAugmentWide: Tuning-free Yet State-of-the-Art Data Augmentation <https://arxiv.org/abs/2103.10158>`_ .
+
+    Only support 3-channel RGB image.
 
     Args:
         num_magnitude_bins (int, optional): The number of different magnitude values,
             must be greater than or equal to 2. Default: 31.
-        interpolation (Inter, optional): Image interpolation mode for Resize operator. 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.
-
-            - Inter.BILINEAR: means interpolation method is bilinear interpolation.
+        interpolation (Inter, optional): Image interpolation method. Default: Inter.NEAREST.
+            It can be Inter.NEAREST, Inter.BILINEAR, Inter.BICUBIC or Inter.AREA.
 
-            - Inter.BICUBIC: means the interpolation method is bicubic interpolation.
-
-            - Inter.AREA: means the interpolation method is area interpolation.
+            - Inter.NEAREST, nearest-neighbor interpolation.
+            - Inter.BILINEAR, bilinear interpolation.
+            - Inter.BICUBIC, bicubic interpolation.
+            - Inter.AREA, pixel area interpolation.
 
-        fill_value (Union[int, tuple[int, int, int]], 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.
+        fill_value (Union[int, tuple[int, int, int]], optional): Pixel fill value for the area outside the
+            transformed image, must be in range of [0, 255]. Default: 0.
+            If int is provided, pad all RGB channels with this value.
+            If tuple[int, int, int] is provided, pad R, G, B channels respectively.
 
     Raises:
         TypeError: If `num_magnitude_bins` is not of type int.
         ValueError: If `num_magnitude_bins` is less than 2.
-        TypeError: If `interpolation` is not of type Inter.
-        TypeError: If `fill_value` is not an integer or a tuple of length 3.
-        RuntimeError: If given tensor shape is not <H, W, C>.
+        TypeError: If `interpolation` not of type :class:`mindspore.dataset.vision.Inter` .
+        TypeError: If `fill_value` is not of type int or tuple[int, int, int].
+        ValueError: If `fill_value` is not in range of [0, 255].
+        RuntimeError: If shape of the input image is not <H, W, C>.
 
     Supported Platforms:
         ``CPU``
@@ -4225,7 +4226,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``