本文详解如何将开源电力系统仿真库 powsybl 集成至 anylogic：包括从源码构建可部署的单体 jar 包、在 anylogic 中正确导入与配置，以及调用核心潮流计算功能的完整流程。
PowSyBl 是一个功能完备、符合 IEC 61970/61968 标准的 Java 基础电力系统建模与分析框架，支持潮流计算（Load Flow）、状态估计、短路分析等核心功能。虽然 AnyLogic 原生不提供电力系统专用库，但其完全兼容标准 Java 生态，因此可通过引入外部 Java 库实现深度扩展。关键挑战在于：PowSyBl 官方未发布预编译的“开箱即用”JAR，而是以 Maven 多模块项目形式托管于 GitHub，需手动构建并优化依赖结构。
✅ 步骤一：构建精简、可嵌入的单体 JAR
推荐基于 powsybl-starter 项目（轻量级启动模板）进行构建，它已预置核心依赖（如 powsybl-core, powsybl-loadflow-api, powsybl-loadflow-simulation）。执行以下操作：
-
克隆 starter 仓库并切换到稳定版本（如 v4.5.0）：
git clone https://github.com/powsybl/powsybl-starter.git cd powsybl-starter git checkout v4.5.0
-
修改 pom.xml，添加 maven-shade-plugin 实现依赖打包（避免 AnyLogic 加载 100+ JAR 的性能与路径问题）：
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-shade-plugin</artifactId> <version>3.4.1</version> <executions> <execution> <phase>package</phase> <goals><goal>shade</goal></goals> <configuration> <transformers> <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"> <mainClass>org.powsybl.starter.Starter</mainClass> </transformer> </transformers> <filters> <filter> <artifact>*:*</artifact> <excludes> <exclude>META-INF/*.SF</exclude> <exclude>META-INF/*.DSA</exclude> <exclude>META-INF/*.RSA</exclude> </excludes> </filter> </filters> </configuration> </execution> </executions> </plugin> -
构建单体 JAR（含所有运行时依赖）：
mvn clean package -DskipTests # 输出路径：target/powsybl-starter-4.5.0-jar-with-dependencies.jar
✅ 步骤二：在 AnyLogic 中导入与验证
打开 AnyLogic 模型 → File > Preferences > Libraries → 点击 Add，选择上一步生成的 -jar-with-dependencies.jar；
-
在模型代码中（如 Main agent 的 on startup 字段），添加测试代码验证加载成功：
try { // 创建空网络并运行潮流 Network network = Network.create("test-grid", "test"); VoltageLevel vl = network.getSubstation("S1").newVoltageLevel() .setId("VL1").setNominalV(220.0).setTopologyKind(TopologyKind.BUS_BREAKER).add(); vl.getBusBreakerView().newBus().setId("B1").add(); vl.getBusBreakerView().newBus().setId("B2").add(); LoadFlowResult result = LoadFlow.run(network); traceln("Power flow completed: " + result.isOk()); } catch (Exception e) { traceln("PowSyBl init failed: " + e.getMessage()); e.printStackTrace(); }⚠️ 注意事项： AnyLogic 默认使用 Java 11，而 PowSyBl ≥ v4.x 要求 Java 11+，请确认 AnyLogic 版本 ≥ 8.8.0 并启用对应 JDK； 若出现 NoClassDefFoundError，检查是否遗漏 slf4j 或 logback 相关类——maven-shade-plugin 已自动包含，无需额外添加； 大型网络建议在 on startup 中异步初始化网络对象，避免拖慢模型启动。
✅ 步骤三：扩展应用（进阶提示）
- 使用 NetworkXml.write() / NetworkXml.read() 加载 .xiidm 格式标准电网模型；
- 结合 AnyLogic 的 Agent 和 Event 框架，动态修改发电机出力、线路状态，触发实时潮流重算；
- 将计算结果（如电压幅值、支路功率）映射为 AnyLogic 参数或图表数据源，实现可视化联动。
通过以上流程，您即可在 AnyLogic 中无缝调用 PowSyBl 进行专业级电网仿真，突破平台原生能力限制，构建高保真能源系统数字孪生模型。
