TTClust 的安装和配置教程

项目基础介绍

TTClust 是一个用于分子动力学模拟轨迹聚类的 Python 程序。该程序通过输入轨迹文件和拓扑文件，能够兼容多种分子动力学软件包，如 Amber、Gromacs、Charmm、Namd 或 PDB 格式的轨迹，利用 MDtraj 包进行聚类分析。TTClust 易于使用，并能通过树状图提供聚类结果的视觉反馈。

主要编程语言

• Python

项目使用的关键技术和框架

• MDtraj：用于分子动力学的轨迹分析。
• Scipy：用于聚类分析的多种算法。
• Matplotlib：用于生成树状图和其他图形表示聚类结果。
• Argparse：用于处理命令行参数。

项目安装和配置的准备工作

在开始安装之前，请确保您的系统中已安装以下依赖：

• Python（建议使用 Python 3，因为 Python 2 已不再受支持）
• Conda（推荐使用 Conda 来管理 Python 环境和依赖）
• Git（用于克隆项目）

详细安装步骤

使用 Conda 进行安装

1. 如果您的系统中没有安装 Conda，请先安装 Miniconda：Miniconda 安装链接。

2. 打开命令行工具，使用以下命令安装 TTClust：

   conda install -c tubiana -c conda-forge ttclust
   

使用 PIP 进行安装

1. 首先安装 Numpy 和 Cython：

   pip install cython numpy
   

2. 然后安装 TTClust：

   pip install ttclust
   

   注意：使用 PIP 安装时可能会遇到编译 MDtraj 的问题，因此推荐使用 Conda。

从源代码安装

1. 克隆项目仓库：

   git clone https://github.com/tubiana/ttclust
   

2. 安装依赖项：

   • 使用 pip：

     sudo pip install -r requirements.txt
     

   • 使用 conda（推荐）：

     conda env create -f environment.yml
     conda activate ttclust
     

3. 使用以下命令运行 TTClust 脚本：

   python {PATH}/ttclust/ttclust.py
   

   或者如果你安装了 GUI 版本：

   python {PATH}/ttclust/ttclustGUI.py
   

请确保替换 {PATH} 为你克隆的 TTClust 项目的实际路径。

以上步骤将指导你完成 TTClust 的安装和配置。如果遇到任何问题，请参考项目的 README 文件或相关文档以获得更多帮助。