mosdef/foyer

原子类型划分与力场应用工具镜像

镜像概述

本Docker镜像提供了一套用于原子类型划分（atom-typing）以及力场（forcefields）应用与传播的工具包，旨在为分子模拟、计算化学等领域的科研与开发工作提供便捷的环境支持，简化原子类型分配及力场参数应用流程。

核心功能与特性

• 原子类型划分：支持对分子系统中的原子进行自动分类与类型标记，为后续力场参数匹配奠定基础。
• 力场应用：提供力场参数的加载与应用功能，可将预设或自定义力场应用于分子系统，支持常见分子模拟场景。
• 力场传播：支持力场文件的标准化处理与分发，便于团队协作及跨平台使用。

使用场景与适用范围

• 科研领域：适用于计算化学、生物物理等领域的分子模拟研究，如蛋白质-配体相互作用、材料性质预测等。
• 教学场景：可作为分子模拟教学工具，帮助学生理解原子类型划分原理及力场应用方法。
• 药物研发：支持药物分子的力场参数构建，辅助药物设计中的分子动力学模拟。

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -v /本地数据目录:/data [镜像名称] [命令] [参数]

• -v /本地数据目录:/data：将本地数据目录挂载至容器内/data路径，用于输入分子文件及输出结果。
• [命令]：工具包支持的具体命令（如原子类型划分命令、力场应用命令等）。
• [参数]：根据具体命令需要传递的参数（如输入文件路径、力场类型等）。

示例：原子类型划分

假设需对/本地数据目录/molecule.pdb文件进行原子类型划分，输出至/本地数据目录/output：

bash
docker run -v /path/to/local/data:/data [镜像名称] atom-type --input /data/molecule.pdb --output /data/output

示例：力场应用

将指定力场应用于分子系统：

bash
docker run -v /path/to/local/data:/data [镜像名称] apply-forcefield --input /data/molecule.pdb --forcefield amber --output /data/parameterized_system

环境变量配置（可选）

• FORCEFIELD_PATH：自定义力场文件路径，默认为容器内预设力场目录。
• OUTPUT_FORMAT：设置输出文件格式（如pdb、mol2等），默认为pdb。

注意事项

• 确保本地数据目录具有读写权限，避免容器内文件操作失败。
• 使用前建议查阅工具包官方文档，了解支持的分子文件格式及力场类型。