agv-control-slam/docs/guides/CUSTOM_PATH_README.md

自定义路径功能 - 快速导航

📍 文档位置

所有自定义路径功能的文档已整理到：

docs/custom_path/

🚀 快速开始

1. 查看文档目录

cd docs/custom_path
cat README.md

2. 推荐阅读顺序

新手入门（5分钟）：

docs/custom_path/FINAL_SUMMARY.md          # 功能总览 ⭐
docs/custom_path/QUICKSTART_CUSTOM_PATH.md # 快速上手

QT界面集成（10分钟）：

docs/custom_path/apply_qt_modifications.md      # 修改步骤 ⭐
docs/custom_path/qt_gui_custom_code_snippet.cpp # 代码示例

深入学习（30分钟）：

docs/custom_path/CUSTOM_PATH_GUIDE.md     # 完整教程

📦 核心功能

1. CSV文件加载 - 从外部文件加载任意路径
2. 样条插值 - 从关键点生成平滑曲线
3. 路径保存 - 导出路径为CSV格式
4. QT界面集成 - 图形化操作

🔧 安装

自动安装（推荐）

bash docs/custom_path/install_custom_path.sh

手动安装

参考文档：docs/custom_path/CUSTOM_PATH_GUIDE.md

📖 完整文档列表

访问 docs/custom_path/README.md 查看所有文档的详细说明。

📁 文件结构

agv_path_tracking/
├── src/
│   └── path_curve_custom.cpp       # 核心实现
├── include/
│   └── path_curve.h                # 需要添加方法声明
├── examples/
│   ├── custom_path.csv             # 示例路径
│   └── warehouse_path.csv          # 仓库路径
├── docs/
│   └── custom_path/                # 📚 所有文档在这里！
│       ├── README.md               # 文档导航
│       ├── FINAL_SUMMARY.md        # 功能总览 ⭐
│       ├── QUICKSTART_CUSTOM_PATH.md
│       ├── CUSTOM_PATH_GUIDE.md
│       ├── apply_qt_modifications.md ⭐
│       ├── QT_GUI_CUSTOM_PATH_GUIDE.md
│       ├── qt_gui_custom_code_snippet.cpp
│       ├── install_custom_path.sh
│       ├── path_curve.h.patch
│       └── CUSTOM_PATH_IMPLEMENTATION_SUMMARY.txt
└── CUSTOM_PATH_README.md           # 本文件（快速导航）

✨ 快速示例

// 1. 加载自定义路径
PathCurve path;
path.loadFromCSV("examples/custom_path.csv");

// 2. 使用路径
PathTracker tracker(agv);
tracker.setReferencePath(path);
tracker.generateControlSequence("pure_pursuit", 0.1, 20.0);

🎯 使用场景

场景	查看文档
快速试用	docs/custom_path/QUICKSTART_CUSTOM_PATH.md
QT界面	docs/custom_path/apply_qt_modifications.md
深入学习	docs/custom_path/CUSTOM_PATH_GUIDE.md
安装配置	docs/custom_path/install_custom_path.sh
完整总览	docs/custom_path/FINAL_SUMMARY.md ⭐

---

开始使用: cd docs/custom_path && cat README.md