classv310

Version 3.1.0 (2026-02-25)

Extends from Modelica.Icons.ReleaseNotes (Icon for release notes in documentation).

Information

This release version 3.1.0 of OpenIPSL is led by an Industrial-Grade Model Expansion. The release significantly expands the availability of new models and examples, with broad additions across synchronous machine dynamics, governors, excitation and stabilizer systems, and WECC-type renewable energy source models (Wind, PV and BESS), while also improving compatibility and quality checks.

Highlights

Primary highlight: Industrial-Grade Model Expansion:

  • Industrial-Grade Model Expansion: substantial additions and hardening of production-ready dynamic models and associated examples.
  • Comprehensive model catalog growth: expanded synchronous machine, governor, excitation systems, and WECC renewable models for large-scale stability studies.
  • WECC renewables energy source models (RES): WECC generic renewable models, including REGC, REEC, and REPC components for Wind/PV/BESS integration studies. Pre-defined templates with hierarchical modeling for BESS, PV and Wind.
  • Expanded Microgrid and Voltage Source Models: new and updated IEEE/University Campus microgrid examples and voltage-behind-impedance source variants.
  • Generic Variable Speed Drive Model: new model for variable speed drive systems with their power electronics and controller modules.
  • Model quality and robustness improvements: targeted updates to key dynamic models and release checks.
  • New Addition to Tutorial Examples: new example showing the integration of power flow records from GridCal/VeraGrid.
New component additions:

Key additions highlighted for this release include:

  • New machine models: CIM5, CIM6, GENTPJ.
  • Renewable Energy (WECC generic models): Renewable Energy Generator/Converter (REGC) models REGC_A; Renewable Energy Electric Controller (REEC) models REEC_A, REEC_B, and REEC_C; Renewable Energy Plant Controller (REPC) models REPC_A.
  • Governing systems (thermal, gas, and hydro): DEGOV, IEEEG2, WEHGOV, WPIDHY, and WSIEG1.
  • Excitation systems and compensators: AC7B, AC8B, DC4B, ESDC1A, ESDC2A, ESURRY, EXBAS, EXNI, SCRX, and IEEEVC.

Changes in detail

🚀 Features
  • feat: Update HYGOV.mo by @lvanfretti in #309
  • feat: Adding New Test Models for PSAT Solar PV by @lvanfretti in #322
  • feat: Ideal Voltage Source by @lvanfretti in #320
  • feat: Ideal Current Source Model by @lvanfretti in #319
  • feat: Add advanced Example 4 (which uses GridCal) to tutorials by @maguilerac in #324
  • feat: Graphical enhancements of line model and IEEE14 example by @ceraolo in #336
  • feat: Adding Data package containing typical data sets of powerplant components. by @maguilerac in #329
  • feat: WECC-Based Renewable Models by @fachif in #327
  • feat: Updates to the PV all-in-one model by @fachif in #345
  • feat: New Voltage Behind Impedance Models for the implementation of GFC by @lvanfretti in #349
  • feat: Adding input option to voltage source behind an impedance model by @lvanfretti in #352
  • feat: Updated Tutorial - Example 4 by @maguilerac in #351
  • feat: New PSSE models (COMP, ES, TG, UEL, Machines) by @GiuseppeLaera in #347
  • feat: Adding PowerFactory implementation of distributed solar PVD1 by @tinrabuzin in #267
  • feat: New IEEE Microgrid and new components by @fachif in #343
  • feat: University Campus Microgrid by @fachif in #341
  • feat: Added Experiment Annotations and Modified ULTC Example by @lvanfretti in #376
🐛 Bug Fixes
  • fix: 'abs' function not properly converted to MSL 4.0.0 by @dietmarw in #302
  • fix: Remove cyclical dependency on function input by @dietmarw in #333
  • fix: remove bogus libraries AC7B and DC4B from the uses annotation by @adrpo in #354
  • fix: Fixes the variability of function variables by @dietmarw in #356
  • fix: Update Reals IEE2ST, REECA1, REECB1, REECCU1, and REPCA1 by @gkhalley in #366
  • fix: Typo on PV and Wind Template Parameters by @lvanfretti in #385
📚 Documentation
⚡ Performance Improvements
  • perf: Avoid equality on Real variables in SE Non-electrical function by @gkhalley in #313
  • perf: Avoid equality on Real variables by @tbeu in #310
  • perf: Invalid == on Reals NegCurLogic by @gkhalley in #326
  • perf: Invalid == on Reals IEEEST by @gkhalley in #325
  • perf: Changes to ULTC and correct syntax fixes for OCT by @hubertus65 in #265
  • perf: Division by zero protection block and function added by @lvanfretti in #348
  • perf: Parameter evaluation for simpler initial equation systems by @maltelenz in #369
  • perf: Adding "--daeMode", "DAEsolver=true" and related changes by @lvanfretti in #375
♻️ Code Refactoring
  • refactor: Converts internal variable to connector by @dietmarw in #332
🔨 Build System & CI
  • ci: Fix regex to optionally ignore quoted strings when checking for deprecated Text.lineColor annotation by @tbeu in #339
  • ci: Enable deprecation checks in CI by @beutlich in #382
🔧 Chores & Maintenance
  • chore: Replaces deprecated lineColor with textColor by @dietmarw in #380
New Contributors
Full Changelog

v3.0.1...v3.1.0