geodynamics/aspect

ASPECT Docker镜像技术文档

镜像概述和主要用途

ASPECT（Advanced Solver for Problems in Earth's ConvecTion）是一款并行、可扩展的有限元代码，主要用于模拟地球地幔及其他场景中的对流过程。该Docker镜像集成了ASPECT代码及其所有依赖项，基于官方Dockerfile构建，旨在提供便捷的部署环境，无需手动配置复杂的依赖关系，适用于快速开展地球动力学模拟研究。

核心功能和特性

• 地幔对流模拟：核心功能为模拟地球地幔对流过程，支持从基础模型到复杂场景的扩展
• 多场景适用性：扩展支持内核对流、岩石圈尺度变形、两相流等多种地球动力学应用
• 数值方法开发：可作为数值方法研究平台，支持新算法的验证与实现
• 2D/3D模型支持：支持二维和三维对流模型的模拟
• 并行计算能力：基于并行计算框架，可高效处理大规模问题
• 模块化设计：基于deal.II有限元库构建，具备良好的可扩展性，便于功能定制与扩展

使用场景和适用范围

• 地球动力学研究：模拟地幔对流、内核演化等地球内部动力学过程
• 岩石圈尺度分析：研究岩石圈变形机制及相关地质现象
• 两相流模拟：分析多相流体在地质介质中的流动特性
• 数值方法验证：验证新的有限元方法、并行算法在地球物理问题中的应用
• 科研与教学：地球物理、地质工程等领域的科研项目和教学实践

详细的使用方法和配置说明

镜像获取与构建

该镜像基于ASPECT官方GitHub仓库的Dockerfile构建，可通过以下方式获取或构建：

bash
# 克隆ASPECT源码仓库
git clone https://github.com/geodynamics/aspect.git

# 进入Dockerfile目录
cd aspect/contrib/docker/docker

# 构建镜像（标签可自定义，此处以"aspect"为例）
docker build -t aspect .

容器运行与数据挂载

使用docker run命令启动容器，建议挂载本地工作目录以实现数据持久化（输入配置文件和输出模拟结果）：

bash
docker run -it --rm -v /path/to/local/data:/data docker.xuanyuan.run/aspect

参数说明：

• -it：启用交互式终端，支持命令行操作
• --rm：容器退出后自动删除，避免残留临时文件
• -v /path/to/local/data:/data：将本地数据目录（需替换为实际路径）挂载到容器内/data目录，用于输入配置文件（如.prm）和输出模拟结果

执行模拟任务

在容器内，通过aspect命令执行模拟，需指定输入参数文件（通常为.prm格式）：

bash
# 在容器内运行模拟，使用挂载目录中的配置文件
aspect /data/input_parameters.prm

模拟结果（如输出文件、日志等）将保存至挂载的本地数据目录/path/to/local/data。

更多信息

• 官方网站：[***]
• GitHub仓库：https://github.com/geodynamics/aspect
• 在线手册：https://aspect-documentation.readthedocs.io/en/latest/
• 引用指南：[***]
• 用户论坛：[***]（ASPECT用户与开发者交流平台）
• deal.II支持：deal.II库相关问题可参考其讨论组：[***]
• CIG地幔对流邮件列表：[***]（一般性地幔对流问题讨论）

许可证

ASPECT发布于GPL v2或更新版本许可证下，详见https://github.com/geodynamics/aspect/blob/master/LICENSE。