Adding support for custom load profiles.

Author: staudtMarius

CHANGELOG.md

@@ -8,6 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - Extend Validation to EnergyManagement Systems. [#1356](https://github.com/ie3-institute/PowerSystemDataModel/issues/1356)
+- Added support for custom load profiles [#1362](https://github.com/ie3-institute/PowerSystemDataModel/issues/1362)
 
 ### Fixed
 - Fixed handling of `CongestionResult.InputModelType` in `EntityProcessor` [#1325](https://github.com/ie3-institute/PowerSystemDataModel/issues/1325)

src/main/java/edu/ie3/datamodel/io/factory/input/participant/LoadInputFactory.java

@@ -5,7 +5,6 @@
 */
 package edu.ie3.datamodel.io.factory.input.participant;
 
-import edu.ie3.datamodel.exceptions.ParsingException;
 import edu.ie3.datamodel.models.OperationTime;
 import edu.ie3.datamodel.models.StandardUnits;
 import edu.ie3.datamodel.models.input.EmInput;
@@ -17,13 +16,10 @@
 import java.util.UUID;
 import javax.measure.quantity.Energy;
 import javax.measure.quantity.Power;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 import tech.units.indriya.ComparableQuantity;
 
 public class LoadInputFactory
     extends SystemParticipantInputEntityFactory<LoadInput, SystemParticipantEntityData> {
-  private static final Logger logger = LoggerFactory.getLogger(LoadInputFactory.class);
 
   private static final String LOAD_PROFILE = "loadProfile";
   private static final String E_CONS_ANNUAL = "eConsAnnual";
@@ -48,16 +44,8 @@ protected LoadInput buildModel(
       ReactivePowerCharacteristic qCharacteristics,
       OperatorInput operator,
       OperationTime operationTime) {
-    LoadProfile loadProfile;
-    try {
-      loadProfile = LoadProfile.parse(data.getField(LOAD_PROFILE));
-    } catch (ParsingException e) {
-      logger.warn(
-          "Cannot parse the standard load profile \"{}\" of load \"{}\". Assign no load profile instead.",
-          data.getField(LOAD_PROFILE),
-          id);
-      loadProfile = LoadProfile.DefaultLoadProfiles.NO_LOAD_PROFILE;
-    }
+    LoadProfile loadProfile = LoadProfile.parse(data.getField(LOAD_PROFILE));
+
     final EmInput em = data.getControllingEm().orElse(null);
 
     final ComparableQuantity<Energy> eConsAnnual =

src/main/java/edu/ie3/datamodel/models/profile/LoadProfile.java

@@ -5,10 +5,8 @@
 */
 package edu.ie3.datamodel.models.profile;
 
-import edu.ie3.datamodel.exceptions.ParsingException;
 import java.io.Serializable;
 import java.util.Arrays;
-import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
 public interface LoadProfile extends Serializable {
@@ -20,9 +18,8 @@ public interface LoadProfile extends Serializable {
    *
    * @param key Key to parse
    * @return Matching {@link StandardLoadProfile}
-   * @throws ParsingException If key cannot be parsed
    */
-  static LoadProfile parse(String key) throws ParsingException {
+  static LoadProfile parse(String key) {
     if (key == null || key.isEmpty()) return LoadProfile.DefaultLoadProfiles.NO_LOAD_PROFILE;
 
     return LoadProfile.getProfile(getAllProfiles(), key);
@@ -38,25 +35,21 @@ static LoadProfile[] getAllProfiles() {
   }
 
   /**
-   * Looks for load profile with given key and returns it.
+   * Looks for load profile with given key and returns it. If no suitable profile is found, a {@link
+   * CustomLoadProfile} with the given key is returned.
    *
    * @param profiles we search within
    * @param key to look for
    * @return the matching load profile
    */
-  static <T extends LoadProfile> T getProfile(T[] profiles, String key) throws ParsingException {
+  @SuppressWarnings("unchecked")
+  static <T extends LoadProfile> T getProfile(T[] profiles, String key) {
+    String uniformKey = getUniformKey(key);
+
     return Arrays.stream(profiles)
-        .filter(loadProfile -> loadProfile.getKey().equalsIgnoreCase(getUniformKey(key)))
+        .filter(loadProfile -> loadProfile.getKey().equalsIgnoreCase(uniformKey))
         .findFirst()
-        .orElseThrow(
-            () ->
-                new ParsingException(
-                    "No predefined load profile with key '"
-                        + key
-                        + "' found. Please provide one of the following keys: "
-                        + Arrays.stream(profiles)
-                            .map(LoadProfile::getKey)
-                            .collect(Collectors.joining(", "))));
+        .orElseGet(() -> (T) new CustomLoadProfile(uniformKey));
   }
 
   private static String getUniformKey(String key) {
@@ -72,6 +65,13 @@ public String getKey() {
     }
   }
 
+  record CustomLoadProfile(String key) implements LoadProfile {
+    @Override
+    public String getKey() {
+      return key;
+    }
+  }
+
   enum RandomLoadProfile implements LoadProfile {
     RANDOM_LOAD_PROFILE;
 

src/test/groovy/edu/ie3/datamodel/models/profile/LoadProfileTest.groovy

@@ -7,7 +7,6 @@ package edu.ie3.datamodel.models.profile
 
 import static edu.ie3.datamodel.models.profile.LoadProfile.RandomLoadProfile.RANDOM_LOAD_PROFILE
 
-import edu.ie3.datamodel.exceptions.ParsingException
 import spock.lang.Specification
 
 class LoadProfileTest extends Specification {
@@ -181,12 +180,19 @@ class LoadProfileTest extends Specification {
     "ez_2"    || NbwTemperatureDependantLoadProfile.EZ2
   }
 
-  def "Throws an exception when encountering an unknown key"() {
+  def "Return a custom load profile when encountering an unknown key"() {
     when:
-    LoadProfile.parse("not_a_key")
+    def custom = LoadProfile.parse("not_a_key")
 
     then:
-    def e = thrown(ParsingException)
-    e.message == "No predefined load profile with key 'not_a_key' found. Please provide one of the following keys: h0, l0, l1, l2, g0, g1, g2, g3, g4, g5, g6, ep1, ez2, random"
+    custom == new LoadProfile.CustomLoadProfile("notakey")
+  }
+
+  def "Return nothing when encountering an empty key"() {
+    when:
+    def actual = LoadProfile.parse(null)
+
+    then:
+    actual == LoadProfile.DefaultLoadProfiles.NO_LOAD_PROFILE
   }
 }