This Not That (TNT) 项目安装指南

项目简介

This Not That (TNT) 是一个基于 Panel 库构建的数据可视化工具，专注于数据地图的探索和分析。它为用户提供了一种直观的方式来交互式地探索高维数据，特别适合数据科学家和研究人员使用。

系统要求

在安装 TNT 之前，请确保您的系统满足以下基本要求：

• Python 3.7 或更高版本
• 稳定的互联网连接（用于下载依赖包）
• 足够的磁盘空间（建议至少 500MB 可用空间）

核心依赖

TNT 的核心功能依赖于以下 Python 包：

1. Panel 库：作为 TNT 的基础框架，Panel 提供了交互式仪表板的构建能力

   • 包含 Bokeh（用于交互式可视化）
   • 包含 Param（用于参数管理）

2. 数据处理与分析：

   • NumPy (>=1.22)：基础数值计算
   • pandas：数据框操作
   • scikit-learn：机器学习工具

3. 降维与可视化：

   • umap-learn：UMAP 降维算法
   • numba：加速计算
   • pynndescent：近似最近邻搜索

4. 颜色处理：

   • matplotlib：基础绘图
   • colorcet：颜色映射
   • glasbey：离散颜色方案
   • cmocean：海洋学颜色主题

5. 聚类分析：

   • hdbscan：密度聚类算法

6. 文本处理：

   • vectorizers：文本向量化工具

可选依赖

为了获得更完整的功能体验，建议安装以下可选包：

1. 文本聚类标注：
   • apricot-select：子模块选择算法
   • networkx：图结构处理

安装方法

方法一：通过 PyPI 安装（推荐）

对于大多数用户，我们推荐使用 PyPI 进行安装，这是最简单的方法：

pip install thisnotthat

此命令会自动安装所有必需的依赖项。

方法二：从源代码安装（开发人员）

如果您需要最新版本或计划参与开发，可以从源代码安装：

pip install git+https://<repository-url>/thisnotthat

注意：源代码安装可能需要额外的构建工具，如 C 编译器。

安装验证

安装完成后，您可以通过以下方式验证安装是否成功：

import thisnotthat as tnt
print(tnt.__version__)

如果没有报错并显示版本号，则说明安装成功。

常见问题解答

1. 依赖冲突：

   • 如果遇到依赖冲突，建议使用虚拟环境
   • 可以使用 conda create -n tnt_env python=3.8 创建专用环境

2. 安装速度慢：

   • 考虑使用国内镜像源，如清华源或阿里云源
   • 添加 -i https://pypi.tuna.tsinghua.edu.cn/simple 参数

3. 缺少系统库：

   • 在 Linux 系统上可能需要安装 python3-dev 等开发包
   • Windows 用户可能需要安装 Microsoft Visual C++ 构建工具

后续步骤

成功安装后，您可以：

1. 浏览项目文档了解基本用法
2. 尝试运行示例代码熟悉功能
3. 探索数据地图可视化功能

希望本指南能帮助您顺利安装 This Not That 项目。如有任何安装问题，建议查阅详细的错误信息并检查依赖版本是否兼容。