com.interpss.dstab.algo

Interface IDynamicSimulation

All Superinterfaces:

org.eclipse.emf.ecore.EObject, org.eclipse.emf.common.notify.Notifier

All Known Subinterfaces:

BaseDStabBus<TGen,TLoad>, BaseDynLoadModel, DStabBus, DynamicBranchDevice, DynamicBusDevice, DynamicDevice, DynamicGenDevice, DynamicMachine, DynamicSimuAdapter, DynLoadModel, EConstMachine, Eq1Ed1Machine, Eq1Machine, HvdcLine2TVSCDyn, Machine, MachineController, RoundRotorMachine, SalientPoleMachine, ScriptDynamicBranchDevice, ScriptDynamicBusDevice, VSCConverterDyn, VSCConverterDynController

All Known Implementing Classes:

AbstractAnnotateController, AbstractChildAnnotateController, AbstractExciter, AbstractGovernor, AbstractStabilizer, AnnotateExciter, AnnotateGovernor, AnnotateStabilizer, BaseDStabBusImpl, BaseDynLoadModelImpl, DStabBusImpl, DynamicBranchDeviceImpl, DynamicBusDeviceImpl, DynamicDeviceImpl, DynamicMachineImpl, DynamicSimuAdapterImpl, DynLoadModelImpl, EConstMachineImpl, Eq1Ed1MachineImpl, Eq1MachineImpl, HvdcLine2TVSCDynImpl, MachineControllerImpl, MachineImpl, RoundRotorMachineImpl, SalientPoleMachineImpl, ScriptDynamicBranchDeviceImpl, ScriptDynamicBusDeviceImpl, VSCConverterDynControllerImpl, VSCConverterDynImpl

public interface IDynamicSimulation
extends org.eclipse.emf.ecore.EObject

A representation of the model object 'IDyamic Simulation'. Interface to define methods need to be implemented to perform dynamic simulation

See Also:

DstabAlgorithmPackage.getIDynamicSimulation()

Method Summary

Modifier and Type	Method and Description
boolean	afterStep(double dt) Different from "updateAttributes" that is used/called inside the network solution-integration step, this afterStep() is used after the network convergence for each step.
double	getOutput() Calculate the output of this controller from its states.
double	getOutput(Machine mach) Calculate the output of this controller from its states.
java.util.List<?>	getOutputList() return a list of controller output objects.
java.lang.Object	getOutputObject() Calculate the output of this controller from its states.
java.util.Hashtable<java.lang.String,java.lang.Object>	getStates(Machine mach, java.lang.Object ref) Return a Hashtable of all controller states for output purpose.
java.util.Hashtable<java.lang.String,java.lang.Object>	getStates(java.lang.Object ref) Return a Hashtable of all controller states for output purpose.
boolean	initStates() Initialize controller states.
boolean	initStates(BaseDStabBus<?,?> abus) Initialize controller states.
boolean	initStates(BaseDStabBus<?,?> abus, Machine mach) Initialize controller states.
boolean	nextStep(double dt, DynamicSimuMethod method, int flag) Calculate the controller's next step states x(t+1) = x(t) + dxdt * dt.
boolean	nextStep(double dt, DynamicSimuMethod method, Machine mach, int flag) Calculate the controller's next step states x(t+1) = x(t) + dxdt * dt.
boolean	nextStepElectrical(double dt, DynamicSimuMethod method, Network<?,?> net, int flag) Calculate the next step states x(t+1) = x(t) + dxdt * dt for the machine electrical equations.
boolean	nextStepMechanical(double dt, DynamicSimuMethod method, Network<?,?> net, int flag) Calculate the next step states x(t+1) = x(t) + dxdt * dt for the machine mechanical eqn.
boolean	updateAttributes(boolean netChange) When there is a dynamic event(s), the network will be solved before and after applying the event.

Methods inherited from interface org.eclipse.emf.ecore.EObject

eAllContents, eClass, eContainer, eContainingFeature, eContainmentFeature, eContents, eCrossReferences, eGet, eGet, eInvoke, eIsProxy, eIsSet, eResource, eSet, eUnset

Methods inherited from interface org.eclipse.emf.common.notify.Notifier

eAdapters, eDeliver, eNotify, eSetDeliver

Method Detail

initStates

boolean initStates()

Initialize controller states. This method is for controller init, where DStabBus is not needed.

initStates

boolean initStates(BaseDStabBus<?,?> abus)

Initialize controller states. It also calls all child controllers initStates methods.

initStates

boolean initStates(BaseDStabBus<?,?> abus,
                   Machine mach)

Initialize controller states. It also calls all child controllers initStates methods.

nextStep

boolean nextStep(double dt,
                 DynamicSimuMethod method,
                 int flag)

Calculate the controller's next step states x(t+1) = x(t) + dxdt * dt. All constraints, such as limits, should be applied. Return false if there is an error in the calculation

Parameters:

dt - the time step for solving the differential eqn.

nextStep

boolean nextStep(double dt,
                 DynamicSimuMethod method,
                 Machine mach,
                 int flag)

Calculate the controller's next step states x(t+1) = x(t) + dxdt * dt. All constraints, such as limits, should be applied. Return false if there is an error in the calculation

Parameters:

dt - the time step for solving the differential eqn.

nextStepMechanical

boolean nextStepMechanical(double dt,
                           DynamicSimuMethod method,
                           Network<?,?> net,
                           int flag)

Calculate the next step states x(t+1) = x(t) + dxdt * dt for the machine mechanical eqn.

nextStepElectrical

boolean nextStepElectrical(double dt,
                           DynamicSimuMethod method,
                           Network<?,?> net,
                           int flag)

Calculate the next step states x(t+1) = x(t) + dxdt * dt for the machine electrical equations.

getStates

java.util.Hashtable<java.lang.String,java.lang.Object> getStates(java.lang.Object ref)

Return a Hashtable of all controller states for output purpose.

getStates

java.util.Hashtable<java.lang.String,java.lang.Object> getStates(Machine mach,
                                                                 java.lang.Object ref)

Return a Hashtable of all controller states for output purpose.

getOutput

double getOutput()

Calculate the output of this controller from its states. This method is not applicable to the Machine object

getOutput

double getOutput(Machine mach)

Calculate the output of this controller from its states. This method is not applicable to the Machine object

getOutputObject

java.lang.Object getOutputObject()

Calculate the output of this controller from its states.

getOutputList

java.util.List<?> getOutputList()

return a list of controller output objects.

updateAttributes

boolean updateAttributes(boolean netChange)

When there is a dynamic event(s), the network will be solved before and after applying the event. imput to dynamic device, such as machine voltage, power, is adjusted using before and after network state.

afterStep

boolean afterStep(double dt)

Different from "updateAttributes" that is used/called inside the network solution-integration step, this afterStep() is used after the network convergence for each step. It is mainly used to model the voltage, frequency or internal state dependent protection and relays, such as the thermal protection in motors, fault-ride-through behaviors in DERs or IBRs

Parameters:

dt -

Returns: