mindspore 2.0.0rc1__cp38-none-any.whl → 2.2.0__cp38-none-any.whl

mindspore/dataset/vision/c_transforms.py

@@ -151,7 +151,7 @@ class AdjustGamma(ImageTensorOperation):
             The output image pixel value is exponentially related to the input image pixel value.
             gamma larger than 1 make the shadows darker,
             while gamma smaller than 1 make dark regions lighter.
-        gain (float, optional): The constant multiplier. Default: 1.0.
+        gain (float, optional): The constant multiplier. Default: ``1.0``.
 
     Raises:
         TypeError: If `gain` is not of type float.
@@ -186,7 +186,7 @@ class AutoAugment(ImageTensorOperation):
 
     Args:
         policy (AutoAugmentPolicy, optional): AutoAugment policies learned on different datasets.
-            Default: AutoAugmentPolicy.IMAGENET.
+            Default: ``AutoAugmentPolicy.IMAGENET``.
             It can be any of [AutoAugmentPolicy.IMAGENET, AutoAugmentPolicy.CIFAR10, AutoAugmentPolicy.SVHN].
             Randomly apply 2 operations from a candidate set. See auto augmentation details in AutoAugmentPolicy.
 
@@ -196,21 +196,21 @@ class AutoAugment(ImageTensorOperation):
 
             - AutoAugmentPolicy.SVHN, means to apply AutoAugment learned on SVHN dataset.
 
-        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].
+        interpolation (Inter, optional): Image interpolation mode for Resize operation. Default: ``Inter.NEAREST``.
+            It can be ``Inter.NEAREST``, ``Inter.BILINEAR``, ``Inter.BICUBIC``, ``Inter.AREA``.
 
-            - Inter.NEAREST: means interpolation method is nearest-neighbor interpolation.
+            - ``Inter.NEAREST`` : means interpolation method is nearest-neighbor interpolation.
 
-            - Inter.BILINEAR: means interpolation method is bilinear interpolation.
+            - ``Inter.BILINEA`` : means interpolation method is bilinear interpolation.
 
-            - Inter.BICUBIC: means the interpolation method is bicubic interpolation.
+            - ``Inter.BICUBIC`` : means the interpolation method is bicubic interpolation.
 
-            - Inter.AREA: means the interpolation method is pixel area interpolation.
+            - ``Inter.AREA`` : means the interpolation method is pixel area interpolation.
 
         fill_value (Union[int, tuple], optional): Pixel fill value for the area outside the transformed image.
             It can be an int or a 3-tuple. If it is a 3-tuple, it is used to fill R, G, B channels respectively.
-            If it is an integer, it is used for all RGB channels. The fill_value values must be in range [0, 255].
-            Default: 0.
+            If it is an integer, it is used for all RGB channels. The `fill_value` values must be in range [0, 255].
+            Default: ``0``.
 
     Raises:
         TypeError: If `policy` is not of type AutoAugmentPolicy.
@@ -252,9 +252,9 @@ class AutoContrast(ImageTensorOperation):
 
     Args:
         cutoff (float, optional): Percent of lightest and darkest pixels to cut off from
-            the histogram of input image. The value must be in the range [0.0, 50.0). Default: 0.0.
+            the histogram of input image. The value must be in the range [0.0, 50.0). Default: ``0.0``.
         ignore (Union[int, sequence], optional): The background pixel values to ignore,
-            The ignore values must be in range [0, 255]. Default: None.
+            The ignore values must be in range [0, 255]. Default: ``None``.
 
     Raises:
         TypeError: If `cutoff` is not of type float.
@@ -294,7 +294,7 @@ class BoundingBoxAugment(ImageTensorOperation):
         transform (TensorOperation): C++ transformation operation to be applied on random selection
             of bounding box regions of a given image.
         ratio (float, optional): Ratio of bounding boxes to apply augmentation on.
-            Range: [0.0, 1.0]. Default: 0.3.
+            Range: [0.0, 1.0]. Default: ``0.3``.
 
     Raises:
         TypeError: If `transform` is not an image processing operation
@@ -493,10 +493,11 @@ class CutMixBatch(ImageTensorOperation):
     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.
+        image_batch_format (ImageBatchFormat): The method of padding. Can be
+            ``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``.
 
     Raises:
         TypeError: If `image_batch_format` is not of type :class:`mindspore.dataset.vision.ImageBatchFormat` .
