com.interpss.dstab

Class DStabObjectFactory

java.lang.Object

com.interpss.dstab.DStabObjectFactory

public class DStabObjectFactory
extends java.lang.Object

Factory methods for create dynamic simulation object

Constructor Summary

Constructors

Constructor and Description
DStabObjectFactory()

Method Summary

Modifier and Type	Method and Description
static BranchOutageEvent	createBranchOutageEvent(java.lang.String branchId, BaseDStabNetwork<?,?> net) Create a Branch Outage event object
static DynamicSimuEvent	createBranchReclosureEvent(BaseDStabNetwork<?,?> net, DStabBranchFault fault, java.lang.String eventId, java.lang.String eventName) Create a reclosure object and add it to the net object
static DynamicSimuEvent	createBusFaultEvent(java.lang.String faultBusId, BaseDStabNetwork<?,?> net, SimpleFaultCode code, org.apache.commons.math3.complex.Complex zlg, org.apache.commons.math3.complex.Complex zll, double startTime, double durationTime) create a dynamic bus fault event
static DynamicSimuEvent	createBusFaultEvent(java.lang.String faultBusId, BaseDStabNetwork<?,?> net, SimpleFaultCode code, double startTime, double durationTime) create a dynamic bus fault event with zero ZLG and ZLL
static ICMLControlBlock	createBusFreqMeasurement() Create a BusFreqMeasurement object
static MachineController	createController(java.lang.String id, java.lang.String name, Machine machine) Create a Controller object
static DynamicSimuEvent	createDEvent(java.lang.String eventId, java.lang.String eventName, DynamicSimuEventType type, BaseDStabNetwork<?,?> net) Create a DynamicEvent object of the type
static Branch	createDStab3WBranch()
static DStabBranch	createDStabBranch() Create a DStabBranch object
static DStabBranch	createDStabBranch(java.lang.String fromId, java.lang.String toId, BaseDStabNetwork net) Create a DStabBranch object and then added into the network
static DStabBranchFault	createDStabBranchFault(BaseDStabNetwork<?,?> net, java.lang.String fromBusId, java.lang.String toBusId, SimpleFaultCode type, double distance, double rLG, double xLG, double rLL, double xLL, boolean reclosure, double reclosureTime) Create a DStabBranchFault object and add it to the DStabilityNetwork object
static DStabBranchFault	createDStabBranchFault(java.lang.String id) Create a DStabBranchFault object
static DStabBus	createDStabBus() Create a DStabBus object
static java.util.Optional<BaseDStabBus<?,?>>	createDStabBus(java.lang.String busId, BaseDStabNetwork net) Create a DStabBus object
static DStabGen	createDStabGen() Create a DStabGen object
static DStabGen	createDStabGen(java.lang.String id) Create a DStabGen object
static DStabilityNetwork	createDStabilityNetwork() Create a DStabilityNetwork object
static DStabLoad	createDStabLoad() Create a DStabLoad object
static DStabLoad	createDStabLoad(java.lang.String id) Create a DStabLoad object
static DynamicSimuAlgorithm	createDynamicSimuAlgorithm() Create a DynamicSimuAlgorithm object
static DynamicSimuAlgorithm	createDynamicSimuAlgorithm(BaseDStabNetwork<?,?> net, IDStabSimuDatabaseOutputHandler dbOutputHandler, IPSSMsgHub msg) Create a DynamicSimuAlgorithm object
static DynamicSimuAlgorithm	createDynamicSimuAlgorithm(BaseDStabNetwork<?,?> net, IPSSMsgHub msg) Create a DynamicSimuAlgorithm object
static DynamicSimuAlgorithm	createDynamicSimuAlgorithm(IPSSMsgHub msg) Create a DynamicSimuAlgorithm object
static DynamicSimuEvent	createGeneratorEnergizationEvent(java.lang.String busId, java.lang.String genId, BaseDStabNetwork net, double startTime)
static DynamicSimuEvent	createGeneratorTripEvent(java.lang.String busId, java.lang.String genId, BaseDStabNetwork net, double startTime)
static EConstMachine	createInfiniteMachine(java.lang.String machId, java.lang.String machName, BaseDStabNetwork<?,?> net, java.lang.String busId, java.lang.String genId) Create an Infinite Machine of type EConstMachine
static EConstMachine	createInfiniteMachine(java.lang.String machId, java.lang.String machName, org.apache.commons.math3.complex.Complex z1, org.apache.commons.math3.complex.Complex z0, BaseDStabNetwork<?,?> net, java.lang.String busId, java.lang.String genId) Create an Infinite Machine of type EConstMachine
static LoadChangeEvent	createLoadChangeEvent(java.lang.String busId, BaseDStabNetwork<?,?> net) Create a load change event object
static DynamicSimuEvent	createLoadChangeEvent(java.lang.String busId, BaseDStabNetwork<?,?> net, LoadChangeEventType type, double changeFraction, double startTimeOrThreshold)
static Machine	createMachine(MachineModelType type) Create a Machine object of the type
static Machine	createMachine(java.lang.String machId, java.lang.String machName, MachineModelType type) Create a Machine object of the type
static Machine	createMachine(java.lang.String machId, java.lang.String machName, MachineModelType type, BaseDStabNetwork<?,?> net, java.lang.String busId, java.lang.String genId) Create a Machine object of the type
static MachineData	createMachineData() Create a MachineDate object
static SetPointChangeEvent	createSetPointChangeEvent(java.lang.String machId, BaseDStabNetwork<?,?> net) Create a set point change event object
static ICMLFieldObjectFactory	getFieldObjectFactory() Object factory to create CML control blocks.

