图像分类模块使用教程

一、概述

图像分类模块是计算机视觉系统中的关键组成部分，负责对输入的图像进行分类。该模块的性能直接影响到整个计算机视觉系统的准确性和效率。图像分类模块通常会接收图像作为输入，然后通过深度学习或其他机器学习算法，根据图像的特性和内容，将其分类到预定义的类别中。例如，对于一个动物识别系统，图像分类模块可能需要将输入的图像分类为“猫”、“狗”、“马”等类别。图像分类模块的分类结果将作为输出，供其他模块或系统使用。

二、支持模型列表

模型	模型下载链接	Top1 Acc(%)	GPU推理耗时（ms） [常规模式 / 高性能模式]	CPU推理耗时（ms） [常规模式 / 高性能模式]	模型存储大小（MB）
CLIP_vit_base_patch16_224	推理模型/训练模型	85.36	12.03 / 2.49	60.86 / 42.69	331
MobileNetV3_small_x1_0	推理模型/训练模型	68.2	4.23 / 0.78	5.24 / 1.48	10.5
PP-HGNet_small	推理模型/训练模型	81.51	5.87 / 1.68	25.58 / 18.50	86.5
PP-HGNetV2-B0	推理模型/训练模型	77.77	4.41 / 0.87	10.58 / 1.87	21.4
PP-HGNetV2-B4	推理模型/训练模型	83.57	7.05 / 1.16	16.23 / 7.55	70.4
PP-HGNetV2-B6	推理模型/训练模型	86.30	13.86 / 3.28	67.25 / 56.70	268.4
PP-LCNet_x1_0	推理模型/训练模型	71.32	2.59 / 0.68	3.18 / 1.19	10.5
ResNet50	推理模型/训练模型	76.5	6.25 / 1.17	15.93 / 9.72	90.8
SwinTransformer_tiny_patch4_window7_224	推理模型/训练模型	81.10	7.11 / 2.01	62.72 / 47.35	100.1

❗ 以上列出的是图像分类模块重点支持的9个核心模型，该模块总共支持80个模型，完整的模型列表如下：

👉模型列表详情

