nanozoo/hdbscan

hdbscan Docker镜像文档

镜像概述

本镜像基于GitHub项目https://github.com/lmcinnes/hdbscan%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9Bv0.8.23%E7%89%88%E6%9C%AC%E7%9A%84HDBSCAN%EF%BC%88Hierarchical Density-Based Spatial Clustering of Applications with Noise）聚类算法。HDBSCAN是一种高效的密度基聚类算法，能够处理复杂数据分布并识别任意形状的聚类。

基本信息

• 维护者：Martin
• 许可证：3-Clause BSD
• 版本：hdbscan v0.8.23
• 文档链接：Dockerwiki

核心功能与特性

• 层次密度聚类：结合层次聚类与密度基聚类优势，可识别不同密度的聚类结构
• 噪声点识别：能自动区分聚类点与噪声点，提高聚类结果准确性
• 高效处理：针对大规模数据集优化，支持高维数据聚类分析
• 灵活参数：提供多种可调参数（如最小聚类大小、距离度量等）以适应不同数据场景

使用场景与适用范围

• 机器学习：作为数据预处理步骤，用于特征空间聚类分析
• 数据挖掘：探索复杂数据集的内在结构与分布模式
• 学术研究：聚类算法相关的实验与验证
• 工程应用：需要无监督学习进行数据分组的场景（如用户分群、异常检测等）

使用方法与配置说明

基本使用

假设镜像已包含Python环境及hdbscan库，可通过以下方式运行容器并使用hdbscan：

bash
docker run -it --rm [镜像名称] python

在Python交互环境中导入并使用hdbscan：

python
import hdbscan
from docker.xuanyuan.run/sklearn.datasets import make_blobs

# 生成示例数据
data, _ = make_blobs(n_samples=1000, centers=5, random_state=42)

# 执行HDBSCAN聚类
clusterer = hdbscan.HDBSCAN(min_cluster_size=5)
clusters = clusterer.fit_predict(data)

# 查看聚类结果
print("聚类标签:", clusters)
print("噪声点数量:", sum(clusters == -1))

高级配置

可通过挂载本地数据目录或脚本，实现批量数据处理：

bash
docker run -it --rm -v /本地数据目录:/data [镜像名称] python /data/your_script.py

其中your_script.py为包含hdbscan聚类逻辑的自定义脚本。

参数说明

hdbscan主要参数（详细配置可参考https://hdbscan.readthedocs.io/%EF%BC%89%EF%BC%9A

• min_cluster_size：最小聚类大小，默认5
• min_samples：核心点最小样本数，默认None（使用min_cluster_size）
• metric：距离度量方式，可选"euclidean"、"manhattan"等
• cluster_selection_method：聚类选择策略，可选"eom"（默认）或"leaf"

注意事项

• 确保宿主机与容器之间的数据挂载路径正确
• 大规模数据处理时建议分配足够的内存资源
• 如需特定依赖版本，可基于此镜像构建自定义Dockerfile扩展配置