Package com.powsybl.iidm.network

Class ValidationUtil

java.lang.Object

com.powsybl.iidm.network.ValidationUtil

public final class ValidationUtil
extends Object

Author:

Geoffroy Jamgotchian <geoffroy.jamgotchian at rte-france.com>

Method Summary

Modifier and Type	Method	Description
static void	checkActivePowerLimits(Validable validable, double minP, double maxP)
static ValidationLevel	checkActivePowerSetpoint(Validable validable, double activePowerSetpoint, boolean throwException)
static ValidationLevel	checkActivePowerSetpoint(Validable validable, double activePowerSetpoint, boolean throwException, ReportNode reportNode)
static ValidationLevel	checkActivePowerSetpoint(Validable validable, double activePowerSetpoint, ValidationLevel validationLevel)
static ValidationLevel	checkActivePowerSetpoint(Validable validable, double activePowerSetpoint, ValidationLevel validationLevel, ReportNode reportNode)
static void	checkB(Validable validable, double b)
static void	checkB1(Validable validable, double b1)
static void	checkB2(Validable validable, double b2)
static void	checkBmax(Validable validable, double bMax)
static void	checkBmin(Validable validable, double bMin)
static void	checkBPerSection(Validable validable, double sectionB)
static void	checkCaseDate(Validable validable, ZonedDateTime caseDate)
static void	checkConnected(Validable validable, Boolean connected)
static ValidationLevel	checkConvertersMode(Validable validable, HvdcLine.ConvertersMode converterMode, boolean throwException)
static ValidationLevel	checkConvertersMode(Validable validable, HvdcLine.ConvertersMode converterMode, boolean throwException, ReportNode reportNode)
static void	checkEnergySource(Validable validable, EnergySource energySource)
static void	checkForecastDistance(Validable validable, int forecastDistance)
static void	checkG(Validable validable, double g)
static void	checkG1(Validable validable, double g1)
static void	checkG2(Validable validable, double g2)
static ValidationLevel	checkHvdcActivePowerSetpoint(Validable validable, double activePowerSetpoint, boolean throwException)
static ValidationLevel	checkHvdcActivePowerSetpoint(Validable validable, double activePowerSetpoint, boolean throwException, ReportNode reportNode)
static void	checkHvdcMaxP(Validable validable, double maxP)
static ValidationLevel	checkLoadingLimits(Validable validable, double permanentLimit, Collection<LoadingLimits.TemporaryLimit> temporaryLimits, boolean throwException, ReportNode reportNode)
static void	checkLoadType(Validable validable, LoadType loadType)
static void	checkLossFactor(Validable validable, float lossFactor)
static void	checkMaximumSectionCount(Validable validable, int maximumSectionCount)
static void	checkMaxP(Validable validable, double maxP)
static void	checkMinP(Validable validable, double minP)
static void	checkNominalV(Validable validable, double nominalV)
static ValidationLevel	checkOnlyOneTapChangerRegulatingEnabled(Validable validable, Set<TapChanger<?,?,?,?>> tapChangersNotIncludingTheModified, boolean regulating, boolean throwException)
static ValidationLevel	checkOnlyOneTapChangerRegulatingEnabled(Validable validable, Set<TapChanger<?,?,?,?>> tapChangersNotIncludingTheModified, boolean regulating, boolean throwException, ReportNode reportNode)
static ValidationLevel	checkP0(Validable validable, double p0, boolean throwException, ReportNode reportNode)
static ValidationLevel	checkP0(Validable validable, double p0, ValidationLevel validationLevel)
static ValidationLevel	checkP0(Validable validable, double p0, ValidationLevel validationLevel, ReportNode reportNode)
static ValidationLevel	checkPermanentLimit(Validable validable, double permanentLimit, Collection<LoadingLimits.TemporaryLimit> temporaryLimits, boolean throwException)
static ValidationLevel	checkPermanentLimit(Validable validable, double permanentLimit, Collection<LoadingLimits.TemporaryLimit> temporaryLimits, boolean throwException, ReportNode reportNode)
static ValidationLevel	checkPhaseTapChangerRegulation(Validable validable, PhaseTapChanger.RegulationMode regulationMode, double regulationValue, boolean regulating, Terminal regulationTerminal, Network network, boolean throwException)
static ValidationLevel	checkPhaseTapChangerRegulation(Validable validable, PhaseTapChanger.RegulationMode regulationMode, double regulationValue, boolean regulating, Terminal regulationTerminal, Network network, boolean throwException, ReportNode reportNode)
static void	checkPowerFactor(Validable validable, double powerFactor)
static ValidationLevel	checkQ0(Validable validable, double q0, boolean throwException, ReportNode reportNode)
static ValidationLevel	checkQ0(Validable validable, double q0, ValidationLevel validationLevel)
static ValidationLevel	checkQ0(Validable validable, double q0, ValidationLevel validationLevel, ReportNode reportNode)
static void	checkR(Validable validable, double r)
static void	checkRatedS(Validable validable, double ratedS)
static void	checkRatedU(Validable validable, double ratedU, String num)
static void	checkRatedU1(Validable validable, double ratedU1)
static void	checkRatedU2(Validable validable, double ratedU2)
static ValidationLevel	checkRatioTapChangerRegulation(Validable validable, boolean regulating, boolean loadTapChangingCapabilities, Terminal regulationTerminal, RatioTapChanger.RegulationMode regulationMode, double regulationValue, Network network, boolean throwException, ReportNode reportNode)
static ValidationLevel	checkRatioTapChangerRegulation(Validable validable, boolean regulating, boolean loadTapChangingCapabilities, Terminal regulationTerminal, RatioTapChanger.RegulationMode regulationMode, double regulationValue, Network network, ValidationLevel validationLevel)
static ValidationLevel	checkRatioTapChangerRegulation(Validable validable, boolean regulating, boolean loadTapChangingCapabilities, Terminal regulationTerminal, RatioTapChanger.RegulationMode regulationMode, double regulationValue, Network network, ValidationLevel validationLevel, ReportNode reportNode)
static void	checkRegulatingTerminal(Validable validable, Terminal regulatingTerminal, Network network)
static ValidationLevel	checkSections(Validable validable, Integer currentSectionCount, int maximumSectionCount, boolean throwException, ReportNode reportNode)
static ValidationLevel	checkSections(Validable validable, Integer currentSectionCount, int maximumSectionCount, ValidationLevel validationLevel)
static ValidationLevel	checkSections(Validable validable, Integer currentSectionCount, int maximumSectionCount, ValidationLevel validationLevel, ReportNode reportNode)
static ValidationLevel	checkSvcRegulator(Validable validable, double voltageSetpoint, double reactivePowerSetpoint, StaticVarCompensator.RegulationMode regulationMode, boolean throwException, ReportNode reportNode)
static ValidationLevel	checkSvcRegulator(Validable validable, double voltageSetpoint, double reactivePowerSetpoint, StaticVarCompensator.RegulationMode regulationMode, ValidationLevel validationLevel)
static ValidationLevel	checkSvcRegulator(Validable validable, double voltageSetpoint, double reactivePowerSetpoint, StaticVarCompensator.RegulationMode regulationMode, ValidationLevel validationLevel, ReportNode reportNode)
static ValidationLevel	checkTargetDeadband(Validable validable, String validableType, boolean regulating, double targetDeadband, boolean throwsException, ReportNode reportNode)
static ValidationLevel	checkTargetDeadband(Validable validable, String validableType, boolean regulating, double targetDeadband, ValidationLevel validationLevel)
static ValidationLevel	checkTargetDeadband(Validable validable, String validableType, boolean regulating, double targetDeadband, ValidationLevel validationLevel, ReportNode reportNode)
static void	checkTemporaryLimits(Validable validable, double permanentLimit, Collection<LoadingLimits.TemporaryLimit> temporaryLimits)
static void	checkTopologyKind(Validable validable, TopologyKind topologyKind)
static ValidationLevel	checkVoltageControl(Validable validable, boolean voltageRegulatorOn, double voltageSetpoint, boolean throwException, ReportNode reportNode)
static ValidationLevel	checkVoltageControl(Validable validable, boolean voltageRegulatorOn, double voltageSetpoint, ValidationLevel validationLevel)
static ValidationLevel	checkVoltageControl(Validable validable, boolean voltageRegulatorOn, double voltageSetpoint, ValidationLevel validationLevel, ReportNode reportNode)
static ValidationLevel	checkVoltageControl(Validable validable, Boolean voltageRegulatorOn, double voltageSetpoint, double reactivePowerSetpoint, boolean throwException, ReportNode reportNode)
static ValidationLevel	checkVoltageControl(Validable validable, Boolean voltageRegulatorOn, double voltageSetpoint, double reactivePowerSetpoint, ValidationLevel validationLevel)
static ValidationLevel	checkVoltageControl(Validable validable, Boolean voltageRegulatorOn, double voltageSetpoint, double reactivePowerSetpoint, ValidationLevel validationLevel, ReportNode reportNode)
static void	checkVoltageLimits(Validable validable, double lowVoltageLimit, double highVoltageLimit)
static void	checkX(Validable validable, double x)
static PowsyblException	createUndefinedValueGetterException()
static PowsyblException	createUnsetMethodException()
static void	throwExceptionOrLogError(Validable validable, String message, boolean throwException, ReportNode reportNode)
static void	throwExceptionOrLogError(Validable validable, String message, ValidationLevel validationLevel)
static void	throwExceptionOrLogError(Validable validable, String message, ValidationLevel validationLevel, ReportNode reportNode)
static ValidationLevel	validate(Collection<Identifiable<?>> identifiables, boolean allChecks, boolean throwException, ValidationLevel previous, ReportNode reportNode)

