openmodelica/openmodelica

OpenModelica Docker镜像文档

镜像概述

本Docker镜像为OpenModelica提供默认安装环境，基于指定分支版本构建，旨在快速部署一致的Modelica建模与仿真平台，消除环境配置差异，满足开箱即用需求。

核心功能与特性

• 默认完整安装：包含OpenModelica标准工具链，支持Modelica模型开发、编译、仿真全流程
• 分支版本锁定：基于指定分支版本构建，确保功能稳定性与版本一致性
• 零配置启动：无需手动安装依赖，容器启动后直接进入可用环境

适用场景

• 教育教学：快速搭建标准化OpenModelica教学环境，适用于Modelica课程实验
• 科研开发：为Modelica模型研究提供隔离、可复现的仿真环境
• 测试验证：用于Modelica模型跨环境兼容性测试和版本功能验证

使用方法

基本部署命令

通过以下命令拉取并启动镜像（替换branch-name为实际分支名称，如main或版本分支）：

bash
docker run -it --rm openmodelica/branch-name:latest

交互模式使用

容器启动后自动进入OpenModelica交互终端，可直接执行Modelica建模与仿真操作：

bash
# 示例：创建并仿真简单模型
OpenModelica CLI> model SimpleModel
OpenModelica CLI>   parameter Real a = 1.0;
OpenModelica CLI>   Real x;
OpenModelica CLI> equation
OpenModelica CLI>   x = a * time;
OpenModelica CLI> end SimpleModel;
OpenModelica CLI> simulate(SimpleModel, stopTime=10);

注意事项

• 镜像标签中的branch-name需与OpenModelica代码仓库实际分支对应
• 如需持久化模型文件，可通过-v参数挂载本地目录：

  bash
  docker run -it --rm -v /本地模型目录:/models openmodelica/branch-name:latest
  

• 容器默认以非root用户运行，确保挂载目录权限正确