KeplerMapper交互式HTML可视化教程：颜色映射、搜索栏与节点冻结的8个技巧

KeplerMapper交互式HTML可视化教程颜色映射、搜索栏与节点冻结的8个技巧【免费下载链接】kepler-mapperKepler Mapper: A flexible Python implementation of the Mapper algorithm.项目地址: https://gitcode.com/gh_mirrors/ke/kepler-mapperKeplerMapper 是一款灵活开源的 Python 实现的 Mapper 算法工具能把高维数据降维成一张可交互的拓扑网络图。它的visualize方法生成的交互式 HTML 可视化是最大亮点节点颜色可切换、搜索栏可定位、节点可冻结保存。本教程用 8 个实用技巧带你快速上手颜色映射、搜索栏与节点冻结等核心交互功能。为什么需要交互式 HTML 可视化 传统的静态图只能看而 KeplerMapper 生成的 HTML 页面基于 D3.js可以 在多种颜色映射color scale之间一键切换 用搜索栏按标签放大、高亮匹配的节点❄️ 拖拽冻结节点位置甚至把布局保存成 JSON 文件与同事共享 点击节点查看直方图、聚类详情所有功能都由 kmapper/kmapper.py 中的visualize方法一个入口驱动完整功能清单可参考官方文档 docs/html-visualization-features.rst。技巧一一行代码生成交互式 HTML 地图 调用visualize时只要传入map输出的 graph并指定输出文件名就能得到一个完整的可视化页面html mapper.visualize(graph, path_htmlkepler-mapper-output.html, titleMy Data)参数说明摘自 kmapper/kmapper.py参数作用path_html输出 HTML 文件路径默认mapper_visualization_output.htmltitle页面左上角显示的标题save_file是否落盘保存默认 Truecolor_values节点配色数值详见技巧二custom_tooltips每个样本的提示文本搜索栏靠它工作在 Jupyter Notebook 里想直接内嵌预览可以配合 kmapper/jupyter.py 中的jupyter.display()。技巧二多套颜色映射下拉框随意切换 color_values决定了节点颜色每个样本一个数值按 min-max 缩放后映射到colorscale色阶。妙处在于——传入多套颜色值一个 1d 数组的列表页面顶部会自动出现下拉框随时切换当前激活的颜色映射。以乳腺癌数据集为例同时传入 Isolation Forest 和 L2 范数两个 lens并给它们命名mapper.visualize( graph, color_valueslens, color_function_name[Isolation Forest, L2-norm], custom_tooltipsy, )完整示例见 examples/plot_breast_cancer.py。右侧的Mapper Summary面板还会同步显示当前投影、聚类器、节点数等元信息。技巧三用节点颜色函数定义节点取什么色 ️样本颜色怎么汇总成节点颜色由node_color_function决定默认mean任何 NumPy 方法都能用。传入数组时同样生成下拉框node_color_function[mean, std, median, max]mean看节点整体水平std看节点内部数据的离散程度——标准差大的节点往往藏着异质性值得点开细看右侧面板中的 Node Distribution 热力图也会随函数切换而更新实现细节在 kmapper/visuals.py。技巧四搜索栏三剑客——AND / OR / EXACT 快速定位 想让搜索栏出现传include_searchbarTrue并给样本配上custom_tooltips。搜索基于小写的 tooltip 文本支持三种模式模式行为AND查询词全部命中才算匹配节点尺寸随匹配样本数放大OR命中任意一个词即匹配EXACTtooltip 与查询完全一致时节点发光glow输入空查询即可重置所有视觉变化。适合快速回答哪些簇里含有标签 X 的样本这类问题。技巧五动态调整最小交集实时重构网络 ⚙️KeplerMapper.map中的min_intersection决定两个节点之间是否连边。可视化页面内置了Min-Intersection Selector改一下数字JavaScript 会实时重算边无需重新运行 Python。开启方式include_min_intersection_selectorTrue。调大阈值 → 网络更稀疏、结构更清晰调小 → 连通性更强。这是探索数据拓扑结构时非常好用的即时反馈工具。技巧六冻结节点 保存布局为协作而生 ❄️节点默认在 d3-force 模拟下自由漂浮。交互规则很简单单击拖拽节点 → 节点被冻结停在你放的位置双击冻结的节点 → 解冻恢复自由页面支持保存节点坐标与冻结状态导出为.json配置文件下次打开 HTML 时重新加载布局原样还原点击拖拽 → 冻结 | 双击 → 解冻 | 保存/加载 → JSON 配置文件这意味着你可以把.html.json两个文件打包发给同事双方看到一模一样的布局——非常适合报告与评审场景。技巧七明暗双模式打印演示两不误 页面默认是深色背景适合屏幕浏览按键盘p切换到白色打印模式d切回深色。快捷键逻辑在 kmapper/static/kmapper.js。这套交互里还藏了几个实用快捷键按键功能f/x冻结全部 / 解冻全部节点s/c给选中节点添加 / 移除发光效果z关闭重力节点彻底失重m/e宽松 / 紧凑布局演示中常用f先把布局摆好再逐一微调。技巧八自定义提示词 直方图细节尽现 custom_tooltips为每个样本指定悬停显示的文本如样本标签、ID默认显示行号节点详情面板点击节点后显示该节点样本的颜色值分布直方图nbins控制分箱数默认 10传入X/X_names或lens/lens_names面板会额外计算并展示每个节点内原始数据各变量的统计量让你不打开原始 CSV 就能对比各簇特征配合技巧四的搜索栏就能做到悬停看细节 → 搜索找目标 → 冻结做标记的完整分析闭环。总结8 个技巧速查表 ✅#技巧关键参数 / 操作1一键生成交互式 HTMLvisualize(graph, path_html...)2多套颜色映射下拉切换color_valuescolor_function_name3节点颜色聚合函数node_color_function[mean,std,...]4搜索栏定位节点include_searchbarTruecustom_tooltips5动态调整连边阈值include_min_intersection_selectorTrue6冻结节点并保存布局拖拽冻结 / 双击解冻 / JSON 保存加载7明暗模式与快捷键p打印模式、d深色模式、f/x全冻结8提示词与直方图详情custom_tooltips、nbins、X/lens统计更多场景如 Jupyter 内嵌、Plotly 交互可在 docs/notebooks/ 的 Notebook 和 examples/ 目录中找到完整演示。用这 8 个技巧KeplerMapper 的拓扑网络将从一张图变成你的交互式数据探索工作台。【免费下载链接】kepler-mapperKepler Mapper: A flexible Python implementation of the Mapper algorithm.项目地址: https://gitcode.com/gh_mirrors/ke/kepler-mapper创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考