模型	模型下载链接	Top1 Acc(%)	GPU推理耗时（ms） [常规模式 / 高性能模式]	CPU推理耗时（ms） [常规模式 / 高性能模式]	模型存储大小（MB）	介绍
CLIP_vit_base_patch16_224	推理模型/训练模型	85.36	12.03 / 2.49	60.86 / 42.69	331	CLIP是一种基于视觉和语言相关联的图像分类模型，采用对比学习和预训练方法，实现无监督或弱监督的图像分类，尤其适用于大规模数据集。模型通过将图像和文本映射到同一表示空间，学习到通用特征，具有良好的泛化能力和解释性。其在较好的训练误差，在很多下游任务都有较好的表现。
CLIP_vit_large_patch14_224	推理模型/训练模型	88.1	49.15 / 9.75	223.16 / 206.49	1040
ConvNeXt_base_224	推理模型/训练模型	83.84	11.37 / 5.65	143.98 / 52.31	313.9	ConvNeXt系列模型是Meta在2022年提出的基于CNN架构的模型。该系列模型是在ResNet的基础上，通过借鉴SwinTransformer的优点设计，包括训练策略和网络结构的优化思路，从而改进的纯CNN架构网络，探索了卷积神经网络的性能上限。ConvNeXt系列模型具备卷积神经网络的诸多优点，包括推理效率高和易于迁移到下游任务等。
ConvNeXt_base_384	推理模型/训练模型	84.90	29.48 / 11.17	293.76 / 134.27	313.9
ConvNeXt_large_224	推理模型/训练模型	84.26	22.99 / 12.73	220.79 / 113.24	700.7
ConvNeXt_large_384	推理模型/训练模型	85.27	58.90 / 24.63	509.48 / 260.27	700.7
ConvNeXt_small	推理模型/训练模型	83.13	7.72 / 4.35	95.92 / 33.34	178.0
ConvNeXt_tiny	推理模型/训练模型	82.03	6.00 / 2.47	63.59 / 18.23	104.1
FasterNet-L	推理模型/训练模型	83.5	11.96 / 2.68	51.93 / 35.33	357.1	FasterNet是一个旨在提高运行速度的神经网络，改进点主要如下： 1.重新审视了流行的运算符，发现低FLOPS主要来自于运算频繁的内存访问，特别是深度卷积； 2.提出了部分卷积(PConv)，通过减少冗余计算和内存访问来更高效地提取图像特征； 3.基于PConv推出了FasterNet系列模型，这是一种新的设计方案，在不影响模型任务性能的情况下，在各种设备上实现了显著更高的运行速度。
FasterNet-M	推理模型/训练模型	83.0	11.17 / 2.16	38.49 / 21.17	204.6
FasterNet-S	推理模型/训练模型	81.3	7.70 / 1.24	19.51 / 11.22	119.3
FasterNet-T0	推理模型/训练模型	71.9	4.73 / 0.82	6.40 / 1.96	15.1
FasterNet-T1	推理模型/训练模型	75.9	4.80 / 0.80	8.14 / 3.13	29.2
FasterNet-T2	推理模型/训练模型	79.1	6.10 / 0.88	12.71 / 5.35	57.4
MobileNetV1_x0_5	推理模型/训练模型	63.5	1.98 / 0.51	2.50 / 1.04	4.8	MobileNetV1是Google于2017年发布的用于移动设备或嵌入式设备中的网络。该网络将传统的卷积操作拆解成深度可分离卷积，即Depthwise卷积和Pointwise卷积的组合。相比传统的卷积网络，该组合可以大大节省参数量和计算量。同时该网络可以用于图像分类等其他视觉任务中。
MobileNetV1_x0_25	推理模型/训练模型	51.4	1.99 / 0.45	1.82 / 0.73	1.8
MobileNetV1_x0_75	推理模型/训练模型	68.8	2.33 / 0.41	3.33 / 1.34	9.3
MobileNetV1_x1_0	推理模型/训练模型	71.0	2.31 / 0.45	3.91 / 1.89	15.2
MobileNetV2_x0_5	推理模型/训练模型	65.0	3.58 / 0.62	3.86 / 1.23	7.1	MobileNetV2是Google继MobileNetV1提出的一种轻量级网络。相比MobileNetV1，MobileNetV2提出了Linear bottlenecks与Inverted residual block作为网络基本结构，通过大量地堆叠这些基本模块，构成了MobileNetV2的网络结构。最后，在FLOPs只有MobileNetV1的一半的情况下取得了更高的分类精度。
MobileNetV2_x0_25	推理模型/训练模型	53.2	3.05 / 0.66	3.30 / 0.98	5.5
MobileNetV2_x1_0	推理模型/训练模型	72.2	3.85 / 0.63	5.50 / 1.87	12.6
MobileNetV2_x1_5	推理模型/训练模型	74.1	3.93 / 0.73	8.84 / 3.12	25.0
MobileNetV2_x2_0	推理模型/训练模型	75.2	3.89 / 0.79	10.36 / 4.50	41.2
MobileNetV3_large_x0_5	推理模型/训练模型	69.2	4.60 / 0.77	5.32 / 1.58	9.6	MobileNetV3是Google于2019年提出的一种基于NAS的轻量级网络。为了进一步提升效果，将relu和sigmoid激活函数分别替换为hard_swish与hard_sigmoid激活函数，同时引入了一些专门为减少网络计算量的改进策略。
MobileNetV3_large_x0_35	推理模型/训练模型	64.3	4.44 / 0.75	5.20 / 1.50	7.5
MobileNetV3_large_x0_75	推理模型/训练模型	73.1	5.30 / 0.85	6.02 / 1.93	14.0
MobileNetV3_large_x1_0	推理模型/训练模型	75.3	5.38 / 0.81	7.16 / 2.19	19.5
MobileNetV3_large_x1_25	推理模型/训练模型	76.4	5.54 / 0.84	7.06 / 2.84	26.5
MobileNetV3_small_x0_5	推理模型/训练模型	59.2	3.87 / 0.77	4.90 / 1.32	6.8
MobileNetV3_small_x0_35	推理模型/训练模型	53.0	3.68 / 0.77	3.94 / 1.27	6.0
MobileNetV3_small_x0_75	推理模型/训练模型	66.0	3.92 / 0.77	4.68 / 1.39	8.5
MobileNetV3_small_x1_0	推理模型/训练模型	68.2	4.23 / 0.78	5.24 / 1.48	10.5
MobileNetV3_small_x1_25	推理模型/训练模型	70.7	4.59 / 0.79	5.36 / 1.63	13.0
MobileNetV4_conv_large	推理模型/训练模型	83.4	9.04 / 2.28	34.34 / 22.01	125.2	MobileNetV4是专为移动设备设计的高效架构。其核心在于引入了UIB（Universal Inverted Bottleneck）模块，这是一种统一且灵活的结构，融合了IB（Inverted Bottleneck）、ConvNeXt、FFN（Feed Forward Network）以及最新的ExtraDW（Extra Depthwise）模块。与UIB同时推出的还有Mobile MQA，这是种专为移动加速器定制的注意力块，可实现高达39%的显著加速。此外，MobileNetV4引入了一种新的神经架构搜索（Neural Architecture Search, NAS）方案，以提升搜索的有效性。
MobileNetV4_conv_medium	推理模型/训练模型	79.9	5.70 / 1.05	13.78 / 5.64	37.6
MobileNetV4_conv_small	推理模型/训练模型	74.6	3.81 / 0.55	5.24 / 1.50	14.7
MobileNetV4_hybrid_large	推理模型/训练模型	83.8	13.43 / 4.28	61.16 / 31.06	145.1
MobileNetV4_hybrid_medium	推理模型/训练模型	80.5	11.82 / 1.30	22.01 / 6.06	42.9
PP-HGNet_base	推理模型/训练模型	85.0	13.43 / 3.81	71.24 / 51.48	249.4	PP-HGNet（High Performance GPU Net）是百度飞桨视觉团队研发的适用于GPU平台的高性能骨干网络。该网络结合VOVNet的基础出使用了可学习的下采样层（LDS Layer），融合了ResNet_vd、PPHGNet等模型的优点。该模型在GPU平台上与其他SOTA模型在相同的速度下有着更高的精度。在同等速度下，该模型高于ResNet34-0模型3.8个百分点，高于ResNet50-0模型2.4个百分点，在使用相同的SLSD条款下，最终超越了ResNet50-D模型4.7个百分点。与此同时，在相同精度下，其推理速度也远超主流VisionTransformer的推理速度。
PP-HGNet_small	推理模型/训练模型	81.51	5.87 / 1.68	25.58 / 18.50	86.5
PP-HGNet_tiny	推理模型/训练模型	79.83	5.84 / 1.38	17.03 / 10.58	52.4
PP-HGNetV2-B0	推理模型/训练模型	77.77	4.41 / 0.87	10.58 / 1.87	21.4	PP-HGNetV2（High Performance GPU Network V2）是百度飞桨视觉团队的PP-HGNet的下一代版本，其在PP-HGNet的基础上，做了进一步优化和改进，其在NVIDIA发布的“Accuracy-Latency Balance”做到了极致，精度大幅超越了其他同样推理速度的模型。在每种标签分类，考标场景中，都有较强的表现。
PP-HGNetV2-B1	推理模型/训练模型	79.18	4.52 / 0.73	11.98 / 2.28	22.6
PP-HGNetV2-B2	推理模型/训练模型	81.74	6.67 / 0.96	14.22 / 4.04	39.9
PP-HGNetV2-B3	推理模型/训练模型	82.98	7.47 / 1.94	17.73 / 5.63	57.9
PP-HGNetV2-B4	推理模型/训练模型	83.57	7.05 / 1.16	16.23 / 7.55	70.4
PP-HGNetV2-B5	推理模型/训练模型	84.75	10.38 / 1.95	31.53 / 18.02	140.8
PP-HGNetV2-B6	推理模型/训练模型	86.30	13.86 / 3.28	67.25 / 56.70	268.4
PP-LCNet_x0_5	推理模型/训练模型	63.14	2.41 / 0.60	2.54 / 0.90	6.7	PP-LCNet是百度飞桨视觉团队自研的轻量级骨干网络，它能在不增加推理时间的前提下，进一步提升模型的性能，大幅超越其他轻量级SOTA模型。
PP-LCNet_x0_25	推理模型/训练模型	51.86	2.16 / 0.60	2.73 / 0.77	5.5
PP-LCNet_x0_35	推理模型/训练模型	58.09	2.18 / 0.60	2.32 / 0.89	5.9
PP-LCNet_x0_75	推理模型/训练模型	68.18	2.61 / 0.58	3.00 / 1.09	8.4
PP-LCNet_x1_0	推理模型/训练模型	71.32	2.59 / 0.68	3.18 / 1.19	10.5
PP-LCNet_x1_5	推理模型/训练模型	73.71	2.60 / 0.68	3.98 / 1.66	16.0
PP-LCNet_x2_0	推理模型/训练模型	75.18	2.53 / 0.68	5.21 / 2.24	23.2
PP-LCNet_x2_5	推理模型/训练模型	76.60	2.76 / 0.67	6.78 / 3.20	32.1
PP-LCNetV2_base	推理模型/训练模型	77.05	4.04 / 0.62	6.80 / 2.67	23.7	PP-LCNetV2 图像分类模型是百度飞桨视觉团队自研的 PP-LCNet 的下一代版本，其在 PP-LCNet 的基础上，做了进一步优化和改进，主要使用重参数化策略组合了不同大小卷积核的深度卷积，并优化了点卷积、Shortcut等。在不使用额外数据的前提下，PPLCNetV2_base 模型在图像分类 ImageNet 数据集上能够取得超过 77% 的 Top1 Acc，同时在 Intel CPU 平台的推理时间在 4.4 ms 以下
PP-LCNetV2_large	推理模型/训练模型	78.51	4.91 / 0.85	10.30 / 5.38	37.3
PP-LCNetV2_small	推理模型/训练模型	73.97	3.07 / 0.60	4.28 / 1.58	14.6
ResNet18_vd	推理模型/训练模型	72.3	2.87 / 0.77	7.91 / 4.64	41.5	ResNet 系列模型是在 2015 年提出的，一举在 ILSVRC2015 比赛中取得冠军，top5 错误率为 3.57%。该网络创新性的提出了残差结构，通过堆叠多个残差结构从而构建了 ResNet 网络。实验表明使用残差块可以有效地提升收敛速度和精度。
ResNet18	推理模型/训练模型	71.0	2.63 / 0.74	6.30 / 4.16	41.5
ResNet34_vd	推理模型/训练模型	76.0	4.47 / 1.09	14.30 / 8.33	77.3
ResNet34	推理模型/训练模型	74.6	4.20 / 1.07	12.53 / 7.83	77.3
ResNet50_vd	推理模型/训练模型	79.1	6.66 / 1.23	16.34 / 10.00	90.8
ResNet50	推理模型/训练模型	76.5	6.25 / 1.17	15.93 / 9.72	90.8
ResNet101_vd	推理模型/训练模型	80.2	11.93 / 2.07	32.47 / 23.62	158.4
ResNet101	推理模型/训练模型	77.6	13.73 / 2.06	29.69 / 17.72	158.4
ResNet152_vd	推理模型/训练模型	80.6	20.70 / 2.82	43.90 / 27.91	214.3
ResNet152	推理模型/训练模型	78.3	17.86 / 2.79	46.19 / 26.00	214.2
ResNet200_vd	推理模型/训练模型	80.9	22.55 / 3.54	58.54 / 35.70	266.0
StarNet-S1	推理模型/训练模型	73.6	6.24 / 0.96	8.78 / 2.44	11.2	StarNet 聚焦于研究网络设计中“星操作”（即元素级乘法）的未开发潜力。揭示星操作能够将输入映射到高维、非线性特征空间的能力，这一过程类似于核技巧，但无需扩大网络规模。因此进一步提出了 StarNet，一个简单而强大的原型网络，该网络在紧凑的网络结构和有限的计算资源下，展现出了卓越的性能和低延迟。
StarNet-S2	推理模型/训练模型	74.8	4.78 / 0.85	7.24 / 2.48	14.3
StarNet-S3	推理模型/训练模型	77.0	6.77 / 1.07	9.69 / 3.35	22.2
StarNet-S4	推理模型/训练模型	79.0	9.01 / 1.48	14.79 / 4.58	28.9
SwinTransformer_base_patch4_window7_224	推理模型/训练模型	83.37	13.04 / 10.77	133.79 / 118.45	340	SwinTransformer 是一种新的视觉 Transformer 网络，可以用作计算机视觉领域的通用骨干网路。SwinTransformer 由移动窗口（shifted windows）表示的层次 Transformer 结构组成。移动窗口将自注意计算限制在非重叠的局部窗口上，同时允许跨窗口连接，从而提高了网络性能。
SwinTransformer_base_patch4_window12_384	推理模型/训练模型	84.17	33.99 / 28.42	400.19 / 317.36	311.4
SwinTransformer_large_patch4_window7_224	推理模型/训练模型	86.19	23.69 / 6.18	198.60 / 177.18	694.8
SwinTransformer_large_patch4_window12_384	推理模型/训练模型	87.06	68.07 / 14.84	609.07 / 525.72	696.1
SwinTransformer_small_patch4_window7_224	推理模型/训练模型	83.21	12.17 / 3.51	111.03 / 92.51	175.6
SwinTransformer_tiny_patch4_window7_224	推理模型/训练模型	81.10	7.11 / 2.01	62.72 / 47.35	100.1