Methods inherited from class java.lang.Object

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

Constructor Detail

DStabObjectFactory

public DStabObjectFactory()

Method Detail

getFieldObjectFactory

public static ICMLFieldObjectFactory getFieldObjectFactory()

Object factory to create CML control blocks. Spring config is defined in coreLibContext.xml The default impl is at ipss.plugin CMLFieldObjectFactoryImpl.java

Returns:

the factory object

createDStabilityNetwork

public static DStabilityNetwork createDStabilityNetwork()

Create a DStabilityNetwork object

Returns:

a DStabilityNetwork object

createDStabGen

public static DStabGen createDStabGen()

Create a DStabGen object

Returns:

a DStabGen object

createDStabGen

public static DStabGen createDStabGen(java.lang.String id)

Create a DStabGen object

Returns:

a DStabGen object

createDStabLoad

public static DStabLoad createDStabLoad()

Create a DStabLoad object

Returns:

a DStabLoad object

createDStabLoad

public static DStabLoad createDStabLoad(java.lang.String id)

Create a DStabLoad object

Returns:

a DStabLoad object

createDStabBus

public static DStabBus createDStabBus()

Create a DStabBus object

Returns:

a DStabBus object

createBusFreqMeasurement

public static ICMLControlBlock createBusFreqMeasurement()

Create a BusFreqMeasurement object

Returns:

a BusFreqMeasurement object

createDStabBus

public static java.util.Optional<BaseDStabBus<?,?>> createDStabBus(java.lang.String busId,
                                                                   BaseDStabNetwork net)

Create a DStabBus object

Parameters:

busId - bus id

Returns:

a DStabBus object

createDStabBranch

public static DStabBranch createDStabBranch()

Create a DStabBranch object

Returns:

a DStabBranch object

createDStab3WBranch

public static Branch createDStab3WBranch()

createDStabBranch

public static DStabBranch createDStabBranch(java.lang.String fromId,
                                            java.lang.String toId,
                                            BaseDStabNetwork net)
                                     throws InterpssException

Create a DStabBranch object and then added into the network

Returns:

a DStabBranch object

Throws:

InterpssException

createInfiniteMachine

public static EConstMachine createInfiniteMachine(java.lang.String machId,
                                                  java.lang.String machName,
                                                  BaseDStabNetwork<?,?> net,
                                                  java.lang.String busId,
                                                  java.lang.String genId)
                                           throws InterpssException

