Yifan Hu（胡一凡）布局是Gephi里专为大规模/稀疏网络优化 的力导向算法，核心是用"超节点 "近似远距斥力，把复杂度从O(n²)降到O(n log n) ，能轻松跑几万---几十万节点，比ForceAtlas 2更快、更稳。
一、适用场景（什么时候选它）
- ✅ 节点≥10,000 ，尤其稀疏网络（边数≈节点数）
- ✅ 社交网络、引文网络、蛋白质交互、地理关联等
- ✅ 追求速度+全局结构清晰，不纠结极致紧凑
- ❌ 超密集网络（边极多）→优先ForceAtlas 2
- ❌ 强社区分层→可选Yifan Hu Multilevel
二、3种Yifan Hu布局怎么选
在Layout面板下拉找到3个变体：
| 布局 | 核心差异 | 最佳场景 |
|---|---|---|
| Yifan Hu（标准） | 固定最优距离，自动冷却 | 大多数大规模网络（默认首选） |
| Yifan Hu Proportional | 按节点度数缩放距离 | 节点度数差异大（核心节点更突出） |
| Yifan Hu Multilevel | 多层次聚类+逐级布局 | 超大规模（≥50万）、强社区结构 |
三、标准Yifan Hu参数详解（直接照抄）
右侧Layout→选Yifan Hu→点Properties，关键参数：
- Optimal Distance（最佳距离）
- 节点间理想间距；越大图越松散、尺寸越大
- 建议：20--100（1万节点≈50，10万节点≈80）
- Relative Strength（相对强度）
- 斥力/引力比例；越大越稀疏、越小越紧凑
- 建议：0.2--0.5（默认0.2，密集调0.1，稀疏调0.6）
- Theta（近似精度）
- 超节点近似阈值；越小越准、越慢
- 建议：0.5--1.0（默认0.8；追求质量0.4，速度1.2）
- Step Ratio（步长比例）
- 迭代步长；越高质量越好、越慢
- 建议：0.5--1.0（默认0.9；新手0.7，精调1.0）
- Initial Step Size（初始步长）
- 初始移动幅度；大→快收敛，小→稳
- 建议：0.5--2.0（默认2.0；节点密→1.0）
- Convergence Threshold（收敛阈值）
- 位移小于此值自动停止；越小越久、越稳
- 建议：1.0E-4--1.0E-6（默认1e-4；大规模1e-3）
四、实操步骤（5步跑通大规模数据）
1. 数据预处理（必做！）
- 节点数>5万：删孤立节点、过滤弱边（权重<阈值）
- 边表只留Source/Target/Weight，减少计算开销
- 内存建议：10万节点≥16GB，50万节点≥32GB
2. 选布局并设参数
- Overview→右侧Layout→下拉选Yifan Hu
- 点Properties，按上表设参数（新手直接用：Distance=50, Strength=0.2, Theta=0.8）
- 勾选Auto Stop（自动停止，避免死跑）
3. 运行布局
- 点Run；1万节点≈10--30秒，10万节点≈2--5分钟
- 进度条走动，节点逐渐散开；看到清晰结构就Stop（不必等100%）
- 中途卡慢：降低Theta/Step Ratio，或分阶段跑（先粗调再精调）
4. 结果优化（防重叠+清标签）
- 节点重叠：适度增大Optimal Distance 或降低Relative Strength
- 标签乱：先跑Label Adjust布局（1--2分钟），自动错开标签
5. 预览导出
- 切Preview→调节点大小/边透明度→Export高清PNG/PDF
五、对比ForceAtlas 2（怎么选）
- Yifan Hu ：快、稳、省内存；大规模/稀疏网络首选；结构清晰、边缘不挤
- ForceAtlas 2 ：紧凑、社区分明；中小规模/密集网络更好；慢、内存占用高
六、常见问题
- 跑不动/闪退：减节点数、关其他软件、增大JVM内存（Gephi.conf改-Xmx32G）
- 节点成团不散：增大Distance、提高Strength、降低Theta
- 结构不清晰：换Multilevel变体，或先社区检测（Modularity）再布局
七、一键参数模板（直接复制用）
- 通用（1--10万节点）：
- Optimal Distance: 50
- Relative Strength: 0.2
- Theta: 0.8
- Step Ratio: 0.9
- Initial Step Size: 2.0
- Convergence Threshold: 1e-4