bev-project/project/docs/DOCS_INDEX.md

6.7 KiB
Raw Blame History

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