259 lines
6.7 KiB
Markdown
259 lines
6.7 KiB
Markdown
# BEVFusion 项目文档索引
|
||
|
||
**更新时间**：2025-10-22 09:25 UTC（北京时间 17:25）
|
||
**文档数量**：20个核心文档
|
||
**总大小**：约300 KB
|
||
|
||
---
|
||
|
||
## 📚 文档导航
|
||
|
||
### 🎯 核心文档（必读）
|
||
|
||
#### 1. 项目概述
|
||
- **README.md** (13KB)
|
||
- 项目官方文档
|
||
- 安装和快速开始
|
||
- 官方性能基准
|
||
|
||
- **PROJECT_MASTER_PLAN.md** (16KB) ⭐ 最重要
|
||
- 项目总体规划
|
||
- 6大阶段详细计划
|
||
- 时间表和里程碑
|
||
- 当前进度追踪
|
||
|
||
#### 2. 当前状态
|
||
- **TRAINING_PROGRESS_UPDATE_20251021.md** (11KB) ⭐ 最新
|
||
- 训练最新进展（10-21更新）
|
||
- Epoch 1完成情况
|
||
- Loss收敛分析
|
||
- GPU使用状态
|
||
|
||
- **PHASE5_RESTART_WORKERS0.md** (2KB) ⭐ 当前配置
|
||
- 当前训练配置
|
||
- workers=0的原因
|
||
- 6 GPU配置
|
||
|
||
#### 3. 技术架构
|
||
- **BEVFUSION_ARCHITECTURE.md** (16KB)
|
||
- 完整架构说明
|
||
- 模型组件详解
|
||
- 调用关系图
|
||
- 核心算子说明
|
||
|
||
- **BEVFUSION_VERSIONS_COMPARISON.md** (16KB)
|
||
- MIT版本 vs ADLab版本
|
||
- 技术差异对比
|
||
- 适用场景分析
|
||
|
||
---
|
||
|
||
### 🔬 技术分析
|
||
|
||
#### 分割任务分析
|
||
- **SEGMENTATION_DIMENSIONS_ANALYSIS.md** (18KB)
|
||
- 输入输出尺寸详解
|
||
- 数据流分析
|
||
- 分辨率配置
|
||
|
||
- **SEGMENTATION_HEAD_ARCHITECTURE_COMPARISON.md** (19KB)
|
||
- 原始分割头 vs 增强版
|
||
- 架构对比详解
|
||
- 性能差异分析
|
||
|
||
#### 训练分析
|
||
- **TRAINING_TIME_ANALYSIS.md** (8KB) ⭐ 重要
|
||
- 单epoch时间分解
|
||
- 性能瓶颈分析
|
||
- 优化建议
|
||
|
||
- **CHECKPOINT_MISMATCH_EXPLANATION.md** (10KB)
|
||
- 为什么从Epoch 1开始
|
||
- Checkpoint兼容性
|
||
- 权重复用策略
|
||
|
||
#### 预训练模型
|
||
- **PRETRAINED_MODELS_INFO.md** (3KB)
|
||
- 可用预训练模型列表
|
||
- 模型下载和使用
|
||
- 性能基准
|
||
|
||
---
|
||
|
||
### 📖 使用指南
|
||
|
||
#### 推理和可视化
|
||
- **INFERENCE_GUIDE.md** (8KB) ⭐ 推荐
|
||
- 模型推理完整流程
|
||
- 命令行使用
|
||
- 结果解析
|
||
|
||
- **VISUALIZATION_GUIDE.md** (4KB)
|
||
- 结果可视化方法
|
||
- 图像和视频生成
|
||
- 自定义可视化
|
||
|
||
#### 训练指南
|
||
- **MULTITASK_GUIDE.md** (15KB)
|
||
- 多任务训练详解
|
||
- 配置文件说明
|
||
- 双任务 vs 单任务
|
||
|
||
- **PROGRESSIVE_ENHANCEMENT_PLAN.md** (7KB)
|
||
- 渐进式增强策略
|
||
- 分阶段训练计划
|
||
- 性能提升路径
|
||
|
||
#### 高级应用
|
||
- **TRANSFER_LEARNING_GUIDE.md** (23KB)
|
||
- 迁移学习完整指南
|
||
- 从nuScenes迁移到自定义数据
|
||
- Checkpoint复用策略
|
||
|
||
- **CUSTOM_SENSOR_MIGRATION_GUIDE.md** (41KB)
|
||
- 自定义传感器配置
|
||
- 相机和LiDAR参数调整
|
||
- 坐标系转换
|
||
|
||
---
|
||
|
||
### 🚀 未来计划
|
||
|
||
#### MapTR集成
|
||
- **MAPTR_INTEGRATION_PLAN.md** (39KB)
|
||
- 三任务训练方案
|
||
- 矢量地图预测
|
||
- 代码实现细节
|
||
- 数据准备流程
|
||
|
||
#### Orin部署
|
||
- **ORIN_DEPLOYMENT_PLAN.md** (20KB)
|
||
- NVIDIA Orin 270T部署方案
|
||
- 模型剪枝和量化
|
||
- TensorRT优化
|
||
- 性能调优策略
|
||
|
||
---
|
||
|
||
## 📂 文档组织结构
|
||
|
||
```
|
||
/workspace/bevfusion/
|
||
│
|
||
├── 📘 项目核心 (6个)
|
||
│ ├── README.md 官方文档
|
||
│ ├── PROJECT_MASTER_PLAN.md ⭐ 总体规划
|
||
│ ├── BEVFUSION_ARCHITECTURE.md 架构文档
|
||
│ ├── BEVFUSION_VERSIONS_COMPARISON.md 版本对比
|
||
│ ├── TRAINING_PROGRESS_UPDATE_20251021.md ⭐ 最新进展
|
||
│ └── TRAINING_TIME_ANALYSIS.md 时间分析
|
||
│
|
||
├── 📗 技术分析 (4个)
|
||
│ ├── SEGMENTATION_DIMENSIONS_ANALYSIS.md 尺寸分析
|
||
│ ├── SEGMENTATION_HEAD_ARCHITECTURE_COMPARISON.md 分割头对比
|
||
│ ├── CHECKPOINT_MISMATCH_EXPLANATION.md Checkpoint说明
|
||
│ └── PRETRAINED_MODELS_INFO.md 预训练模型
|
||
│
|
||
├── 📙 使用指南 (6个)
|
||
│ ├── INFERENCE_GUIDE.md ⭐ 推理指南
|
||
│ ├── VISUALIZATION_GUIDE.md 可视化指南
|
||
│ ├── MULTITASK_GUIDE.md 多任务指南
|
||
│ ├── TRANSFER_LEARNING_GUIDE.md 迁移学习
|
||
│ ├── CUSTOM_SENSOR_MIGRATION_GUIDE.md 传感器迁移
|
||
│ └── PROGRESSIVE_ENHANCEMENT_PLAN.md 增强计划
|
||
│
|
||
├── 📕 未来计划 (2个)
|
||
│ ├── MAPTR_INTEGRATION_PLAN.md MapTR集成
|
||
│ └── ORIN_DEPLOYMENT_PLAN.md Orin部署
|
||
│
|
||
├── 📝 当前配置 (1个)
|
||
│ └── PHASE5_RESTART_WORKERS0.md ⭐ 当前训练
|
||
│
|
||
└── 📋 其他 (1个)
|
||
└── DOCS_CLEANUP_PLAN.md 清理记录
|
||
```
|
||
|
||
**总计：20个文档，组织清晰**
|
||
|
||
---
|
||
|
||
## 🔍 快速查找
|
||
|
||
### 我想了解...
|
||
|
||
**项目概况？**
|
||
→ README.md, PROJECT_MASTER_PLAN.md
|
||
|
||
**当前训练状态？**
|
||
→ TRAINING_PROGRESS_UPDATE_20251021.md, PHASE5_RESTART_WORKERS0.md
|
||
|
||
**如何使用模型推理？**
|
||
→ INFERENCE_GUIDE.md, VISUALIZATION_GUIDE.md
|
||
|
||
**如何训练多任务模型？**
|
||
→ MULTITASK_GUIDE.md, PROGRESSIVE_ENHANCEMENT_PLAN.md
|
||
|
||
**分割任务的技术细节？**
|
||
→ SEGMENTATION_HEAD_ARCHITECTURE_COMPARISON.md, SEGMENTATION_DIMENSIONS_ANALYSIS.md
|
||
|
||
**如何迁移到自己的数据？**
|
||
→ TRANSFER_LEARNING_GUIDE.md, CUSTOM_SENSOR_MIGRATION_GUIDE.md
|
||
|
||
**未来集成MapTR？**
|
||
→ MAPTR_INTEGRATION_PLAN.md
|
||
|
||
**部署到边缘设备？**
|
||
→ ORIN_DEPLOYMENT_PLAN.md
|
||
|
||
**训练为什么这么慢？**
|
||
→ TRAINING_TIME_ANALYSIS.md
|
||
|
||
**为什么从Epoch 1开始？**
|
||
→ CHECKPOINT_MISMATCH_EXPLANATION.md
|
||
|
||
---
|
||
|
||
## 📊 文档质量
|
||
|
||
| 类别 | 数量 | 平均大小 | 完整度 |
|
||
|------|------|---------|--------|
|
||
| 核心文档 | 6 | 14KB | ⭐⭐⭐⭐⭐ |
|
||
| 技术分析 | 4 | 13KB | ⭐⭐⭐⭐⭐ |
|
||
| 使用指南 | 6 | 16KB | ⭐⭐⭐⭐⭐ |
|
||
| 未来计划 | 2 | 30KB | ⭐⭐⭐⭐⭐ |
|
||
| 当前配置 | 1 | 2KB | ⭐⭐⭐⭐⭐ |
|
||
|
||
**评价**：文档完整、组织清晰、内容实用 ✅
|
||
|
||
---
|
||
|
||
## ⭐ 推荐阅读顺序
|
||
|
||
### 新手入门
|
||
1. README.md - 了解项目
|
||
2. BEVFUSION_ARCHITECTURE.md - 理解架构
|
||
3. MULTITASK_GUIDE.md - 多任务训练
|
||
4. INFERENCE_GUIDE.md - 推理使用
|
||
|
||
### 当前项目状态
|
||
1. PROJECT_MASTER_PLAN.md - 了解全局计划
|
||
2. TRAINING_PROGRESS_UPDATE_20251021.md - 查看最新进展
|
||
3. PHASE5_RESTART_WORKERS0.md - 当前配置
|
||
4. TRAINING_TIME_ANALYSIS.md - 时间分析
|
||
|
||
### 深入研究
|
||
1. SEGMENTATION_HEAD_ARCHITECTURE_COMPARISON.md - 分割头对比
|
||
2. CHECKPOINT_MISMATCH_EXPLANATION.md - Checkpoint机制
|
||
3. TRANSFER_LEARNING_GUIDE.md - 迁移学习
|
||
4. CUSTOM_SENSOR_MIGRATION_GUIDE.md - 自定义传感器
|
||
|
||
### 未来扩展
|
||
1. MAPTR_INTEGRATION_PLAN.md - MapTR集成
|
||
2. ORIN_DEPLOYMENT_PLAN.md - 边缘部署
|
||
|
||
---
|
||
|
||
**最后更新**：2025-10-22 09:25 UTC
|
||
**维护者**：BEVFusion Project Team
|
||
|