ijknabla/openmodelica

精简版OpenModelica镜像文档

镜像概述

本镜像为精简版OpenModelica部署方案，包含OpenModelica核心组件及其他辅助软件。设计目标是提供轻量级、高效的多域物理系统建模与仿真环境，适用于开发、测试及生产环境的快速部署。镜像基于精简操作系统构建，优化了体积与性能，同时保留OpenModelica核心功能及常用辅助工具。

核心功能与特性

OpenModelica核心功能

• 支持多域物理系统建模（机械、电气、热力学等）
• 内置仿真引擎，支持多种数值求解算法
• 模型代码生成功能，可导出C/C++等语言代码
• 兼容Modelica标准库（Modelica Standard Library）

精简设计特性

• 优化镜像体积，减少冗余组件，提升启动速度
• 基于轻量级基础镜像（如Alpine或Debian Slim）构建
• 最小化运行时依赖，降低资源占用

辅助软件集成

• 包含常用模型验证工具，支持模型语法检查与完整性验证
• 集成基础数据处理工具，便于仿真结果分析与导出
• 提供命令行交互环境，支持脚本化建模与自动化仿真

使用场景与适用范围

学术研究

• 多域物理系统建模教学与实验
• 控制算法验证与原型开发
• 学术论文中的仿真结果复现

工程开发

• 工业系统多域建模与性能仿真
• 产品设计阶段的虚拟测试
• 跨团队协作中的模型共享与一致性验证

自动化流程

• 集成至CI/CD pipeline，实现模型自动化构建与测试
• 批量仿真任务处理
• 云端建模与仿真服务部署

资源受限环境

• 边缘计算节点的轻量级建模应用
• 低配置设备上的离线仿真

使用方法与配置说明

基础使用

交互式运行

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

bash
docker run -it --rm docker.xuanyuan.run/minimal-openmodelica:latest /bin/bash

直接运行OpenModelica编译器

启动OpenModelica编译器（omc）执行模型文件：

bash
docker run -it --rm -v $(pwd)/models:/models docker.xuanyuan.run/minimal-openmodelica:latest omc /models/your_model.mo

• -v $(pwd)/models:/models：挂载本地模型目录至容器内/models路径
• your_model.mo：本地Modelica模型文件

后台运行仿真任务

提交后台仿真任务并将结果输出至本地目录：

bash
docker run -d --name openmodelica-sim \
  -v $(pwd)/models:/models \
  -v $(pwd)/results:/results \
  docker.xuanyuan.run/minimal-openmodelica:latest \
  sh -c "omc /models/your_model.mo > /results/simulation.log"

环境变量配置

示例：自定义工作目录与日志级别

bash
docker run -it --rm \
  -e WORKDIR=/custom_workspace \
  -e LOG_LEVEL=DEBUG \
  docker.xuanyuan.run/minimal-openmodelica:latest

扩展配置

安装额外依赖

如需添加自定义依赖，可通过Dockerfile基于本镜像扩展：

dockerfile
FROM docker.xuanyuan.run/minimal-openmodelica:latest
RUN apt-get update && apt-get install -y <additional-package>

持久化存储

使用命名卷持久化模型与仿真结果：

bash
# 创建命名卷
docker volume create modelica_models
docker volume create modelica_results

# 使用命名卷运行容器
docker run -it --rm \
  -v modelica_models:/models \
  -v modelica_results:/results \
  docker.xuanyuan.run/minimal-openmodelica:latest

注意事项

• 镜像仅包含OpenModelica核心组件及基础辅助工具，如需完整GUI环境，需额外配置图形界面转发（如-e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix）
• 大模型仿真建议分配足够内存，可通过--memory参数限制或调整容器资源
• 模型文件需确保符合Modelica语法标准，可通过omc --check-syntax your_model.mo提前验证