@@ -537,7 +538,8 @@ class CutOut(ImageTensorOperation):
 
     Args:
         length (int): The side length of each square patch, must be larger than 0.
-        num_patches (int, optional): Number of patches to be cut out of an image, must be larger than 0. Default: 1.
+        num_patches (int, optional): Number of patches to be cut out of an image, must be larger than 0.
+            Default: ``1``.
 
     Raises:
         TypeError: If `length` is not of type int.
@@ -570,11 +572,11 @@ class Decode(ImageTensorOperation):
     Decode the input image.
 
     Args:
-        rgb (bool, optional): Mode of decoding input image. Default: True.
-            If True means format of decoded image is RGB else BGR (deprecated).
+        rgb (bool, optional): Mode of decoding input image. Default: ``True``.
+            If ``True`` means format of decoded image is RGB else BGR (deprecated).
 
     Raises:
-        RuntimeError: If `rgb` is False, since this option is deprecated.
+        RuntimeError: If `rgb` is ``False``, since this option is deprecated.
         RuntimeError: If given tensor is not a 1D sequence.
 
     Supported Platforms:
@@ -608,7 +610,8 @@ class Decode(ImageTensorOperation):
         return super().__call__(img)
 
     def parse(self):
-        return cde.DecodeOperation(self.rgb)
+        # deprecated api just support cpu device target
+        return cde.DecodeOperation(self.rgb, "CPU")
 
 
 class Equalize(ImageTensorOperation):
@@ -644,9 +647,10 @@ class GaussianBlur(ImageTensorOperation):
             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).
+            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.
+            If ``None`` is provided, the sigma will be calculated as ((kernel_size - 1) * 0.5 - 1) * 0.3 + 0.8.
 
     Raises:
         TypeError: If `kernel_size` is not of type int or Sequence[int].
@@ -771,7 +775,7 @@ class MixUpBatch(ImageTensorOperation):
     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.
@@ -839,7 +843,8 @@ class Normalize(ImageTensorOperation):
         self.std = std
 
     def parse(self):
-        return cde.NormalizeOperation(self.mean, self.std, True)
+        # deprecated api just support cpu device target
+        return cde.NormalizeOperation(self.mean, self.std, True, "CPU")
 
 
 class NormalizePad(ImageTensorOperation):
@@ -851,7 +856,7 @@ class NormalizePad(ImageTensorOperation):
             The mean values must be in range (0.0, 255.0].
         std (sequence): List or tuple of standard deviations for each channel, with respect to channel order.
             The standard deviation values must be in range (0.0, 255.0].
-        dtype (str, optional): Set the dtype of the output image. Default: "float32".
+        dtype (str, optional): Set the dtype of the output image. Default: ``"float32"``.
 
     Raises:
         TypeError: If `mean` is not of type sequence.
@@ -897,20 +902,20 @@ class Pad(ImageTensorOperation):
             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