Methods inherited from class java.lang.Object

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

Method Details

createUndefinedValueGetterException

public static PowsyblException createUndefinedValueGetterException()

createUnsetMethodException

public static PowsyblException createUnsetMethodException()

throwExceptionOrLogError

public static void throwExceptionOrLogError(Validable validable,
 String message,
 ValidationLevel validationLevel)

throwExceptionOrLogError

public static void throwExceptionOrLogError(Validable validable,
 String message,
 boolean throwException,
 ReportNode reportNode)

throwExceptionOrLogError

public static void throwExceptionOrLogError(Validable validable,
 String message,
 ValidationLevel validationLevel,
 ReportNode reportNode)

checkActivePowerSetpoint

public static ValidationLevel checkActivePowerSetpoint(Validable validable,
 double activePowerSetpoint,
 ValidationLevel validationLevel)

checkActivePowerSetpoint

public static ValidationLevel checkActivePowerSetpoint(Validable validable,
 double activePowerSetpoint,
 ValidationLevel validationLevel,
 ReportNode reportNode)

checkActivePowerSetpoint

public static ValidationLevel checkActivePowerSetpoint(Validable validable,
 double activePowerSetpoint,
 boolean throwException)

checkActivePowerSetpoint

public static ValidationLevel checkActivePowerSetpoint(Validable validable,
 double activePowerSetpoint,
 boolean throwException,
 ReportNode reportNode)

