openbcl/fds

FDS Docker镜像文档

镜像概述与主要用途

该镜像由OpenBCL维护（GitHub仓库：https://github.com/openbcl/fds-dockerfiles%EF%BC%89%EF%BC%8C%E6%8F%90%E4%BE%9B%E7%BE%8E%E5%9B%BD%E5%9B%BD%E5%AE%B6%E6%A0%87%E5%87%86%E4%B8%8E%E6%8A%80%E6%9C%AF%E7%A0%94%E7%A9%B6%E9%99%A2(NIST)%E7%9A%84FDS%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%E3%80%82%E9%95%9C%E5%83%8F%E5%9F%BA%E4%BA%8EUbuntu%E7%B3%BB%E7%BB%9F%E6%9E%84%E5%BB%BA%EF%BC%8C%E4%B8%8D%E5%8C%85%E5%90%ABSmokeview%EF%BC%8C%E7%94%A8%E6%88%B7%E9%9C%80%E8%87%AA%E8%A1%8C%E4%BB%8ENIST%E7%BD%91%E7%AB%99%E4%B8%8B%E8%BD%BD%E5%B9%B6%E5%AE%89%E8%A3%85Smokeview%E5%88%B0%E4%B8%BB%E6%9C%BA%E7%B3%BB%E7%BB%9F%E3%80%82%E4%BD%BF%E7%94%A8%E6%9C%AC%E9%95%9C%E5%83%8F%E7%9A%84%E9%A3%8E%E9%99%A9%E7%94%B1%E7%94%A8%E6%88%B7%E8%87%AA%E8%A1%8C%E6%89%BF%E6%8B%85%E3%80%82

核心功能与特性

• 提供多版本FDS二进制文件，支持通过标签指定具体版本（如5.5.3、6.9.0等）
• 容器化运行FDS，确保跨平台环境一致性
• 支持MPI并行计算（部分版本）
• 支持OpenMP多线程（部分版本，需手动配置）
• 兼容Linux系统，部分版本支持WSL 2(Windows)和Hyperkit(Mac OS)

使用场景与适用范围

适用于需要在容器环境中运行FDS模拟的用户，尤其适合：

• 需要在不同系统（Linux、Windows WSL 2、Mac OS Hyperkit）中一致运行FDS的场景
• 需测试或使用特定版本FDS的模拟任务
• 希望通过容器隔离FDS运行环境的用户

使用方法与配置说明

如何使用该镜像

测试运行

如需测试最新版本FDS（不执行实际模拟），运行以下命令：

bash
docker run --rm openbcl/fds fds

指定版本运行

如需运行特定版本FDS（如6.9.0），需在镜像名后添加对应标签：

bash
docker run --rm openbcl/fds:6.9.0 fds

支持的标签

不指定标签时，默认拉取latest版本。如需其他版本，可添加版本标签（如5.5.3、6.5.3等）。

✅ 正常运行
☑️ 运行时有警告，不影响FDS功能
❌ 不兼容

非交互模式运行（推荐）

为使FDS访问容器内的模拟文件，需将本地文件系统中的文件夹共享给容器。在终端/Shell中导航至包含.fds输入文件的模拟文件夹，根据主机操作系统和Shell类型运行以下命令（Windows仅支持本地磁盘挂载，不支持网络驱动器）：

Linux/Mac OS

bash
docker run --rm -v $(pwd):/workdir openbcl/fds fds <文件名>.fds

Windows PowerShell

bash
docker run --rm -v ${pwd}:/workdir openbcl/fds fds <文件名>.fds

Windows命令提示符

bash
docker run --rm -v %cd%:/workdir openbcl/fds fds <文件名>.fds

支持MPI运行

FDS支持MPI并行计算，以下为Linux主机的示例命令：

• FDS 6.2.0及更高版本：

bash
docker run --rm -v $(pwd):/workdir openbcl/fds mpiexec -n <网格数> fds <文件名>.fds

• FDS 5.5.3版本：

bash
docker run --rm -v $(pwd):/workdir openbcl/fds lamboot mpirun -np <网格数> fds_mpi <文件名>.fds

交互模式运行

如需在交互式Shell中运行FDS，根据主机操作系统运行以下命令：

Linux/Mac OS

bash
docker run --rm -it -v $(pwd):/workdir openbcl/fds

Windows PowerShell

bash
docker run --rm -it -v ${pwd}:/workdir openbcl/fds

Windows命令提示符

bash
docker run --rm -it -v %cd%:/workdir openbcl/fds

连接到容器的交互式Shell后，可按常规方式启动FDS：

• 非MPI模式：

bash
fds <文件名>.fds

• FDS 6.2.0及更高版本（MPI模式）：

bash
mpiexec -n <网格数> fds <文件名>.fds

• FDS 5.5.3（MPI模式）：

bash
lamboot mpirun -np <网格数> fds_mpi <文件名>.fds

模拟完成后，输入exit命令关闭容器。

附加信息

OpenMP：OMP_NUM_THREADS

FDS通常会设置系统环境变量OMP_NUM_THREADS（默认值为处理器核心数的一半），但本镜像未在编译时设置该变量。FDS默认使用主机的处理器核心数，用户可通过添加-e OMP_NUM_THREADS=<数量>来自定义。与MPI一起运行时，建议设置-e OMP_NUM_THREADS=1以禁用OpenMP。FDS 6.7.8及更高版本、5.5.3版本默认禁用OpenMP。

对于FDS 6.7.8及更高版本，如需使用OpenMP，需将命令中的fds替换为fds_openmp。

已知错误与解决方案

KILLED BY SIGNAL: 7：使用mpiexec时的错误

若出现以下错误，需增加共享内存：

bash
=========================================================
=   BAD TERMINATION OF ONE OF YOUR APPLICATION PROCESSES
=   RANK 0 PID 9 RUNNING AT bfc9e9b610a2
=   KILLED BY SIGNAL: 7 (Bus error)
=========================================================

解决方法：在docker run命令中添加--shm-size=384M（将默认64MB共享内存增加至384MB，可根据模拟需求调整更高值）。

LINUX：发生段错误

Linux主机若出现以下错误https://github.com/firemodels/fds/issues/6265%EF%BC%8C%E9%9C%80%E8%AE%BE%E7%BD%AEulimit stack为无限制：

bash
forrtl: severe (174): SIGSEGV, segmentation fault occurred

解决方法：在docker run命令中添加--ulimit stack=-1。

免责声明

本Docker镜像非NIST官方提供，为第三方镜像。我们不提供任何形式的担保，包括但不限于适销性、特定用途适用性、非侵权性和数据准确性的默示担保。我们不保证软件运行不会中断或无错误，也不保证任何缺陷会被纠正。对于软件的使用或其结果，包括但不限于正确性、准确性、可靠性或实用性，我们不提供任何陈述或保证。

本镜像不应用于任何可能因故障导致人身伤害或财产损失的场景。