How gridsuite/network-modification works
GridSuite Network Modification is a Java library for applying structural, operational, and topological changes to PowSyBl electrical networks. A caller supplies a typed modification request; the library represents it as a DTO, builds an executable modification, applies it to the network, and can report changes or validation errors. The README documents these responsibilities and the broader capabilities; the excerpts show DTO-to-modification conversion, assignment execution, and network mutation details for transformers and operational limits. Other implementation branches are represented at subsystem level because their source was not sampled.
Main entry points: ModificationInfos.java Modification DTOs · AbstractModification.java Modification base · modifications Equipment changes · byfilter Filter and formula
Components 16
Requests and context
- Modification DTOs
src/main/java/org/gridsuite/modification/dto/ModificationInfos.java - Modification context
src/main/java/org/gridsuite/modification/context - Assignment data
src/main/java/org/gridsuite/modification/modifications/data/assignment/AbstractAssignmentData.java
Modification execution
- Modification base
src/main/java/org/gridsuite/modification/modifications/AbstractModification.java - Equipment changes
src/main/java/org/gridsuite/modification/modifications - Topology changes
src/main/java/org/gridsuite/modification/modifications - Operational limits
src/main/java/org/gridsuite/modification/modifications/olg/OperationalLimitsGroupModification.java - Filter and formula
src/main/java/org/gridsuite/modification/modifications/byfilter - Tabular changes
src/main/java/org/gridsuite/modification/modifications/tabular
Shared support
- Modification utilities
src/main/java/org/gridsuite/modification/utils/ModificationUtils.java - Modification errors
src/main/java/org/gridsuite/modification/error/NetworkModificationException.java - Filter service
src/main/java/org/gridsuite/modification/IFilterService.java - Load-flow service
src/main/java/org/gridsuite/modification/ILoadFlowService.java
Network and reporting
- PowSyBl network
- Change reports
src/main/java/org/gridsuite/modification/report/NetworkModificationReportResourceBundle.java
Other components
- Library caller
Connections 19
- Library caller → Modification DTOs: provides request
README.md - Modification DTOs → Modification base: builds executable
src/main/java/org/gridsuite/modification/dto/ModificationInfos.java - Modification base → Equipment changes: specializes into
src/main/java/org/gridsuite/modification/modifications/AbstractModification.java - Modification DTOs → Modification context: resolves dependencies
src/main/java/org/gridsuite/modification/dto/ModificationInfos.java - Modification base → PowSyBl network: applies changes
README.md - Equipment changes → PowSyBl network: mutates network
README.md - Topology changes → PowSyBl network: mutates topology
README.md - Operational limits → PowSyBl network: updates limits
src/main/java/org/gridsuite/modification/modifications/olg/OperationalLimitsGroupModification.java - Filter and formula → PowSyBl network: applies assignments
src/main/java/org/gridsuite/modification/modifications/byfilter/AbstractModificationByAssignment.java - Assignment data → Filter and formula: supplies values
src/main/java/org/gridsuite/modification/modifications/byfilter/AbstractModificationByAssignment.java - Tabular changes → PowSyBl network: mutates network
README.md - Equipment changes → Modification utilities: uses helpers
src/main/java/org/gridsuite/modification/modifications/TwoWindingsTransformerModification.java - Equipment changes → Modification errors: raises errors
src/main/java/org/gridsuite/modification/modifications/TwoWindingsTransformerModification.java - Equipment changes → Change reports: creates reports
src/main/java/org/gridsuite/modification/modifications/TwoWindingsTransformerModification.java - Modification base → Filter service: uses integration
src/main/java/org/gridsuite/modification/modifications/AbstractModification.java - Modification base → Load-flow service: uses integration
src/main/java/org/gridsuite/modification/modifications/AbstractModification.java - Modification DTOs → Filter and formula: supports filter requests
README.md - Modification DTOs → Tabular changes: supports tabular requests
README.md - PowSyBl network → Change reports: emits change reports