checkHvdcActivePowerSetpoint

public static ValidationLevel checkHvdcActivePowerSetpoint(Validable validable,
 double activePowerSetpoint,
 boolean throwException)

checkHvdcActivePowerSetpoint

public static ValidationLevel checkHvdcActivePowerSetpoint(Validable validable,
 double activePowerSetpoint,
 boolean throwException,
 ReportNode reportNode)

checkActivePowerLimits

public static void checkActivePowerLimits(Validable validable,
 double minP,
 double maxP)

checkTargetDeadband

public static ValidationLevel checkTargetDeadband(Validable validable,
 String validableType,
 boolean regulating,
 double targetDeadband,
 ValidationLevel validationLevel)

checkTargetDeadband

public static ValidationLevel checkTargetDeadband(Validable validable,
 String validableType,
 boolean regulating,
 double targetDeadband,
 ValidationLevel validationLevel,
 ReportNode reportNode)

checkTargetDeadband

public static ValidationLevel checkTargetDeadband(Validable validable,
 String validableType,
 boolean regulating,
 double targetDeadband,
 boolean throwsException,
 ReportNode reportNode)

checkVoltageControl

public static ValidationLevel checkVoltageControl(Validable validable,
 boolean voltageRegulatorOn,
 double voltageSetpoint,
 ValidationLevel validationLevel)

checkVoltageControl

public static ValidationLevel checkVoltageControl(Validable validable,
 boolean voltageRegulatorOn,
 double voltageSetpoint,
 ValidationLevel validationLevel,
 ReportNode reportNode)

checkVoltageControl

public static ValidationLevel checkVoltageControl(Validable validable,
 boolean voltageRegulatorOn,
 double voltageSetpoint,
 boolean throwException,
 ReportNode reportNode)

checkVoltageControl

public static ValidationLevel checkVoltageControl(Validable validable,
 Boolean voltageRegulatorOn,
 double voltageSetpoint,
 double reactivePowerSetpoint,
 ValidationLevel validationLevel)

checkVoltageControl

