褚宏光
95d13b2cce
- Added `--show-details` parameter to `pipeline_converging_triangle.py` for generating detailed charts that display all pivot points and fitting lines. - Implemented an iterative outlier removal algorithm in `fit_pivot_line` to improve the accuracy of pivot point fitting by eliminating weak points. - Updated `USAGE.md` to include new command examples for the detailed mode. - Revised multiple documentation files to reflect recent changes and improvements in the pivot detection and visualization processes.
383 lines
10 KiB
Markdown
383 lines
10 KiB
Markdown
# 项目文档索引
|
||
|
||
本文档提供项目所有文档的分类索引，方便快速查找相关资料。
|
||
|
||
**最后更新**: 2026-01-26
|
||
|
||
---
|
||
|
||
## 📚 快速导航
|
||
|
||
- [新手入门](#新手入门) - 从这里开始
|
||
- [核心算法](#核心算法) - 深入理解算法原理
|
||
- [使用指南](#使用指南) - 配置和使用
|
||
- [改进记录](#改进记录) - 功能改进历程
|
||
- [问题分析](#问题分析) - 问题诊断和解决方案
|
||
|
||
---
|
||
|
||
## 🎯 新手入门
|
||
|
||
从这里开始了解项目：
|
||
|
||
1. **[README.md](../README.md)** ⭐
|
||
- 项目概述
|
||
- 核心功能
|
||
- 快速开始
|
||
- 最新更新
|
||
|
||
2. **[USAGE.md](../USAGE.md)** ⭐
|
||
- 环境配置
|
||
- 运行脚本
|
||
- 参数调整
|
||
- 常见问题
|
||
|
||
3. **[收敛三角形检测系统-使用指南.md](./收敛三角形检测系统-使用指南.md)**
|
||
- 详细使用流程
|
||
- 参数说明
|
||
- 输出解读
|
||
|
||
---
|
||
|
||
## 🧮 核心算法
|
||
|
||
深入理解算法原理：
|
||
|
||
### 枢轴点检测
|
||
|
||
1. **[枢轴点检测原理.md](./枢轴点检测原理.md)** ⭐
|
||
- 什么是枢轴点
|
||
- k参数的含义
|
||
- 检测算法详解
|
||
|
||
2. **[枢轴点边界问题分析.md](./枢轴点边界问题分析.md)**
|
||
- 15天盲区问题
|
||
- 四种解决方案
|
||
- 方案对比分析
|
||
|
||
3. **[枢轴点分段选择算法详解.md](./枢轴点分段选择算法详解.md)** ⭐⭐⭐
|
||
- 为什么需要分段
|
||
- 分段算法完整说明
|
||
- 独立分段机制
|
||
- 实际案例分析
|
||
- **推荐阅读**：理解拟合算法的关键
|
||
|
||
### 三角形检测
|
||
|
||
4. **[方案4-混合策略详解.md](./方案4-混合策略详解.md)** ⭐
|
||
- 实时模式完整说明
|
||
- 确认枢轴 vs 候选枢轴
|
||
- 混合检测策略
|
||
|
||
5. **[突破强度计算方法.md](./突破强度计算方法.md)**
|
||
- 突破强度的定义
|
||
- 计算公式
|
||
- 评分系统
|
||
|
||
6. **[突破方向计算逻辑详解.md](./突破方向计算逻辑详解.md)** ⭐
|
||
- up / down / none 判定
|
||
- break_tol 容忍度
|
||
- 计算流程详解
|
||
- 常见问题解答
|
||
|
||
---
|
||
|
||
## 🛠️ 使用指南
|
||
|
||
配置和使用相关：
|
||
|
||
1. **[实时模式使用指南.md](./实时模式使用指南.md)** ⭐
|
||
- 实时模式 vs 标准模式
|
||
- 配置方法
|
||
- 使用建议
|
||
|
||
2. **[图表详细模式功能.md](./2026-01-26_图表详细模式功能.md)** 🎨
|
||
- 简洁模式 vs 详细模式
|
||
- 如何启用
|
||
- 图表元素说明
|
||
- 可视化解读
|
||
|
||
3. **[converging_triangles_outputs.md](./converging_triangles_outputs.md)**
|
||
- CSV输出字段说明
|
||
- 数据含义
|
||
- 筛选方法
|
||
|
||
---
|
||
|
||
## 📈 改进记录
|
||
|
||
功能改进历程：
|
||
|
||
### 2026-01-26 改进系列
|
||
|
||
1. **[2026-01-26_图表详细模式功能.md](./2026-01-26_图表详细模式功能.md)** 🎨
|
||
- 新增简洁/详细模式切换
|
||
- 图表可视化改进
|
||
- 使用场景说明
|
||
|
||
2. **[2026-01-26_枢轴点拟合改进.md](./2026-01-26_枢轴点拟合改进.md)** 📊
|
||
- 从2点拟合改进到多点拟合
|
||
- 分段选择策略
|
||
- 效果对比（19k → 6k）
|
||
|
||
3. **[2026-01-26_上沿线覆盖问题修复.md](./2026-01-26_上沿线覆盖问题修复.md)** 🔧
|
||
- 上沿线横穿高点问题
|
||
- 覆盖性验证机制
|
||
- 修复过程记录
|
||
|
||
4. **[2026-01-26_相向收敛约束改进.md](./2026-01-26_相向收敛约束改进.md)**
|
||
- 过滤通道形态
|
||
- 相向收敛检查
|
||
- 三角形类型识别
|
||
|
||
5. **[2026-01-26_完整改进总结.md](./2026-01-26_完整改进总结.md)**
|
||
- 当日所有改进汇总
|
||
- 改进时间线
|
||
- 整体效果评估
|
||
|
||
6. **[2026-01-26_项目清理总结.md](./2026-01-26_项目清理总结.md)**
|
||
- 删除测试文件记录
|
||
- 文档更新说明
|
||
- 项目结构整理
|
||
|
||
7. **[2026-01-26_枢轴点检测与可视化修复.md](./2026-01-26_枢轴点检测与可视化修复.md)** 🔧
|
||
- 斜率约束收紧
|
||
- NaN值处理修复
|
||
- 候选枢轴点合并
|
||
- 对称窗口逻辑优化
|
||
|
||
### 实时模式实施
|
||
|
||
7. **[方案4实施完成报告.md](./方案4实施完成报告.md)**
|
||
- 实施计划
|
||
- 实现细节
|
||
- 测试验证
|
||
- 使用建议
|
||
|
||
---
|
||
|
||
## 🔍 问题分析
|
||
|
||
问题诊断和解决方案：
|
||
|
||
1. **[枢轴点边界问题分析.md](./枢轴点边界问题分析.md)**
|
||
- **问题**：15天边界盲区
|
||
- **原因**：k参数窗口限制
|
||
- **方案**：四种解决方案对比
|
||
- **结论**：方案4混合策略
|
||
|
||
2. **[2026-01-26_上沿线覆盖问题修复.md](./2026-01-26_上沿线覆盖问题修复.md)**
|
||
- **问题**：上沿线横穿最高点
|
||
- **原因**：旧算法选点策略缺陷
|
||
- **修复**：覆盖性验证 + 全局极值保护
|
||
- **结果**：问题完全解决
|
||
|
||
3. **[2026-01-26_相向收敛约束改进.md](./2026-01-26_相向收敛约束改进.md)**
|
||
- **问题**：通道被误判为三角形
|
||
- **原因**：缺少相向收敛检查
|
||
- **修复**：增加斜率方向约束
|
||
- **结果**：有效过滤通道形态
|
||
|
||
4. **[FAQ_为什么某些低点不是枢轴点.md](./FAQ_为什么某些低点不是枢轴点.md)** ⭐
|
||
- **问题**：视觉明显的低点未被识别
|
||
- **原因**：枢轴点的严格数学定义
|
||
- **解答**：四种常见情况分析
|
||
- **验证**：如何查看和确认
|
||
|
||
---
|
||
|
||
## 📊 文档类型分类
|
||
|
||
### 概述类（Overview）
|
||
- README.md
|
||
- USAGE.md
|
||
|
||
### 教程类（Tutorial）
|
||
- 收敛三角形检测系统-使用指南.md
|
||
- 实时模式使用指南.md
|
||
|
||
### 原理类（Concept）
|
||
- 枢轴点检测原理.md
|
||
- 枢轴点分段选择算法详解.md ⭐⭐⭐
|
||
- 方案4-混合策略详解.md
|
||
- 突破强度计算方法.md
|
||
- 突破方向计算逻辑详解.md ⭐
|
||
|
||
### 参考类（Reference）
|
||
- converging_triangles_outputs.md
|
||
- 图表详细模式功能.md
|
||
|
||
### 分析类（Analysis）
|
||
- 枢轴点边界问题分析.md
|
||
- FAQ_为什么某些低点不是枢轴点.md ⭐
|
||
|
||
### 改进类（Improvement）
|
||
- 2026-01-26_图表详细模式功能.md
|
||
- 2026-01-26_枢轴点拟合改进.md
|
||
- 2026-01-26_上沿线覆盖问题修复.md
|
||
- 2026-01-26_相向收敛约束改进.md
|
||
|
||
### 总结类（Summary）
|
||
- 2026-01-26_完整改进总结.md
|
||
- 2026-01-26_项目清理总结.md
|
||
- 方案4实施完成报告.md
|
||
|
||
---
|
||
|
||
## 🎓 推荐阅读路径
|
||
|
||
### 路径1: 快速上手（新用户）
|
||
|
||
```
|
||
1. README.md （5分钟）
|
||
↓
|
||
2. USAGE.md （10分钟）
|
||
↓
|
||
3. 收敛三角形检测系统-使用指南.md （15分钟）
|
||
↓
|
||
4. 运行脚本，查看结果 （实践）
|
||
```
|
||
|
||
### 路径2: 理解算法（研究者）
|
||
|
||
```
|
||
1. 枢轴点检测原理.md （10分钟）
|
||
↓
|
||
2. 枢轴点分段选择算法详解.md ⭐ （30分钟）
|
||
↓
|
||
3. 方案4-混合策略详解.md （20分钟）
|
||
↓
|
||
4. 突破强度计算方法.md （10分钟）
|
||
```
|
||
|
||
### 路径3: 可视化理解（视觉学习者）
|
||
|
||
```
|
||
1. 运行脚本生成图表 （实践）
|
||
↓
|
||
2. plot_converging_triangles.py --show-details （详细模式）
|
||
↓
|
||
3. 图表详细模式功能.md （15分钟）
|
||
↓
|
||
4. 枢轴点分段选择算法详解.md （配合图表理解）
|
||
```
|
||
|
||
### 路径4: 深入调试（开发者）
|
||
|
||
```
|
||
1. 枢轴点边界问题分析.md （问题背景）
|
||
↓
|
||
2. 方案4实施完成报告.md （解决方案）
|
||
↓
|
||
3. 2026-01-26_上沿线覆盖问题修复.md （具体案例）
|
||
↓
|
||
4. 阅读源码 src/converging_triangle.py
|
||
```
|
||
|
||
---
|
||
|
||
## 🔑 关键概念索引
|
||
|
||
### A-Z
|
||
|
||
- **Breakout Strength (突破强度)** → 突破强度计算方法.md
|
||
- **Candidate Pivot (候选枢轴)** → 方案4-混合策略详解.md
|
||
- **Converging Triangle (收敛三角形)** → README.md
|
||
- **Coverage Validation (覆盖性验证)** → 2026-01-26_上沿线覆盖问题修复.md
|
||
- **Flexible Zone (灵活区域)** → 方案4-混合策略详解.md
|
||
- **Fractal Pivot (分形枢轴点)** → 枢轴点检测原理.md
|
||
- **Hybrid Strategy (混合策略)** → 方案4-混合策略详解.md
|
||
- **k Parameter (k参数)** → 枢轴点检测原理.md
|
||
- **Line Fitting (线性拟合)** → 枢轴点分段选择算法详解.md
|
||
- **Pivot Point (枢轴点)** → 枢轴点检测原理.md
|
||
- **Real-time Mode (实时模式)** → 实时模式使用指南.md
|
||
- **Segmentation (分段)** → 枢轴点分段选择算法详解.md
|
||
- **Slope Constraint (斜率约束)** → 2026-01-26_相向收敛约束改进.md
|
||
- **Standard Mode (标准模式)** → 实时模式使用指南.md
|
||
|
||
### 中文关键词
|
||
|
||
- **边界盲区** → 枢轴点边界问题分析.md
|
||
- **分段选择** → 枢轴点分段选择算法详解.md ⭐⭐⭐
|
||
- **候选枢轴点** → 方案4-混合策略详解.md
|
||
- **混合策略** → 方案4-混合策略详解.md
|
||
- **确认枢轴点** → 方案4-混合策略详解.md
|
||
- **实时模式** → 实时模式使用指南.md
|
||
- **枢轴点** → 枢轴点检测原理.md
|
||
- **突破强度** → 突破强度计算方法.md
|
||
- **相向收敛** → 2026-01-26_相向收敛约束改进.md
|
||
- **线性回归** → 枢轴点分段选择算法详解.md
|
||
|
||
---
|
||
|
||
## 📝 文档编写规范
|
||
|
||
### 文档命名
|
||
|
||
- **日期标记**：`YYYY-MM-DD_描述.md`（改进/修复类）
|
||
- **功能描述**：`功能名称.md`（原理/指南类）
|
||
- **特殊文档**：`README.md`, `USAGE.md`
|
||
|
||
### 文档结构
|
||
|
||
```markdown
|
||
# 标题
|
||
|
||
**日期**: YYYY-MM-DD
|
||
**类型**: [改进/原理/指南/分析]
|
||
|
||
---
|
||
|
||
## 目录（可选）
|
||
|
||
## 概述
|
||
|
||
## 详细内容
|
||
|
||
## 总结
|
||
|
||
## 相关文档（推荐添加）
|
||
```
|
||
|
||
### emoji 使用规范
|
||
|
||
- ⭐ - 重要文档/推荐阅读
|
||
- 🎨 - 可视化相关
|
||
- 🔧 - 修复类
|
||
- 📊 - 数据/统计相关
|
||
- 🎯 - 目标/要点
|
||
- ✅ - 完成/正确
|
||
- ❌ - 错误/不推荐
|
||
|
||
---
|
||
|
||
## 🔄 文档更新记录
|
||
|
||
### 2026-01-26
|
||
|
||
- ✅ 新增：枢轴点分段选择算法详解.md
|
||
- ✅ 新增：2026-01-26_图表详细模式功能.md
|
||
- ✅ 更新：README.md（添加最新改进）
|
||
- ✅ 更新：USAGE.md（添加详细模式说明）
|
||
- ✅ 更新：多个文档（添加交叉引用）
|
||
- ✅ 新增：本文档（文档索引）
|
||
|
||
### 更早记录
|
||
|
||
参见各文档的修改历史。
|
||
|
||
---
|
||
|
||
## 💡 建议
|
||
|
||
1. **新用户**：从 README.md 开始，按推荐路径1学习
|
||
2. **遇到问题**：查看"问题分析"部分的相关文档
|
||
3. **深入学习**：重点阅读标记 ⭐ 的文档
|
||
4. **实践为主**：边运行脚本边查阅文档，效果最好
|
||
|
||
---
|
||
|
||
**维护**: 请在添加新文档时更新本索引
|
||
**位置**: `docs/文档索引.md`
|
||
|