gridlabd/grip

镜像概述

该镜像为GRIP项目容器，是SLAC国家加速器实验室基于GridLAB-D的开发分支构建，用于提供GridLAB-D的运行与开发环境。GridLAB-D是一款电力系统仿真工具，本镜像支持用户快速部署并使用GridLAB-D进行电力系统建模与分析，同时为开发者提供构建和调试环境。

核心功能

1. 提供GridLAB-D命令行运行环境，支持加载本地仿真模型文件
2. 支持Docker挂载本地目录，方便用户使用本地模型
3. 提供开发者构建GridLAB-D的脚本和配置选项，支持系统级/用户级安装
4. 支持调试模式配置，便于开发者排查代码问题
5. 提供版本验证和引用生成功能，确保仿真结果可追溯

使用场景

• 普通用户：快速运行GridLAB-D仿真模型，无需本地安装复杂依赖
• 开发者：进行GridLAB-D代码开发、调试、构建及贡献
• 研究人员：使用特定版本GridLAB-D开展电力系统仿真研究，并生成可引用版本信息

配置说明

用户快速启动

1. 安装Docker后，运行GridLAB-D命令：

bash
host% docker run -it -v $PWD:/model gridlabd/slac-master gridlabd -W /model [加载选项] [filename.glm] [运行选项]

2. 设置别名简化命令：

bash
host% alias gridlabd='docker run -it -v $PWD:/model gridlabd/slac-master gridlabd -W /model'

注意：此别名会与本地安装的GridLAB-D冲突。

开发者快速启动

Linux/Mac OS X系统

1. 克隆仓库并系统级安装：

bash
host% git clone https://github.com/dchassin/gridlabd gridlabd
host% gridlabd/install.sh

2. 用户级安装步骤：

bash
host% git clone https://github.com/dchassin/gridlabd -b _branch-name_ _work-folder_
host% cd _work-folder_
host% autoreconf -isf
host% ./configure --enable-silent-rules --prefix=$PWD/install [_options_]
host% make -j install
host% export PATH=$PWD/install/bin:$PATH
host% gridlabd --version
host% gridlabd --validate

常用配置选项

• --with-mysql=/usr/local：启用MySQL支持（需先安装mysql-dev）
• CXXFLAGS='-w -O0 -g'：启用C++代码调试模式
• CFLAGS='-w -O0 -g'：启用C代码调试模式

注意事项

• 版本号应包含分支名称，若未包含，用which gridlabd检查路径
• 使用--docker选项可控制运行Docker镜像而非本地安装
• 主分支验证测试理论上应全部通过，若遇错误请查看issue或报告（需提供--origin输出、validate.txt及uname -a结果）

引用格式

发表时需引用，通过以下命令获取：

bash
host% gridlabd --cite

示例引用：
Chassin, D.P., et al. "GridLAB-D 4.2.0-*** (fix_python_validate) DARWIN", (2019) [online]. Available at https://github.com/dchassin/gridlabd/commit/dfc39..., Accessed on: Oct.8,2019.

贡献指南

参考https://github.com/dchassin/gridlabd/blob/master/CONTRIBUTING.md%E4%BA%86%E8%A7%A3%E8%B4%A1%E7%8C%AE%E6%96%B9%E5%BC%8F%E3%80%82