Merge pull request #1334 from ie3-institute/pp/#1330-increase-range-of-azimuth-angle-for-pv-inputs

Extend azimuth angle range to [-180°, 180°] for PV inputs

Author: danielfeismann

CHANGELOG.md

@@ -12,6 +12,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 - Updated dependabot workflow and added CODEOWNERS [#1328](https://github.com/ie3-institute/PowerSystemDataModel/issues/1328)
+- Extend azimuth angle range to [-180°, 180°] for PV inputs [#1330](https://github.com/ie3-institute/PowerSystemDataModel/issues/1330)
 
 ## [7.0.0] - 2025-05-08
 

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

@@ -44,8 +44,7 @@ Detailed model of a photovoltaic power plant.
 
    * - azimuth
      - °
-     - Inclination in a compass direction
-       South = 0°, West = 90°, East = -90°
+     - South = 0°, West = 90°, East = -90°, North = +/- 180°  
 
    * - etaConv
      - %

src/main/java/edu/ie3/datamodel/utils/validation/SystemParticipantValidationUtils.java

@@ -393,7 +393,7 @@ private static List<Try<Void, InvalidEntityException>> checkLoad(LoadInput loadI
    * <ul>
    *   <li>its rated apparent power is not negative
    *   <li>its albedo value of the plant's surrounding is between 0 and 1
-   *   <li>its inclination in a compass direction (azimuth) is between -90° and 90°
+   *   <li>its inclination in a compass direction (azimuth) is between -180° and 180°
    *   <li>its efficiency of the asset's inverter (etaConv) is between 0% and 100%
    *   <li>its tilted inclination from horizontal (elevation angle) is between 0° and 90°
    *   <li>its rated power factor is between 0 and 1
@@ -431,17 +431,17 @@ private static void checkAlbedo(PvInput pvInput) throws InvalidEntityException {
   }
 
   /**
-   * Check if azimuth angle of pvInput is between -90° and 90°
+   * Check if azimuth angle of pvInput is between -180° and 180°
    *
    * @param pvInput PvInput to validate
    */
   private static void checkAzimuth(PvInput pvInput) throws InvalidEntityException {
-    if (pvInput.getAzimuth().isLessThan(Quantities.getQuantity(-90d, AZIMUTH))
-        || pvInput.getAzimuth().isGreaterThan(Quantities.getQuantity(90d, AZIMUTH)))
+    if (pvInput.getAzimuth().isLessThan(Quantities.getQuantity(-180d, AZIMUTH))
+        || pvInput.getAzimuth().isGreaterThan(Quantities.getQuantity(180d, AZIMUTH)))
       throw new InvalidEntityException(
           "Azimuth angle of "
               + pvInput.getClass().getSimpleName()
-              + " must be between -90° (east) and 90° (west)",
+              + " must be between -180° and 180°",
           pvInput);
   }
 

src/test/groovy/edu/ie3/datamodel/utils/validation/SystemParticipantValidationUtilsTest.groovy

@@ -365,7 +365,7 @@ class SystemParticipantValidationUtilsTest extends Specification {
     invalidPV                                                                                                            || expectedSize || expectedException
     SystemParticipantTestData.pvInput.copy().sRated(Quantities.getQuantity(-25d, ACTIVE_POWER_IN)).build()               || 1            || new InvalidEntityException("The following quantities have to be zero or positive: -25 kVA", invalidPV)
     SystemParticipantTestData.pvInput.copy().albedo(2).build()                                                           || 1            || new InvalidEntityException("Albedo of the plant's surrounding of PvInput must be between 0 and 1", invalidPV)
-    SystemParticipantTestData.pvInput.copy().azimuth(Quantities.getQuantity(-100d, AZIMUTH)).build()                     || 1            || new InvalidEntityException("Azimuth angle of PvInput must be between -90° (east) and 90° (west)", invalidPV)
+    SystemParticipantTestData.pvInput.copy().azimuth(Quantities.getQuantity(-181d, AZIMUTH)).build()                     || 1            || new InvalidEntityException("Azimuth angle of PvInput must be between -180° and 180°", invalidPV)
     SystemParticipantTestData.pvInput.copy().etaConv(Quantities.getQuantity(110d, EFFICIENCY)).build()                   || 1            || new InvalidEntityException("Efficiency of the converter of PvInput must be between 0% and 100%", invalidPV)
     SystemParticipantTestData.pvInput.copy().elevationAngle(Quantities.getQuantity(100d, SOLAR_ELEVATION_ANGLE)).build() || 1            || new InvalidEntityException("Tilted inclination from horizontal of PvInput must be between 0° and 90°", invalidPV)
     SystemParticipantTestData.pvInput.copy().cosPhiRated(2).build()                                                      || 1            || new InvalidEntityException("Rated power factor of PvInput must be between 0 and 1", invalidPV)