测试环境说明:

• 性能测试环境
  • 测试数据集：ImageNet-1k 验证集 Top1 Acc。
  • 硬件配置：
    • GPU：NVIDIA Tesla T4
    • CPU：Intel Xeon Gold 6271C @ 2.60GHz
    • 其他环境：Ubuntu 20.04 / CUDA 11.8 / cuDNN 8.9 / TensorRT 8.6.1.6
• 推理模式说明

模式	GPU配置	CPU配置	加速技术组合
常规模式	FP32精度 / 无TRT加速	FP32精度 / 8线程	PaddleInference
高性能模式	选择先验精度类型和加速策略的最优组合	FP32精度 / 8线程	选择先验最优后端（Paddle/OpenVINO/TRT等）

三、快速集成

❗ 在快速集成前，请先安装 PaddleX 的 wheel 包，详细请参考 PaddleX本地安装教程。

完成 wheel 包的安装后，几行代码即可完成图像分类模块的推理，可以任意切换该模块下的模型，您也可以将图像分类的模块中的模型推理集成到您的项目中。运行以下代码前，请您下载示例图片到本地。

from paddlex import create_model
model = create_model(model_name="PP-LCNet_x1_0")
output = model.predict("general_image_classification_001.jpg", batch_size=1)
for res in output:
    res.print(json_format=False)
    res.save_to_img("./output/")
    res.save_to_json("./output/res.json")

