.OpenIPSL.UsersGuide.ReleaseNotes.v310

Version 3.1.0 (2026-02-25)

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

docs: Fix typo by @tbeu in #312
docs: Adding publications from AMConf 2022 by @lvanfretti in #321
docs: Update CITATION.cff by @lvanfretti in #330
docs: Document RampTrackingFilter, PSS2A and PSS2B model implementation details by @lvanfretti in #374
doc: Enhance README with tutorial links for OpenIPSL by @lvanfretti in #389
doc: Update Release Notes by @lvanfretti in #381

⚡ 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

@gkhalley made their first contribution in #313
@hubertus65 made their first contribution in #265
@ceraolo made their first contribution in #336
@fachif made their first contribution in #327
@GiuseppeLaera made their first contribution in #347
@adrpo made their first contribution in #354
@maltelenz made their first contribution in #369
@beutlich made their first contribution in #382

Full Changelog

v3.0.1...v3.1.0

Generated at 2026-04-14T18:18:34Z by OpenModelicaOpenModelica 1.26.3 using GenerateDoc.mos