opensciencegrid/osgvo-psi4

osgvo-psi4 镜像文档

镜像概述

osgvo-psi4是专为开放科学网格(Open Science Grid, OSG)环境设计的Docker镜像，内置PSI4量子化学软件包，用于在分布式计算平台上执行量子化学相关作业。该镜像旨在简化科研人员在OSG上部署和运行PSI4计算任务的流程，提供预配置的运行环境。

核心功能与特性

• 内置PSI4软件：包含完整的PSI4量子化学计算套件，支持多种量子化学方法（如Hartree-Fock、MP2、DFT等）
• OSG环境适配：针对开放科学网格的作业调度和资源管理机制进行优化
• 预配置依赖：集成PSI4运行所需的科学计算库和系统依赖，无需额外安装
• 轻量级设计：在保证功能完整性的前提下，优化镜像体积，提升在分布式环境中的传输效率

使用场景与适用范围

• 学术研究中的量子化学计算任务（分子电子结构、能量计算、反应路径分析等）
• 需要在开放科学网格上进行大规模并行计算的科研项目
• 对计算资源有较高需求的量子化学模拟场景

使用方法与配置说明

基本运行方式

通过以下命令可在本地或OSG节点上运行该镜像：

bash
docker run --rm -v /path/to/local/data:/data docker.xuanyuan.run/osgvo-psi4 psi4 /data/input_file.in

参数说明：

• -v /path/to/local/data:/data：将本地数据目录挂载到容器内的/data目录，用于输入文件和输出结果的交互
• psi4 /data/input_file.in：执行PSI4计算，指定输入文件路径

OSG作业提交示例

在OSG环境中，可通过以下作业描述文件（.submit）提交任务：

executable = run_psi4.sh
arguments = input_file.in
output = job.out
error = job.err
log = job.log
transfer_input_files = input_file.in
requirements = OSGVO_OS_STRING == "RHEL 7" && HAS_DOCKER == True
request_cpus = 4
request_memory = 8GB
request_disk = 10GB
queue

其中run_psi4.sh脚本内容：

bash
#!/bin/bash
docker run --rm -v ${PWD}:/data docker.xuanyuan.run/osgvo-psi4 psi4 /data/$1

注意事项

• 确保输入文件格式符合PSI4规范
• 根据计算任务需求调整CPU、内存等资源请求
• 输出文件将保存在挂载的数据目录中，需确保有足够的磁盘空间

环境变量

目前该镜像未定义额外环境变量，PSI4的配置可通过输入文件或运行时参数进行调整。