!37802 modify the Chinese API files
Merge pull request !37802 from 宦晓玲/code_docs_07111
This commit is contained in:
Gitee
commit
a234e22608
|
|
@ -34,14 +34,14 @@ mindspore.dataset.text.JiebaTokenizer
|
|||
- **user_dict** (Union[str, dict]) - 有两种输入方式。可以通过指定jieba字典格式的文件路径加载。
|
||||
要求的jieba字典格式为：[word，freq]，如：
|
||||
|
||||
.. code-block::
|
||||
.. code-block::
|
||||
|
||||
word1 freq1
|
||||
word2 None
|
||||
word3 freq3
|
||||
word1 freq1
|
||||
word2 None
|
||||
word3 freq3
|
||||
|
||||
在提供的jieba字典文件中，只有有效的词对才会被添加到字典中，无效的输入行将被忽略，且不返回错误或警告状态。
|
||||
同时用户也可以通过Python dict定义要添加的词汇，要求的Python字典格式为：{word1:freq1, word2:freq2,...}。
|
||||
在提供的jieba字典文件中，只有有效的词对才会被添加到字典中，无效的输入行将被忽略，且不返回错误或警告状态。
|
||||
同时用户也可以通过Python dict定义要添加的词汇，要求的Python字典格式为：{word1:freq1, word2:freq2,...}。
|
||||
|
||||
.. py:method:: add_word(word, freq=None)
|
||||
|
||||
|
|
|
|||
|
|
@ -18,7 +18,7 @@ mindspore.dataset.text.NormalizeUTF8
|
|||
- NormalizeForm.NFD，对输入字符串进行D形式规范化。
|
||||
- NormalizeForm.NFKD，对输入字符串进行KD形式规范化。
|
||||
|
||||
有关规范化详细信息，请参阅 http://unicode.org/reports/tr15/。
|
||||
有关规范化详细信息，请参阅 http://unicode.org/reports/tr15/。
|
||||
|
||||
异常：
|
||||
- **TypeError** - 参数 `normalize_form` 的类型不是 :class:`mindspore.dataset.text.NormalizeForm` 。
|
||||
|
|
|
|||
|
|
@ -41,7 +41,7 @@
|
|||
- SentencePieceModel.CHAR：引用基于字符的SentencePiece模型类型。
|
||||
- SentencePieceModel.WORD：引用基于单词的SentencePiece模型类型。
|
||||
|
||||
- **params** (dict) - 表示没有传入参数的字典（参数派生自SentencePiece库）。
|
||||
- **params** (dict) - 表示没有传入参数的字典（参数派生自SentencePiece库）。
|
||||
|
||||
返回：
|
||||
SentencePieceVocab，表示从文件中构建的Vocab对象。
|
||||
|
|
|
|||
|
|
@ -5,15 +5,13 @@ mindspore.dataset.vision.AutoContrast
|
|||
|
||||
在输入图像上应用自动对比度。首先计算图像的直方图，将直方图中最亮像素的值映射为255，将直方图中最暗像素的值映射为0。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **cutoff** (float, 可选) - 输入图像直方图中最亮和最暗像素的百分比。该值必须在 [0.0, 50.0) 范围内，默认值：0.0。
|
||||
- **ignore** (Union[int, sequence], 可选) - 要忽略的背景像素值，忽略值必须在 [0, 255] 范围内，默认值：None。
|
||||
|
||||
- **cutoff** (float, 可选) - 输入图像直方图中最亮和最暗像素的百分比。该值必须在 [0.0, 50.0) 范围内，默认值：0.0。
|
||||
- **ignore** (Union[int, sequence], 可选) - 要忽略的背景像素值，忽略值必须在 [0, 255] 范围内，默认值：None。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `cutoff` 不是float类型。
|
||||
- **TypeError** - 如果 `ignore` 不是int或sequence类型。
|
||||
- **ValueError** - 如果 `cutoff` 不在[0, 50.0) 范围内。
|
||||
- **ValueError** - 如果 `ignore` 不在[0, 255] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `cutoff` 不是float类型。
|
||||
- **TypeError** - 如果 `ignore` 不是int或sequence类型。
|
||||
- **ValueError** - 如果 `cutoff` 不在[0, 50.0) 范围内。
|
||||
- **ValueError** - 如果 `ignore` 不在[0, 255] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,14 +5,12 @@ mindspore.dataset.vision.BoundingBoxAugment
|
|||
|
||||
对图像的随机标注边界框区域，应用给定的图像变换处理。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **transform** (TensorOperation) - 对图像的随机标注边界框区域应用的变换处理。
|
||||
- **ratio** (float, 可选) - 要应用变换的边界框的比例。范围：[0.0, 1.0]，默认值：0.3。
|
||||
|
||||
- **transform** (TensorOperation) - 对图像的随机标注边界框区域应用的变换处理。
|
||||
- **ratio** (float, 可选) - 要应用变换的边界框的比例。范围：[0.0, 1.0]，默认值：0.3。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `transform` 不是 :class:`mindspore.dataset.vision.transforms` 模块中的图像变换处理。
|
||||
- **TypeError** - 如果 `ratio` 不是float类型。
|
||||
- **ValueError** - 如果 `ratio` 不在 [0.0, 1.0] 范围内。
|
||||
- **RuntimeError** - 如果给定的边界框无效。
|
||||
异常：
|
||||
- **TypeError** - 如果 `transform` 不是 :class:`mindspore.dataset.vision.transforms` 模块中的图像变换处理。
|
||||
- **TypeError** - 如果 `ratio` 不是float类型。
|
||||
- **ValueError** - 如果 `ratio` 不在 [0.0, 1.0] 范围内。
|
||||
- **RuntimeError** - 如果给定的边界框无效。
|
||||
|
|
|
|||
|
|
@ -5,15 +5,13 @@ mindspore.dataset.vision.CenterCrop
|
|||
|
||||
对输入图像应用中心区域裁剪。如果输入图像尺寸小于输出尺寸，则在裁剪前对输入图像边界填充0像素。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **size** (Union[int, sequence]) - 裁剪区域尺寸大小。
|
||||
如果 `size` 是整数，则返回一个裁剪尺寸大小为 (size, size) 的正方形。
|
||||
如果 `size` 是一个长度为 2 的序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
值必须大于 0。
|
||||
|
||||
- **size** (Union[int, sequence]) - 裁剪区域尺寸大小。
|
||||
如果 `size` 是整数，则返回一个裁剪尺寸大小为 (size, size) 的正方形。
|
||||
如果 `size` 是一个长度为 2 的序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
值必须大于 0。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `size` 不是int或sequence类型。
|
||||
- **ValueError** - 如果 `size` 小于或等于 0。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `size` 不是int或sequence类型。
|
||||
- **ValueError** - 如果 `size` 小于或等于 0。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,32 +5,30 @@ mindspore.dataset.vision.ConvertColor
|
|||
|
||||
更改图像的色彩空间。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **convert_mode** (ConvertMode) - 图像色彩空间转换的模式。
|
||||
|
||||
- **convert_mode** (ConvertMode) - 图像色彩空间转换的模式。
|
||||
- **ConvertMode.COLOR_BGR2BGRA**: 将 BGR 图像转换为 BGRA 图像。
|
||||
- **ConvertMode.COLOR_RGB2RGBA**: 将 RGB 图像转换为 RGBA 图像。
|
||||
- **ConvertMode.COLOR_BGRA2BGR**: 将 BGRA 图像转换为 BGR 图像。
|
||||
- **ConvertMode.COLOR_RGBA2RGB**: 将 RGBA 图像转换为 RGB 图像。
|
||||
- **ConvertMode.COLOR_BGR2RGBA**: 将 BGR 图像转换为 RGBA 图像。
|
||||
- **ConvertMode.COLOR_RGB2BGRA**: 将 RGB 图像转换为 BGRA 图像。
|
||||
- **ConvertMode.COLOR_RGBA2BGR**: 将 RGBA 图像转换为 BGR 图像。
|
||||
- **ConvertMode.COLOR_BGRA2RGB**: 将 BGRA 图像转换为 RGB 图像。
|
||||
- **ConvertMode.COLOR_BGR2RGB**: 将 BGR 图像转换为 RGB 图像。
|
||||
- **ConvertMode.COLOR_RGB2BGR**: 将 RGB 图像转换为 BGR 图像。
|
||||
- **ConvertMode.COLOR_BGRA2RGBA**: 将 BGRA 图像转换为 RGBA 图像。
|
||||
- **ConvertMode.COLOR_RGBA2BGRA**: 将 RGBA 图像转换为 BGRA 图像。
|
||||
- **ConvertMode.COLOR_BGR2GRAY**: 将 BGR 图像转换为 GRAY 图像。
|
||||
- **ConvertMode.COLOR_RGB2GRAY**: 将 RGB 图像转换为 GRAY 图像。
|
||||
- **ConvertMode.COLOR_GRAY2BGR**: 将 GRAY 图像转换为 BGR 图像。
|
||||
- **ConvertMode.COLOR_GRAY2RGB**: 将 GRAY 图像转换为 RGB 图像。
|
||||
- **ConvertMode.COLOR_GRAY2BGRA**: 将 GRAY 图像转换为 BGRA 图像。
|
||||
- **ConvertMode.COLOR_GRAY2RGBA**: 将 GRAY 图像转换为 RGBA 图像。
|
||||
- **ConvertMode.COLOR_BGRA2GRAY**: 将 BGRA 图像转换为 GRAY 图像。
|
||||
- **ConvertMode.COLOR_RGBA2GRAY**: 将 RGBA 图像转换为 GRAY 图像。
|
||||
|
||||
- **ConvertMode.COLOR_BGR2BGRA**: 将 BGR 图像转换为 BGRA 图像。
|
||||
- **ConvertMode.COLOR_RGB2RGBA**:将 RGB 图像转换为 RGBA 图像。
|
||||
- **ConvertMode.COLOR_BGRA2BGR**: 将 BGRA 图像转换为 BGR 图像。
|
||||
- **ConvertMode.COLOR_RGBA2RGB**: 将 RGBA 图像转换为 RGB 图像。
|
||||
- **ConvertMode.COLOR_BGR2RGBA**: 将 BGR 图像转换为 RGBA 图像。
|
||||
- **ConvertMode.COLOR_RGB2BGRA**: 将 RGB 图像转换为 BGRA 图像。
|
||||
- **ConvertMode.COLOR_RGBA2BGR**: 将 RGBA 图像转换为 BGR 图像。
|
||||
- **ConvertMode.COLOR_BGRA2RGB**: 将 BGRA 图像转换为 RGB 图像。
|
||||
- **ConvertMode.COLOR_BGR2RGB**: 将 BGR 图像转换为 RGB 图像。
|
||||
- **ConvertMode.COLOR_RGB2BGR**: 将 RGB 图像转换为 BGR 图像。
|
||||
- **ConvertMode.COLOR_BGRA2RGBA**: 将 BGRA 图像转换为 RGBA 图像。
|
||||
- **ConvertMode.COLOR_RGBA2BGRA**: 将 RGBA 图像转换为 BGRA 图像。
|
||||
- **ConvertMode.COLOR_BGR2GRAY**: 将 BGR 图像转换为 GRAY 图像。
|
||||
- **ConvertMode.COLOR_RGB2GRAY**: 将 RGB 图像转换为 GRAY 图像。
|
||||
- **ConvertMode.COLOR_GRAY2BGR**: 将 GRAY 图像转换为 BGR 图像。
|
||||
- **ConvertMode.COLOR_GRAY2RGB**: 将 GRAY 图像转换为 RGB 图像。
|
||||
- **ConvertMode.COLOR_GRAY2BGRA**: 将 GRAY 图像转换为 BGRA 图像。
|
||||
- **ConvertMode.COLOR_GRAY2RGBA**: 将 GRAY 图像转换为 RGBA 图像。
|
||||
- **ConvertMode.COLOR_BGRA2GRAY**: 将 BGRA 图像转换为 GRAY 图像。
|
||||
- **ConvertMode.COLOR_RGBA2GRAY**: 将 RGBA 图像转换为 GRAY 图像。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `convert_mode` 不是类 :class:`mindspore.dataset.vision.ConvertMode` 的类型。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `convert_mode` 不是类 :class:`mindspore.dataset.vision.ConvertMode` 的类型。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,18 +5,16 @@ mindspore.dataset.vision.Crop
|
|||
|
||||
在输入图像上裁剪出指定区域。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **coordinates** (sequence) - 裁剪区域的起始左上角坐标。必须是两个值的序列，形式为(上，左)。
|
||||
- **size** (Union[int, sequence]) - 裁剪区域的尺寸大小。
|
||||
如果 `size` 是整数，则返回一个裁剪尺寸大小为 (size, size) 的正方形。
|
||||
如果 `size` 是一个长度为 2 的序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
值必须大于 0。
|
||||
|
||||
- **coordinates** (sequence) - 裁剪区域的起始左上角坐标。 必须是两个值的序列，形式为(上，左)。
|
||||
- **size** (Union[int, sequence]) - 裁剪区域的尺寸大小。
|
||||
如果 `size` 是整数，则返回一个裁剪尺寸大小为 (size, size) 的正方形。
|
||||
如果 `size` 是一个长度为 2 的序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
值必须大于 0。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `coordinates` 不是sequence类型。
|
||||
- **TypeError** - 如果 `size` 不是int或sequence类型。
|
||||
- **ValueError** - 如果 `coordinates` 小于 0。
|
||||
- **ValueError** - 如果 `size` 小于或等于 0。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `coordinates` 不是sequence类型。
|
||||
- **TypeError** - 如果 `size` 不是int或sequence类型。
|
||||
- **ValueError** - 如果 `coordinates` 小于 0。
|
||||
- **ValueError** - 如果 `size` 小于或等于 0。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -6,17 +6,15 @@ mindspore.dataset.vision.CutMixBatch
|
|||
对输入批次的图像和标注应用剪切混合转换。
|
||||
请注意，在调用此操作符之前，您需要将标注制作为 one-hot 格式并进行批处理。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **image_batch_format** (ImageBatchFormat) - 图像批处理输出格式。可以是 [ImageBatchFormat.NHWC、ImageBatchFormat.NCHW] 中的任何一个。
|
||||
- **alpha** (float, 可选) - β分布的超参数，必须大于0，默认值：1.0。
|
||||
- **prob** (float, 可选) - 对每个图像应用剪切混合处理的概率，范围：[0.0, 1.0]，默认值：1.0。
|
||||
|
||||
- **image_batch_format** (ImageBatchFormat) - 图像批处理输出格式。可以是 [ImageBatchFormat.NHWC、ImageBatchFormat.NCHW] 中的任何一个。
|
||||
- **alpha** (float, 可选) - β分布的超参数，必须大于0，默认值：1.0。
|
||||
- **prob** (float, 可选) - 对每个图像应用剪切混合处理的概率，范围：[0.0, 1.0]，默认值：1.0。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `image_batch_format` 不是 :class:`mindspore.dataset.vision.ImageBatchFormat` 的类型。
|
||||
- **TypeError** - 如果 `alpha` 不是float类型。
|
||||
- **TypeError** - 如果 `prob` 不是 float 类型。
|
||||
- **ValueError** - 如果 `alpha` 小于或等于 0。
|
||||
- **ValueError** - 如果 `prob` 不在 [0.0, 1.0] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `image_batch_format` 不是 :class:`mindspore.dataset.vision.ImageBatchFormat` 的类型。
|
||||
- **TypeError** - 如果 `alpha` 不是float类型。
|
||||
- **TypeError** - 如果 `prob` 不是 float 类型。
|
||||
- **ValueError** - 如果 `alpha` 小于或等于 0。
|
||||
- **ValueError** - 如果 `prob` 不在 [0.0, 1.0] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,17 +5,15 @@ mindspore.dataset.vision.CutOut
|
|||
|
||||
从输入图像数组中随机裁剪出给定数量的正方形区域。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **length** (int) - 每个正方形区域的边长，必须大于 0。
|
||||
- **num_patches** (int, 可选) - 要从图像中切出的正方形区域数，必须大于0，默认值：1。
|
||||
- **is_hwc** (bool, 可选) - 表示输入图像是否为HWC格式，True为HWC格式，False为CHW格式。默认值：True。
|
||||
|
||||
- **length** (int) - 每个正方形区域的边长，必须大于 0。
|
||||
- **num_patches** (int, 可选) - 要从图像中切出的正方形区域数，必须大于0，默认值：1。
|
||||
- **is_hwc** (bool, 可选) - 表示输入图像是否为HWC格式，True为HWC格式，False为CHW格式。默认值：True。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `length` 不是int类型。
|
||||
- **TypeError** - 如果 `num_patches` 不是int类型。
|
||||
- **TypeError** - 如果 `is_hwc` 不是bool类型。
|
||||
- **ValueError** - 如果 `length` 小于或等于 0。
|
||||
- **ValueError** - 如果 `num_patches` 小于或等于 0。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `length` 不是int类型。
|
||||
- **TypeError** - 如果 `num_patches` 不是int类型。
|
||||
- **TypeError** - 如果 `is_hwc` 不是bool类型。
|
||||
- **ValueError** - 如果 `length` 小于或等于 0。
|
||||
- **ValueError** - 如果 `num_patches` 小于或等于 0。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,12 +5,10 @@ mindspore.dataset.vision.Decode
|
|||
|
||||
将输入的压缩图像解码为RGB格式。当前支持的图片类型：JPEG, BMP, PNG, TIFF, GIF(需要指定 `to_pil=True`), WEBP(需要指定 `to_pil=True`)。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **to_pil** (bool，可选) - 是否将图像解码为PIL数据类型。若为True，图像将被解码为PIL数据类型，否则解码为NumPy数据类型。默认值：False。
|
||||
|
||||
- **to_pil** (bool，可选) - 是否将图像解码为PIL数据类型。若为True，图像将被解码为PIL数据类型，否则解码为NumPy数据类型。默认值：False。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **RuntimeError** - 如果输入图像不是一维序列。
|
||||
- **RuntimeError** - 如果输入数据不是合法的图像字节数据。
|
||||
- **RuntimeError** - 如果输入数据已经是解码的图像数据。
|
||||
异常：
|
||||
- **RuntimeError** - 如果输入图像不是一维序列。
|
||||
- **RuntimeError** - 如果输入数据不是合法的图像字节数据。
|
||||
- **RuntimeError** - 如果输入数据已经是解码的图像数据。
|
||||
|
|
|
|||
|
|
@ -5,6 +5,5 @@ mindspore.dataset.vision.Equalize
|
|||
|
||||
对输入图像进行直方图均衡化。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
异常：
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,11 +5,9 @@ mindspore.dataset.vision.FiveCrop
|
|||
|
||||
在输入PIL图像的中心与四个角处分别裁剪指定尺寸大小的子图。
|
||||
|
||||
**参数：**
|
||||
|
||||
- **size** (Union[int, Sequence[int, int]]) - 裁剪子图的尺寸大小。若输入int，则以该值为边长裁剪( `size` , `size` )尺寸大小的子图；若输入Sequence[int, int]，则以2个元素分别为高和宽裁剪子图。
|
||||
参数：
|
||||
- **size** (Union[int, Sequence[int, int]]) - 裁剪子图的尺寸大小。若输入int，则以该值为边长裁剪( `size` , `size` )尺寸大小的子图；若输入Sequence[int, int]，则以2个元素分别为高和宽裁剪子图。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `size` 的类型不为int或Sequence[int, int]。
|
||||
- **ValueError** - 当 `size` 不为正数。
|
||||
异常：
|
||||
- **TypeError** - 当 `size` 的类型不为int或Sequence[int, int]。
|
||||
- **ValueError** - 当 `size` 不为正数。
|
||||
|
|
|
|||
|
|
@ -5,20 +5,18 @@ mindspore.dataset.vision.GaussianBlur
|
|||
|
||||
使用指定的高斯核对输入图像进行模糊处理。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **kernel_size** (Union[int, Sequence[int]]) - 要使用的高斯核的大小。该值必须是正数和奇数。
|
||||
如果只提供一个整数，高斯核大小将为 (kernel_size, kernel_size)。
|
||||
如果提供了整数序列，则它必须是表示（宽度、高度）的 2 个值的序列。
|
||||
- **sigma** (Union[float, Sequence[float]], 可选) - 要使用的高斯核的标准差，该值必须是正数，默认值：None。
|
||||
如果仅提供浮点数，则 `sigma` 将为 (sigma, sigma)。
|
||||
如果提供了浮点序列，则它必须是表示（宽度、高度）的 2 个值的序列。
|
||||
如果为None， `sigma` 采用的值为 ((kernel\underline{} size - 1) * 0.5 - 1) * 0.3 + 0.8。
|
||||
|
||||
- **kernel_size** (Union[int, Sequence[int]]) - 要使用的高斯核的大小。该值必须是正数和奇数。
|
||||
如果只提供一个整数，高斯核大小将为 (kernel_size, kernel_size)。
|
||||
如果提供了整数序列，则它必须是表示（宽度、高度）的 2 个值的序列。
|
||||
- **sigma** (Union[float, Sequence[float]], 可选) - 要使用的高斯核的标准差，该值必须是正数，默认值：None。
|
||||
如果仅提供浮点数，则 `sigma` 将为 (sigma, sigma)。
|
||||
如果提供了浮点序列，则它必须是表示（宽度、高度）的 2 个值的序列。
|
||||
如果为None， `sigma` 采用的值为 ((kernel\underline{} size - 1) * 0.5 - 1) * 0.3 + 0.8。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `kernel_size` 不是int或Sequence[int]类型。
|
||||
- **TypeError** - 如果 `sigma` 不是float或Sequence[float]类型。
|
||||
- **ValueError** - 如果 `kernel_size` 不是正数和奇数。
|
||||
- **ValueError** - 如果 `sigma` 不是正数。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `kernel_size` 不是int或Sequence[int]类型。
|
||||
- **TypeError** - 如果 `sigma` 不是float或Sequence[float]类型。
|
||||
- **ValueError** - 如果 `kernel_size` 不是正数和奇数。
|
||||
- **ValueError** - 如果 `sigma` 不是正数。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,11 +5,9 @@ mindspore.dataset.vision.Grayscale
|
|||
|
||||
将输入PIL图像转换为灰度图。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **num_output_channels** (int) - 输出灰度图的通道数，取值可为1或3。当取值为3时，返回图像各通道的像素值将相同。默认值：1。
|
||||
|
||||
- **num_output_channels** (int) - 输出灰度图的通道数，取值可为1或3。当取值为3时，返回图像各通道的像素值将相同。默认值：1。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `num_output_channels` 的类型不为int。
|
||||
- **ValueError** - 当 `num_output_channels` 取值不为1或3。
|
||||
异常：
|
||||
- **TypeError** - 当 `num_output_channels` 的类型不为int。
|
||||
- **ValueError** - 当 `num_output_channels` 取值不为1或3。
|
||||
|
|
|
|||
|
|
@ -8,6 +8,5 @@ mindspore.dataset.vision.HWC2CHW
|
|||
|
||||
.. note:: 此操作支持通过 Offload 在 Ascend 或 GPU 平台上运行。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
异常：
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,6 +5,5 @@ mindspore.dataset.vision.HorizontalFlip
|
|||
|
||||
水平翻转输入图像。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
异常：
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,10 +5,8 @@ mindspore.dataset.vision.HsvToRgb
|
|||
|
||||
将输入的HSV格式numpy.ndarray图像转换为RGB格式。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **is_hwc** (bool) - 若为True，表示输入图像的shape为(H, W, C)或(N, H, W, C)；否则为(C, H, W)或(N, C, H, W)。默认值：False。
|
||||
|
||||
- **is_hwc** (bool) - 若为True，表示输入图像的shape为(H, W, C)或(N, H, W, C)；否则为(C, H, W)或(N, C, H, W)。默认值：False。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `is_hwc` 的类型不为bool。
|
||||
异常：
|
||||
- **TypeError** - 当 `is_hwc` 的类型不为bool。
|
||||
|
|
|
|||
|
|
@ -5,6 +5,5 @@ mindspore.dataset.vision.Invert
|
|||
|
||||
在 RGB 模式下对输入图像应用像素反转，计算方式为（255 - pixel）。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W, C>。
|
||||
异常：
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -7,17 +7,15 @@ mindspore.dataset.vision.LinearTransformation
|
|||
|
||||
先将输入图像展平为一维，从中减去均值向量，然后计算其与变换方阵的点积，最后再变形回原始shape。
|
||||
|
||||
**参数：**
|
||||
|
||||
- **transformation_matrix** (numpy.ndarray) - shape为(D, D)的变换方阵，其中
|
||||
参数：
|
||||
- **transformation_matrix** (numpy.ndarray) - shape为(D, D)的变换方阵，其中
|
||||
|
||||
:math:`D = C \times H \times W` 。
|
||||
:math:`D = C \times H \times W` 。
|
||||
|
||||
- **mean_vector** (numpy.ndarray) - shape为(D,)的均值向量，其中
|
||||
- **mean_vector** (numpy.ndarray) - shape为(D,)的均值向量，其中
|
||||
|
||||
:math:`D = C \times H \times W` 。
|
||||
:math:`D = C \times H \times W` 。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `transformation_matrix` 的类型不为 :class:`numpy.ndarray` 。
|
||||
- **TypeError** - 当 `mean_vector` 的类型不为 :class:`numpy.ndarray` 。
|
||||
异常：
|
||||
- **TypeError** - 当 `transformation_matrix` 的类型不为 :class:`numpy.ndarray` 。
|
||||
- **TypeError** - 当 `mean_vector` 的类型不为 :class:`numpy.ndarray` 。
|
||||
|
|
|
|||
|
|
@ -7,16 +7,14 @@ mindspore.dataset.vision.MixUp
|
|||
|
||||
首先将每个图像乘以一个从Beta分布随机生成的权重 :math:`lambda` ，然后加上另一个图像与 :math:`1 - lambda` 之积，最后使用同样的 :math:`lambda` 值将图像对应的标签进行混合，请确保标签预先进行了one-hot编码。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **batch_size** (int) - 批处理大小，即图片的数量。
|
||||
- **alpha** (float) - Beta分布的α参数值，β参数也将使用该值。
|
||||
- **is_single** (bool，可选) - 若为True，将在批内随机混合图像[img0, ..., img(n-1), img(n)]与[img1, ..., img(n), img0]及对应标签；否则，将每批图像与前一批图像的处理结果混合。默认值：True。
|
||||
|
||||
- **batch_size** (int) - 批处理大小，即图片的数量。
|
||||
- **alpha** (float) - Beta分布的α参数值，β参数也将使用该值。
|
||||
- **is_single** (bool，可选) - 若为True，将在批内随机混合图像[img0, ..., img(n-1), img(n)]与[img1, ..., img(n), img0]及对应标签；否则，将每批图像与前一批图像的处理结果混合。默认值：True。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `batch_size` 的类型不为int。
|
||||
- **TypeError** - 当 `alpha` 的类型不为float。
|
||||
- **TypeError** - 当 `is_single` 的类型不为bool。
|
||||
- **ValueError** - 当 `batch_size` 不为正数。
|
||||
- **ValueError** - 当 `alpha` 不为正数。
|
||||
异常：
|
||||
- **TypeError** - 当 `batch_size` 的类型不为int。
|
||||
- **TypeError** - 当 `alpha` 的类型不为float。
|
||||
- **TypeError** - 当 `is_single` 的类型不为bool。
|
||||
- **ValueError** - 当 `batch_size` 不为正数。
|
||||
- **ValueError** - 当 `alpha` 不为正数。
|
||||
|
|
|
|||
|
|
@ -9,12 +9,10 @@ mindspore.dataset.vision.MixUpBatch
|
|||
|
||||
请注意，在调用此处理之前，您需要将标注制作成 one-hot 格式并进行batch操作。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **alpha** (float, 可选) - β分布的超参数，该值必须为正，默认值：1.0。
|
||||
|
||||
- **alpha** (float, 可选) - β分布的超参数，该值必须为正，默认值：1.0。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `alpha` 不是float类型。
|
||||
- **ValueError** - 如果 `alpha` 不是正数。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <N, H, W, C> 或 <N, C, H, W>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `alpha` 不是float类型。
|
||||
- **ValueError** - 如果 `alpha` 不是正数。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <N, H, W, C> 或 <N, C, H, W>。
|
||||
|
|
|
|||
|
|
@ -9,16 +9,14 @@ mindspore.dataset.vision.Normalize
|
|||
|
||||
.. note:: 此操作支持通过 Offload 在 Ascend 或 GPU 平台上运行。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **mean** (sequence) - 图像每个通道的均值组成的列表或元组。平均值必须在 [0.0, 255.0] 范围内。
|
||||
- **std** (sequence) - 图像每个通道的标准差组成的列表或元组。标准差值必须在 (0.0, 255.0] 范围内。
|
||||
- **is_hwc** (bool, 可选) - 表示输入图像是否为HWC格式，True为HWC格式，False为CHW格式。默认值：True。
|
||||
|
||||
- **mean** (sequence) - 图像每个通道的均值组成的列表或元组。平均值必须在 [0.0, 255.0] 范围内。
|
||||
- **std** (sequence) - 图像每个通道的标准差组成的列表或元组。标准差值必须在 (0.0, 255.0] 范围内。
|
||||
- **is_hwc** (bool, 可选) - 表示输入图像是否为HWC格式，True为HWC格式，False为CHW格式。默认值：True。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `mean` 不是sequence类型。
|
||||
- **TypeError** - 如果 `std` 不是sequence类型。
|
||||
- **TypeError** - 如果 `is_hwc` 不是bool类型。
|
||||
- **ValueError** - 如果 `mean` 不在 [0.0, 255.0] 范围内。
|
||||
- **ValueError** - 如果 `mean` 不在范围内 (0.0, 255.0]。
|
||||
异常：
|
||||
- **TypeError** - 如果 `mean` 不是sequence类型。
|
||||
- **TypeError** - 如果 `std` 不是sequence类型。
|
||||
- **TypeError** - 如果 `is_hwc` 不是bool类型。
|
||||
- **ValueError** - 如果 `mean` 不在 [0.0, 255.0] 范围内。
|
||||
- **ValueError** - 如果 `mean` 不在范围内 (0.0, 255.0]。
|
||||
|
|
|
|||
|
|
@ -5,19 +5,17 @@ mindspore.dataset.vision.NormalizePad
|
|||
|
||||
根据均值和标准差对输入图像进行归一化，然后填充一个全零的额外通道。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **mean** (sequence) - 图像每个通道的均值组成的列表或元组。平均值必须在 (0.0, 255.0] 范围内。
|
||||
- **std** (sequence) - 图像每个通道的标准差组成的列表或元组。标准差值必须在 (0.0, 255.0] 范围内。
|
||||
- **dtype** (str, 可选) - 输出图像的数据类型，默认值："float32"。
|
||||
- **is_hwc** (bool, 可选) - 表示输入图像是否为HWC格式，True为HWC格式，False为CHW格式。默认值：True。
|
||||
|
||||
- **mean** (sequence) - 图像每个通道的均值组成的列表或元组。平均值必须在 (0.0, 255.0] 范围内。
|
||||
- **std** (sequence) - 图像每个通道的标准差组成的列表或元组。标准差值必须在 (0.0, 255.0] 范围内。
|
||||
- **dtype** (str, 可选) - 输出图像的数据类型，默认值："float32"。
|
||||
- **is_hwc** (bool, 可选) - 表示输入图像是否为HWC格式，True为HWC格式，False为CHW格式。默认值：True。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `mean` 不是sequence类型。
|
||||
- **TypeError** - 如果 `std` 不是sequence类型。
|
||||
- **TypeError** - 如果 `dtype` 不是str类型。
|
||||
- **TypeError** - 如果 `is_hwc` 不是bool类型。
|
||||
- **ValueError** - 如果 `mean` 不在 [0.0, 255.0] 范围内。
|
||||
- **ValueError** - 如果 `std` 不在范围内 (0.0, 255.0]。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W>, <H, W, C> 或 <C, H, W>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `mean` 不是sequence类型。
|
||||
- **TypeError** - 如果 `std` 不是sequence类型。
|
||||
- **TypeError** - 如果 `dtype` 不是str类型。
|
||||
- **TypeError** - 如果 `is_hwc` 不是bool类型。
|
||||
- **ValueError** - 如果 `mean` 不在 [0.0, 255.0] 范围内。
|
||||
- **ValueError** - 如果 `std` 不在范围内 (0.0, 255.0]。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W>, <H, W, C> 或 <C, H, W>。
|
||||
|
|
|
|||
|
|
@ -5,31 +5,29 @@ mindspore.dataset.vision.Pad
|
|||
|
||||
填充图像。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **padding** (Union[int, Sequence[int]]) - 图像各边填充的像素数。
|
||||
如果 `padding` 是一个整数，代表为图像的所有方向填充该值大小的像素。
|
||||
如果 `padding` 是一个包含2个值的元组或列表，第一个值会用于填充图像的左侧和上侧，第二个值会用于填充图像的右侧和下侧。
|
||||
如果 `padding` 是一个包含4个值的元组或列表，则分别填充图像的左侧、上侧、右侧和下侧。
|
||||
填充值必须为非负值。
|
||||
- **fill_value** (Union[int, tuple[int]], 可选) - 填充的像素值，仅在 `padding_mode` 取值为Border.CONSTANT时有效。
|
||||
如果是3元素元组，则分别用于填充R、G、B通道。
|
||||
如果是整数，则用于所有 RGB 通道。
|
||||
`fill_value` 值必须在 [0, 255] 范围内，默认值：0。
|
||||
- **padding_mode** (Border, 可选) - 边界填充方式。可以是 [Border.CONSTANT、Border.EDGE、Border.REFLECT、Border.SYMMETRIC] 中的任何一个，默认值：Border.CONSTANT。
|
||||
|
||||
- **padding** (Union[int, Sequence[int]]) - 图像各边填充的像素数。
|
||||
如果 `padding` 是一个整数，代表为图像的所有方向填充该值大小的像素。
|
||||
如果 `padding` 是一个包含2个值的元组或列表，第一个值会用于填充图像的左侧和上侧，第二个值会用于填充图像的右侧和下侧。
|
||||
如果 `padding` 是一个包含4个值的元组或列表，则分别填充图像的左侧、上侧、右侧和下侧。
|
||||
填充值必须为非负值。
|
||||
- **fill_value** (Union[int, tuple[int]], 可选) - 填充的像素值，仅在 `padding_mode` 取值为Border.CONSTANT时有效。
|
||||
如果是3元素元组，则分别用于填充R、G、B通道。
|
||||
如果是整数，则用于所有 RGB 通道。
|
||||
`fill_value` 值必须在 [0, 255] 范围内, 默认值：0。
|
||||
- **padding_mode** (Border, 可选) - 边界填充方式。可以是 [Border.CONSTANT、Border.EDGE、Border.REFLECT、Border.SYMMETRIC] 中的任何一个，默认值：Border.CONSTANT。
|
||||
|
||||
- **Border.CONSTANT** - 使用常量值进行填充。
|
||||
- **Border.EDGE** - 使用各边的边界像素值进行填充。
|
||||
- **Border.REFLECT** - 以各边的边界为轴进行镜像填充，忽略边界像素值。
|
||||
- **Border.SYMMETRIC** - 以各边的边界为轴进行对称填充，包括边界像素值。
|
||||
- **Border.CONSTANT** - 使用常量值进行填充。
|
||||
- **Border.EDGE** - 使用各边的边界像素值进行填充。
|
||||
- **Border.REFLECT** - 以各边的边界为轴进行镜像填充，忽略边界像素值。
|
||||
- **Border.SYMMETRIC** - 以各边的边界为轴进行对称填充，包括边界像素值。
|
||||
|
||||
.. note:: 当 `padding` 输入长度为2的序列时的行为未来将从使用第一个值填充左/上边界，使用第二个值填充右/下边界，变为使用第一个值填充左/右边界，使用第二个值填充上/下边界。你也可以直接输入长度为4的序列来分别指定左、上、右和下边界的填充长度。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `padding` 不是int或Sequence[int]类型。
|
||||
- **TypeError** - 如果 `fill_value` 不是int或tuple[int]类型。
|
||||
- **TypeError** - 如果 `padding_mode` 不是 :class:`mindspore.dataset.vision.Border` 的类型。
|
||||
- **ValueError** - 如果 `padding` 为负数。
|
||||
- **ValueError** - 如果 `fill_value` 不在 [0, 255] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `padding` 不是int或Sequence[int]类型。
|
||||
- **TypeError** - 如果 `fill_value` 不是int或tuple[int]类型。
|
||||
- **TypeError** - 如果 `padding_mode` 不是 :class:`mindspore.dataset.vision.Border` 的类型。
|
||||
- **ValueError** - 如果 `padding` 为负数。
|
||||
- **ValueError** - 如果 `fill_value` 不在 [0, 255] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,41 +5,39 @@ mindspore.dataset.vision.RandomAffine
|
|||
|
||||
对输入图像应用随机仿射变换。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **degrees** (Union[int, float, sequence]) - 旋转度数的范围。
|
||||
如果 `degrees` 是一个数字，它代表旋转范围是(-degrees, degrees)。
|
||||
如果 `degrees` 是一个序列，它代表旋转是 (min, max)。
|
||||
- **translate** (sequence, 可选) - 一个序列(tx_min, tx_max, ty_min, ty_max)用于表示水平(tx)方向和垂直(ty)方向的最小/最大平移范围，取值范围 [-1.0, 1.0]，默认值：None。
|
||||
水平和垂直偏移分别从以下范围中随机选择：(tx_min*width, tx_max*width) 和 (ty_min*height, ty_max*height)。
|
||||
如果 `translate` 是一个包含2个值的元组或列表，则 (translate[0], translate[1]) 表示水平(X)方向的随机平移范围。
|
||||
如果 `translate` 是一个包含4个值的元组或列表，则 (translate[0], translate[1]) 表示水平(X)方向的随机平移范围，(translate[2], translate[3])表示垂直(Y)方向的随机平移范围。
|
||||
如果为None，则不对图像进行任何平移。
|
||||
- **scale** (sequence, 可选) - 图像的比例因子的随机范围，必须为非负数，使用原始比例，默认值：None。
|
||||
- **shear** (Union[int, float, sequence], 可选) - 图像的剪切因子的随机范围，必须为正数，默认值：None。
|
||||
如果是数字，则应用在 (-shear, +shear) 范围内平行于 X 轴的剪切。
|
||||
如果 `shear` 是一个包含2个值的元组或列表，则在 (shear[0],shear[1]) 范围内进行水平(X)方向的剪切变换。
|
||||
如果 `shear` 是一个包含4个值的元组或列表，则在 (shear[0],shear[1]) 范围内进行水平(X)方向的剪切变换，并在(shear[2], shear[3])范围内进行垂直(Y)方向的剪切变换。
|
||||
如果为None，则不应用任何剪切。
|
||||
- **resample** (Inter, 可选) - 图像插值方式。它可以是 [Inter.BILINEAR、Inter.NEAREST、Inter.BICUBIC、Inter.AREA] 中的任何一个，默认值：Inter.NEAREST。
|
||||
|
||||
- **degrees** (Union[int, float, sequence]) - 旋转度数的范围。
|
||||
如果 `degrees` 是一个数字，它代表旋转范围是(-degrees, degrees)。
|
||||
如果 `degrees` 是一个序列，它代表旋转是 (min, max)。
|
||||
- **translate** (sequence, 可选) - 一个序列(tx_min, tx_max, ty_min, ty_max)用于表示水平(tx)方向和垂直(ty)方向的最小/最大平移范围，取值范围 [-1.0, 1.0]，默认值：None。
|
||||
水平和垂直偏移分别从以下范围中随机选择：(tx_min*width, tx_max*width) 和 (ty_min*height, ty_max*height)。
|
||||
如果 `translate` 是一个包含2个值的元组或列表，则 (translate[0], translate[1]) 表示水平(X)方向的随机平移范围。
|
||||
如果 `translate` 是一个包含4个值的元组或列表，则 (translate[0], translate[1]) 表示水平(X)方向的随机平移范围，(translate[2], translate[3])表示垂直(Y)方向的随机平移范围。
|
||||
如果为None，则不对图像进行任何平移。
|
||||
- **scale** (sequence, 可选) - 图像的比例因子的随机范围，必须为非负数，使用原始比例，默认值：None。
|
||||
- **shear** (Union[int, float, sequence], 可选) - 图像的剪切因子的随机范围，必须为正数，默认值：None。
|
||||
如果是数字，则应用在 (-shear, +shear) 范围内平行于 X 轴的剪切。
|
||||
如果 `shear` 是一个包含2个值的元组或列表，则在 (shear[0],shear[1]) 范围内进行水平(X)方向的剪切变换。
|
||||
如果 `shear` 是一个包含4个值的元组或列表，则在 (shear[0],shear[1]) 范围内进行水平(X)方向的剪切变换，并在(shear[2], shear[3])范围内进行垂直(Y)方向的剪切变换。
|
||||
如果为None，则不应用任何剪切。
|
||||
- **resample** (Inter, 可选) - 图像插值方式。它可以是 [Inter.BILINEAR、Inter.NEAREST、Inter.BICUBIC、Inter.AREA] 中的任何一个，默认值：Inter.NEAREST。
|
||||
- **Inter.BILINEAR**: 双线性插值。
|
||||
- **Inter.NEAREST**: 最近邻插值。
|
||||
- **Inter.BICUBIC**: 双三次插值。
|
||||
- **Inter.AREA**: 像素区域插值。
|
||||
|
||||
- **Inter.BILINEAR**: 双线性插值。
|
||||
- **Inter.NEAREST**: 最近邻插值。
|
||||
- **Inter.BICUBIC**: 双三次插值。
|
||||
- **Inter.AREA**: 像素区域插值。
|
||||
- **fill_value** (Union[int, tuple[int]], 可选) - 用于填充输出图像中变换之外的区域。元组中必须有三个值，取值范围是[0, 255]，默认值：0。
|
||||
|
||||
- **fill_value** (Union[int, tuple[int]], 可选) - 用于填充输出图像中变换之外的区域。元组中必须有三个值，取值范围是[0, 255]，默认值：0。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `degrees` 不是int、float或sequence类型。
|
||||
- **TypeError** - 如果 `translate` 不是sequence类型。
|
||||
- **TypeError** - 如果 `scale` 不是sequence类型。
|
||||
- **TypeError** - 如果 `shear` 不是int、float或sequence类型。
|
||||
- **TypeError** - 如果 `resample` 不是 :class:`mindspore.dataset.vision.Inter` 的类型。
|
||||
- **TypeError** - 如果 `fill_value` 不是int或tuple[int]类型。
|
||||
- **ValueError** - 如果 `degrees` 为负数。
|
||||
- **ValueError** - 如果 `translate` 不在范围 [-1.0, 1.0] 内。
|
||||
- **ValueError** - 如果 `scale` 为负数。
|
||||
- **ValueError** - 如果 `shear` 不是正数。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `degrees` 不是int、float或sequence类型。
|
||||
- **TypeError** - 如果 `translate` 不是sequence类型。
|
||||
- **TypeError** - 如果 `scale` 不是sequence类型。
|
||||
- **TypeError** - 如果 `shear` 不是int、float或sequence类型。
|
||||
- **TypeError** - 如果 `resample` 不是 :class:`mindspore.dataset.vision.Inter` 的类型。
|
||||
- **TypeError** - 如果 `fill_value` 不是int或tuple[int]类型。
|
||||
- **ValueError** - 如果 `degrees` 为负数。
|
||||
- **ValueError** - 如果 `translate` 不在范围 [-1.0, 1.0] 内。
|
||||
- **ValueError** - 如果 `scale` 为负数。
|
||||
- **ValueError** - 如果 `shear` 不是正数。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,13 +5,11 @@ mindspore.dataset.vision.RandomColor
|
|||
|
||||
随机调整输入图像的颜色。此操作仅适用于 3 通道RGB图像。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **degrees** (Sequence[float], 可选) - 色彩调节系数的范围，必须为非负数。它应该是(min, max)格式。
|
||||
如果min与max相等，则代表色彩变化步长固定，默认值：(0.1, 1.9)。
|
||||
|
||||
- **degrees** (Sequence[float], 可选) - 色彩调节系数的范围，必须为非负数。它应该是(min, max)格式。
|
||||
如果min与max相等，则代表色彩变化步长固定，默认值：(0.1, 1.9)。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `degrees` 不是Sequence[float]类型。
|
||||
- **ValueError** - 如果 `degrees` 为负数。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `degrees` 不是Sequence[float]类型。
|
||||
- **ValueError** - 如果 `degrees` 为负数。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -7,29 +7,27 @@ mindspore.dataset.vision.RandomColorAdjust
|
|||
|
||||
.. note:: 此操作支持通过 Offload 在 Ascend 或 GPU 平台上运行。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **brightness** (Union[float, Sequence[float]], 可选) - 亮度调整因子。不能为负，默认值：(1, 1)。
|
||||
如果是浮点数，则从 [max(0, 1-brightness), 1+brightness] 范围内统一选择因子。
|
||||
如果它是一个序列，则代表是范围 [min, max]，从此范围中选择调整因子。
|
||||
- **contrast** (Union[float, Sequence[float]], 可选) - 对比度调整因子。不能为负，默认值：(1, 1)。
|
||||
如果是浮点数，则从 [max(0, 1-contrast), 1+contrast] 范围内统一选择因子。
|
||||
如果它是一个序列，则代表是范围 [min, max]，从此范围中选择调整因子。
|
||||
- **saturation** (Union[float, Sequence[float]], 可选) - 饱和度调整因子。不能为负，默认值：(1, 1)。
|
||||
如果是浮点数，则从 [max(0, 1-saturation), 1+saturation] 范围内统一选择因子。
|
||||
如果它是一个序列，则代表是范围 [min, max]，从此范围中选择调整因子。
|
||||
- **hue** (Union[float, Sequence[float]], 可选) - 色调调整因子，默认值：(0, 0)。
|
||||
如果是浮点数，则代表是范围 [-hue, hue]，从此范围中选择调整因子。注意 `hue` 取值应为[0, 0.5]。
|
||||
如果它是一个序列，则代表是范围 [min, max]，从此范围中选择调整因子。注意取值范围min和max是 [-0.5, 0.5] 范围内的浮点数，并且min小于等于max。
|
||||
|
||||
- **brightness** (Union[float, Sequence[float]], 可选) - 亮度调整因子。不能为负，默认值：(1, 1)。
|
||||
如果是浮点数，则从 [max(0, 1-brightness), 1+brightness] 范围内统一选择因子。
|
||||
如果它是一个序列，则代表是范围 [min, max]，从此范围中选择调整因子。
|
||||
- **contrast** (Union[float, Sequence[float]], 可选) - 对比度调整因子。不能为负，默认值：(1, 1)。
|
||||
如果是浮点数，则从 [max(0, 1-contrast), 1+contrast] 范围内统一选择因子。
|
||||
如果它是一个序列，则代表是范围 [min, max]，从此范围中选择调整因子。
|
||||
- **saturation** (Union[float, Sequence[float]], 可选) - 饱和度调整因子。不能为负，默认值：(1, 1)。
|
||||
如果是浮点数，则从 [max(0, 1-saturation), 1+saturation] 范围内统一选择因子。
|
||||
如果它是一个序列，则代表是范围 [min, max]，从此范围中选择调整因子。
|
||||
- **hue** (Union[float, Sequence[float]], 可选) - 色调调整因子，默认值：(0, 0)。
|
||||
如果是浮点数，则代表是范围 [-hue, hue]，从此范围中选择调整因子。注意 `hue` 取值应为[0, 0.5]。
|
||||
如果它是一个序列，则代表是范围 [min, max]，从此范围中选择调整因子。注意取值范围min和max是 [-0.5, 0.5] 范围内的浮点数，并且min小于等于max。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `brightness` 不是float或Sequence[float]类型。
|
||||
- **TypeError** - 如果 `contrast` 不是float或Sequence[float]类型。
|
||||
- **TypeError** - 如果 `saturation` 不是float或Sequence[float]类型。
|
||||
- **TypeError** - 如果 `hue` 不是float或Sequence[float]类型。
|
||||
- **ValueError** - 如果 `brightness` 为负数。
|
||||
- **ValueError** - 如果 `contrast` 为负数。
|
||||
- **ValueError** - 如果 `saturation` 为负数。
|
||||
- **ValueError** - 如果 `hue` 不在 [-0.5, 0.5] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `brightness` 不是float或Sequence[float]类型。
|
||||
- **TypeError** - 如果 `contrast` 不是float或Sequence[float]类型。
|
||||
- **TypeError** - 如果 `saturation` 不是float或Sequence[float]类型。
|
||||
- **TypeError** - 如果 `hue` 不是float或Sequence[float]类型。
|
||||
- **ValueError** - 如果 `brightness` 为负数。
|
||||
- **ValueError** - 如果 `contrast` 为负数。
|
||||
- **ValueError** - 如果 `saturation` 为负数。
|
||||
- **ValueError** - 如果 `hue` 不在 [-0.5, 0.5] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -7,38 +7,36 @@ mindspore.dataset.vision.RandomCrop
|
|||
|
||||
.. note:: 如果在多个数据列上应用此处理，则需要确保每个数据列图像的shape相同。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **size** (Union[int, Sequence[int]]) - 裁剪图像的输出尺寸大小。值必须为正。
|
||||
如果 size 是整数，则返回一个裁剪尺寸大小为 (size, size) 的正方形。
|
||||
如果 size 是一个长度为 2 的序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
- **padding** (Union[int, Sequence[int]], 可选) - 图像各边填充的像素数。填充值必须为非负值，默认值：None。
|
||||
如果 `padding` 不为 None，则首先使用 `padding` 填充图像。
|
||||
如果 `padding` 是一个整数，代表为图像的所有方向填充该值大小的像素。
|
||||
如果 `padding` 是一个包含2个值的元组或列表，第一个值会用于填充图像的左侧和上侧，第二个值会用于填充图像的右侧和下侧。
|
||||
如果 `padding` 是一个包含4个值的元组或列表，则分别填充图像的左侧、上侧、右侧和下侧。
|
||||
- **pad_if_needed** (bool, 可选) - 如果输入图像高度或者宽度小于 `size` 指定的输出图像尺寸大小，是否进行填充。默认值：False。
|
||||
- **fill_value** (Union[int, tuple[int]], 可选) - 边框的像素强度，仅当 `padding_mode` 为 Border.CONSTANT 时有效。
|
||||
如果是3元素元组，则分别用于填充R、G、B通道。
|
||||
如果是整数，则用于所有RGB通道。
|
||||
`fill_value` 值必须在 [0, 255] 范围内，默认值：0。
|
||||
- **padding_mode** (Border, 可选) - 边界填充方式。它可以是 [Border.CONSTANT、Border.EDGE、Border.REFLECT、Border.SYMMETRIC] 中的任何一个，默认值：Border.CONSTANT。
|
||||
|
||||
- **size** (Union[int, Sequence[int]]) - 裁剪图像的输出尺寸大小。值必须为正。
|
||||
如果 size 是整数，则返回一个裁剪尺寸大小为 (size, size) 的正方形。
|
||||
如果 size 是一个长度为 2 的序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
- **padding** (Union[int, Sequence[int]], 可选) - 图像各边填充的像素数。填充值必须为非负值，默认值：None。
|
||||
如果 `padding` 不为 None，则首先使用 `padding` 填充图像。
|
||||
如果 `padding` 是一个整数，代表为图像的所有方向填充该值大小的像素。
|
||||
如果 `padding` 是一个包含2个值的元组或列表，第一个值会用于填充图像的左侧和上侧，第二个值会用于填充图像的右侧和下侧。
|
||||
如果 `padding` 是一个包含4个值的元组或列表，则分别填充图像的左侧、上侧、右侧和下侧。
|
||||
- **pad_if_needed** (bool, 可选) - 如果输入图像高度或者宽度小于 `size` 指定的输出图像尺寸大小，是否进行填充。默认值：False。
|
||||
- **fill_value** (Union[int, tuple[int]], 可选) - 边框的像素强度，仅当 `padding_mode` 为 Border.CONSTANT 时有效。
|
||||
如果是3元素元组，则分别用于填充R、G、B通道。
|
||||
如果是整数，则用于所有RGB通道。
|
||||
`fill_value` 值必须在 [0, 255] 范围内，默认值：0。
|
||||
- **padding_mode** (Border, 可选) - 边界填充方式。它可以是 [Border.CONSTANT、Border.EDGE、Border.REFLECT、Border.SYMMETRIC] 中的任何一个，默认值：Border.CONSTANT。
|
||||
|
||||
- **Border.CONSTANT** - 使用常量值进行填充。
|
||||
- **Border.EDGE** - 使用各边的边界像素值进行填充。
|
||||
- **Border.REFLECT** - 以各边的边界为轴进行镜像填充，忽略边界像素值。
|
||||
- **Border.SYMMETRIC** - 以各边的边界为轴进行对称填充，包括边界像素值。
|
||||
- **Border.CONSTANT** - 使用常量值进行填充。
|
||||
- **Border.EDGE** - 使用各边的边界像素值进行填充。
|
||||
- **Border.REFLECT** - 以各边的边界为轴进行镜像填充，忽略边界像素值。
|
||||
- **Border.SYMMETRIC** - 以各边的边界为轴进行对称填充，包括边界像素值。
|
||||
|
||||
.. note:: 当 `padding` 输入长度为2的序列时的行为未来将从使用第一个值填充左/上边界，使用第二个值填充右/下边界，变为使用第一个值填充左/右边界，使用第二个值填充上/下边界。你也可以直接输入长度为4的序列来分别指定左、上、右和下边界的填充长度。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `size` 不是int或Sequence[int]类型。
|
||||
- **TypeError** - 如果 `padding` 不是int或Sequence[int]类型。
|
||||
- **TypeError** - 如果 `pad_if_needed` 不是bool类型。
|
||||
- **TypeError** - 如果 `fill_value` 不是int或tuple[int]类型。
|
||||
- **TypeError** - 如果 `padding_mode` 不是 :class:`mindspore.dataset.vision.Border` 的类型。
|
||||
- **ValueError** - 如果 `size` 不是正数。
|
||||
- **ValueError** - 如果 `padding` 为负数。
|
||||
- **ValueError** - 如果 `fill_value` 不在 [0, 255] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `size` 不是int或Sequence[int]类型。
|
||||
- **TypeError** - 如果 `padding` 不是int或Sequence[int]类型。
|
||||
- **TypeError** - 如果 `pad_if_needed` 不是bool类型。
|
||||
- **TypeError** - 如果 `fill_value` 不是int或tuple[int]类型。
|
||||
- **TypeError** - 如果 `padding_mode` 不是 :class:`mindspore.dataset.vision.Border` 的类型。
|
||||
- **ValueError** - 如果 `size` 不是正数。
|
||||
- **ValueError** - 如果 `padding` 为负数。
|
||||
- **ValueError** - 如果 `fill_value` 不在 [0, 255] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,32 +5,30 @@ mindspore.dataset.vision.RandomCropDecodeResize
|
|||
|
||||
"裁剪"、"解码"和"调整尺寸大小"的组合处理。该算子将在随机位置裁剪输入图像，以 RGB 模式对裁剪后的图像进行解码，并调整解码图像的尺寸大小。针对 JPEG 图像进行了优化, 可以获得更好的性能。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **size** (Union[int, Sequence[int]]) - 调整后图像的输出尺寸大小。大小值必须为正。
|
||||
如果 size 是整数，则返回一个裁剪尺寸大小为 (size, size) 的正方形。
|
||||
如果 size 是一个长度为 2 的序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
- **scale** (Union[list, tuple], 可选) - 要裁剪的原始尺寸大小的各个尺寸的范围[min, max)，必须为非负数，默认值：(0.08, 1.0)。
|
||||
- **ratio** (Union[list, tuple], 可选) - 宽高比的范围 [min, max) 裁剪，必须为非负数，默认值：(3. / 4., 4. / 3.)。
|
||||
- **interpolation** (Inter, 可选) - resize算子的图像插值方式。它可以是 [Inter.BILINEAR、Inter.NEAREST、Inter.BICUBIC、Inter.AREA、Inter.PILCUBIC] 中的任何一个，默认值：Inter.BILINEAR。
|
||||
|
||||
- **size** (Union[int, Sequence[int]]) - 调整后图像的输出尺寸大小。大小值必须为正。
|
||||
如果 size 是整数，则返回一个裁剪尺寸大小为 (size, size) 的正方形。
|
||||
如果 size 是一个长度为 2 的序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
- **scale** (Union[list, tuple], 可选) - 要裁剪的原始尺寸大小的各个尺寸的范围[min, max)，必须为非负数，默认值：(0.08, 1.0)。
|
||||
- **ratio** (Union[list, tuple], 可选) - 宽高比的范围 [min, max) 裁剪，必须为非负数，默认值：(3. / 4., 4. / 3.)。
|
||||
- **interpolation** (Inter, 可选) - resize算子的图像插值方式。它可以是 [Inter.BILINEAR、Inter.NEAREST、Inter.BICUBIC、Inter.AREA、Inter.PILCUBIC] 中的任何一个，默认值：Inter.BILINEAR。
|
||||
- **Inter.BILINEAR**: 双线性插值。
|
||||
- **Inter.NEAREST**: 最近邻插值。
|
||||
- **Inter.BICUBIC**: 双三次插值。
|
||||
- **Inter.AREA**: 像素区域插值。
|
||||
- **Inter.PILCUBIC**: Pillow库中实现的双三次插值，输入需为3通道格式。
|
||||
|
||||
- **Inter.BILINEAR**: 双线性插值。
|
||||
- **Inter.NEAREST**: 最近邻插值。
|
||||
- **Inter.BICUBIC**: 双三次插值。
|
||||
- **Inter.AREA**: 像素区域插值。
|
||||
- **Inter.PILCUBIC**: Pillow库中实现的双三次插值，输入需为3通道格式。
|
||||
- **max_attempts** (int, 可选) - 生成随机裁剪位置的最大尝试次数，超过该次数时将使用中心裁剪， `max_attempts` 值必须为正数，默认值：10。
|
||||
|
||||
- **max_attempts** (int, 可选) - 生成随机裁剪位置的最大尝试次数，超过该次数时将使用中心裁剪， `max_attempts` 值必须为正数，默认值：10。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `size` 不是int或Sequence[int]类型。
|
||||
- **TypeError** - 如果 `scale` 不是tuple或list类型。
|
||||
- **TypeError** - 如果 `ratio` 不是tuple或list类型。
|
||||
- **TypeError** - 如果 `interpolation` 不是 :class:`mindspore.dataset.vision.Inter` 的类型。
|
||||
- **TypeError** - 如果 `max_attempts` 不是int类型。
|
||||
- **ValueError** - 如果 `size` 不是正数。
|
||||
- **ValueError** - 如果 `scale` 为负数。
|
||||
- **ValueError** - 如果 `ratio` 为负数。
|
||||
- **ValueError** - 如果 `max_attempts` 不是正数。
|
||||
- **RuntimeError** - 如果输入图像不是一维序列。
|
||||
异常：
|
||||
- **TypeError** - 如果 `size` 不是int或Sequence[int]类型。
|
||||
- **TypeError** - 如果 `scale` 不是tuple或list类型。
|
||||
- **TypeError** - 如果 `ratio` 不是tuple或list类型。
|
||||
- **TypeError** - 如果 `interpolation` 不是 :class:`mindspore.dataset.vision.Inter` 的类型。
|
||||
- **TypeError** - 如果 `max_attempts` 不是int类型。
|
||||
- **ValueError** - 如果 `size` 不是正数。
|
||||
- **ValueError** - 如果 `scale` 为负数。
|
||||
- **ValueError** - 如果 `ratio` 为负数。
|
||||
- **ValueError** - 如果 `max_attempts` 不是正数。
|
||||
- **RuntimeError** - 如果输入图像不是一维序列。
|
||||
|
|
|
|||
|
|
@ -5,38 +5,36 @@ mindspore.dataset.vision.RandomCropWithBBox
|
|||
|
||||
在输入图像的随机位置进行裁剪并相应地调整边界框。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **size** (Union[int, Sequence[int]]) - 裁剪图像的输出尺寸大小。大小值必须为正。
|
||||
如果 size 是整数，则返回一个裁剪尺寸大小为 (size, size) 的正方形。
|
||||
如果 size 是一个长度为 2 的序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
- **padding** (Union[int, Sequence[int]], 可选) - 填充图像的像素数。填充值必须非负值，默认值：None。
|
||||
如果 `padding` 不为 None，则首先使用 `padding` 填充图像。
|
||||
如果 `padding` 是一个整数，代表为图像的所有方向填充该值大小的像素。
|
||||
如果 `padding` 是一个包含2个值的元组或列表，第一个值会用于填充图像的左侧和上侧，第二个值会用于填充图像的右侧和下侧。
|
||||
如果 `padding` 是一个包含4个值的元组或列表，则分别填充图像的左侧、上侧、右侧和下侧。
|
||||
- **pad_if_needed** (bool, 可选) - 如果输入图像高度或者宽度小于 `size` 指定的输出图像尺寸大小，是否进行填充。默认值：False。
|
||||
- **fill_value** (Union[int, tuple[int]], 可选) - 边框的像素强度，仅当 `padding_mode` 为 Border.CONSTANT 时有效。
|
||||
如果是3元素元组，则分别用于填充R、G、B通道。
|
||||
如果是整数，则用于所有 RGB 通道。
|
||||
`fill_value` 值必须在 [0, 255] 范围内，默认值：0。
|
||||
- **padding_mode** (Border, 可选) - 边界填充方式。它可以是 [Border.CONSTANT、Border.EDGE、Border.REFLECT、Border.SYMMETRIC] 中的任何一个，默认值：Border.CONSTANT。
|
||||
|
||||
- **size** (Union[int, Sequence[int]]) - 裁剪图像的输出尺寸大小。大小值必须为正。
|
||||
如果 size 是整数，则返回一个裁剪尺寸大小为 (size, size) 的正方形。
|
||||
如果 size 是一个长度为 2 的序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
- **padding** (Union[int, Sequence[int]], 可选) - 填充图像的像素数。填充值必须非负值，默认值：None。
|
||||
如果 `padding` 不为 None，则首先使用 `padding` 填充图像。
|
||||
如果 `padding` 是一个整数，代表为图像的所有方向填充该值大小的像素。
|
||||
如果 `padding` 是一个包含2个值的元组或列表，第一个值会用于填充图像的左侧和上侧，第二个值会用于填充图像的右侧和下侧。
|
||||
如果 `padding` 是一个包含4个值的元组或列表，则分别填充图像的左侧、上侧、右侧和下侧。
|
||||
- **pad_if_needed** (bool, 可选) - 如果输入图像高度或者宽度小于 `size` 指定的输出图像尺寸大小，是否进行填充。默认值：False。
|
||||
- **fill_value** (Union[int, tuple[int]], 可选) - 边框的像素强度，仅当 `padding_mode` 为 Border.CONSTANT 时有效。
|
||||
如果是3元素元组，则分别用于填充R、G、B通道。
|
||||
如果是整数，则用于所有 RGB 通道。
|
||||
`fill_value` 值必须在 [0, 255] 范围内，默认值：0。
|
||||
- **padding_mode** (Border, 可选) - 边界填充方式。它可以是 [Border.CONSTANT、Border.EDGE、Border.REFLECT、Border.SYMMETRIC] 中的任何一个，默认值：Border.CONSTANT。
|
||||
|
||||
- **Border.CONSTANT** - 使用常量值进行填充。
|
||||
- **Border.EDGE** - 使用各边的边界像素值进行填充。
|
||||
- **Border.REFLECT** - 以各边的边界为轴进行镜像填充，忽略边界像素值。
|
||||
- **Border.SYMMETRIC** - 以各边的边界为轴进行对称填充，包括边界像素值。
|
||||
- **Border.CONSTANT** - 使用常量值进行填充。
|
||||
- **Border.EDGE** - 使用各边的边界像素值进行填充。
|
||||
- **Border.REFLECT** - 以各边的边界为轴进行镜像填充，忽略边界像素值。
|
||||
- **Border.SYMMETRIC** - 以各边的边界为轴进行对称填充，包括边界像素值。
|
||||
|
||||
.. note:: 当 `padding` 输入长度为2的序列时的行为未来将从使用第一个值填充左/上边界，使用第二个值填充右/下边界，变为使用第一个值填充左/右边界，使用第二个值填充上/下边界。你也可以直接输入长度为4的序列来分别指定左、上、右和下边界的填充长度。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `size` 不是int或Sequence[int]类型。
|
||||
- **TypeError** - 如果 `padding` 不是int或Sequence[int]类型。
|
||||
- **TypeError** - 如果 `pad_if_needed` 不是bool类型。
|
||||
- **TypeError** - 如果 `fill_value` 不是int或tuple[int]类型。
|
||||
- **TypeError** - 如果 `padding_mode` 不是 :class:`mindspore.dataset.vision.Border` 的类型。
|
||||
- **ValueError** - 如果 `size` 不是正数。
|
||||
- **ValueError** - 如果 `padding` 为负数。
|
||||
- **ValueError** - 如果 `fill_value` 不在 [0, 255] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `size` 不是int或Sequence[int]类型。
|
||||
- **TypeError** - 如果 `padding` 不是int或Sequence[int]类型。
|
||||
- **TypeError** - 如果 `pad_if_needed` 不是bool类型。
|
||||
- **TypeError** - 如果 `fill_value` 不是int或tuple[int]类型。
|
||||
- **TypeError** - 如果 `padding_mode` 不是 :class:`mindspore.dataset.vision.Border` 的类型。
|
||||
- **ValueError** - 如果 `size` 不是正数。
|
||||
- **ValueError** - 如果 `padding` 为负数。
|
||||
- **ValueError** - 如果 `fill_value` 不在 [0, 255] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -7,25 +7,23 @@ mindspore.dataset.vision.RandomErasing
|
|||
|
||||
请参阅论文 `Random Erasing Data Augmentation <https://arxiv.org/pdf/1708.04896.pdf>`_。
|
||||
|
||||
**参数：**
|
||||
|
||||
- **prob** (float，可选) - 执行随机擦除的概率，默认值：0.5。
|
||||
- **scale** (Sequence[float, float]，可选) - 擦除区域面积相对原图比例的随机选取范围，按照(min, max)顺序排列，默认值：(0.02, 0.33)。
|
||||
- **ratio** (Sequence[float, float]，可选) - 擦除区域宽高比的随机选取范围，按照(min, max)顺序排列，默认值：(0.3, 3.3)。
|
||||
- **value** (Union[int, str, Sequence[int, int, int]]) - 擦除区域的像素填充值。若输入int，将以该值填充RGB通道；若输入Sequence[int, int, int]，将分别用于填充R、G、B通道；若输入字符串'random'，将以从标准正态分布获得的随机值擦除各个像素。默认值：0。
|
||||
- **inplace** (bool，可选) - 是否直接在原图上执行擦除，默认值：False。
|
||||
- **max_attempts** (int，可选) - 生成随机擦除区域的最大尝试次数，超过该次数时将返回原始图像。默认值：10。
|
||||
参数：
|
||||
- **prob** (float，可选) - 执行随机擦除的概率，默认值：0.5。
|
||||
- **scale** (Sequence[float, float]，可选) - 擦除区域面积相对原图比例的随机选取范围，按照(min, max)顺序排列，默认值：(0.02, 0.33)。
|
||||
- **ratio** (Sequence[float, float]，可选) - 擦除区域宽高比的随机选取范围，按照(min, max)顺序排列，默认值：(0.3, 3.3)。
|
||||
- **value** (Union[int, str, Sequence[int, int, int]]) - 擦除区域的像素填充值。若输入int，将以该值填充RGB通道；若输入Sequence[int, int, int]，将分别用于填充R、G、B通道；若输入字符串'random'，将以从标准正态分布获得的随机值擦除各个像素。默认值：0。
|
||||
- **inplace** (bool，可选) - 是否直接在原图上执行擦除，默认值：False。
|
||||
- **max_attempts** (int，可选) - 生成随机擦除区域的最大尝试次数，超过该次数时将返回原始图像。默认值：10。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `prob` 的类型不为float。
|
||||
- **TypeError** - 当 `scale` 的类型不为Sequence[float, float]。
|
||||
- **TypeError** - 当 `ratio` 的类型不为Sequence[float, float]。
|
||||
- **TypeError** - 当 `value` 的类型不为int、str或Sequence[int, int, int]。
|
||||
- **TypeError** - 当 `inplace` 的类型不为bool。
|
||||
- **TypeError** - 当 `max_attempts` 的类型不为int。
|
||||
- **ValueError** - 当 `prob` 取值不在[0, 1]范围内。
|
||||
- **ValueError** - 当 `scale` 为负数。
|
||||
- **ValueError** - 当 `ratio` 为负数。
|
||||
- **ValueError** - 当 `value` 取值不在[0, 255]范围内。
|
||||
- **ValueError** - 当 `max_attempts` 不为正数。
|
||||
异常：
|
||||
- **TypeError** - 当 `prob` 的类型不为float。
|
||||
- **TypeError** - 当 `scale` 的类型不为Sequence[float, float]。
|
||||
- **TypeError** - 当 `ratio` 的类型不为Sequence[float, float]。
|
||||
- **TypeError** - 当 `value` 的类型不为int、str或Sequence[int, int, int]。
|
||||
- **TypeError** - 当 `inplace` 的类型不为bool。
|
||||
- **TypeError** - 当 `max_attempts` 的类型不为int。
|
||||
- **ValueError** - 当 `prob` 取值不在[0, 1]范围内。
|
||||
- **ValueError** - 当 `scale` 为负数。
|
||||
- **ValueError** - 当 `ratio` 为负数。
|
||||
- **ValueError** - 当 `value` 取值不在[0, 255]范围内。
|
||||
- **ValueError** - 当 `max_attempts` 不为正数。
|
||||
|
|
|
|||
|
|
@ -5,11 +5,9 @@ mindspore.dataset.vision.RandomGrayscale
|
|||
|
||||
按照指定的概率将输入PIL图像转换为灰度图。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **prob** (float，可选) - 执行灰度转换的概率，默认值：0.1。
|
||||
|
||||
- **prob** (float，可选) - 执行灰度转换的概率，默认值：0.1。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `prob` 的类型不为float。
|
||||
- **ValueError** - 当 `prob` 取值不在[0, 1]范围内。
|
||||
异常：
|
||||
- **TypeError** - 当 `prob` 的类型不为float。
|
||||
- **ValueError** - 当 `prob` 取值不在[0, 1]范围内。
|
||||
|
|
|
|||
|
|
@ -5,12 +5,10 @@ mindspore.dataset.vision.RandomHorizontalFlip
|
|||
|
||||
对输入图像按给定的概率进行水平随机翻转。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **prob** (float, 可选) - 图像被翻转的概率，必须在 [0, 1] 范围内，默认值：0.5。
|
||||
|
||||
- **prob** (float, 可选) - 图像被翻转的概率，必须在 [0, 1] 范围内, 默认值：0.5。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `prob` 不是float类型。
|
||||
- **ValueError** - 如果 `prob` 不在 [0, 1] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `prob` 不是float类型。
|
||||
- **ValueError** - 如果 `prob` 不在 [0, 1] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,12 +5,10 @@ mindspore.dataset.vision.RandomHorizontalFlipWithBBox
|
|||
|
||||
对输入图像按给定的概率进行水平随机翻转并相应地调整边界框。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **prob** (float, 可选) - 图像被翻转的概率，必须在 [0, 1] 范围内，默认值：0.5。
|
||||
|
||||
- **prob** (float, 可选) - 图像被翻转的概率，必须在 [0, 1] 范围内，默认值：0.5。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `prob` 不是float类型。
|
||||
- **ValueError** - 如果 `prob` 不在 [0, 1] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `prob` 不是float类型。
|
||||
- **ValueError** - 如果 `prob` 不在 [0, 1] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,20 +5,18 @@ mindspore.dataset.vision.RandomPerspective
|
|||
|
||||
按照指定的概率对输入PIL图像进行透视变换。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **distortion_scale** (float，可选) - 失真程度，取值范围为[0, 1]，默认值：0.5。
|
||||
- **prob** (float，可选) - 执行透视变换的概率，默认值：0.5。
|
||||
- **interpolation** (Inter，可选) - 插值方式，取值可为 Inter.BILINEAR、Inter.NEAREST 或 Inter.BICUBIC。默认值：Inter.BICUBIC。
|
||||
|
||||
- **distortion_scale** (float，可选) - 失真程度，取值范围为[0, 1]，默认值：0.5。
|
||||
- **prob** (float，可选) - 执行透视变换的概率，默认值：0.5。
|
||||
- **interpolation** (Inter，可选) - 插值方式，取值可为 Inter.BILINEAR、Inter.NEAREST 或 Inter.BICUBIC。默认值：Inter.BICUBIC。
|
||||
- **Inter.BILINEAR**：双线性插值。
|
||||
- **Inter.NEAREST**：最近邻插值。
|
||||
- **Inter.BICUBIC**：双三次插值。
|
||||
|
||||
- **Inter.BILINEAR**：双线性插值。
|
||||
- **Inter.NEAREST**：最近邻插值。
|
||||
- **Inter.BICUBIC**：双三次插值。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `distortion_scale` 的类型不为float。
|
||||
- **TypeError** - 当 `prob` 的类型不为float。
|
||||
- **TypeError** - 当 `interpolation` 的类型不为 :class:`mindspore.dataset.vision.Inter` 。
|
||||
- **ValueError** - 当 `distortion_scale` 取值不在[0, 1]范围内。
|
||||
- **ValueError** - 当 `prob` 取值不在[0, 1]范围内。
|
||||
异常：
|
||||
- **TypeError** - 当 `distortion_scale` 的类型不为float。
|
||||
- **TypeError** - 当 `prob` 的类型不为float。
|
||||
- **TypeError** - 当 `interpolation` 的类型不为 :class:`mindspore.dataset.vision.Inter` 。
|
||||
- **ValueError** - 当 `distortion_scale` 取值不在[0, 1]范围内。
|
||||
- **ValueError** - 当 `prob` 取值不在[0, 1]范围内。
|
||||
|
|
|
|||
|
|
@ -5,13 +5,11 @@ mindspore.dataset.vision.RandomPosterize
|
|||
|
||||
随机减少输入图像每个颜色通道的位数。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **bits** (Union[int, Sequence[int]], 可选) - 随机位数压缩的范围。位值必须在 [1,8] 范围内，并且在给定范围内至少包含一个整数值。它必须是 (min, max) 或整数格式。
|
||||
如果min与max相等，那么它是一个单一的位数压缩操作，默认值：(8, 8)。
|
||||
|
||||
- **bits** (Union[int, Sequence[int]], 可选) - 随机位数压缩的范围。位值必须在 [1,8] 范围内，并且在给定范围内至少包含一个整数值。它必须是 (min, max) 或整数格式。
|
||||
如果min与max相等，那么它是一个单一的位数压缩操作，默认值：(8, 8)。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `bits` 不是int或Sequence[int]类型。
|
||||
- **ValueError** - 如果 `bits` 不在 [1, 8] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `bits` 不是int或Sequence[int]类型。
|
||||
- **ValueError** - 如果 `bits` 不在 [1, 8] 范围内。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,12 +5,10 @@ mindspore.dataset.vision.RandomResize
|
|||
|
||||
对输入图像使用随机选择的 :class:`mindspore.dataset.vision.Inter` 插值方式去调整它的尺寸大小。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **size** (Union[int, Sequence[int]]) - 调整后图像的输出尺寸大小。值必须为正。若输入整型，则放缩至(size, size)大小；若输入2元素序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
|
||||
- **size** (Union[int, Sequence[int]]) - 调整后图像的输出尺寸大小。值必须为正。若输入整型，则放缩至(size, size)大小；若输入2元素序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `size` 不是int或Sequence[int]类型。
|
||||
- **ValueError** - 如果 `size` 不是正数。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 如果 `size` 不是int或Sequence[int]类型。
|
||||
- **ValueError** - 如果 `size` 不是正数。
|
||||
- **RuntimeError** - 如果输入图像的shape不是 <H, W> 或 <H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,12 +5,10 @@ mindspore.dataset.vision.RandomResizeWithBBox
|
|||
|
||||
对输入图像使用随机选择的 :class:`mindspore.dataset.vision.Inter` 插值方式去调整它的尺寸大小，并相应地调整边界框的尺寸大小。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **size** (Union[int, Sequence[int]]) - 调整后图像的输出尺寸大小。若输入整型，则放缩至(size, size)大小；若输入2元素序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
|
||||
- **size** (Union[int, Sequence[int]]) - 调整后图像的输出尺寸大小。若输入整型，则放缩至(size, size)大小；若输入2元素序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `size` 的类型不为int或Sequence[int]类型。
|
||||
- **ValueError** - 当 `size` 不为正数。
|
||||
- **RuntimeError** - 当输入图像的shape不为<H, W>或<H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 当 `size` 的类型不为int或Sequence[int]类型。
|
||||
- **ValueError** - 当 `size` 不为正数。
|
||||
- **RuntimeError** - 当输入图像的shape不为<H, W>或<H, W, C>。
|
||||
|
|
|
|||
|
|
@ -7,30 +7,28 @@ mindspore.dataset.vision.RandomResizedCrop
|
|||
|
||||
.. note:: 如果输入图像不止一张，需要保证输入的多张图像尺寸大小一致。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **size** (Union[int, Sequence[int]]) - 图像的输出尺寸大小。若输入整型，则放缩至(size, size)大小；若输入2元素序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
- **scale** (Union[list, tuple], 可选) - 裁剪子图的尺寸大小相对原图比例的随机选取范围，需要在[min, max)区间，默认值：(0.08, 1.0)。
|
||||
- **ratio** (Union[list, tuple], 可选) - 裁剪子图的宽高比的随机选取范围，需要在[min, max)区间，默认值：(3./4., 4./3.)。
|
||||
- **interpolation** (Inter, 可选) - 插值方式。它可以是 [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.PILCUBIC] 中的任何一个，默认值：Inter.BILINEAR。
|
||||
|
||||
- **size** (Union[int, Sequence[int]]) - 图像的输出尺寸大小。若输入整型，则放缩至(size, size)大小；若输入2元素序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
- **scale** (Union[list, tuple], 可选) - 裁剪子图的尺寸大小相对原图比例的随机选取范围，需要在[min, max)区间，默认值：(0.08, 1.0)。
|
||||
- **ratio** (Union[list, tuple], 可选) - 裁剪子图的宽高比的随机选取范围，需要在[min, max)区间，默认值：(3./4., 4./3.)。
|
||||
- **interpolation** (Inter, 可选) - 插值方式。它可以是 [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.PILCUBIC] 中的任何一个，默认值：Inter.BILINEAR。
|
||||
- Inter.BILINEAR，双线性插值。
|
||||
- Inter.NEAREST，最近邻插值。
|
||||
- Inter.BICUBIC，双三次插值。
|
||||
- Inter.AREA，像素区域插值。
|
||||
- Inter.PILCUBIC，Pillow库中实现的双三次插值，输入应为3通道格式。
|
||||
|
||||
- Inter.BILINEAR，双线性插值。
|
||||
- Inter.NEAREST，最近邻插值。
|
||||
- Inter.BICUBIC，双三次插值。
|
||||
- Inter.AREA，像素区域插值。
|
||||
- Inter.PILCUBIC，Pillow库中实现的双三次插值，输入应为3通道格式。
|
||||
- **max_attempts** (int, 可选) - 生成随机裁剪位置的最大尝试次数，超过该次数时将使用中心裁剪，默认值：10。
|
||||
|
||||
- **max_attempts** (int, 可选) - 生成随机裁剪位置的最大尝试次数，超过该次数时将使用中心裁剪，默认值：10。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `size` 的类型不为int或Sequence[int]。
|
||||
- **TypeError** - 当 `scale` 的类型不为tuple或list。
|
||||
- **TypeError** - 当 `ratio` 的类型不为tuple或list。
|
||||
- **TypeError** - 当 `interpolation` 的类型不为 :class:`mindspore.dataset.vision.Inter` 。
|
||||
- **TypeError** - 当 `max_attempts` 的类型不为int。
|
||||
- **ValueError** - 当 `size` 不为正数。
|
||||
- **ValueError** - 当 `scale` 为负数。
|
||||
- **ValueError** - 当 `ratio` 为负数。
|
||||
- **ValueError** - 当 `max_attempts` 不为正数。
|
||||
- **RuntimeError** - 当输入图像的shape不为<H, W>或<H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 当 `size` 的类型不为int或Sequence[int]。
|
||||
- **TypeError** - 当 `scale` 的类型不为tuple或list。
|
||||
- **TypeError** - 当 `ratio` 的类型不为tuple或list。
|
||||
- **TypeError** - 当 `interpolation` 的类型不为 :class:`mindspore.dataset.vision.Inter` 。
|
||||
- **TypeError** - 当 `max_attempts` 的类型不为int。
|
||||
- **ValueError** - 当 `size` 不为正数。
|
||||
- **ValueError** - 当 `scale` 为负数。
|
||||
- **ValueError** - 当 `ratio` 为负数。
|
||||
- **ValueError** - 当 `max_attempts` 不为正数。
|
||||
- **RuntimeError** - 当输入图像的shape不为<H, W>或<H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,28 +5,26 @@ mindspore.dataset.vision.RandomResizedCropWithBBox
|
|||
|
||||
对输入图像进行随机裁剪且随机调整纵横比，并将处理后的图像调整为指定的尺寸大小，并相应地调整边界框。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **size** (Union[int, Sequence[int]]) - 图像的输出尺寸大小。若输入整型，则放缩至(size, size)大小；若输入2元素序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
- **scale** (Union[list, tuple], 可选) - 裁剪子图的尺寸大小相对原图比例的随机选取范围，需要在[min, max)区间，默认值：(0.08, 1.0)。
|
||||
- **ratio** (Union[list, tuple], 可选) - 裁剪子图的宽高比的随机选取范围，需要在[min, max)区间，默认值：(3./4., 4./3.)。
|
||||
- **interpolation** (Inter, 可选) - 插值方式。它可以是 [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC] 中的任何一个，默认值：Inter.BILINEAR。
|
||||
|
||||
- **size** (Union[int, Sequence[int]]) - 图像的输出尺寸大小。若输入整型，则放缩至(size, size)大小；若输入2元素序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
|
||||
- **scale** (Union[list, tuple], 可选) - 裁剪子图的尺寸大小相对原图比例的随机选取范围，需要在[min, max)区间，默认值：(0.08, 1.0)。
|
||||
- **ratio** (Union[list, tuple], 可选) - 裁剪子图的宽高比的随机选取范围，需要在[min, max)区间，默认值：(3./4., 4./3.)。
|
||||
- **interpolation** (Inter, 可选) - 插值方式。它可以是 [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC] 中的任何一个，默认值：Inter.BILINEAR。
|
||||
- Inter.BILINEAR，双线性插值。
|
||||
- Inter.NEAREST，最近邻插值。
|
||||
- Inter.BICUBIC，双三次插值。
|
||||
|
||||
- Inter.BILINEAR，双线性插值。
|
||||
- Inter.NEAREST，最近邻插值。
|
||||
- Inter.BICUBIC，双三次插值。
|
||||
- **max_attempts** (int, 可选) - 生成随机裁剪位置的最大尝试次数，超过该次数时将使用中心裁剪，默认值：10。
|
||||
|
||||
- **max_attempts** (int, 可选): 生成随机裁剪位置的最大尝试次数，超过该次数时将使用中心裁剪，默认值：10。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `size` 的类型不为int或Sequence[int]。
|
||||
- **TypeError** - 当 `scale` 的类型不为tuple或list。
|
||||
- **TypeError** - 当 `ratio` 的类型不为tuple或list。
|
||||
- **TypeError** - 当 `interpolation` 的类型不为 :class:`mindspore.dataset.vision.Inter` 。
|
||||
- **TypeError** - 当 `max_attempts` 的类型不为int。
|
||||
- **ValueError** - 当 `size` 不为正数。
|
||||
- **ValueError** - 当 `scale` 为负数。
|
||||
- **ValueError** - 当 `ratio` 为负数。
|
||||
- **ValueError** - 当 `max_attempts` 不为正数。
|
||||
- **RuntimeError** 当输入图像的shape不为<H, W>或<H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 当 `size` 的类型不为int或Sequence[int]。
|
||||
- **TypeError** - 当 `scale` 的类型不为tuple或list。
|
||||
- **TypeError** - 当 `ratio` 的类型不为tuple或list。
|
||||
- **TypeError** - 当 `interpolation` 的类型不为 :class:`mindspore.dataset.vision.Inter` 。
|
||||
- **TypeError** - 当 `max_attempts` 的类型不为int。
|
||||
- **ValueError** - 当 `size` 不为正数。
|
||||
- **ValueError** - 当 `scale` 为负数。
|
||||
- **ValueError** - 当 `ratio` 为负数。
|
||||
- **ValueError** - 当 `max_attempts` 不为正数。
|
||||
- **RuntimeError** 当输入图像的shape不为<H, W>或<H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,26 +5,24 @@ mindspore.dataset.vision.RandomRotation
|
|||
|
||||
在指定的角度范围内，随机旋转输入图像。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **degrees** (Union[int, float, sequence]) - 旋转角度的随机选取范围。若输入单个数字，则从(-degrees, degrees)中随机生成旋转角度；若输入2元素序列，需按(min, max)顺序排列。
|
||||
- **resample** (Inter, 可选) - 插值方式。它可以是 [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.AREA] 中的任何一个，默认值：Inter.NEAREST。
|
||||
|
||||
- **degrees** (Union[int, float, sequence]) - 旋转角度的随机选取范围。若输入单个数字，则从(-degrees, degrees)中随机生成旋转角度；若输入2元素序列，需按(min, max)顺序排列。
|
||||
- **resample** (Inter, 可选) - 插值方式。它可以是 [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.AREA] 中的任何一个，默认值：Inter.NEAREST。
|
||||
- Inter.BILINEAR，双线性插值。
|
||||
- Inter.NEAREST，最近邻插值。
|
||||
- Inter.BICUBIC，双三次插值。
|
||||
- Inter.AREA，区域插值。
|
||||
|
||||
- Inter.BILINEAR，双线性插值。
|
||||
- Inter.NEAREST，最近邻插值。
|
||||
- Inter.BICUBIC，双三次插值。
|
||||
- Inter.AREA，区域插值。
|
||||
- **expand** (bool, 可选) - 若为True，将扩展图像尺寸大小使其足以容纳整个旋转图像；若为False，则保持图像尺寸大小不变。请注意，扩展时将假设图像为中心旋转且未进行平移。默认值：False。
|
||||
- **center** (tuple, 可选) - 可选的旋转中心，以图像左上角为原点，旋转中心的位置按照 (宽度, 高度) 格式指定。默认值：None，表示中心旋转。
|
||||
- **fill_value** (Union[int, tuple[int]], 可选) - 旋转图像之外区域的像素填充值。若输入3元素元组，将分别用于填充R、G、B通道；若输入整型，将以该值填充RGB通道。`fill_value` 值必须在 [0, 255] 范围内，默认值：0。
|
||||
|
||||
- **expand** (bool, 可选) - 若为True，将扩展图像尺寸大小使其足以容纳整个旋转图像；若为False，则保持图像尺寸大小不变。请注意，扩展时将假设图像为中心旋转且未进行平移。默认值：False。
|
||||
- **center** (tuple, 可选) - 可选的旋转中心，以图像左上角为原点，旋转中心的位置按照 (宽度, 高度) 格式指定。默认值：None，表示中心旋转。
|
||||
- **fill_value** (Union[int, tuple[int]], 可选) - 旋转图像之外区域的像素填充值。若输入3元素元组，将分别用于填充R、G、B通道；若输入整型，将以该值填充RGB通道。`fill_value` 值必须在 [0, 255] 范围内，默认值：0。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `degrees` 的类型不为int、float或sequence。
|
||||
- **TypeError** - 当 `resample` 的类型不为 :class:`mindspore.dataset.vision.Inter` 。
|
||||
- **TypeError** - 当 `expand` 的类型不为bool。
|
||||
- **TypeError** - 当 `center` 的类型不为tuple。
|
||||
- **TypeError** - 当 `fill_value` 的类型不为int或tuple[int]。
|
||||
- **ValueError** - 当 `fill_value` 取值不在[0, 255]范围内。
|
||||
- **RuntimeError** - 当输入图像的shape不为<H, W>或<H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 当 `degrees` 的类型不为int、float或sequence。
|
||||
- **TypeError** - 当 `resample` 的类型不为 :class:`mindspore.dataset.vision.Inter` 。
|
||||
- **TypeError** - 当 `expand` 的类型不为bool。
|
||||
- **TypeError** - 当 `center` 的类型不为tuple。
|
||||
- **TypeError** - 当 `fill_value` 的类型不为int或tuple[int]。
|
||||
- **ValueError** - 当 `fill_value` 取值不在[0, 255]范围内。
|
||||
- **RuntimeError** - 当输入图像的shape不为<H, W>或<H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,10 +5,8 @@ mindspore.dataset.vision.RandomSelectSubpolicy
|
|||
|
||||
从策略列表中随机选择一个子策略以应用于输入图像。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **policy** (list[list[tuple[TensorOperation, float]]]) - 可供选择的子策略列表。子策略是一系列 (operation, prob) 格式的元组组成的列表，其中 `operation` 是数据处理操作， `prob` 是应用此操作的概率， `prob` 值必须在 [0, 1] 范围内。 一旦选择了子策略，子策略中的每个操作都将根据其概率依次应用。
|
||||
|
||||
- **policy** (list[list[tuple[TensorOperation, float]]]) - 可供选择的子策略列表。子策略是一系列 (operation, prob) 格式的元组组成的列表，其中 `operation` 是数据处理操作， `prob` 是应用此操作的概率， `prob` 值必须在 [0, 1] 范围内。 一旦选择了子策略，子策略中的每个操作都将根据其概率依次应用。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `policy` 包含无效数据处理操作。
|
||||
异常：
|
||||
- **TypeError** - 当 `policy` 包含无效数据处理操作。
|
||||
|
|
|
|||
|
|
@ -5,12 +5,10 @@ mindspore.dataset.vision.RandomSharpness
|
|||
|
||||
在固定或随机的范围调整输入图像的锐度。度数为0.0时将返回模糊图像；度数为1.0时将返回原始图像；度数为2.0时将返回锐化图像。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **degrees** (Union[list, tuple], 可选) - 锐度调节系数的随机选取范围，需为非负数，按照(min, max)顺序排列。如果min与max相等，将使用固定的调节系数进行处理，默认值：(0.1, 1.9)。
|
||||
|
||||
- **degrees** (Union[list, tuple], 可选) - 锐度调节系数的随机选取范围，需为非负数，按照(min, max)顺序排列。如果min与max相等，将使用固定的调节系数进行处理，默认值：(0.1, 1.9)。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `degree` 的类型不为list或tuple。
|
||||
- **ValueError** - 如果 `degree` 为负数。
|
||||
- **ValueError** - 如果 `degree` 采用 (max, min) 格式而不是 (min, max)。
|
||||
异常：
|
||||
- **TypeError** - 如果 `degree` 的类型不为list或tuple。
|
||||
- **ValueError** - 如果 `degree` 为负数。
|
||||
- **ValueError** - 如果 `degree` 采用 (max, min) 格式而不是 (min, max)。
|
||||
|
|
|
|||
|
|
@ -5,11 +5,9 @@ mindspore.dataset.vision.RandomSolarize
|
|||
|
||||
从给定阈值范围内随机选择一个子范围，对位于给定子范围内的像素，将其像素值设置为(255 - 原本像素值)。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **threshold** (tuple, 可选) - 随机曝光的阈值范围，默认值：(0, 255)。 `threshold` 输入格式应该为 (min, max)，其中min和max是 (0, 255) 范围内的整数，并且min小于等于max。如果min与max相等，则反转所有高于 min(或max) 的像素值。
|
||||
|
||||
- **threshold** (tuple, 可选) - 随机曝光的阈值范围，默认值：(0, 255)。 `threshold` 输入格式应该为 (min, max)，其中min和max是 (0, 255) 范围内的整数，并且min小于等于max。如果min与max相等，则反转所有高于 min(或max) 的像素值。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `threshold` 的类型不为tuple。
|
||||
- **ValueError** - 当 `threshold` 取值不在[0, 255]范围内。
|
||||
异常：
|
||||
- **TypeError** - 当 `threshold` 的类型不为tuple。
|
||||
- **ValueError** - 当 `threshold` 取值不在[0, 255]范围内。
|
||||
|
|
|
|||
|
|
@ -5,12 +5,10 @@ mindspore.dataset.vision.RandomVerticalFlip
|
|||
|
||||
以给定的概率对输入图像在垂直方向进行随机翻转。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **prob** (float, 可选) - 图像被翻转的概率，默认值：0.5。
|
||||
|
||||
- **prob** (float, 可选) - 图像被翻转的概率，默认值：0.5。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `prob` 不是float类型。
|
||||
- **ValueError** - 如果 `prob` 不在 [0, 1] 范围。
|
||||
- **RuntimeError** - 如果输入的Tensor不是 <H, W> 或 <H, W, C> 格式。
|
||||
异常：
|
||||
- **TypeError** - 如果 `prob` 不是float类型。
|
||||
- **ValueError** - 如果 `prob` 不在 [0, 1] 范围。
|
||||
- **RuntimeError** - 如果输入的Tensor不是 <H, W> 或 <H, W, C> 格式。
|
||||
|
|
@ -5,12 +5,10 @@ mindspore.dataset.vision.RandomVerticalFlipWithBBox
|
|||
|
||||
以给定的概率对输入图像和边界框在垂直方向进行随机翻转。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **prob** (float, 可选) - 图像被翻转的概率，默认值：0.5。
|
||||
|
||||
- **prob** (float, 可选) - 图像被翻转的概率，默认值：0.5。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 如果 `prob` 不是float类型。
|
||||
- **ValueError** - 如果 `prob` 不在 [0, 1] 范围。
|
||||
- **RuntimeError** - 如果输入的Tensor不是 <H, W> 或<H, W, C> 格式。
|
||||
异常：
|
||||
- **TypeError** - 如果 `prob` 不是float类型。
|
||||
- **ValueError** - 如果 `prob` 不在 [0, 1] 范围。
|
||||
- **RuntimeError** - 如果输入的Tensor不是 <H, W> 或<H, W, C> 格式。
|
||||
|
|
|
|||
|
|
@ -7,12 +7,10 @@ mindspore.dataset.vision.Rescale
|
|||
|
||||
.. note:: 此操作支持通过 Offload 在 Ascend 或 GPU 平台上运行。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **rescale** (float) - 缩放因子。
|
||||
- **shift** (float) - 平移因子。
|
||||
|
||||
- **rescale** (float) - 缩放因子。
|
||||
- **shift** (float) - 平移因子。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `rescale` 的类型不为float。
|
||||
- **TypeError** - 当 `shift` 的类型不为float。
|
||||
异常：
|
||||
- **TypeError** - 当 `rescale` 的类型不为float。
|
||||
- **TypeError** - 当 `shift` 的类型不为float。
|
||||
|
|
|
|||
|
|
@ -5,22 +5,20 @@ mindspore.dataset.vision.Resize
|
|||
|
||||
对输入图像使用给定的 :class:`mindspore.dataset.vision.Inter` 插值方式去调整为给定的尺寸大小。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **size** (Union[int, Sequence[int]]) - 图像的输出尺寸大小。若输入整型，将调整图像的较短边长度为 `size`，且保持图像的宽高比不变；若输入是2元素组成的序列，其输入格式需要是 (高度, 宽度) 。
|
||||
- **interpolation** (Inter, 可选) - 图像插值方式。它可以是 [Inter.LINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.PILCUBIC] 中的任何一个，默认值：Inter.LINEAR。
|
||||
|
||||
- **size** (Union[int, Sequence[int]]) - 图像的输出尺寸大小。若输入整型，将调整图像的较短边长度为 `size`，且保持图像的宽高比不变；若输入是2元素组成的序列，其输入格式需要是 (高度, 宽度) 。
|
||||
- **interpolation** (Inter, 可选) - 图像插值方式。它可以是 [Inter.LINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.PILCUBIC] 中的任何一个，默认值：Inter.LINEAR。
|
||||
- Inter.BILINEAR，双线性插值。
|
||||
- Inter.LINEAR，双线性插值，同 Inter.BILINEAR 。
|
||||
- Inter.NEAREST，最近邻插值。
|
||||
- Inter.BICUBIC，双三次插值。
|
||||
- Inter.AREA，像素区域插值。
|
||||
- Inter.PILCUBIC，双三次插值，实现同Pillow，仅当输入为numpy.ndarray格式的3通道图像时有效。
|
||||
- Inter.ANTIALIAS，抗锯齿插值。
|
||||
|
||||
- Inter.BILINEAR，双线性插值。
|
||||
- Inter.LINEAR，双线性插值，同 Inter.BILINEAR 。
|
||||
- Inter.NEAREST，最近邻插值。
|
||||
- Inter.BICUBIC，双三次插值。
|
||||
- Inter.AREA，像素区域插值。
|
||||
- Inter.PILCUBIC，双三次插值，实现同Pillow，仅当输入为numpy.ndarray格式的3通道图像时有效。
|
||||
- Inter.ANTIALIAS，抗锯齿插值。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `size` 的类型不为int或Sequence[int]。
|
||||
- **TypeError** - 当 `interpolation` 的类型不为 :class:`mindspore.dataset.vision.Inter` 。
|
||||
- **ValueError** - 当 `size` 不为正数。
|
||||
- **RuntimeError** - 如果输入的Tensor不是 <H, W> 或 <H, W, C> 格式。
|
||||
异常：
|
||||
- **TypeError** - 当 `size` 的类型不为int或Sequence[int]。
|
||||
- **TypeError** - 当 `interpolation` 的类型不为 :class:`mindspore.dataset.vision.Inter` 。
|
||||
- **ValueError** - 当 `size` 不为正数。
|
||||
- **RuntimeError** - 如果输入的Tensor不是 <H, W> 或 <H, W, C> 格式。
|
||||
|
|
|
|||
|
|
@ -5,18 +5,16 @@ mindspore.dataset.vision.ResizeWithBBox
|
|||
|
||||
将输入图像调整为给定的尺寸大小并相应地调整边界框的大小。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **size** (Union[int, Sequence[int]]) - 图像的输出尺寸大小。若输入整型，将调整图像的较短边长度为 `size`，且保持图像的宽高比不变；若输入是2元素组成的序列，其输入格式需要是 (高度, 宽度) 。
|
||||
- **interpolation** (Inter, 可选) - 图像插值方式。它可以是 [Inter.LINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.PILCUBIC] 中的任何一个，默认值：Inter.LINEAR。
|
||||
|
||||
- **size** (Union[int, Sequence[int]]) - 图像的输出尺寸大小。若输入整型，将调整图像的较短边长度为 `size`，且保持图像的宽高比不变；若输入是2元素组成的序列，其输入格式需要是 (高度, 宽度) 。
|
||||
- **interpolation** (Inter, 可选) - 图像插值方式。它可以是 [Inter.LINEAR, Inter.NEAREST, Inter.BICUBIC, Inter.PILCUBIC] 中的任何一个，默认值：Inter.LINEAR。
|
||||
- Inter.LINEAR，双线性插值。
|
||||
- Inter.NEAREST，最近邻插值。
|
||||
- Inter.BICUBIC，双三次插值。
|
||||
|
||||
- Inter.LINEAR，双线性插值。
|
||||
- Inter.NEAREST，最近邻插值。
|
||||
- Inter.BICUBIC，双三次插值。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `size` 的类型不为int或Sequence[int]。
|
||||
- **TypeError** - 当 `interpolation` 的类型不为 :class:`mindspore.dataset.vision.Inter` 。
|
||||
- **ValueError** - 当 `size` 不为正数。
|
||||
- **RuntimeError** - 如果输入的Tensor不是 <H, W> 或 <H, W, C> 格式。
|
||||
异常：
|
||||
- **TypeError** - 当 `size` 的类型不为int或Sequence[int]。
|
||||
- **TypeError** - 当 `interpolation` 的类型不为 :class:`mindspore.dataset.vision.Inter` 。
|
||||
- **ValueError** - 当 `size` 不为正数。
|
||||
- **RuntimeError** - 如果输入的Tensor不是 <H, W> 或 <H, W, C> 格式。
|
||||
|
|
|
|||
|
|
@ -5,10 +5,8 @@ mindspore.dataset.vision.RgbToHsv
|
|||
|
||||
将输入的RGB格式numpy.ndarray图像转换为HSV格式。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **is_hwc** (bool) - 若为True，表示输入图像的shape为(H, W, C)或(N, H, W, C)；否则为(C, H, W)或(N, C, H, W)。默认值：False。
|
||||
|
||||
- **is_hwc** (bool) - 若为True，表示输入图像的shape为(H, W, C)或(N, H, W, C)；否则为(C, H, W)或(N, C, H, W)。默认值：False。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `is_hwc` 的类型不为bool。
|
||||
异常：
|
||||
- **TypeError** - 当 `is_hwc` 的类型不为bool。
|
||||
|
|
|
|||
|
|
@ -5,25 +5,23 @@ mindspore.dataset.vision.Rotate
|
|||
|
||||
将输入图像旋转指定的度数。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **degrees** (Union[int, float]) - 旋转角度。
|
||||
- **resample** (Inter, 可选) - 插值方式。它可以是 [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC] 中的任何一个，默认值：Inter.NEAREST。
|
||||
|
||||
- **degrees** (Union[int, float]) - 旋转角度。
|
||||
- **resample** (Inter, 可选) - 插值方式。 它可以是 [Inter.BILINEAR, Inter.NEAREST, Inter.BICUBIC] 中的任何一个，默认值：Inter.NEAREST。
|
||||
- Inter.BILINEAR，双线性插值。
|
||||
- Inter.NEAREST，最近邻插值。
|
||||
- Inter.BICUBIC，双三次插值。
|
||||
|
||||
- Inter.BILINEAR，双线性插值。
|
||||
- Inter.NEAREST，最近邻插值。
|
||||
- Inter.BICUBIC，双三次插值。
|
||||
- **expand** (bool, 可选) - 若为True，将扩展图像尺寸大小使其足以容纳整个旋转图像；若为False，则保持图像尺寸大小不变。请注意，扩展时将假设图像为中心旋转且未进行平移。默认值：False。
|
||||
- **center** (tuple, 可选) - 可选的旋转中心，以图像左上角为原点，旋转中心的位置按照 (宽度, 高度) 格式指定。默认值：None，表示中心旋转。
|
||||
- **fill_value** (Union[int, tuple[int]], 可选) - 旋转图像之外区域的像素填充值。若输入3元素元组，将分别用于填充R、G、B通道；若输入整型，将以该值填充RGB通道。 `fill_value` 值必须在 [0, 255] 范围内，默认值：0。
|
||||
|
||||
- **expand** (bool, 可选) - 若为True，将扩展图像尺寸大小使其足以容纳整个旋转图像；若为False，则保持图像尺寸大小不变。请注意，扩展时将假设图像为中心旋转且未进行平移。默认值：False。
|
||||
- **center** (tuple, 可选) - 可选的旋转中心，以图像左上角为原点，旋转中心的位置按照 (宽度, 高度) 格式指定。默认值：None，表示中心旋转。
|
||||
- **fill_value** (Union[int, tuple[int]], 可选) - 旋转图像之外区域的像素填充值。若输入3元素元组，将分别用于填充R、G、B通道；若输入整型，将以该值填充RGB通道。 `fill_value` 值必须在 [0, 255] 范围内，默认值：0。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `degrees` 的类型不为int或float。
|
||||
- **TypeError** - 当 `resample` 的类型不为 :class:`mindspore.dataset.vision.Inter` 。
|
||||
- **TypeError** - 当 `expand` 的类型不为bool。
|
||||
- **TypeError** - 当 `center` 的类型不为tuple。
|
||||
- **TypeError** - 当 `fill_value` 的类型不为int或tuple[int]。
|
||||
- **ValueError** - 当 `fill_value` 取值不在[0, 255]范围内。
|
||||
- **RuntimeError** - 当输入图像的shape不为<H, W>或<H, W, C>。
|
||||
异常：
|
||||
- **TypeError** - 当 `degrees` 的类型不为int或float。
|
||||
- **TypeError** - 当 `resample` 的类型不为 :class:`mindspore.dataset.vision.Inter` 。
|
||||
- **TypeError** - 当 `expand` 的类型不为bool。
|
||||
- **TypeError** - 当 `center` 的类型不为tuple。
|
||||
- **TypeError** - 当 `fill_value` 的类型不为int或tuple[int]。
|
||||
- **ValueError** - 当 `fill_value` 取值不在[0, 255]范围内。
|
||||
- **RuntimeError** - 当输入图像的shape不为<H, W>或<H, W, C>。
|
||||
|
|
|
|||
|
|
@ -5,20 +5,18 @@ mindspore.dataset.vision.SlicePatches
|
|||
|
||||
在水平和垂直方向上将Tensor切片为多个块。适合于Tensor高宽较大的使用场景。如果将 `num_height` 和 `num_width` 都设置为 1，则Tensor将保持不变。输出Tensor的数量等于 num_height*num_width。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **num_height** (int, 可选) - 垂直方向的切块数量，默认值：1。
|
||||
- **num_width** (int, 可选) - 水平方向的切块数量，默认值：1。
|
||||
- **slice_mode** (Inter, 可选) - 表示填充或丢弃，它可以是 [SliceMode.PAD, SliceMode.DROP] 中的任何一个，默认值：SliceMode.PAD。
|
||||
- **fill_value** (int, 可选) - 如果 `slice_mode` 取值为 SliceMode.PAD，该值表示在右侧和底部方向上的填充的边界宽度（以像素数计），默认值：0。
|
||||
|
||||
- **num_height** (int, 可选) - 垂直方向的切块数量，默认值：1。
|
||||
- **num_width** (int, 可选) - 水平方向的切块数量，默认值：1。
|
||||
- **slice_mode** (Inter, 可选) - 表示填充或丢弃，它可以是 [SliceMode.PAD, SliceMode.DROP] 中的任何一个，默认值：SliceMode.PAD。
|
||||
- **fill_value** (int, 可选) - 如果 `slice_mode` 取值为 SliceMode.PAD，该值表示在右侧和底部方向上的填充的边界宽度（以像素数计），默认值：0。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `num_height` 不是int。
|
||||
- **TypeError** - 当 `num_width` 不是int。
|
||||
- **TypeError** - 当 `slice_mode` 的类型不为 :class:`mindspore.dataset.vision.Inter` 。
|
||||
- **TypeError** - 当 `fill_value` 不是int。
|
||||
- **ValueError** - 当 `num_height` 不为正数。
|
||||
- **ValueError** - 当 `num_width` 不为正数。
|
||||
- **ValueError** - 当 `fill_value` 不在 [0, 255]范围内。
|
||||
- **RuntimeError** - 如果输入的Tensor不是 <H, W> 或<H, W, C> 格式。
|
||||
异常：
|
||||
- **TypeError** - 当 `num_height` 不是int。
|
||||
- **TypeError** - 当 `num_width` 不是int。
|
||||
- **TypeError** - 当 `slice_mode` 的类型不为 :class:`mindspore.dataset.vision.Inter` 。
|
||||
- **TypeError** - 当 `fill_value` 不是int。
|
||||
- **ValueError** - 当 `num_height` 不为正数。
|
||||
- **ValueError** - 当 `num_width` 不为正数。
|
||||
- **ValueError** - 当 `fill_value` 不在 [0, 255]范围内。
|
||||
- **RuntimeError** - 如果输入的Tensor不是 <H, W> 或<H, W, C> 格式。
|
||||
|
|
|
|||
|
|
@ -5,13 +5,11 @@ mindspore.dataset.vision.TenCrop
|
|||
|
||||
在输入PIL图像的中心与四个角处分别裁剪指定尺寸大小的子图，并将其翻转图一并返回。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **size** (Union[int, Sequence[int, int]]) - 裁剪子图的尺寸大小。若输入int，则以该值为边长裁剪( `size` , `size` )尺寸大小的子图；若输入Sequence[int, int]，则以2个元素分别为高和宽裁剪子图。
|
||||
- **use_vertical_flip** (bool，可选) - 若为True，将对子图进行垂直翻转；否则进行水平翻转。默认值：False。
|
||||
|
||||
- **size** (Union[int, Sequence[int, int]]) - 裁剪子图的尺寸大小。若输入int，则以该值为边长裁剪( `size` , `size` )尺寸大小的子图；若输入Sequence[int, int]，则以2个元素分别为高和宽裁剪子图。
|
||||
- **use_vertical_flip** (bool，可选) - 若为True，将对子图进行垂直翻转；否则进行水平翻转。默认值：False。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `size` 的类型不为int或Sequence[int, int]。
|
||||
- **TypeError** - 当 `use_vertical_flip` 的类型不为bool。
|
||||
- **ValueError** - 当 `size` 不为正数。
|
||||
异常：
|
||||
- **TypeError** - 当 `size` 的类型不为int或Sequence[int, int]。
|
||||
- **TypeError** - 当 `use_vertical_flip` 的类型不为bool。
|
||||
- **ValueError** - 当 `size` 不为正数。
|
||||
|
|
|
|||
|
|
@ -7,6 +7,5 @@ mindspore.dataset.vision.ToPIL
|
|||
|
||||
.. note:: 转换模式将根据 :class:`PIL.Image.fromarray` 由图像的数据类型决定。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当输入图像的类型不为 :class:`numpy.ndarray` 或 :class:`PIL.Image.Image` 。
|
||||
异常：
|
||||
- **TypeError** - 当输入图像的类型不为 :class:`numpy.ndarray` 或 :class:`PIL.Image.Image` 。
|
||||
|
|
|
|||
|
|
@ -5,11 +5,9 @@ mindspore.dataset.vision.ToTensor
|
|||
|
||||
将输入PIL图像或numpy.ndarray图像转换为指定类型的numpy.ndarray图像，图像的像素值范围将从[0, 255]放缩为[0.0, 1.0]，shape将从(H, W, C)调整为(C, H, W)。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **output_type** (Union[mindspore.dtype, numpy.dtype]，可选) - 输出图像的数据类型，默认值：:class:`numpy.float32`。
|
||||
|
||||
- **output_type** (Union[mindspore.dtype, numpy.dtype]，可选) - 输出图像的数据类型，默认值：:class:`numpy.float32`。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当输入图像的类型不为 :class:`PIL.Image.Image` 或 :class:`numpy.ndarray` 。
|
||||
- **TypeError** - 输入图像的维度不为2或3。
|
||||
异常：
|
||||
- **TypeError** - 当输入图像的类型不为 :class:`PIL.Image.Image` 或 :class:`numpy.ndarray` 。
|
||||
- **TypeError** - 输入图像的维度不为2或3。
|
||||
|
|
|
|||
|
|
@ -9,10 +9,8 @@ mindspore.dataset.vision.ToType
|
|||
|
||||
.. note:: 此操作支持通过 Offload 在 Ascend 或 GPU 平台上运行。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **data_type** (Union[mindspore.dtype, numpy.dtype]) - 输出图像的数据类型，例如 :class:`numpy.float32` 。
|
||||
|
||||
- **data_type** (Union[mindspore.dtype, numpy.dtype]) - 输出图像的数据类型，例如 :class:`numpy.float32` 。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `data_type` 的类型不为 :class:`mindspore.dtype` 或 :class:`numpy.dtype` 。
|
||||
异常：
|
||||
- **TypeError** - 当 `data_type` 的类型不为 :class:`mindspore.dtype` 或 :class:`numpy.dtype` 。
|
||||
|
|
|
|||
|
|
@ -7,13 +7,11 @@ mindspore.dataset.vision.UniformAugment
|
|||
|
||||
序列中的所有数据处理操作要求具有相同的输入和输出类型，以便后一个操作能够处理前一个操作的输出数据。
|
||||
|
||||
**参数：**
|
||||
参数：
|
||||
- **transforms** (Sequence) - 数据处理操作序列。
|
||||
- **num_ops** (int，可选) - 均匀采样的数据处理操作数，默认值：2。
|
||||
|
||||
- **transforms** (Sequence) - 数据处理操作序列。
|
||||
- **num_ops** (int，可选) - 均匀采样的数据处理操作数，默认值：2。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **TypeError** - 当 `transforms` 的类型不为数据处理操作序列。
|
||||
- **TypeError** - 当 `num_ops` 的类型不为int。
|
||||
- **ValueError** - 当 `num_ops` 不为正数。
|
||||
异常：
|
||||
- **TypeError** - 当 `transforms` 的类型不为数据处理操作序列。
|
||||
- **TypeError** - 当 `num_ops` 的类型不为int。
|
||||
- **ValueError** - 当 `num_ops` 不为正数。
|
||||
|
|
|
|||
|
|
@ -5,6 +5,5 @@ mindspore.dataset.vision.VerticalFlip
|
|||
|
||||
对输入图像进行垂直翻转。
|
||||
|
||||
**异常：**
|
||||
|
||||
- **RuntimeError** - 如果输入的Tensor不是 <H, W> 或 <H, W, C> 格式。
|
||||
异常：
|
||||
- **RuntimeError** - 如果输入的Tensor不是 <H, W> 或 <H, W, C> 格式。
|
||||
|
|
|
|||
Loading…
Reference in New Issue