Package edu.ie3.datamodel.utils.validation

Class ConnectorValidationUtils

java.lang.Object
edu.ie3.datamodel.utils.validation.ValidationUtils
edu.ie3.datamodel.utils.validation.ConnectorValidationUtils
public class ConnectorValidationUtils extends ValidationUtils

  • Method Summary

    Modifier and Type
    Method
    Description
    protected static void
    check(ConnectorInput connector)
    Validates a connector if:
    - it is not null
    A "distribution" method, that forwards the check request to specific implementations to fulfill the checking task, based on the class of the given object.
    protected static void
    checkLineType(LineTypeInput lineType)
    Validates a line type if:
    - it is not null
    - B is greater/equal to 0 (Phase-to-ground susceptance per length)
    - G is greater/equal to 0 (Phase-to-ground conductance per length)
    - R is greater 0 (Phase resistance per length)
    - X is greater 0 (Phase reactance per length)
    - iMax is greater 0 (Maximum permissible current)
    - vRated is greater 0 (Rated voltage)
    protected static void
    checkTransformer2WType(Transformer2WTypeInput transformer2WType)
    Validates a transformer2W type if:
    - it is not null
    - rSc is greater 0 (short circuit resistance)
    - xSc is greater 0 (short circuit impedance)
    - gM is greater/equal to 0 (no load conductance)
    - bM is less/equal to 0 (no load susceptance)
    - sRated is greater 0 (rated apparent power)
    - vRatedA is greater 0 (rated voltage at higher voltage terminal)
    - vRatedB is greater 0 (rated voltage at lower voltage terminal)
    - dV is between 0% and 100% (voltage magnitude increase per tap position
    - dPhi is greater/equal to 0 (voltage angle increase per tap position)
    - neutral tap position is between min and max tap position
    - minimum tap position is smaller than maximum tap position
    protected static void
    checkTransformer3WType(Transformer3WTypeInput transformer3WType)
    Validates a transformer3W type if:
    - it is not null
    - rScA, rScB, rScC are greater 0 (short circuit resistance in branches A,B,C)
    - xScA, xScB, xScC are greater 0 (short circuit impedance in branches A,B,C)
    - gM is greater/equal to 0 (no load conductance)
    - bM is less/equal to 0 (no load susceptance)
    - sRatedA, sRatedB, sRatedC are greater 0 (rated apparent power in branches A,B,C)
    - vRatedA, vRatedB, vRatedC are greater 0 (rated voltage at higher node A,B,C)
    - dV is between 0% and 100% (voltage magnitude increase per tap position
    - dPhi is greater/equal to 0 (voltage angle increase per tap position)
    - neutral tap position is between min and max tap position
    - minimum tap position is smaller than maximum tap position

    Methods inherited from class edu.ie3.datamodel.utils.validation.ValidationUtils

    check, checkForDuplicateUuids, checkNonNull, checkNotImplementedException, detectMalformedQuantities, detectNegativeQuantities, detectPositiveQuantities, detectZeroOrNegativeQuantities, distinctByKey

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Method Details

    • check

      protected static void check(ConnectorInput connector)
      Validates a connector if:
      - it is not null
      A "distribution" method, that forwards the check request to specific implementations to fulfill the checking task, based on the class of the given object.
      Parameters:
      connector - Connector to validate
      Throws:
      NotImplementedException - if an unknown class is handed in

    • checkLineType

      protected static void checkLineType(LineTypeInput lineType)
      Validates a line type if:
      - it is not null
      - B is greater/equal to 0 (Phase-to-ground susceptance per length)
      - G is greater/equal to 0 (Phase-to-ground conductance per length)
      - R is greater 0 (Phase resistance per length)
      - X is greater 0 (Phase reactance per length)
      - iMax is greater 0 (Maximum permissible current)
      - vRated is greater 0 (Rated voltage)
      Parameters:
      lineType - Line type to validate

    • checkTransformer2WType

      protected static void checkTransformer2WType(Transformer2WTypeInput transformer2WType)
      Validates a transformer2W type if:
      - it is not null
      - rSc is greater 0 (short circuit resistance)
      - xSc is greater 0 (short circuit impedance)
      - gM is greater/equal to 0 (no load conductance)
      - bM is less/equal to 0 (no load susceptance)
      - sRated is greater 0 (rated apparent power)
      - vRatedA is greater 0 (rated voltage at higher voltage terminal)
      - vRatedB is greater 0 (rated voltage at lower voltage terminal)
      - dV is between 0% and 100% (voltage magnitude increase per tap position
      - dPhi is greater/equal to 0 (voltage angle increase per tap position)
      - neutral tap position is between min and max tap position
      - minimum tap position is smaller than maximum tap position
      Parameters:
      transformer2WType - Transformer2W type to validate

    • checkTransformer3WType

      protected static void checkTransformer3WType(Transformer3WTypeInput transformer3WType)
      Validates a transformer3W type if:
      - it is not null
      - rScA, rScB, rScC are greater 0 (short circuit resistance in branches A,B,C)
      - xScA, xScB, xScC are greater 0 (short circuit impedance in branches A,B,C)
      - gM is greater/equal to 0 (no load conductance)
      - bM is less/equal to 0 (no load susceptance)
      - sRatedA, sRatedB, sRatedC are greater 0 (rated apparent power in branches A,B,C)
      - vRatedA, vRatedB, vRatedC are greater 0 (rated voltage at higher node A,B,C)
      - dV is between 0% and 100% (voltage magnitude increase per tap position
      - dPhi is greater/equal to 0 (voltage angle increase per tap position)
      - neutral tap position is between min and max tap position
      - minimum tap position is smaller than maximum tap position
      Parameters:
      transformer3WType - Transformer type to validate