gridlabd/slac-develop

HiPAS GridLAB-D开发版镜像

镜像概述

HiPAS GridLAB-D是SLAC国家加速器实验室为加州能源委员会开发的商业级GridLAB-D版本，基于美国能源部太平洋西北国家实验室（PNNL）的GridLAB-D研究版本，与多个CEC（加州能源委员会）和DOE（美国能源部）项目协作开发，包括GLOW、OpenFIDO、PowerNET等。该镜像提供开发版环境，支持能源系统模拟相关的开发与测试。

核心功能

• 能源系统模拟：支持电力系统等能源领域的建模与仿真
• 多项目协作：与多个能源相关项目协同开发，代码可迁移回研究版本
• 版本管理：通过gridlabd version命令管理系统中活跃的版本
• 调试工具：支持gridlabd trace、gdb（Linux）、lldb（Mac OSX）等调试功能
• 验证功能：通过gridlabd --validate验证构建版本的正确性

使用场景

• 普通用户：通过Docker快速运行GridLAB-D进行能源模拟
• 开发者：基于源码编译、调试和二次开发GridLAB-D
• 能源项目团队：参与CEC/DOE相关能源项目的协作开发

配置说明

用户快速启动

1. 安装Docker（参考https://www.docker.com/get-started）
2. 运行Docker命令启动镜像：

bash
docker run -it -v $PWD:/model docker.xuanyuan.run/slacgismo/gridlabd:latest gridlabd -W /model [加载选项] [filename.glm] [运行选项]

3. 设置别名简化命令（避免与本地安装冲突）：

bash
alias gridlabd='docker run -it -v $PWD:/tmp slacgismo/gridlabd:latest gridlabd'

开发者快速启动

源码克隆与安装

bash
git clone https://github.com/slacgismo/gridlabd gridlabd
cd gridlabd && ./install.sh

重新构建与安装

bash
make system # 或并行构建：make -j$(nproc) system

调试版本配置

bash
make reconfigure-debug

版本管理

使用gridlabd version命令管理活跃版本，详情参考版本管理文档。

注意事项

• 版本号应包含分支名称，若不包含可通过which gridlabd检查路径是否正确
• 可通过--docker选项控制是否使用Docker镜像运行
• 构建后建议使用gridlabd --validate验证版本正确性
• 贡献代码请参考https://github.com/slacgismo/gridlabd/blob/master/CONTRIBUTING.md