chuhg/technical-patterns-lab
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
technical-patterns-lab/docs/文档索引.md
褚宏光 95d13b2cce Enhance converging triangle analysis with detailed mode and outlier removal algorithm 
- 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.
2026-01-26 18:43:18 +08:00

10 KiB
Raw Permalink Blame History

项目文档索引

本文档提供项目所有文档的分类索引，方便快速查找相关资料。

最后更新: 2026-01-26

📚 快速导航

🎯 新手入门

从这里开始了解项目：

  1. README.md ⭐

    • 项目概述
    • 核心功能
    • 快速开始
    • 最新更新

  2. USAGE.md ⭐

    • 环境配置
    • 运行脚本
    • 参数调整
    • 常见问题

  3. 收敛三角形检测系统-使用指南.md

    • 详细使用流程
    • 参数说明
    • 输出解读

🧮 核心算法

深入理解算法原理：

枢轴点检测

  1. 枢轴点检测原理.md ⭐

    • 什么是枢轴点
    • k参数的含义
    • 检测算法详解

  2. 枢轴点边界问题分析.md

    • 15天盲区问题
    • 四种解决方案
    • 方案对比分析

  3. 枢轴点分段选择算法详解.md ⭐⭐⭐

    • 为什么需要分段
    • 分段算法完整说明
    • 独立分段机制
    • 实际案例分析
    • 推荐阅读：理解拟合算法的关键

三角形检测

  1. 方案4-混合策略详解.md ⭐

    • 实时模式完整说明
    • 确认枢轴 vs 候选枢轴
    • 混合检测策略

  2. 突破强度计算方法.md

    • 突破强度的定义
    • 计算公式
    • 评分系统

  3. 突破方向计算逻辑详解.md ⭐

    • up / down / none 判定
    • break_tol 容忍度
    • 计算流程详解
    • 常见问题解答

🛠️ 使用指南

配置和使用相关：

  1. 实时模式使用指南.md ⭐

    • 实时模式 vs 标准模式
    • 配置方法
    • 使用建议

  2. 图表详细模式功能.md 🎨

    • 简洁模式 vs 详细模式
    • 如何启用
    • 图表元素说明
    • 可视化解读

  3. converging_triangles_outputs.md

    • CSV输出字段说明
    • 数据含义
    • 筛选方法

📈 改进记录

功能改进历程：

2026-01-26 改进系列

  1. 2026-01-26_图表详细模式功能.md 🎨

    • 新增简洁/详细模式切换
    • 图表可视化改进
    • 使用场景说明

  2. 2026-01-26_枢轴点拟合改进.md 📊

    • 从2点拟合改进到多点拟合
    • 分段选择策略
    • 效果对比（19k → 6k）

  3. 2026-01-26_上沿线覆盖问题修复.md 🔧

    • 上沿线横穿高点问题
    • 覆盖性验证机制
    • 修复过程记录

  4. 2026-01-26_相向收敛约束改进.md

    • 过滤通道形态
    • 相向收敛检查
    • 三角形类型识别

  5. 2026-01-26_完整改进总结.md

    • 当日所有改进汇总
    • 改进时间线
    • 整体效果评估

  6. 2026-01-26_项目清理总结.md

    • 删除测试文件记录
    • 文档更新说明
    • 项目结构整理

  7. 2026-01-26_枢轴点检测与可视化修复.md 🔧

    • 斜率约束收紧
    • NaN值处理修复
    • 候选枢轴点合并
    • 对称窗口逻辑优化

实时模式实施

  1. 方案4实施完成报告.md
    • 实施计划
    • 实现细节
    • 测试验证
    • 使用建议

🔍 问题分析

问题诊断和解决方案：

  1. 枢轴点边界问题分析.md

    • 问题：15天边界盲区
    • 原因：k参数窗口限制
    • 方案：四种解决方案对比
    • 结论：方案4混合策略

  2. 2026-01-26_上沿线覆盖问题修复.md

    • 问题：上沿线横穿最高点
    • 原因：旧算法选点策略缺陷
    • 修复：覆盖性验证 + 全局极值保护
    • 结果：问题完全解决

  3. 2026-01-26_相向收敛约束改进.md

    • 问题：通道被误判为三角形
    • 原因：缺少相向收敛检查
    • 修复：增加斜率方向约束
    • 结果：有效过滤通道形态

  4. 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

文档结构

# 标题

**日期**: 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