Interface TapChanger<C extends TapChanger<C,S,R,A>,S extends TapChangerStep<S>,R extends TapChangerStepsReplacer<R,A>,A extends TapChangerStepAdder<A,R>>

All Known Subinterfaces:
PhaseTapChanger, RatioTapChanger

public interface TapChanger<C extends TapChanger<C,S,R,A>,S extends TapChangerStep<S>,R extends TapChangerStepsReplacer<R,A>,A extends TapChangerStepAdder<A,R>>
Author:
Geoffroy Jamgotchian <geoffroy.jamgotchian at rte-france.com>
  • Method Details

    • getLowTapPosition

      int getLowTapPosition()
      Get the lowest tap position corresponding to the first step of the tap changer.
    • setLowTapPosition

      C setLowTapPosition(int lowTapPosition)
      Set the lowest tap position corresponding to the first step of the tap changer.
    • getHighTapPosition

      int getHighTapPosition()
      Get the highest tap position corresponding to the last step of the tap changer.
    • getTapPosition

      int getTapPosition()
      Get the current tap position.

      Depends on the working variant.

      See Also:
    • findTapPosition

      default OptionalInt findTapPosition()
      Get an optional containing the current tap position if it is defined. Otherwise, get an empty optional.

      Depends on the working variant.

      See Also:
    • setTapPosition

      C setTapPosition(int tapPosition)
      Set the current tap position.

      It is expected to be contained between the lowest and the highest tap position.

      Depends on the working variant.

      Parameters:
      tapPosition - the current tap position
      See Also:
    • unsetTapPosition

      default C unsetTapPosition()
      Unset the current tap position: tap position is now undefined. Note: this can be done only in SCADA validation level.
    • getStepCount

      int getStepCount()
      Get the number of steps.
    • getStep

      S getStep(int tapPosition)
      Get a step.
      Parameters:
      tapPosition - position of the tap
      Returns:
      the step
    • stepsReplacer

      R stepsReplacer()
      Return a replacer that allow to replace the whole step list.
    • getCurrentStep

      S getCurrentStep()
      Get the current step.

      Depends on the working variant.

      See Also:
    • getNeutralPosition

      default OptionalInt getNeutralPosition()
      Get the position of the neutral step (rho = 1, alpha = 0) if it exists. Otherwise return an empty optional.
    • getNeutralStep

      default Optional<S> getNeutralStep()
      Get the neutral step (rho = 1, alpha = 0) if it exists. Otherwise return an empty optional.
    • isRegulating

      boolean isRegulating()
      Get the regulating status.

      Depends on the working variant.

      See Also:
    • setRegulating

      C setRegulating(boolean regulating)
      Set the regulating status.

      Depends on the working variant.

      See Also:
    • getRegulationTerminal

      Terminal getRegulationTerminal()
      Get the terminal used for regulation.
    • setRegulationTerminal

      C setRegulationTerminal(Terminal regulationTerminal)
      Set the terminal used for regulation.
    • getTargetDeadband

      default double getTargetDeadband()
      Get the tap changer's deadband (in kV) used to avoid excessive update of discrete control while regulating. This attribute is necessary only if the tap changer is regulating.

      Depends on the working variant.

      See Also:
    • setTargetDeadband

      default C setTargetDeadband(double targetDeadband)
      Set the tap changer's deadband (in kV) used to avoid excessive update of discrete control while regulating. This attribute is necessary only if the tap changer is regulating. It must be positive.

      Depends on the working variant.

      See Also:
    • remove

      void remove()
      Remove the tap changer.
    • getAllSteps

      default Map<Integer,S> getAllSteps()
      Get all Tap changer steps