-            [Border.CONSTANT, Border.EDGE, Border.REFLECT, Border.SYMMETRIC].
+            `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
+            ``Border.CONSTANT``, ``Border.EDGE``, ``Border.REFLECT``, ``Border.SYMMETRIC``.
 
-            - Border.CONSTANT, means it fills the border with constant values.
+            - ``Border.CONSTANT`` , means it fills the border with constant values.
 
-            - Border.EDGE, means it pads with the last value on the edge.
+            - ``Border.EDGE`` , means it pads with the last value on the edge.
 
-            - Border.REFLECT, means it reflects the values on the edge omitting the last
+            - ``Border.REFLECT`` , means it reflects the values on the edge omitting the last
               value of edge.
 
-            - Border.SYMMETRIC, means it reflects the values on the edge repeating the last
+            - ``Border.SYMMETRIC`` , means it reflects the values on the edge repeating the last
               value of edge.
 
     Note:
@@ -956,10 +961,10 @@ class RandomAdjustSharpness(ImageTensorOperation):
 
     Args:
         degree (float): Sharpness adjustment degree, which must be non negative.
-            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.
+            Degree of ``0.0`` gives a blurred image, degree of ``1.0`` gives the original image,
+            and degree of ``2.0`` increases the sharpness by a factor of 2.
         prob (float, optional): Probability of the image being sharpness adjusted, which
-            must be in range of [0, 1]. Default: 0.5.
+            must be in range of [0, 1]. Default: ``0.5``.
 
     Raises:
         TypeError: If `degree` is not of type float.
@@ -996,7 +1001,7 @@ class RandomAffine(ImageTensorOperation):
             If `degrees` is a number, the range will be (-degrees, degrees).
             If `degrees` is a sequence, it should be (min, max).
         translate (sequence, optional): Sequence (tx_min, tx_max, ty_min, ty_max) of minimum/maximum translation in
-            x(horizontal) and y(vertical) directions, range [-1.0, 1.0]. Default: None.
+            x(horizontal) and y(vertical) directions, range [-1.0, 1.0]. Default: ``None``.
             The horizontal and vertical shift is selected randomly from the range:
             (tx_min*width, tx_max*width) and (ty_min*height, ty_max*height), respectively.
             If a tuple or list of size 2, then a translate parallel to the X axis in the range of
@@ -1004,30 +1009,31 @@ class RandomAffine(ImageTensorOperation):
             If a tuple or list of size 4, then a translate parallel to the X axis in the range of
             (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.
+            If ``None``, no translation is applied.
         scale (sequence, optional): Scaling factor interval, which must be non negative.
-            Default: None, original scale is used.
-        shear (Union[int, float, sequence], optional): Range of shear factor, which must be positive. Default: None.
+            Default: ``None``, original scale is used.
+        shear (Union[int, float, sequence], optional): Range of shear factor, which must be positive.
+            Default: ``None``.
             If a number, then a shear parallel to the X axis in the range of (-shear, +shear) is applied.
             If a tuple or list of size 2, then a shear parallel to the X axis in the range of (shear[0], shear[1])
             is applied.
             If a tuple or list of size 4, then a shear parallel to X axis in the range of (shear[0], shear[1])
             and a shear parallel to Y axis in the range of (shear[2], shear[3]) is applied.
             If None, no shear is applied.
-        resample (Inter, optional): An optional resampling filter. Default: Inter.NEAREST.
-            It can be any of [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.AREA].
+        resample (Inter, optional): An optional resampling filter. Default: ``Inter.NEAREST``.
+            It can be ``Inter.BILINEAR``, ``Inter.NEAREST``, ``Inter.BICUBIC``, ``Inter.AREA``.
 
-            - Inter.BILINEAR, means resample method is bilinear interpolation.
+            - ``Inter.BILINEA`` , means resample method is bilinear interpolation.
 
-            - Inter.NEAREST, means resample method is nearest-neighbor interpolation.
+            - ``Inter.NEAREST`` , means resample method is nearest-neighbor interpolation.
 
-            - Inter.BICUBIC, means resample method is bicubic interpolation.
+            - ``Inter.BICUBIC`` , means resample method is bicubic interpolation.
 
-            - Inter.AREA, means resample method is pixel area interpolation.
+            - ``Inter.AREA`` :, means resample method is pixel area interpolation.
 
         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.
@@ -1106,11 +1112,11 @@ class RandomAutoContrast(ImageTensorOperation):
 
     Args:
         cutoff (float, optional): Percent of the lightest and darkest pixels to be cut off from
-            the histogram of the input image. The value must be in range of [0.0, 50.0). Default: 0.0.
+            the histogram of the input image. The value must be in range of [0.0, 50.0). Default: ``0.0``.
         ignore (Union[int, sequence], optional): The background pixel values to be ignored, each of
-            which must be in range of [0, 255]. Default: None.
+            which must be in range of [0, 255]. Default: ``None``.
         prob (float, optional): Probability of the image being automatically contrasted, which
-            must be in range of [0, 1]. Default: 0.5.
+            must be in range of [0, 1]. Default: ``0.5``.
 
     Raises:
         TypeError: If `cutoff` is not of type float.
@@ -1153,7 +1159,7 @@ class RandomColor(ImageTensorOperation):
     Args:
          degrees (Sequence[float], optional): Range of random color adjustment degrees, which must be non-negative.
             It should be in (min, max) format. If min=max, then it is a
-            single fixed magnitude operation. Default: (0.1, 1.9).
+            single fixed magnitude operation. Default: ``(0.1, 1.9)``.
 
     Raises:
         TypeError: If `degrees` is not of type Sequence[float].
@@ -1186,19 +1192,19 @@ class RandomColorAdjust(ImageTensorOperation):
         This operation supports running on Ascend or GPU platforms by Offload.
 
     Args:
-        brightness (Union[float, Sequence[float]], optional): Brightness adjustment factor. Default: (1, 1).
+        brightness (Union[float, Sequence[float]], optional): Brightness adjustment factor. Default: ``(1, 1)``.
             Cannot be negative.
             If it is a float, the factor is uniformly chosen from the range [max(0, 1-brightness), 1+brightness].
             If it is a sequence, it should be [min, max] for the range.
-        contrast (Union[float, Sequence[float]], optional): Contrast adjustment factor. Default: (1, 1).
+        contrast (Union[float, Sequence[float]], optional): Contrast adjustment factor. Default: ``(1, 1)``.
             Cannot be negative.
             If it is a float, the factor is uniformly chosen from the range [max(0, 1-contrast), 1+contrast].
             If it is a sequence, it should be [min, max] for the range.
-        saturation (Union[float, Sequence[float]], optional): Saturation adjustment factor. Default: (1, 1).
+        saturation (Union[float, Sequence[float]], optional): Saturation adjustment factor. Default: ``(1, 1)``.
             Cannot be negative.
             If it is a float, the factor is uniformly chosen from the range [max(0, 1-saturation), 1+saturation].
             If it is a sequence, it should be [min, max] for the range.
-        hue (Union[float, Sequence[float]], optional): Hue adjustment factor. Default: (0, 0).
+        hue (Union[float, Sequence[float]], optional): Hue adjustment factor. Default: ``(0, 0)``.
             If it is a float, the range will be [-hue, hue]. Value should be 0 <= hue <= 0.5.
             If it is a sequence, it should be [min, max] where -0.5 <= min <= max <= 0.5.
 
@@ -1266,30 +1272,30 @@ class RandomCrop(ImageTensorOperation):
             If size is an integer, a square crop of size (size, size) is returned.
             If size is a sequence of length 2, an image of size (height, width) will be cropped.
         padding (Union[int, Sequence[int]], optional): The number of pixels to pad each border of the image.
-            The padding value(s) must be non-negative. Default: None.
-            If padding is not None, pad image first with padding values.
+            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 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.
+            `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
-            [Border.CONSTANT, Border.EDGE, Border.REFLECT, Border.SYMMETRIC].
+            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
+            ``Border.CONSTANT``, ``Border.EDGE``, ``Border.REFLECT``, ``Border.SYMMETRIC``.
 
