Merge branch 'dev' into ms/#1438-abstracting-power-value-sources

# Conflicts:
#	CHANGELOG.md
#	src/main/java/edu/ie3/datamodel/io/csv/CsvLoadProfileMetaInformation.java
#	src/main/java/edu/ie3/datamodel/io/source/LoadProfileSource.java
#	src/main/java/edu/ie3/datamodel/io/source/csv/CsvLoadProfileSource.java

Author: staudtMarius

CHANGELOG.md

@@ -9,19 +9,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - Added weathersource documentation [#1390](https://github.com/ie3-institute/PowerSystemDataModel/issues/1390)
 - Added standard asset parameter for `3wTransformer` in `ReadTheDocs` [#1417](https://github.com/ie3-institute/PowerSystemDataModel/issues/1417)
+- Added getter sRated for SystemParticipant inputs and updated them in tests in src[#1412](https://github.com/ie3-institute/PowerSystemDataModel/issues/1412)
+- Added converters documentation [#1139](https://github.com/ie3-institute/PowerSystemDataModel/issues/1139)
 - Added abstraction for power value sources [#1438](https://github.com/ie3-institute/PowerSystemDataModel/issues/1438)
 
 ### Fixed
 - Fixed small issues in tests [#1400](https://github.com/ie3-institute/PowerSystemDataModel/issues/1400)
 - Fix transformer susceptance in readTheDocs to negative values [#1078](https://github.com/ie3-institute/PowerSystemDataModel/issues/1078)
 - Added mising fields to field validation [#1422](https://github.com/ie3-institute/PowerSystemDataModel/issues/1422)
 - Fixed the issues with rtd for Cylindrical thermal storage [#1273](https://github.com/ie3-institute/PowerSystemDataModel/issues/1273)
+- Updated Controlling_em for all the loads in readthedocs[#1447](https://github.com/ie3-institute/PowerSystemDataModel/issues/1447)
+- Included a doFirst clause into `checkJavaVersion.gradle` [#1462](https://github.com/ie3-institute/PowerSystemDataModel/issues/1462)
 
 ### Changed
 - Updated CI-Pipeline to run task `Deploy` and `Staging` only for `Main` [#1403](https://github.com/ie3-institute/PowerSystemDataModel/issues/1403)
 - Extend `GermanVoltageLevelUtils` with more synonymousIds [#143](https://github.com/ie3-institute/PowerSystemDataModel/issues/143)
 - Change spotless to use googleJavaFormat('1.28.0') [#1409](https://github.com/ie3-institute/PowerSystemDataModel/issues/1409)
 - Change `TimeSeries` to no longer extend `UniqueEntity` [#1441](https://github.com/ie3-institute/PowerSystemDataModel/issues/1441)
+- Refactor CSV handling into shared file-based infrastructure. [#1450](https://github.com/ie3-institute/PowerSystemDataModel/issues/1445)
 
 ## [8.1.0] - 2025-07-25
 
@@ -126,6 +131,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Fixed `MappingEntryies` not getting processed by adding `Getter` methods for record fields [#1084](https://github.com/ie3-institute/PowerSystemDataModel/issues/1084) 
 - Fixed "depth of discharge" in documentation [#872](https://github.com/ie3-institute/PowerSystemDataModel/issues/872)
 - Fixed project being build twice in CI [#994](https://github.com/ie3-institute/PowerSystemDataModel/issues/994)
+- Fix figure of SubGridContainer in rtd and clarify definitions [#1458](https://github.com/ie3-institute/PowerSystemDataModel/issues/1458) 
 
 ### Changed
 - Improvements to the search for corner points in `IdCoordinateSource` [#1016](https://github.com/ie3-institute/PowerSystemDataModel/issues/1016)

build.gradle

@@ -5,11 +5,11 @@ plugins {
   id 'signing'
   id 'pmd' // code check, working on source code
   id 'com.diffplug.spotless' version '8.0.0' //code format
-  id 'com.github.spotbugs' version '6.4.2' // code check, working on byte code
+  id 'com.github.spotbugs' version '6.4.4' // code check, working on byte code
   id 'de.undercouch.download' version '5.6.0'
   id 'kr.motd.sphinx' version '2.10.1' // documentation generation
   id 'jacoco' // java code coverage plugin
-  id "org.sonarqube" version "6.3.1.5724" // sonarqube
+  id "org.sonarqube" version "7.0.0.6105" // sonarqube
   id 'net.thauvin.erik.gradle.semver' version '1.0.4' // semantic versioning
   id "com.github.johnrengelman.shadow" version "8.1.1" // fat jar
 }
@@ -20,7 +20,7 @@ ext {
   groovyVersion = "4.0"
   groovyBinaryVersion = "4.0.28"
 
-  junitVersion = '1.12.0'
+  junitVersion = '6.0.0'
   testcontainersVersion = '1.21.3'
 
   scriptsLocation = 'gradle' + File.separator + 'scripts' + File.separator //location of script plugins
@@ -82,7 +82,7 @@ dependencies {
   testImplementation "org.junit.jupiter:junit-jupiter:$junitVersion"
   testImplementation "org.spockframework:spock-core:2.3-groovy-$groovyVersion"
   testImplementation 'org.objenesis:objenesis:3.4' // Mock creation with constructor parameters
-  testImplementation 'net.bytebuddy:byte-buddy:1.17.7' // Mocks of classes
+  testImplementation 'net.bytebuddy:byte-buddy:1.17.8' // Mocks of classes
 
   // testcontainers (docker framework for testing)
   testImplementation "org.testcontainers:testcontainers:$testcontainersVersion"
@@ -99,7 +99,7 @@ dependencies {
 
   // Databases
   implementation 'org.influxdb:influxdb-java:2.25'
-  implementation 'com.couchbase.client:java-client:3.9.1'
+  implementation 'com.couchbase.client:java-client:3.9.2'
   runtimeOnly 'org.postgresql:postgresql:42.7.8' // postgresql jdbc driver required during runtime
 
   implementation 'commons-io:commons-io:2.20.0' // I/O functionalities

docs/readthedocs/_static/figures/transformerWithSwitchGear.png

@@ -58,6 +58,8 @@
 \definecolor{tuViolette}{cmyk}{0.25, 1, 0, 0}
 \definecolor{tuYellow}{cmyk}{0.05, 0.08, 1, 0}
 \definecolor{tuBrown}{cmyk}{0.05, 0.69, 1, 0}
+\definecolor{red}{rgb}{1, 0, 0}
+\definecolor{blue}{rgb}{0, 0, 1}
 
 % === pgfplots ===
 % Definition of cycle lists
@@ -176,9 +178,26 @@
 	        \draw (port_d.east) -- (winding_a.west) (winding_b.east) -- (port_e.west);
 
 	        \node[tuGreen, anchor = north, inner sep = 2mm, text width = 10mm, align = center] at (port_a.south) {A \\ \SI{110}{\kV} \\ 1};
-	        \node[tuOrange, anchor = north, inner sep = 2mm, text width = 10mm, align = center] at (port_b.south) {B \\ \SI{110}{\kV} \\ 1};
-	        \node[tuOrange, anchor = north, inner sep = 2mm, text width = 10mm, align = center] at (port_c.south) {C \\ \SI{110}{\kV} \\ 1};
-	        \node[tuOrange, anchor = north, inner sep = 2mm, text width = 10mm, align = center] at (port_d.south) {D \\ \SI{110}{\kV} \\ 1};
+	        \node[tuGreen, anchor = north, inner sep = 2mm, text width = 10mm, align = center] at (port_b.south) {B \\ \SI{110}{\kV} \\ 1};
+	        \node[tuGreen, anchor = north, inner sep = 2mm, text width = 10mm, align = center] at (port_c.south) {C \\ \SI{110}{\kV} \\ 1};
+	        \node[tuGreen, anchor = north, inner sep = 2mm, text width = 10mm, align = center] at (port_d.south) {D \\ \SI{110}{\kV} \\ 1};
 	        \node[tuOrange, anchor = north, inner sep = 2mm, text width = 10mm, align = center] at (port_e.south) {E \\ \SI{10}{\kV} \\ 2};
+
+            % Corner points of SubGridContainerA
+            \node[anchor=south west, font=\footnotesize] (SGC_A_SW) at (-0.5, 0.75) {SubGridContainer A}; % South West corner
+            \node[anchor=south east] (SGC_A_SE) at (5.25, 1.0) {}; % South East corner
+            \node[anchor=south west] (SGC_A_NW) at (-0.5, -1.5) {}; % North West corner
+            \node[anchor=south east] (SGC_A_NE) at (5.25, -1.5) {}; % North East corner
+
+            % Corner points of SubGridContainerA
+            \node[anchor=south west] (SGC_B_NW) at (4.0, 0.75) {}; % North West corner
+            \node[anchor=south east, font=\footnotesize] (SGC_B_NE) at (8.25, 0.75) {SubGridContainer B}; % North East corner
+            \node[anchor=north west] (SGC_B_SW) at (4.0, -2.0) {}; % South West corner
+            \node[anchor=south east] (SGC_B_SE) at (8.25, -2.0) {}; % South East corner
+
+            % Draw a red rectangle using the defined nodes
+            \draw [red] (SGC_A_SW.north west) -- (SGC_A_SE.north east) -- (SGC_A_NE.south east) -- (SGC_A_NW.south west) -- cycle;
+            % Draw a bluerectangle using the defined nodes
+            \draw [blue] (SGC_B_SW.north west) -- (SGC_B_SE.south east) -- (SGC_B_NE.south east) -- (SGC_B_NW.south west) -- cycle;
 	    \end{tikzpicture}
 \end{document}

docs/readthedocs/_static/figures/transformerWithSwitchGear.tex

@@ -12,6 +12,7 @@ csvfiles
 sql
 influxdb
 ValidationUtils.md
+converters.md
 ```
 
 ## Data sink structure

docs/readthedocs/io/basiciousage.md

@@ -0,0 +1,17 @@
+# Converters
+This page lists all converters from and to the PSDM format that are known to us.
+
+## Converters to PSDM
+
+- [simBench2psdm](https://github.com/ie3-institute/simBench2psdm): SimBench has been research project of Kassel university, Fraunhofer IEE, RWTH Aachen university and TU Dortmund university, aiming at provision of realistic models of electrical distribution grids including time series. The data is availabe [here](https://simbench.de).
+- [powerFactory2psdm](https://github.com/ie3-institute/powerFactory2psdm): This tool is used to convert PowerFactory projects into the PSDM format.
+- [pp2psdm](https://github.com/ie3-institute/pp2psdm): Converter for grid models from pandapower into PowerSystemDataModel format.
+
+## Converts from PSDM
+
+- [psdm2powerfactory](https://github.com/ie3-institute/psdm2powerfactory): Converter from PSDM to PowerFactory file format.
+
+## Other Converters
+
+- [simBench2PowerFactory](https://github.com/ie3-institute/simBench2PowerFactory): Converts SimBench grids to the PowerFactory file format.
+- The tool [here](https://github.com/e2nIEE/simbench) enables the use of the SimBench data set in the simulation tool [pandapower](https://github.com/e2nIEE/pandapower).

docs/readthedocs/io/converters.md

@@ -40,7 +40,7 @@ Participants are connected to an EM each via their `em` field.
    * - controllingEm
      -
      - Reference to a superior Energy Management Unit that is controlling this EM.
-       Field can be empty or missing, if this EM itself is not controlled.
+       Field can be empty, if this EM itself is not controlled.
 
 ```
 

docs/readthedocs/models/input/em.md

@@ -18,7 +18,7 @@ In contrast to the `JointGridContainer` it only covers one voltage level and the
 for the predominant voltage level apparent in the container.
 Why predominant?
 As of convention, the `SubGridContainers` hold also reference to the transformers leading to higher sub grids
-and their higher voltage coupling point.
+and their higher voltage coupling point. Thus, the higher voltage coupling point is part of more than one `SubGridContainer`.
 
 ![Sub grid boundary definition for transformers with upstream switchgear](../../../_static/figures/transformerWithSwitchGear.png)
 

docs/readthedocs/models/input/grid/gridcontainer.md

@@ -110,7 +110,7 @@ Model of a biomass power plant.
    * - controllingEm
      -
      - UUID reference to an [Energy Management Unit](#em_model) that is controlling
-       this system participant. Field can be empty or missing, if this participant
+       this system participant. Field can be empty, if this participant
        is not controlled.
 
 ```

docs/readthedocs/models/input/participant/bm.md

@@ -117,7 +117,7 @@ Combined heat and power plant.
    * - controllingEm
      -
      - UUID reference to an [Energy Management Unit](em_model) that is controlling
-       this system participant. Field can be empty or missing, if this participant
+       this system participant. Field can be empty, if this participant
        is not controlled.
 
 ```