Firedrake基础容器镜像文档

镜像概述和主要用途

Firedrake是一个使用有限元方法（FEM）实现偏微分方程（PDE）可移植求解的自动化系统。本镜像为仅安装Firedrake核心组件的基础容器，旨在提供精简、纯净的运行环境，主要用于测试依赖Firedrake的下游软件包。

核心功能和特性

• 精简环境：仅包含Firedrake核心组件，无额外冗余依赖，镜像体积小
• PDE求解能力：支持通过有限元方法求解各类偏微分方程
• 离散化兼容性：兼容多种离散化技术，适应不同PDE场景需求
• CPU优化：针对CPU架构优化，可实现高性能数值计算

使用场景和适用范围

• 下游软件包开发测试：验证依赖Firedrake的应用程序功能正确性
• 兼容性验证：测试下游软件与Firedrake版本的兼容性
• 基础计算任务：在资源受限环境中运行轻量级有限元计算任务

使用方法和配置说明

基本使用（docker run）

通过以下命令启动容器并进入交互式终端：

docker run -it firedrake/bare-bones

挂载本地文件测试

如需使用本地测试文件，可通过-v参数挂载主机目录：

# 将当前目录挂载到容器内/workspace目录
docker run -it -v $(pwd):/workspace firedrake/bare-bones

进入容器后，可切换至/workspace目录访问本地文件：

cd /workspace
# 运行下游软件包测试命令（示例）
pytest test_downstream_package.py

容器内Firedrake验证

进入容器后，可通过以下命令验证Firedrake安装：

# 检查Firedrake版本
firedrake-status
# 运行简单示例（如查看IR生成）
firedrake-ir --help

注意事项

• 本镜像不含图形界面及高级可视化工具，仅提供基础计算环境
• 下游软件包测试需自行安装对应依赖（可通过容器内pip命令）
• 如需GPU支持或高级功能，需使用Firedrake完整版本镜像