public static ValidationLevel checkVoltageControl(Validable validable,
 Boolean voltageRegulatorOn,
 double voltageSetpoint,
 double reactivePowerSetpoint,
 ValidationLevel validationLevel,
 ReportNode reportNode)

checkVoltageControl

public static ValidationLevel checkVoltageControl(Validable validable,
 Boolean voltageRegulatorOn,
 double voltageSetpoint,
 double reactivePowerSetpoint,
 boolean throwException,
 ReportNode reportNode)

checkRatedS

public static void checkRatedS(Validable validable,
 double ratedS)

checkEnergySource

public static void checkEnergySource(Validable validable,
 EnergySource energySource)

checkMinP

public static void checkMinP(Validable validable,
 double minP)

checkMaxP

public static void checkMaxP(Validable validable,
 double maxP)

checkHvdcMaxP

public static void checkHvdcMaxP(Validable validable,
 double maxP)

checkRegulatingTerminal

public static void checkRegulatingTerminal(Validable validable,
 Terminal regulatingTerminal,
 Network network)

checkLoadType

public static void checkLoadType(Validable validable,
 LoadType loadType)

checkP0

public static ValidationLevel checkP0(Validable validable,
 double p0,
 ValidationLevel validationLevel)

checkP0

public static ValidationLevel checkP0(Validable validable,
 double p0,
 ValidationLevel validationLevel,
 ReportNode reportNode)

checkP0

public static ValidationLevel checkP0(Validable validable,
 double p0,
 boolean throwException,
 ReportNode reportNode)

checkQ0

public static ValidationLevel checkQ0(Validable validable,
 double q0,
 ValidationLevel validationLevel)

checkQ0

public static ValidationLevel checkQ0(Validable validable,
 double q0,
 ValidationLevel validationLevel,
 ReportNode reportNode)

checkQ0

public static ValidationLevel checkQ0(Validable validable,
 double q0,
 boolean throwException,
 ReportNode reportNode)

checkR

public static void checkR(Validable validable,
 double r)

checkX

public static void checkX(Validable validable,
 double x)

checkG1

public static void checkG1(Validable validable,
 double g1)

checkG2

public static void checkG2(Validable validable,
 double g2)

checkB1

public static void checkB1(Validable validable,
 double b1)

checkB2

public static void checkB2(Validable validable,
 double b2)

checkG

public static void checkG(Validable validable,
 double g)

checkB

public static void checkB(Validable validable,
 double b)

checkNominalV

public static void checkNominalV(Validable validable,
 double nominalV)

checkVoltageLimits

public static void checkVoltageLimits(Validable validable,
 double lowVoltageLimit,
 double highVoltageLimit)

checkTopologyKind

public static void checkTopologyKind(Validable validable,
 TopologyKind topologyKind)

checkCaseDate

public static void checkCaseDate(Validable validable,
 ZonedDateTime caseDate)

checkForecastDistance

public static void checkForecastDistance(Validable validable,
 int forecastDistance)

checkBPerSection

public static void checkBPerSection(Validable validable,
 double sectionB)

checkMaximumSectionCount

public static void checkMaximumSectionCount(Validable validable,
 int maximumSectionCount)

checkSections

public static ValidationLevel checkSections(Validable validable,
 Integer currentSectionCount,
 int maximumSectionCount,
 ValidationLevel validationLevel)

checkSections

public static ValidationLevel checkSections(Validable validable,
 Integer currentSectionCount,
 int maximumSectionCount,
 ValidationLevel validationLevel,
 ReportNode reportNode)

checkSections

public static ValidationLevel checkSections(Validable validable,
 Integer currentSectionCount,
 int maximumSectionCount,
 boolean throwException,
 ReportNode reportNode)

checkRatedU

public static void checkRatedU(Validable validable,
 double ratedU,
 String num)

checkRatedU1

public static void checkRatedU1(Validable validable,
 double ratedU1)

checkRatedU2

public static void checkRatedU2(Validable validable,
 double ratedU2)

checkSvcRegulator

public static ValidationLevel checkSvcRegulator(Validable validable,
 double voltageSetpoint,
 double reactivePowerSetpoint,
 StaticVarCompensator.RegulationMode regulationMode,
 ValidationLevel validationLevel)

checkSvcRegulator

public static ValidationLevel checkSvcRegulator(Validable validable,
 double voltageSetpoint,
 double reactivePowerSetpoint,
 StaticVarCompensator.RegulationMode regulationMode,
 ValidationLevel validationLevel,
 ReportNode reportNode)

