Quaterion实战教程从零构建以图搜车系统计算机视觉篇【免费下载链接】quaterionBlazing fast framework for fine-tuning similarity learning models项目地址: https://gitcode.com/gh_mirrors/qu/quaterion想给海量汽车图片做以图搜车却不知从何下手本文带你用 Quaterion 从零构建一个完整的以图搜车系统。Quaterion 是一款极速的相似性学习模型微调框架Blazing fast framework for fine-tuning similarity learning models它把预训练模型 自定义微调的最后一公里问题全部封装好让你只需少量配置就能训练出能识别从未见过的新车型的图像检索模型。本教程以官方计算机视觉示例为蓝本全程走通数据准备、模型配置、训练评估与上线部署四大环节新手也能轻松复现。以图搜车系统是什么先搞懂相似性学习的核心原理传统图像分类模型只能回答这张图属于哪一类遇到训练时没见过的车型就无能为力。而以图搜车系统走的是相似性学习Similarity Learning路线它训练的不是分类器而是一个特征提取器把每张汽车图片映射成一个固定维度的特征向量Embedding让同款车型的向量彼此靠近、不同车型的向量彼此远离。搜索时只需计算查询图片向量与库中所有向量之间的距离余弦距离或欧氏距离距离最近的即为搜索结果。这也是语义检索、推荐系统、人脸识别背后的通用范式。Quaterion 正是为这类任务而生的框架它构建在 PyTorch Lightning 之上自带缓存加速、丰富的损失函数与评估指标官方还提供了可直接运行的以图搜车完整示例代码位于 examples/cars 目录。快速开始克隆项目并安装依赖先把项目克隆到本地git clone https://gitcode.com/gh_mirrors/qu/quaterion cd quaterion pip install -e .由于汽车示例用到了 torchvision 和斯坦福汽车数据集请额外确认pip install torchvisionStanford Cars 数据集预处理训练与测试按类别严格隔离本项目使用 Stanford Cars 数据集包含 16185 张汽车图片、覆盖 196 个车型类别。一个关键的设计是将原本的 train/test 合并后按类别对半拆分——训练集只含 98 个类测试集含另外 98 个训练阶段完全没见过的类。这正是相似性学习区别于分类的杀手锏模型必须学会什么是相似的车型而不是死记类别标签。数据预处理逻辑集中在examples/cars/data.py的get_datasets()中最终通过GroupSimilarityDataLoader输出SimilarityGroupSample同一车型的图片共享同一个 group 标签供三元组损失使用。图片统一缩放到 336×336见 config.py并使用 ImageNet 的均值/方差做标准化以匹配预训练权重。四步搭建相似性模型编码器、Head、损失与缓存以图搜车模型的核心配置集中在examples/cars/models.py只需实现四个configure_*方法第一步ResNet152 特征提取编码器配置方法用 ImageNet 预训练的 ResNet152 作为骨干网络把最后的分类层替换为恒等映射输出 2048 维特征向量并设置trainable False冻结权重见 encoders.py。冻结编码器是精髓既避免了昂贵的重训练又让后续的缓存机制得以生效。第二步SkipConnectionHead 跳连 Head 层配置Head 层负责在特征之上做轻量适配此处选用SkipConnectionHead配合 0.1 的 dropout参数量少、抗过拟合特别适合小数据集微调。第三步TripletLoss 三元组损失配置方法相似性学习最经典的损失之一每个样本取一个锚点、一个同类正样本、一个异类负样本让锚点与正样本的距离 margin 锚点与负样本的距离。示例采用TripletLoss(mininghard, margin0.5)即只挖掘最难区分的样本对训练效率更高。第四步开启缓存加速配置这是 Quaterion 号称 warp-speed fast 的秘密武器既然编码器是冻结的那每轮 epoch 重复前向计算就是巨大浪费。配置CacheConfig后编码器输出只计算一次并缓存到指定设备CPU/GPU训练直接复用缓存结果官方实测即使在笔记本 GPU 上也能用超大 batch 跑上千 epoch。一键启动训练Quaterion.fit() 与模型保存训练入口在examples/cars/train.py所有模块组装好后只需一行调用Quaterion.fit( trainable_modelmodel, trainerNone, # 使用框架推荐的默认 Trainer 配置 train_dataloadertrain_dataloader, val_dataloaderval_dataloader, )Quaterion.fit()内部会自动完成数据加载器组装、缓存构建与完整训练循环实现见 main.py。训练结束后调用model.save_servable(save_dir)即可导出可部署的相似性模型供推理服务加载。用 Retrieval R-Precision 评估以图搜车效果模型练得好不好用examples/cars/evaluate.py中的评估流程说话通过Quaterion.evaluate()搭配Evaluator与GroupSampler计算检索任务的核心指标Retrieval R-PrecisionRRP——衡量搜索结果中相关图片的占比。从对比热力图可以直观看到原始 ResNet152 的 RRP 仅0.1207而经过 Quaterion 微调后的模型达到0.2540检索精度直接翻倍同时损失值从 1.37 降至 0.63模型收敛充分。这也验证了小数据 冻结编码器 轻量 Head 微调路线的有效性。上线部署生成嵌入向量并构建检索服务训练完成后的部署思路在examples/cars/serving.py中演示遍历测试集图片用训练好的SimilarityModel.encode()批量生成特征向量并保存为.npy文件同时落盘图片与标签清单。之后就能对全量车辆图库预先计算向量库查询时对输入图片提取向量在向量库中检索最近邻返回最相似的车型结果。总结Quaterion 让以图搜车系统开发不再是难题通过本教程你已完成一个完整的以图搜车系统闭环类别隔离的数据集划分 → 冻结 ResNet152 编码器 跳连 Head TripletLoss 的模型配置 → 缓存加速训练 → RRP 指标评估 → 向量化部署。整个过程核心代码不过百行靠的正是 Quaterion 对相似性学习流程的高度抽象。如果你想把同样的思路迁移到商品检索、人脸识别、以文搜图等场景只需替换数据集与编码器即可。想深入了解缓存机制与更多损失函数可以继续翻阅 docs/source/tutorials 下的进阶教程祝你早日搭出自己的检索神器【免费下载链接】quaterionBlazing fast framework for fine-tuning similarity learning models项目地址: https://gitcode.com/gh_mirrors/qu/quaterion创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考