mindspore.dataset.vision.Normalize

class mindspore.dataset.vision.Normalize(mean, std, is_hwc=True)[源代码]

根据均值和标准差对输入图像进行归一化。

此处理将使用以下公式对输入图像进行归一化：output[channel] = (input[channel] - mean[channel]) / std[channel]，其中 channel 代表通道索引，channel >= 1。

说明

此操作默认通过 CPU 执行，也支持异构加速到 GPU 或 Ascend 上执行。

参数：

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 - 如果 std 不在 (0.0, 255.0] 范围内。
RuntimeError - 如果给定的tensor format不是<H, W>或<…,H, W, C>。

支持平台：

CPU GPU Ascend

样例：

>>> import mindspore.dataset as ds
>>> import mindspore.dataset.vision as vision
>>>
>>> image_folder_dataset = ds.ImageFolderDataset("/path/to/image_folder_dataset_directory")
>>> decode_op = vision.Decode() ## Decode output is expected to be HWC format
>>> normalize_op = vision.Normalize(mean=[121.0, 115.0, 100.0], std=[70.0, 68.0, 71.0], is_hwc=True)
>>> transforms_list = [decode_op, normalize_op]
>>> image_folder_dataset = image_folder_dataset.map(operations=transforms_list,
...                                                 input_columns=["image"])

教程样例：

视觉变换样例库

device(device_target='CPU')[源代码]

指定该变换执行的设备。

当执行设备是 CPU 时，输入数据支持 uint8 、 float32 或者 float64 类型，输入数据的通道支持 1/2/3 。
当执行设备是 Ascend 时，输入数据支持 uint8 或者 float32 类型，输入数据的通道仅支持 1/3，且输出结果中为1的维度都会被去除。

参数：

device_target (str, 可选) - 算子将在指定的设备上运行。当前支持 CPU 。默认值： CPU 。

异常：

TypeError - 当 device_target 的类型不为str。
ValueError - 当 device_target 的取值不为 CPU 。

支持平台：

CPU

样例：

>>> import mindspore.dataset as ds
>>> import mindspore.dataset.vision as vision
>>> from mindspore.dataset.vision import Inter
>>>
>>> decode_op = vision.Decode()
>>> resize_op = vision.Resize([100, 75], Inter.BICUBIC)
>>> transforms_list = [decode_op, resize_op]
>>> image_folder_dataset = ds.ImageFolderDataset("/path/to/image_folder_dataset_directory")
>>> image_folder_dataset = image_folder_dataset.map(operations=transforms_list,
...                                                 input_columns=["image"])
>>> normalize_op = vision.Normalize(mean=[121.0, 115.0, 100.0], std=[70.0, 68.0, 71.0]).device("Ascend")
>>> image_folder_dataset = image_folder_dataset.map(operations=normalize_op, input_columns=["image"])