KeplerMapper工作流完全解析fit_transform、map、visualize三大核心API详解【免费下载链接】kepler-mapperKepler Mapper: A flexible Python implementation of the Mapper algorithm.项目地址: https://gitcode.com/gh_mirrors/ke/kepler-mapperKeplerMapper 是一个基于 Python 实现的 TDA拓扑数据分析Mapper 算法可视化库能把高维数据降维成直观的交互式拓扑图。它的整个工作流只围绕三大核心 API 展开fit_transform负责投影、map负责构建拓扑网络、visualize负责生成交互式 HTML 可视化。本文带你逐一拆解这三个 API 的用法、关键参数与常见陷阱帮新手快速上手。一、KeplerMapper 是什么用拓扑图看懂高维数据Mapper 算法的思想可以概括为四步投影 → 覆盖 → 聚类 → 建图。投影Project用一个“镜头”函数把高维数据降到低维例如行均值、t-SNE 或 UMAP覆盖Cover用带重叠的区间/超立方体盖住投影值聚类Cluster把落在每个区间内的点做聚类每个簇成为一个节点建图Nerve两个节点共享成员由重叠产生时连一条边最终得到一张拓扑网络。相比 t-SNE/PCA 只看“点云”KeplerMapper 输出的是结构环形、分支、孤立簇等全局特征都能一眼看到。 关于 Mapper 算法的完整理论背景可以阅读项目内的 docs/theory.rst 文档。二、三步工作流总览fit_transform → map → visualize整个 KeplerMapper 工作流只需要三行代码就能跑通整体遵循 scikit-learn 风格API 定义位于kmapper/kmapper.py的KeplerMapper类中import kmapper as km import sklearn.cluster mapper km.KeplerMapper(verbose1) lens mapper.fit_transform(X, projection[0]) # 1. 投影降到一维“镜头” graph mapper.map(lens, XX, clusterersklearn.cluster.DBSCAN()) # 2. 映射构建拓扑网络 mapper.visualize(graph, path_htmlkeplermapper_output.html) # 3. 可视化生成交互式 HTML三步之间是严格的数据流关系fit_transform输出lens喂给map得到graph含 nodes/links/meta 的字典再喂给visualize得到 HTML 文件。下面逐个拆解。三、fit_transform把高维数据投到一维“镜头”上fit_transformkmapper/kmapper.py中定义的作用是拟合投影函数并变换数据输出一个低维数组lens供map使用。内置投影函数速查projection参数支持多种内置投影无需自己写函数投影名含义sum/mean/median/max/min按行做统计聚合默认sumstd行标准差dist_mean到所有点的平均距离l2norm行 L2 范数knn_distance_5到 5 个最近邻的距离之和n 可自定[0, 2]直接取第 0 维和第 2 维串联 scikit-learn 降维管道fit_transform相比project最大的优势是支持管道串联传入列表即可把多个投影按顺序执行例如TF-IDF → Isomap → UMAPlens mapper.fit_transform( X, projection[manifold.Isomap(n_components2), umap.UMAP(n_components2)], scaler[None, preprocessing.MinMaxScaler()], )每一步还可以独立配置scaler缩放器和distance_matrix距离矩阵支持euclidean、cosine等 20 余种度量非常适合文本、图像等需要多阶段降维的数据。四、mapMapper 算法核心构建拓扑网络map是整个算法的心脏它接收fit_transform的投影输出执行“覆盖 聚类 建边”返回一个包含nodes、links、meta的字典即单纯复形。核心参数如下参数作用常用取值lens低维投影数据fit_transform 的输出必传X原始数据聚类在它上面做避免投影损失可选默认用 lensclusterer聚类算法任意 scikit-learn 兼容实现默认DBSCAN也可用KMeans、HDBSCANcover覆盖方案区间数量与重叠比例km.Cover(n_cubes20, perc_overlap0.1)nerve建边规则km.GraphNerve(min_intersection3)precomputed是否传入预计算距离矩阵默认Falseremove_duplicate_nodes建边前是否去除完全重复的节点默认False三个调参口诀n_cubes越大节点越多、细节越丰富图也越“碎”perc_overlap越大跨区间的共享成员越多边越多图越连通min_intersection控制“多少共有成员才算一条边”是降噪的关键旋钮。覆盖逻辑实现在kmapper/cover.py建边逻辑在kmapper/nerve.py想深挖源码时可以直接看这两个模块。五、visualize一键生成交互式 HTML 拓扑图visualize把map输出的字典渲染成基于 D3.js 的交互式 HTML 文件默认文件名mapper_visualization_output.html节点大小默认按簇内成员数计算。几个最值得了解的参数color_valuescolor_function_name给每个数据点传一组颜色值节点颜色取组内聚合node_color_function默认mean。传多个颜色值组时页面会出现切换按钮一张图看多个维度custom_tooltips自定义鼠标悬停提示例如把标签、类别名显示在节点详情里include_searchbarTrue顶部加搜索栏支持 AND / OR / EXACT 三种匹配节点会随搜索结果实时变化include_min_intersection_selectorTrue页面上动态调节最小交集阈值实时重绘边。在 Jupyter Notebook 中还可以直接内嵌展示不用打开浏览器from kmapper import jupyter mapper.visualize(graph, path_htmloutput.html) jupyter.display(path_htmloutput.html)六、快速上手清单按下面这份清单10 分钟即可跑出自己的第一张拓扑图安装pip install kmapper依赖 Python ≥ 3.6、NumPy、scikit-learn准备数据任意二维以上的 numpy 数组或 DataFrame 都能用跑通三步fit_transform → map → visualize先用默认参数感受输出调参从n_cubes、perc_overlap、clusterer三个旋钮开始实验看示例仓库examples/目录提供了完整可运行的案例脚本推荐从入门级开始示例文件位置适合场景圆环数据examples/makecircles/make_circles_xaxis.py理解“环形结构如何被识别”乳腺癌分类examples/breast-cancer/breast-cancer.ipynb真实数据集 颜色编码手写数字examples/digits/plot_digits.py自定义 tooltips 与 Y 轴投影动物数据examples/lion/lion.py稀疏数据与参考可视化 更多参数细节可查阅kmapper/kmapper.py中各方法的完整 docstring以及 docs/index.rst 文档索引。总结KeplerMapper 的三大核心 API 各司其职fit_transform解决“看哪个角度”map解决“结构怎么连”visualize解决“如何交互探索”。掌握这条 投影 → 映射 → 可视化 的工作流后你只需在覆盖密度、聚类算法和颜色编码上做实验就能把复杂的高维数据变成一眼可懂的拓扑图 —— 这正是 TDA Mapper 算法最强大的地方。【免费下载链接】kepler-mapperKepler Mapper: A flexible Python implementation of the Mapper algorithm.项目地址: https://gitcode.com/gh_mirrors/ke/kepler-mapper创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考