Create an Infinite Machine of type EConstMachine

Parameters:

machId - machine id. It have to be unique

machName - machine name

net - DStability network object

busId - bus id the machine attached to

genId - on the bus the machine attached to

Returns:

a Machine object

Throws:

InterpssException

createInfiniteMachine

public static EConstMachine createInfiniteMachine(java.lang.String machId,
                                                  java.lang.String machName,
                                                  org.apache.commons.math3.complex.Complex z1,
                                                  org.apache.commons.math3.complex.Complex z0,
                                                  BaseDStabNetwork<?,?> net,
                                                  java.lang.String busId,
                                                  java.lang.String genId)
                                           throws InterpssException

Create an Infinite Machine of type EConstMachine

Parameters:

machId - machine id. It have to be unique

machName - machine name

net - DStability network object

genId - on the bus the machine attached to

Returns:

a Machine object

Throws:

InterpssException

createMachineData

public static MachineData createMachineData()

Create a MachineDate object

Returns:

createMachine

public static Machine createMachine(java.lang.String machId,
                                    java.lang.String machName,
                                    MachineModelType type,
                                    BaseDStabNetwork<?,?> net,
                                    java.lang.String busId,
                                    java.lang.String genId)
                             throws InterpssException

Create a Machine object of the type

Parameters:

machId - machine id. It have to be unique

machName - machine name

type - machine simulation model type

net - DStability network object

busId - bus id the machine attached to

genId - gen id on the bus, the machine attached to

Returns:

a Machine object

Throws:

InterpssException

createMachine

public static Machine createMachine(MachineModelType type)

Create a Machine object of the type

Parameters:

type - machine simulation model type

Returns:

a Machine object

createMachine

public static Machine createMachine(java.lang.String machId,
                                    java.lang.String machName,
                                    MachineModelType type)

Create a Machine object of the type

Parameters:

machId - machine id. It have to be unique

machName - machine name

type - machine simulation model type

Returns:

a Machine object

createDEvent

public static DynamicSimuEvent createDEvent(java.lang.String eventId,
                                            java.lang.String eventName,
                                            DynamicSimuEventType type,
                                            BaseDStabNetwork<?,?> net)

Create a DynamicEvent object of the type

Parameters:

eventId - event id. It have to be unique

eventName - event name

type - envet type

net - DStability network object

Returns:

a dynamic event object

createLoadChangeEvent

public static LoadChangeEvent createLoadChangeEvent(java.lang.String busId,
                                                    BaseDStabNetwork<?,?> net)

Create a load change event object

Parameters:

busId -

net -

Returns:

createLoadChangeEvent

public static DynamicSimuEvent createLoadChangeEvent(java.lang.String busId,
                                                     BaseDStabNetwork<?,?> net,
                                                     LoadChangeEventType type,
                                                     double changeFraction,
                                                     double startTimeOrThreshold)

createSetPointChangeEvent

public static SetPointChangeEvent createSetPointChangeEvent(java.lang.String machId,
                                                            BaseDStabNetwork<?,?> net)

Create a set point change event object

Parameters:

machId -

net -

Returns:

createController

public static MachineController createController(java.lang.String id,
                                                 java.lang.String name,
                                                 Machine machine)

Create a Controller object

Parameters:

id - controller id. It have to be unique

name - controler name

machine - machine object the governor attached to

Returns:

a Controller object

createDynamicSimuAlgorithm

public static DynamicSimuAlgorithm createDynamicSimuAlgorithm()

Create a DynamicSimuAlgorithm object

Returns:

a DynamicSimuAlgorithm object

createDynamicSimuAlgorithm

public static DynamicSimuAlgorithm createDynamicSimuAlgorithm(IPSSMsgHub msg)

Create a DynamicSimuAlgorithm object

Parameters:

msg -

Returns:

a DynamicSimuAlgorithm object

createDynamicSimuAlgorithm

public static DynamicSimuAlgorithm createDynamicSimuAlgorithm(BaseDStabNetwork<?,?> net,
                                                              IPSSMsgHub msg)