运行后，得到的结果为：

{'res': {'input_path': 'general_image_classification_001.jpg', 'page_index': None, 'class_ids': array([296, 279, 270, 537, 356], dtype=int32), 'scores': array([0.79155, 0.01738, 0.01428, 0.01301, 0.01222], dtype=float32), 'label_names': ['ice bear, polar bear, Ursus Maritimus, Thalarctos maritimus', 'Arctic fox, white fox, Alopex lagopus', 'white wolf, Arctic wolf, Canis lupus tundrarum', 'dogsled, dog sled, dog sleigh', 'weasel']}}

运行结果参数含义如下： - input_path：表示输入图片的路径。 - page_index：如果输入是PDF文件，则表示当前是PDF的第几页，否则为 None。 - class_ids：表示预测结果的类别id。 - scores：表示预测结果的置信度。 - label_names：表示预测结果的类别名。

可视化图片如下：

相关方法、参数等说明如下：

• create_model实例化图像分类模型（此处以PP-LCNet_x1_0为例），具体说明如下：

参数	参数说明	参数类型	可选项	默认值
model_name	模型名称	str	无	无
model_dir	模型存储路径	str	无	无
device	模型推理设备	str	支持指定GPU具体卡号，如“gpu:0”，其他硬件具体卡号，如“npu:0”，CPU如“cpu”。	gpu:0
topk	预测结果的前topk值，如果不指定，将默认使用PaddleX官方模型配置	int	int，如 5 ，表示打印（返回）预测结果的前5个类别和对应的分类概率	5
use_hpip	是否启用高性能推理插件	bool	无	False
hpi_config	高性能推理配置	dict | None	无	None

