--- comments: true --- # 车辆属性识别模块使用教程 ## 一、概述 车辆属性识别是计算机视觉系统中的重要组成部分,其主要任务是在图像或视频中定位并标记出车辆的特定属性,如车辆类型、颜色、车牌号等。该模块的性能直接影响到整个计算机视觉系统的准确性和效率。车辆属性识别模块通常会输出包含车辆属性信息的边界框(Bounding Boxes),这些边界框将作为输入传递给其他模块(如车辆跟踪、车辆重识别等)进行后续处理。 ## 二、支持模型列表 > 推理耗时仅包含模型推理耗时,不包含前后处理耗时。
| 模型 | 模型下载链接 | mA(%) | GPU推理耗时(ms) [常规模式 / 高性能模式] |
CPU推理耗时(ms) [常规模式 / 高性能模式] |
模型存储大小(MB) | 介绍 |
|---|---|---|---|---|---|---|
| PP-LCNet_x1_0_vehicle_attribute | 推理模型/训练模型 | 91.7 | 2.53 / 0.67 | 2.73 / 1.10 | 6.7 | PP-LCNet_x1_0_vehicle_attribute 是一种基于PP-LCNet的轻量级车辆属性识别模型。 |
| 模式 | GPU配置 | CPU配置 | 加速技术组合 |
|---|---|---|---|
| 常规模式 | FP32精度 / 无TRT加速 | FP32精度 / 8线程 | PaddleInference |
| 高性能模式 | 选择先验精度类型和加速策略的最优组合 | FP32精度 / 8线程 | 选择先验最优后端(Paddle/OpenVINO/TRT等) |
相关方法、参数等说明如下:
* `create_model`实例化车辆属性识别模型(此处以`PP-LCNet_x1_0_vehicle_attribute`为例),具体说明如下:
| 参数 | 参数说明 | 参数类型 | 可选项 | 默认值 |
|---|---|---|---|---|
model_name |
模型名称 | str |
无 | PP-LCNet_x1_0_vehicle_attribute |
model_dir |
模型存储路径 | str |
无 | 无 |
device |
模型推理设备 | str |
支持指定GPU具体卡号,如“gpu:0”,其他硬件具体卡号,如“npu:0”,CPU如“cpu”。 | gpu:0 |
threshold |
车辆属性识别阈值 | float/list/dict |
0.5[0.5,0.5,...]{"default":0.5,1:0.1,...}
|
0.5 |
use_hpip |
是否启用高性能推理插件 | bool |
无 | False |
hpi_config |
高性能推理配置 | dict | None |
无 | None |
| 参数 | 参数说明 | 参数类型 | 可选项 | 默认值 |
|---|---|---|---|---|
input |
待预测数据,支持多种输入类型 | Python Var/str/list |
|
无 |
batch_size |
批大小 | int |
任意整数 | 1 |
threshold |
车辆属性识别阈值 | float/list/dict |
0.5[0.5,0.5,...]{"default":0.5,1:0.1,...}
|
0.5 |
| 方法 | 方法说明 | 参数 | 参数类型 | 参数说明 | 默认值 |
|---|---|---|---|---|---|
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的可视化图像 |
校验结果文件具体内容为:
{
"done_flag": true,
"check_pass": true,
"attributes": {
"label_file": "../../dataset/vehicle_attribute_examples/label.txt",
"num_classes": 19,
"train_samples": 1200,
"train_sample_paths": [
"check_dataset/demo_img/0018_c017_00033140_0.jpg",
"check_dataset/demo_img/0010_c019_00034275_0.jpg",
"check_dataset/demo_img/0015_c019_00068660_0.jpg",
"check_dataset/demo_img/0016_c017_00049590_1.jpg",
"check_dataset/demo_img/0018_c016_00052280_0.jpg",
"check_dataset/demo_img/0023_c001_00006995_0.jpg",
"check_dataset/demo_img/0022_c004_00065910_0.jpg",
"check_dataset/demo_img/0007_c019_00048655_1.jpg",
"check_dataset/demo_img/0022_c007_00072970_0.jpg",
"check_dataset/demo_img/0022_c008_00065785_0.jpg"
],
"val_samples": 300,
"val_sample_paths": [
"check_dataset/demo_img/0025_c003_00054095_0.jpg",
"check_dataset/demo_img/0023_c013_00006350_1.jpg",
"check_dataset/demo_img/0024_c003_00046320_0.jpg",
"check_dataset/demo_img/0025_c005_00054795_2.jpg",
"check_dataset/demo_img/0024_c012_00041770_0.jpg",
"check_dataset/demo_img/0024_c007_00060845_1.jpg",
"check_dataset/demo_img/0023_c017_00013150_0.jpg",
"check_dataset/demo_img/0024_c014_00040410_0.jpg",
"check_dataset/demo_img/0025_c002_00050685_1.jpg",
"check_dataset/demo_img/0025_c005_00032645_0.jpg"
]
},
"analysis": {
"histogram": "check_dataset/histogram.png"
},
"dataset_path": "vehicle_attribute_examples",
"show_type": "image",
"dataset_type": "MLClsDataset"
}
上述校验结果中,check_pass 为 true 表示数据集格式符合要求,其他部分指标的说明如下:
attributes.num_classes:该数据集类别数为 19;attributes.train_samples:该数据集训练集样本数量为 1200;attributes.val_samples:该数据集验证集样本数量为 300;attributes.train_sample_paths:该数据集训练集样本可视化图片相对路径列表;attributes.val_sample_paths:该数据集验证集样本可视化图片相对路径列表;另外,数据集校验还对数据集中所有图片的长宽分布情况进行了分析分析,并绘制了分布直方图(histogram.png):

(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/vehicle_attribute_recognition/PP-LCNet_x1_0_vehicle_attribute.yaml \
-o Global.mode=check_dataset \
-o Global.dataset_dir=./dataset/vehicle_attribute_examples
数据划分执行之后,原有标注文件会被在原路径下重命名为 xxx.bak。
以上参数同样支持通过追加命令行参数的方式进行设置:
python main.py -c paddlex/configs/modules/vehicle_attribute_recognition/PP-LCNet_x1_0_vehicle_attribute.yaml \
-o Global.mode=check_dataset \
-o Global.dataset_dir=./dataset/vehicle_attribute_examples \
-o CheckDataset.split.enable=True \
-o CheckDataset.split.train_percent=90 \
-o CheckDataset.split.val_percent=10
output,如需指定保存路径,可通过配置文件中 -o Global.output 字段进行设置。在完成模型训练后,所有产出保存在指定的输出目录(默认为./output/)下,通常有以下产出:
train_result.json:训练结果记录文件,记录了训练任务是否正常完成,以及产出的权重指标、相关文件路径等;
train.log:训练日志文件,记录了训练过程中的模型指标变化、loss 变化等;config.yaml:训练配置文件,记录了本次训练的超参数的配置;.pdparams、.pdema、.pdopt.pdstate、.pdiparams、.json:模型权重相关文件,包括网络参数、优化器、EMA、静态图网络参数、静态图网络结构等;.pdmodel后缀文件)升级为json(现.json后缀文件),以兼容PIR体系,并获得更好的灵活性与扩展性。在模型评估时,需要指定模型权重文件路径,每个配置文件中都内置了默认的权重保存路径,如需要改变,只需要通过追加命令行参数的形式进行设置即可,如-o Evaluate.weight_path=./output/best_model/best_model.pdparams。
在完成模型评估后,会产出evaluate_result.json,其记录了评估的结果,具体来说,记录了评估任务是否正常完成,以及模型的评估指标,包括 MultiLabelMAP;