checkSvcRegulator

public static ValidationLevel checkSvcRegulator(Validable validable,
 double voltageSetpoint,
 double reactivePowerSetpoint,
 StaticVarCompensator.RegulationMode regulationMode,
 boolean throwException,
 ReportNode reportNode)

checkBmin

public static void checkBmin(Validable validable,
 double bMin)

checkBmax

public static void checkBmax(Validable validable,
 double bMax)

checkRatioTapChangerRegulation

public static ValidationLevel checkRatioTapChangerRegulation(Validable validable,
 boolean regulating,
 boolean loadTapChangingCapabilities,
 Terminal regulationTerminal,
 RatioTapChanger.RegulationMode regulationMode,
 double regulationValue,
 Network network,
 ValidationLevel validationLevel)

checkRatioTapChangerRegulation

public static ValidationLevel checkRatioTapChangerRegulation(Validable validable,
 boolean regulating,
 boolean loadTapChangingCapabilities,
 Terminal regulationTerminal,
 RatioTapChanger.RegulationMode regulationMode,
 double regulationValue,
 Network network,
 ValidationLevel validationLevel,
 ReportNode reportNode)

checkRatioTapChangerRegulation

public static ValidationLevel checkRatioTapChangerRegulation(Validable validable,
 boolean regulating,
 boolean loadTapChangingCapabilities,
 Terminal regulationTerminal,
 RatioTapChanger.RegulationMode regulationMode,
 double regulationValue,
 Network network,
 boolean throwException,
 ReportNode reportNode)

checkPhaseTapChangerRegulation

public static ValidationLevel checkPhaseTapChangerRegulation(Validable validable,
 PhaseTapChanger.RegulationMode regulationMode,
 double regulationValue,
 boolean regulating,
 Terminal regulationTerminal,
 Network network,
 boolean throwException)

checkPhaseTapChangerRegulation

public static ValidationLevel checkPhaseTapChangerRegulation(Validable validable,
 PhaseTapChanger.RegulationMode regulationMode,
 double regulationValue,
 boolean regulating,
 Terminal regulationTerminal,
 Network network,
 boolean throwException,
 ReportNode reportNode)

checkOnlyOneTapChangerRegulatingEnabled

public static ValidationLevel checkOnlyOneTapChangerRegulatingEnabled(Validable validable,
 Set<TapChanger<?,?,?,?>> tapChangersNotIncludingTheModified,
 boolean regulating,
 boolean throwException)

checkOnlyOneTapChangerRegulatingEnabled

public static ValidationLevel checkOnlyOneTapChangerRegulatingEnabled(Validable validable,
 Set<TapChanger<?,?,?,?>> tapChangersNotIncludingTheModified,
 boolean regulating,
 boolean throwException,
 ReportNode reportNode)

checkConvertersMode

public static ValidationLevel checkConvertersMode(Validable validable,
 HvdcLine.ConvertersMode converterMode,
 boolean throwException)

checkConvertersMode

public static ValidationLevel checkConvertersMode(Validable validable,
 HvdcLine.ConvertersMode converterMode,
 boolean throwException,
 ReportNode reportNode)

checkPowerFactor

public static void checkPowerFactor(Validable validable,
 double powerFactor)

checkConnected

public static void checkConnected(Validable validable,
 Boolean connected)

checkLoadingLimits

public static ValidationLevel checkLoadingLimits(Validable validable,
 double permanentLimit,
 Collection<LoadingLimits.TemporaryLimit> temporaryLimits,
 boolean throwException,
 ReportNode reportNode)

checkPermanentLimit

public static ValidationLevel checkPermanentLimit(Validable validable,
 double permanentLimit,
 Collection<LoadingLimits.TemporaryLimit> temporaryLimits,
 boolean throwException,
 ReportNode reportNode)

checkPermanentLimit

public static ValidationLevel checkPermanentLimit(Validable validable,
 double permanentLimit,
 Collection<LoadingLimits.TemporaryLimit> temporaryLimits,
 boolean throwException)

checkTemporaryLimits

public static void checkTemporaryLimits(Validable validable,
 double permanentLimit,
 Collection<LoadingLimits.TemporaryLimit> temporaryLimits)

checkLossFactor

public static void checkLossFactor(Validable validable,
 float lossFactor)

validate

public static ValidationLevel validate(Collection<Identifiable<?>> identifiables,
 boolean allChecks,
 boolean throwException,
 ValidationLevel previous,
 ReportNode reportNode)