• 其中，model_name 必须指定，指定 model_name 后，默认使用 PaddleX 内置的模型参数，在此基础上，指定 model_dir 时，使用用户自定义的模型。

• 调用图像分类模型的 predict() 方法进行推理预测，predict() 方法参数有 input 和 batch_size，具体说明如下：

参数	参数说明	参数类型	可选项	默认值
input	待预测数据，支持多种输入类型	Python Var/str/list	Python变量，如numpy.ndarray表示的图像数据 文件路径，如图像文件的本地路径：/root/data/img.jpg URL链接，如图像文件的网络URL：示例 本地目录，该目录下需包含待预测数据文件，如本地路径：/root/data/ 列表，列表元素需为上述类型数据，如[numpy.ndarray, numpy.ndarray]，[\"/root/data/img1.jpg\", \"/root/data/img2.jpg\"]，[\"/root/data1\", \"/root/data2\"]	无
batch_size	批大小	int	任意整数	1
topk	预测结果的前topk值；如果不指定，将默认使用 creat_model 指定的 topk 参数，如果 creat_model 也没有指定，则默认使用PaddleX官方模型配置	int	int，如 5 ，表示打印（返回）预测结果的前5个类别和对应的分类概率	5

• 对预测结果进行处理，每个样本的预测结果均为对应的Result对象，且支持打印、保存为图片、保存为json文件的操作:

方法	方法说明	参数	参数类型	参数说明	默认值
print()	打印结果到终端	format_json	bool	是否对输出内容进行使用 JSON 缩进格式化	True
		indent	int	指定缩进级别，以美化输出的 JSON 数据，使其更具可读性，仅当 format_json 为 True 时有效	4
		ensure_ascii	bool	控制是否将非 ASCII 字符转义为 Unicode。设置为 True 时，所有非 ASCII 字符将被转义；False 则保留原始字符，仅当format_json为True时有效	False
save_to_json()	将结果保存为json格式的文件	save_path	str	保存的文件路径，当为目录时，保存文件命名与输入文件类型命名一致	无
		indent	int	指定缩进级别，以美化输出的 JSON 数据，使其更具可读性，仅当 format_json 为 True 时有效	4
		ensure_ascii	bool	控制是否将非 ASCII 字符转义为 Unicode。设置为 True 时，所有非 ASCII 字符将被转义；False 则保留原始字符，仅当format_json为True时有效	False
save_to_img()	将结果保存为图像格式的文件	save_path	str	保存的文件路径，当为目录时，保存文件命名与输入文件类型命名一致	无

• 此外，也支持通过属性获取带结果的可视化图像和预测结果，具体如下：

属性	属性说明
json	获取预测的json格式的结果
img	获取格式为dict的可视化图像

关于更多 PaddleX 的单模型推理的 API 的使用方法，可以参考PaddleX单模型Python脚本使用说明。

四、二次开发

如果你追求更高精度的现有模型，可以使用 PaddleX 的二次开发能力，开发更好的图像分类模型。在使用 PaddleX 开发图像分类模型之前，请务必安装 PaddleX 的 图像分类 PaddleX本地安装教程中的二次开发部分。

4.1 数据准备

在进行模型训练前，需要准备相应任务模块的数据集。PaddleX 针对每一个模块提供了数据校验功能，只有通过数据校验的数据才可以进行模型训练。此外，PaddleX 为每一个模块都提供了 Demo 数据集，您可以基于官方提供的 Demo 数据完成后续的开发。若您希望用私有数据集进行后续的模型训练，可以参考PaddleX图像分类任务模块数据标注教程

4.1.1 Demo 数据下载

您可以参考下面的命令将 Demo 数据集下载到指定文件夹：

cd /path/to/paddlex
wget https://paddle-model-ecology.bj.bcebos.com/paddlex/data/cls_flowers_examples.tar -P ./dataset
tar -xf ./dataset/cls_flowers_examples.tar -C ./dataset/

4.1.2 数据校验

一行命令即可完成数据校验：

python main.py -c paddlex/configs/modules/image_classification/PP-LCNet_x1_0.yaml \
    -o Global.mode=check_dataset \
    -o Global.dataset_dir=./dataset/cls_flowers_examples

执行上述命令后，PaddleX 会对数据集进行校验，并统计数据集的基本信息。命令运行成功后会在log中打印出Check dataset passed !信息。校验结果文件保存在./output/check_dataset_result.json，同时相关产出会保存在当前目录的./output/check_dataset目录下，产出目录中包括可视化的示例样本图片和样本分布直方图。

👉 校验结果详情（点击展开）

校验结果文件具体内容为：

{
  "done_flag": true,
  "check_pass": true,
  "attributes": {
    "label_file": "dataset/label.txt",
    "num_classes": 102,
    "train_samples": 1020,
    "train_sample_paths": [
      "check_dataset/demo_img/image_01904.jpg",
      "check_dataset/demo_img/image_06940.jpg"
    ],
    "val_samples": 1020,
    "val_sample_paths": [
      "check_dataset/demo_img/image_01937.jpg",
      "check_dataset/demo_img/image_06958.jpg"
    ]
  },
  "analysis": {
    "histogram": "check_dataset/histogram.png"
  },
  "dataset_path": "cls_flowers_examples",
  "show_type": "image",
  "dataset_type": "ClsDataset"
}

上述校验结果中，check_pass 为 True 表示数据集格式符合要求，其他部分指标的说明如下：

• attributes.num_classes：该数据集类别数为 102；
• attributes.train_samples：该数据集训练集样本数量为 1020；
• attributes.val_samples：该数据集验证集样本数量为 1020；
• attributes.train_sample_paths：该数据集训练集样本可视化图片相对路径列表；
• attributes.val_sample_paths：该数据集验证集样本可视化图片相对路径列表；

另外，数据集校验还对数据集中所有类别的样本数量分布情况进行了分析，并绘制了分布直方图（histogram.png）：

4.1.3 数据集格式转换/数据集划分（可选）

在您完成数据校验之后，可以通过修改配置文件或是追加超参数的方式对数据集的格式进行转换，也可以对数据集的训练/验证比例进行重新划分。

👉 格式转换/数据集划分详情（点击展开）

（1）数据集格式转换

图像分类暂不支持数据转换。

（2）数据集划分

数据集划分的参数可以通过修改配置文件中 CheckDataset 下的字段进行设置，配置文件中部分参数的示例说明如下：

• CheckDataset:
• split:
• enable: 是否进行重新划分数据集，为 True 时进行数据集格式转换，默认为 False；
• train_percent: 如果重新划分数据集，则需要设置训练集的百分比，类型为 0-100 之间的任意整数，需要保证和 val_percent 值加和为100；

例如，您想重新划分数据集为 训练集占比90%、验证集占比10%，则需将配置文件修改为：

......
CheckDataset:
  ......
  split:
    enable: True
    train_percent: 90
    val_percent: 10
  ......

随后执行命令：

python main.py -c paddlex/configs/modules/image_classification/PP-LCNet_x1_0.yaml \
    -o Global.mode=check_dataset \
    -o Global.dataset_dir=./dataset/cls_flowers_examples

数据划分执行之后，原有标注文件会被在原路径下重命名为 xxx.bak。

以上参数同样支持通过追加命令行参数的方式进行设置：

python main.py -c paddlex/configs/modules/image_classification/PP-LCNet_x1_0.yaml \
    -o Global.mode=check_dataset \
    -o Global.dataset_dir=./dataset/cls_flowers_examples \
    -o CheckDataset.split.enable=True \
    -o CheckDataset.split.train_percent=90 \
    -o CheckDataset.split.val_percent=10

4.2 模型训练

一条命令即可完成模型的训练，以此处图像分类模型 PP-LCNet_x1_0 的训练为例：

python main.py -c paddlex/configs/modules/image_classification/PP-LCNet_x1_0.yaml  \
    -o Global.mode=train \
    -o Global.dataset_dir=./dataset/cls_flowers_examples

需要如下几步：

• 指定模型的.yaml 配置文件路径（此处为PP-LCNet_x1_0.yaml,训练其他模型时，需要的指定相应的配置文件，模型和配置的文件的对应关系，可以查阅PaddleX模型列表（CPU/GPU））
• 指定模式为模型训练：-o Global.mode=train
• 指定训练数据集路径：-o Global.dataset_dir
• 其他相关参数均可通过修改.yaml配置文件中的Global和Train下的字段来进行设置，也可以通过在命令行中追加参数来进行调整。如指定前 2 卡 gpu 训练：-o Global.device=gpu:0,1；设置训练轮次数为 10：-o Train.epochs_iters=10。更多可修改的参数及其详细解释，可以查阅模型对应任务模块的配置文件说明PaddleX通用模型配置文件参数说明
• 新特性：Paddle 3.0 版本支持了 CINN 神经网络编译器，在使用 GPU 设备训练时，不同模型有不同程度的训练加速效果。在 PaddleX 中训练模型时，可通过指定参数 -o Train.dy2st=True 开启。

👉 更多说明（点击展开）

• 模型训练过程中，PaddleX 会自动保存模型权重文件，默认为output，如需指定保存路径，可通过配置文件中 -o Global.output 字段进行设置。
• PaddleX 对您屏蔽了动态图权重和静态图权重的概念。在模型训练的过程中，会同时产出动态图和静态图的权重，在模型推理时，默认选择静态图权重推理。

• 在完成模型训练后，所有产出保存在指定的输出目录（默认为./output/）下，通常有以下产出：

• train_result.json：训练结果记录文件，记录了训练任务是否正常完成，以及产出的权重指标、相关文件路径等；

• train.log：训练日志文件，记录了训练过程中的模型指标变化、loss 变化等；
• config.yaml：训练配置文件，记录了本次训练的超参数的配置；
• .pdparams、.pdema、.pdopt.pdstate、.pdiparams、.json：模型权重相关文件，包括网络参数、优化器、EMA、静态图网络参数、静态图网络结构等；
• 【注意】：Paddle 3.0.0 对于静态图网络结构信息的存储格式，由protobuf（原.pdmodel后缀文件）升级为json（现.json后缀文件），以兼容PIR体系，并获得更好的灵活性与扩展性。

4.3 模型评估

在完成模型训练后，可以对指定的模型权重文件在验证集上进行评估，验证模型精度。使用 PaddleX 进行模型评估，一条命令即可完成模型的评估：

python main.py -c  paddlex/configs/modules/image_classification/PP-LCNet_x1_0.yaml  \
    -o Global.mode=evaluate \
    -o Global.dataset_dir=./dataset/cls_flowers_examples

与模型训练类似，需要如下几步：

• 指定模型的.yaml 配置文件路径（此处为PP-LCNet_x1_0.yaml）
• 指定模式为模型评估：-o Global.mode=evaluate
• 指定验证数据集路径：-o Global.dataset_dir 其他相关参数均可通过修改.yaml配置文件中的Global和Evaluate下的字段来进行设置，详细请参考PaddleX通用模型配置文件参数说明。

👉 更多说明（点击展开）

在模型评估时，需要指定模型权重文件路径，每个配置文件中都内置了默认的权重保存路径，如需要改变，只需要通过追加命令行参数的形式进行设置即可，如-o Evaluate.weight_path=./output/best_model/best_model.pdparams。

在完成模型评估后，会产出evaluate_result.json，其记录了评估的结果，具体来说，记录了评估任务是否正常完成，以及模型的评估指标，包含 val.top1、val.top5；

4.4 模型推理和模型集成

在完成模型的训练和评估后，即可使用训练好的模型权重进行推理预测或者进行Python集成。

4.4.1 模型推理

通过命令行的方式进行推理预测，只需如下一条命令。运行以下代码前，请您下载示例图片到本地。

python main.py -c paddlex/configs/modules/image_classification/PP-LCNet_x1_0.yaml \
    -o Global.mode=predict \
    -o Predict.model_dir="./output/best_model/inference" \
    -o Predict.input="general_image_classification_001.jpg"

与模型训练和评估类似，需要如下几步：

• 指定模型的.yaml 配置文件路径（此处为PP-LCNet_x1_0.yaml）
• 指定模式为模型推理预测：-o Global.mode=predict
• 指定模型权重路径：-o Predict.model_dir="./output/best_model/inference"
• 指定输入数据路径：-o Predict.input="..." 其他相关参数均可通过修改.yaml配置文件中的Global和Predict下的字段来进行设置，详细请参考PaddleX通用模型配置文件参数说明。

4.4.2 模型集成

模型可以直接集成到 PaddleX 产线中，也可以直接集成到您自己的项目中。

1.产线集成

图像分类模块可以集成的 PaddleX 产线有通用图像分类产线，只需要替换模型路径即可完成相关产线的图像分类模块的模型更新。在产线集成中，你可以使用高性能部署和服务化部署来部署你得到的模型。

2.模块集成

您产出的权重可以直接集成到图像分类模块中，可以参考快速集成的 Python 示例代码，只需要将模型替换为你训练的到的模型路径即可。

您也可以利用 PaddleX 高性能推理插件来优化您模型的推理过程，进一步提升效率，详细的流程请参考PaddleX高性能推理指南。

评论