gridsuite/cgmes-assembling-job

镜像概述

Cgmes Assembling Job镜像专为电力系统领域的CGMES（通用电网模型交换规范）数据处理设计，提供一站式的CGMES数据组装、转换与验证功能。该镜像基于轻量级Linux环境构建，集成了电力系统模型数据处理工具链，可快速部署并执行CGMES数据相关作业，助力电力系统数据管理流程自动化。

核心功能与特性

1. CGMES数据组装

• 支持多源CGMES数据文件（如XML格式的网络模型、拓扑数据、设备参数等）的批量整合
• 提供灵活的组装规则配置，可自定义数据关联逻辑与合并策略
• 兼容CGMES V2.4、V3.0等主流版本规范

2. 数据格式转换

• 支持CGMES数据与其他电力系统数据格式（如DIgSILENT、PSSE等仿真软件格式）的双向转换
• 内置数据清洗机制，自动处理重复、冲突或不完整数据

3. 数据验证与合规性检查

• 基于CGMES规范自动校验数据完整性、语法正确性及逻辑一致性
• 生成详细的验证报告，包含错误定位与修复建议
• 支持自定义校验规则扩展

4. 高效处理能力

• 采用多线程处理架构，支持大型CGMES数据集（GB级）快速处理
• 轻量级镜像设计，启动时间短，资源占用低

使用场景与适用范围

适用用户

• 电力系统规划与运行人员
• 电力系统仿真工程师
• 电力数据分析与研究人员
• 电力信息化系统开发与维护团队

典型场景

• 电力系统模型管理：整合分散的CGMES模型数据，构建统一的系统模型库
• 仿真前数据准备：对原始CGMES数据进行转换与验证，确保满足仿真工具输入要求
• 跨平台数据交换：在不同电力系统软件（如PSCAD、DIgSILENT、PSS/E）间实现CGMES数据标准化传递
• 数据质量监控：定期对CGMES数据集进行合规性检查，保障数据可靠性

使用方法与配置说明

基本使用（Docker Run）

1. 简单数据组装任务

bash
docker run --rm \
  -v /本地输入目录:/app/input \    # 挂载本地输入目录（存放待组装的CGMES文件）
  -v /本地输出目录:/app/output \  # 挂载本地输出目录（存放组装结果）
  cgmes-assembling-job:latest \    # 镜像名称及标签
  assemble \                       # 核心命令（执行组装任务）
  --input /app/input \             # 指定容器内输入路径
  --output /app/output \           # 指定容器内输出路径
  --version 2.4.15                 # 指定CGMES版本（可选，默认2.4.15）

2. 带数据验证的转换任务

bash
docker run --rm \
  -v /本地输入目录:/app/input \
  -v /本地输出目录:/app/output \
  -v /本地配置目录:/app/config \  # 挂载配置目录（存放自定义校验规则文件）
  -e LOG_LEVEL=DEBUG \             # 设置日志级别（可选，默认INFO）
  cgmes-assembling-job:latest \
  convert \                        # 核心命令（执行转换任务）
  --input /app/input \
  --output /app/output \
  --target-format psse \           # 指定目标格式（如psse、digsilent等）
  --validate true \                # 启用数据验证（默认true）
  --config /app/config/rules.json  # 指定自定义校验规则文件（可选）

Docker Compose配置示例

yaml
version: '3'
services:
  cgmes-job:
    image: cgmes-assembling-job:latest
    volumes:
      - ./local-input:/app/input
      - ./local-output:/app/output
      - ./local-config:/app/config
    environment:
      - LOG_LEVEL=INFO
      - CGMES_DEFAULT_VERSION=3.0
      - OUTPUT_COMPRESS=true  # 启用输出文件压缩（默认false）
    command: assemble --input /app/input --output /app/output

环境变量说明

命令参数说明

注意事项

1. 数据持久化：建议通过-v参数挂载本地目录，避免容器内数据丢失
2. 权限问题：本地挂载目录需确保Docker用户有读写权限（可添加-u $(id -u):$(id -g)参数指定用户）
3. 版本兼容性：不同CGMES版本（如2.4与3.0）存在格式差异，建议明确指定--version参数
4. 资源配置：处理大型数据集时，可通过--memory和--cpus参数调整容器资源限制

bash
# 处理大型数据集时的资源配置示例
docker run --rm \
  --memory=8g \          # 限制内存使用为8GB
  --cpus=4 \             # 限制CPU核心数为4
  -v /本地输入:/app/input \
  -v /本地输出:/app/output \
  cgmes-assembling-job:latest assemble --input /app/input --output /app/output