Create a DynamicSimuAlgorithm object

Parameters:

net - a DStabilityNetwork object

msg -

Returns:

a DynamicSimuAlgorithm object

createDynamicSimuAlgorithm

public static DynamicSimuAlgorithm createDynamicSimuAlgorithm(BaseDStabNetwork<?,?> net,
                                                              IDStabSimuDatabaseOutputHandler dbOutputHandler,
                                                              IPSSMsgHub msg)

Create a DynamicSimuAlgorithm object

Parameters:

net - a DStabilityNetwork object

dbOutputHandler - db output handler

msg -

Returns:

a DynamicSimuAlgorithm object

createDStabBranchFault

public static DStabBranchFault createDStabBranchFault(java.lang.String id)

Create a DStabBranchFault object

Returns:

a DStabBranchFault object

createDStabBranchFault

public static DStabBranchFault createDStabBranchFault(BaseDStabNetwork<?,?> net,
                                                      java.lang.String fromBusId,
                                                      java.lang.String toBusId,
                                                      SimpleFaultCode type,
                                                      double distance,
                                                      double rLG,
                                                      double xLG,
                                                      double rLL,
                                                      double xLL,
                                                      boolean reclosure,
                                                      double reclosureTime)

Create a DStabBranchFault object and add it to the DStabilityNetwork object

Parameters:

net - the DStabilityNetwork object

fromBusId - branch from bus id

toBusId - branch to bus id

type - fault type

distance - fault distance in pu from the FromBus

rLG - Line-ground r

xLG - Line-ground x

rLL - Line-line r

xLL - Line-line x

reclosure -

reclosureTime -

Returns:

a DStabBranchFault object

createBranchOutageEvent

public static BranchOutageEvent createBranchOutageEvent(java.lang.String branchId,
                                                        BaseDStabNetwork<?,?> net)

Create a Branch Outage event object

Parameters:

branchId - branch id

net - the network object

Returns:

the BranchOutageEvent object

createBranchReclosureEvent

public static DynamicSimuEvent createBranchReclosureEvent(BaseDStabNetwork<?,?> net,
                                                          DStabBranchFault fault,
                                                          java.lang.String eventId,
                                                          java.lang.String eventName)

Create a reclosure object and add it to the net object

Parameters:

net - the DStabilityNetwork object

fault - the original branch fault object

eventId - event id

eventName - event name

Returns:

the created event object

createBusFaultEvent

public static DynamicSimuEvent createBusFaultEvent(java.lang.String faultBusId,
                                                   BaseDStabNetwork<?,?> net,
                                                   SimpleFaultCode code,
                                                   double startTime,
                                                   double durationTime)

create a dynamic bus fault event with zero ZLG and ZLL

Parameters:

faultBusId -

net -

code - it can be 3P, LG, LL_G, LL

startTime - fault starting time in s

durationTime - fault duration time in s

Returns:

createBusFaultEvent

public static DynamicSimuEvent createBusFaultEvent(java.lang.String faultBusId,
                                                   BaseDStabNetwork<?,?> net,
                                                   SimpleFaultCode code,
                                                   org.apache.commons.math3.complex.Complex zlg,
                                                   org.apache.commons.math3.complex.Complex zll,
                                                   double startTime,
                                                   double durationTime)

create a dynamic bus fault event

Parameters:

faultBusId -

net -

code - it can be 3P, LG, LL_G, LL

zlg - the line to ground fault impedance, used in LG and LLG type of faults

zll - the line to line fault impedance, used in LL and LLG type of faults

startTime - fault starting time in s

durationTime - fault duration time in s

Returns:

createGeneratorTripEvent

public static DynamicSimuEvent createGeneratorTripEvent(java.lang.String busId,
                                                        java.lang.String genId,
                                                        BaseDStabNetwork net,
                                                        double startTime)

createGeneratorEnergizationEvent

public static DynamicSimuEvent createGeneratorEnergizationEvent(java.lang.String busId,
                                                                java.lang.String genId,
                                                                BaseDStabNetwork net,
                                                                double startTime)