-            - Border.CONSTANT, means it fills the border with constant values.
+            - ``Border.CONSTANT`` , means it fills the border with constant values.
 
-            - Border.EDGE, means it pads with the last value on the edge.
+            - ``Border.EDGE`` , means it pads with the last value on the edge.
 
-            - Border.REFLECT, means it reflects the values on the edge omitting the last
+            - ``Border.REFLECT`` , means it reflects the values on the edge omitting the last
               value of edge.
 
-            - Border.SYMMETRIC, means it reflects the values on the edge repeating the last
+            - ``Border.SYMMETRIC`` , means it reflects the values on the edge repeating the last
               value of edge.
 
     Note:
@@ -1354,25 +1360,25 @@ class RandomCropDecodeResize(ImageTensorOperation):
             If size is an integer, a square crop of size (size, size) is returned.
             If size is a sequence of length 2, an image of size (height, width) will be cropped.
         scale (Union[list, tuple], optional): Range [min, max) of respective size of the
-            original size to be cropped, which must be non-negative. Default: (0.08, 1.0).
+            original size to be cropped, which must be non-negative. Default: ``(0.08, 1.0)``.
         ratio (Union[list, tuple], optional): Range [min, max) of aspect ratio to be
-            cropped, which must be non-negative. Default: (3. / 4., 4. / 3.).
-        interpolation (Inter, optional): Image interpolation mode for resize operation. Default: Inter.BILINEAR.
-            It can be any of [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.AREA, Inter.PILCUBIC].
+            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 ``Inter.BILINEAR``, ``Inter.NEAREST``, ``Inter.BICUBIC``, ``Inter.AREA``, ``Inter.PILCUBIC``.
 
-            - Inter.BILINEAR, means interpolation method is bilinear interpolation.
+            - ``Inter.BILINEA`` , means interpolation method is bilinear interpolation.
 
-            - Inter.NEAREST, means interpolation method is nearest-neighbor interpolation.
+            - ``Inter.NEAREST`` , means interpolation method is nearest-neighbor interpolation.
 
-            - Inter.BICUBIC, means interpolation method is bicubic interpolation.
+            - ``Inter.BICUBIC`` , means interpolation method is bicubic interpolation.
 
-            - Inter.AREA, means interpolation method is pixel area interpolation.
+            - ``Inter.AREA`` :, means interpolation method is pixel area interpolation.
 
-            - Inter.PILCUBIC, means interpolation method is bicubic interpolation like implemented in pillow, input
+            - ``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.
-            If exceeded, fall back to use center_crop instead. The max_attempts value must be positive.
+        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].
@@ -1436,29 +1442,29 @@ 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.
-            If padding is not None, first pad image with padding values.
+            The padding value(s) must be non-negative. Default: ``None``.
+            If `padding` is not ``None``, first pad image with padding values.
             If a single number is provided, pad all borders with this value.
             If a tuple or lists of 2 values are provided, pad the (left and top)
             with the first value and (right and bottom) with the second value.
             If 4 values are provided as a list or tuple, pad the left, top, right and bottom respectively.
         pad_if_needed (bool, optional): Pad the image if either side is smaller than
-            the given output size. Default: False.
+            the given output size. Default: ``False``.
         fill_value (Union[int, tuple[int]], optional): The pixel intensity of the borders, only valid for
-            padding_mode Border.CONSTANT. If it is a 3-tuple, it is used to fill R, G, B channels respectively.
+            `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
-            [Border.CONSTANT, Border.EDGE, Border.REFLECT, Border.SYMMETRIC].
+            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.
+            - ``Border.CONSTANT`` , means it fills the border with constant values.
 
-            - Border.EDGE, means it pads with the last value on the edge.
+            - ``Border.EDGE`` , means it pads with the last value on the edge.
 
-            - Border.REFLECT, means it reflects the values on the edge omitting the last
+            - ``Border.REFLECT`` , means it reflects the values on the edge omitting the last
               value of edge.
 
-            - Border.SYMMETRIC, means it reflects the values on the edge repeating the last
+            - ``Border.SYMMETRIC`` , means it reflects the values on the edge repeating the last
               value of edge.
 
     Note:
@@ -1520,7 +1526,7 @@ class RandomEqualize(ImageTensorOperation):
 
     Args:
         prob (float, optional): Probability of the image being equalized, which
-            must be in range of [0, 1]. Default: 0.5.
+            must be in range of [0, 1]. Default: ``0.5``.
 
     Raises:
         TypeError: If `prob` is not of type float.
@@ -1553,7 +1559,8 @@ class RandomHorizontalFlip(ImageTensorOperation):
         This operation supports running on Ascend or GPU platforms by Offload.
 
     Args:
-        prob (float, optional): Probability of the image being flipped, which must be in range of [0, 1]. Default: 0.5.
+        prob (float, optional): Probability of the image being flipped, which must be in range of [0, 1].
+            Default: ``0.5``.
 
     Raises:
         TypeError: If `prob` is not of type float.
@@ -1583,7 +1590,8 @@ class RandomHorizontalFlipWithBBox(ImageTensorOperation):
     Flip the input image horizontally randomly with a given probability and adjust bounding boxes accordingly.
 
     Args:
-        prob (float, optional): Probability of the image being flipped, which must be in range of [0, 1]. Default: 0.5.
+        prob (float, optional): Probability of the image being flipped, which must be in range of [0, 1].
+            Default: ``0.5``.
 
     Raises:
         TypeError: If `prob` is not of type float.
@@ -1613,7 +1621,8 @@ class RandomInvert(ImageTensorOperation):
     Randomly invert the colors of image with a given probability.
 
     Args:
-        prob (float, optional): Probability of the image being inverted, which must be in range of [0, 1]. Default: 0.5.
+        prob (float, optional): Probability of the image being inverted, which must be in range of [0, 1].
+            Default: ``0.5``.
 
     Raises:
         TypeError: If `prob` is not of type float.
@@ -1644,7 +1653,7 @@ class RandomLighting(ImageTensorOperation):
     calculated from the imagenet dataset.
 
     Args:
-        alpha (float, optional): Intensity of the image, which must be non-negative. Default: 0.05.
+        alpha (float, optional): Intensity of the image, which must be non-negative. Default: ``0.05``.
 
     Raises:
         TypeError: If `alpha` is not of type float.
@@ -1678,7 +1687,7 @@ class RandomPosterize(ImageTensorOperation):
             Bits values must be in range of [1,8], and include at
             least one integer value in the given range. It must be in
             (min, max) or integer format. If min=max, then it is a single fixed
-            magnitude operation. Default: (8, 8).
+            magnitude operation. Default: ``(8, 8)``.
 
     Raises:
         TypeError: If `bits` is not of type int or sequence of int.
@@ -1718,25 +1727,25 @@ class RandomResizedCrop(ImageTensorOperation):
             If size is an integer, a square of size (size, size) will be cropped with this value.
             If size is a sequence of length 2, an image of size (height, width) will be cropped.
         scale (Union[list, tuple], optional): Range [min, max) of respective size of the original
-            size to be cropped, which must be non-negative. Default: (0.08, 1.0).
+            size to be cropped, which must be non-negative. Default: ``(0.08, 1.0)``.
         ratio (Union[list, tuple], optional): Range [min, max) of aspect ratio to be
-            cropped, which must be non-negative. Default: (3. / 4., 4. / 3.).
-        interpolation (Inter, optional): Method of interpolation. Default: Inter.BILINEAR.
-            It can be any of [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.AREA, Inter.PILCUBIC].
+            cropped, which must be non-negative. Default: ``(3. / 4., 4. / 3.)``.
+        interpolation (Inter, optional): Method of interpolation. Default: ``Inter.BILINEAR``.
+            It can be ``Inter.BILINEAR``, ``Inter.NEAREST``, ``Inter.BICUBIC``, ``Inter.AREA``, ``Inter.PILCUBIC``.
 
-            - Inter.BILINEAR, means interpolation method is bilinear interpolation.
+            - ``Inter.BILINEA`` , means interpolation method is bilinear interpolation.
 
-            - Inter.NEAREST, means interpolation method is nearest-neighbor interpolation.
+            - ``Inter.NEAREST`` , means interpolation method is nearest-neighbor interpolation.
 
-            - Inter.BICUBIC, means interpolation method is bicubic interpolation.
+            - ``Inter.BICUBIC`` , means interpolation method is bicubic interpolation.
 
-            - Inter.AREA, means interpolation method is pixel area 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.
+            - ``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. 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].
@@ -1789,20 +1798,20 @@ class RandomResizedCropWithBBox(ImageTensorOperation):
             If size is an integer, a square of size (size, size) will be cropped with this value.
             If size is a sequence of length 2, an image of size (height, width) will be cropped.
         scale (Union[list, tuple], optional): Range (min, max) of respective size of the original
-            size to be cropped, which must be non-negative. Default: (0.08, 1.0).
+            size to be cropped, which must be non-negative. Default: ``(0.08, 1.0)``.
         ratio (Union[list, tuple], optional): Range (min, max) of aspect ratio to be
-            cropped, which must be non-negative. Default: (3. / 4., 4. / 3.).
-        interpolation (Inter mode, optional): Method of interpolation. Default: Inter.BILINEAR.
-            It can be any of [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC] .
+            cropped, which must be non-negative. Default: ``(3. / 4., 4. / 3.)``.
+        interpolation (Inter mode, optional): Method of interpolation. Default: ``Inter.BILINEAR``.
+            It can be ``Inter.BILINEAR``, ``Inter.NEAREST``, ``Inter.BICUBIC`` .
 
-            - Inter.BILINEAR, means interpolation method is bilinear interpolation.
+            - ``Inter.BILINEA`` , means interpolation method is bilinear interpolation.
 
-            - Inter.NEAREST, means interpolation method is nearest-neighbor interpolation.
+            - ``Inter.NEAREST`` , means interpolation method is nearest-neighbor interpolation.
 
-            - Inter.BICUBIC, means interpolation method is bicubic interpolation.
+            - ``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].
@@ -1934,27 +1943,27 @@ class RandomRotation(ImageTensorOperation):
         degrees (Union[int, float, sequence]): Range of random rotation degrees.
             If `degrees` is a number, the range will be converted to (-degrees, degrees).
             If `degrees` is a sequence, it should be (min, max).
-        resample (Inter, optional): An optional resampling filter. Default: Inter.NEAREST.
-            It can be any of [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.AREA].
+        resample (Inter, optional): An optional resampling filter. Default: ``Inter.NEAREST``.
+            It can be ``Inter.BILINEAR``, ``Inter.NEAREST``, ``Inter.BICUBIC``, ``Inter.AREA``.
 
-            - Inter.BILINEAR, means resample method is bilinear interpolation.
+            - ``Inter.BILINEA`` , means resample method is bilinear interpolation.
 
-            - Inter.NEAREST, means resample method is nearest-neighbor interpolation.
+            - ``Inter.NEAREST`` , means resample method is nearest-neighbor interpolation.
 
-            - Inter.BICUBIC, means resample method is bicubic interpolation.
+            - ``Inter.BICUBIC`` , means resample method is bicubic interpolation.
 
-            - Inter.AREA: means the interpolation method is pixel 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.
+            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.
-            Origin is the top left corner. None sets to the center of the image.
+        center (tuple, optional): Optional center of rotation (a 2-tuple). Default: ``None``.
+            Origin is the top left corner. ``None`` sets to the center of the image.
         fill_value (Union[int, tuple[int]], optional): Optional fill color for the area outside the rotated image.
             If it is a 3-tuple, it is used to fill R, G, B channels respectively.
             If it is an integer, it is used for all RGB channels.
-            The fill_value values must be in range [0, 255]. Default: 0.
+            The fill_value values must be in range [0, 255]. Default: ``0``.
 
     Raises:
         TypeError: If `degrees` is not of type int, float or sequence.
@@ -2062,7 +2071,7 @@ class RandomSharpness(ImageTensorOperation):
     Args:
         degrees (Union[list, tuple], optional): Range of random sharpness adjustment degrees,
             which must be non-negative. It should be in (min, max) format. If min=max, then
-            it is a single fixed magnitude operation. Default: (0.1, 1.9).
+            it is a single fixed magnitude operation. Default: ``(0.1, 1.9)``.
 
     Raises:
         TypeError : If `degrees` is not of type list or tuple.
@@ -2093,7 +2102,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).
@@ -2128,7 +2137,7 @@ class RandomVerticalFlip(ImageTensorOperation):
         This operation supports running on Ascend or GPU platforms by Offload.
 
     Args:
-        prob (float, optional): Probability of the image being flipped. Default: 0.5.
+        prob (float, optional): Probability of the image being flipped. Default: ``0.5``.
 
     Raises:
         TypeError: If `prob` is not of type float.
@@ -2158,7 +2167,7 @@ class RandomVerticalFlipWithBBox(ImageTensorOperation):
     Flip the input image vertically, randomly with a given probability and adjust bounding boxes accordingly.
 
     Args:
-        prob (float, optional): Probability of the image being flipped. Default: 0.5.
+        prob (float, optional): Probability of the image being flipped. Default: ``0.5``.
 
     Raises:
         TypeError: If `prob` is not of type float.
@@ -2227,18 +2236,18 @@ class Resize(ImageTensorOperation):
             If size is an integer, the smaller edge of the image will be resized to this value with
             the same image aspect ratio.
             If size is a sequence of length 2, it should be (height, width).
-        interpolation (Inter, optional): Image interpolation mode. Default: Inter.LINEAR.
-            It can be any of [Inter.LINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.AREA, Inter.PILCUBIC].
+        interpolation (Inter, optional): Image interpolation mode. Default: ``Inter.LINEAR``.
+            It can be ``Inter.LINEAR``, ``Inter.NEAREST``, ``Inter.BICUBIC``, ``Inter.AREA``, ``Inter.PILCUBIC``.
 
-            - Inter.LINEAR, means interpolation method is bilinear interpolation.
+            - ``Inter.LINEAR`` , means interpolation method is bilinear interpolation.
 
-            - Inter.NEAREST, means interpolation method is nearest-neighbor interpolation.
+            - ``Inter.NEAREST`` , means interpolation method is nearest-neighbor interpolation.
 
-            - Inter.BICUBIC, means interpolation method is bicubic interpolation.
+            - ``Inter.BICUBIC`` , means interpolation method is bicubic interpolation.
 
-            - Inter.AREA, means interpolation method is pixel area interpolation.
+            - ``Inter.AREA`` :, means interpolation method is pixel area interpolation.
 
-            - Inter.PILCUBIC, means interpolation method is bicubic interpolation like implemented in pillow, input
+            - ``Inter.PILCUBIC`` , means interpolation method is bicubic interpolation like implemented in pillow, input
               should be in 3 channels format.
 
     Raises:
@@ -2268,7 +2277,8 @@ class Resize(ImageTensorOperation):
         self.interpolation = interpolation
 
     def parse(self):
-        return cde.ResizeOperation(self.size, DE_C_INTER_MODE.get(self.interpolation))
+        # deprecated api just support cpu device target
+        return cde.ResizeOperation(self.size, DE_C_INTER_MODE.get(self.interpolation), "CPU")
 
 
 class ResizeWithBBox(ImageTensorOperation):
@@ -2280,14 +2290,14 @@ 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.
-            It can be any of [Inter.LINEAR, Inter.NEAREST, Inter.BICUBIC].
+        interpolation (Inter, optional): Image interpolation mode. Default: ``Inter.LINEAR``.
+            It can be ``Inter.LINEAR``, ``Inter.NEAREST``, ``Inter.BICUBIC``.
 
-            - Inter.LINEAR, means interpolation method is bilinear interpolation.
+            - ``Inter.LINEAR`` , means interpolation method is bilinear interpolation.
 
-            - Inter.NEAREST, means interpolation method is nearest-neighbor interpolation.
+            - ``Inter.NEAREST`` , means interpolation method is nearest-neighbor interpolation.
 
-            - Inter.BICUBIC, means interpolation method is bicubic interpolation.
+            - ``Inter.BICUBIC`` , means interpolation method is bicubic interpolation.
 
     Raises:
         TypeError: If `size` is not of type int or Sequence[int].
@@ -2355,23 +2365,23 @@ class Rotate(ImageTensorOperation):
     Args:
         degrees (Union[int, float]): Rotation degrees.
 
-        resample (Inter, optional): An optional resampling filter. Default: Inter.NEAREST.
-            It can be any of [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC].
+        resample (Inter, optional): An optional resampling filter. Default: ``Inter.NEAREST``.
+            It can be ``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.
+            - ``Inter.BILINEA`` , 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
-            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.
+        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.
-            Origin is the top left corner. None sets to the center of the image.
+        center (tuple, optional): Optional center of rotation (a 2-tuple). Default: ``None``.
+            Origin is the top left corner. ``None`` sets to the center of the image.
         fill_value (Union[int, tuple[int]], optional): Optional fill color for the area outside the rotated image.
             If it is a 3-tuple, it is used to fill R, G, B channels respectively.
             If it is an integer, it is used for all RGB channels.
-            The fill_value values must be in range [0, 255]. Default: 0.
+            The fill_value values must be in range [0, 255]. Default: ``0``.
 
     Raises:
         TypeError: If `degrees` is not of type int or float.
@@ -2424,13 +2434,15 @@ 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.
-            It can be any of [SliceMode.PAD, SliceMode.DROP].
+        num_height (int, optional): The number of patches in vertical direction, which must be positive.
+            Default: ``1``.
+        num_width (int, optional): The number of patches in horizontal direction, which must be positive.
+            Default: ``1``.
+        slice_mode (Inter, optional): A mode represents pad or drop. Default: ``SliceMode.PAD``.
+            It can be ``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.
+            right and bottom direction if `slice_mode` is set to be ``SliceMode.PAD``.
+            The fill_value must be in range [0, 255]. Default: ``0``.
 
     Raises:
         TypeError: If `num_height` is not of type int.
@@ -2488,11 +2500,11 @@ class SoftDvppDecodeRandomCropResizeJpeg(ImageTensorOperation):
             If size is an integer, a square crop of size (size, size) is returned.
             If size is a sequence of length 2, an image of size (height, width) will be cropped.
         scale (Union[list, tuple], optional): Range [min, max) of respective size of the
-            original size to be cropped, which must be non-negative. Default: (0.08, 1.0).
+            original size to be cropped, which must be non-negative. Default: ``(0.08, 1.0)``.
         ratio (Union[list, tuple], optional): Range [min, max) of aspect ratio to be
-            cropped, which must be non-negative. Default: (3. / 4., 4. / 3.).
-        max_attempts (int, optional): The maximum number of attempts to propose a valid crop_area. Default: 10.
-            If exceeded, fall back to use center_crop instead. The max_attempts value must be positive.
+            cropped, which must be non-negative. Default: ``(3. / 4., 4. / 3.)``.
+        max_attempts (int, optional): The maximum number of attempts to propose a valid crop_area. Default: ``10``.
+            If exceeded, fall back to use center_crop instead. The `max_attempts` value must be positive.
 
     Raises:
         TypeError: If `size` is not of type int or Sequence[int].