com.interpss.dstab.mach

Interface Machine

All Superinterfaces:

com.hazelcast.nio.serialization.DataSerializable, DynamicBusDevice, DynamicDevice, DynamicGenDevice, org.eclipse.emf.ecore.EObject, IDynamicSimulation, NameTag, org.eclipse.emf.common.notify.Notifier

All Known Subinterfaces:

DynamicMachine, EConstMachine, Eq1Ed1Machine, Eq1Machine, RoundRotorMachine, SalientPoleMachine

All Known Implementing Classes:

DynamicMachineImpl, EConstMachineImpl, Eq1Ed1MachineImpl, Eq1MachineImpl, MachineImpl, RoundRotorMachineImpl, SalientPoleMachineImpl

public interface Machine
extends DynamicGenDevice

A representation of the model object 'Machine Adapter'. Machine object adapter to adapt the generic MachineData object to a type specific object. It is a DynamicBusDevice with dynamic behavior implemented. Also it has a list of machine controllers for Exc, Gov and PSS model.

The following features are supported:

• Mach Type
• Speed
• Angle
• Efd
• Pm
• Pe
• QGen
• FG
• Parent Gen
• Mach Data
• Controller List
• Pe Neg Seq

See Also:

DstabMachPackage.getMachine()

Method Summary

Modifier and Type	Method and Description
double	calculateIfd(MachineIfdBase base) calculate machine Ifd
void	calMultiFactors() Set V, I and Z multi factors.
double	getAngle() Returns the value of the 'Angle' attribute.
org.eclipse.emf.common.util.EList<MachineController>	getControllerList() Returns the value of the 'Controller List' containment reference list.
double	getD() get machine paramter Damping
double	getEfd() Returns the value of the 'Efd' attribute.
MachineController	getExciter() get machine exciter
Matrix_xy	getFG() Returns the value of the 'FG' attribute.
MachineController	getGovernor() get machine governor
BusScGrounding	getGrounding() get machine grounding data object
double	getH() get machine paramter H
Vector_dq	getIdq() get Machine Idq
org.apache.commons.math3.complex.Complex	getIgen() Machine equivalent current on system base
double	getIMultiFactor() A multiplying factors to transfer I from machine base to system base
Vector_dq	getInitIdq() calculate and return Machine Idq for machine state initialization.
org.apache.commons.math3.complex.Complex	getIxy() get Machine stator current in system xy coordinate
MachineData	getMachData() Returns the value of the 'Mach Data' containment reference.
MachineModelType	getMachType() Returns the value of the 'Mach Type' attribute.
double	getPe_NegSeq() Returns the value of the 'Pe Neg Seq' attribute.
double	getPe() Returns the value of the 'Pe' attribute.
double	getPm() Returns the value of the 'Pm' attribute.
int	getPoles() get machine number of poles
double	getQGen() Returns the value of the 'QGen' attribute.
double	getRa() get machine paramter Ra
double	getRatedVoltage() get Machine rated voltage in volts
double	getRatedVoltage(Unit.UnitType unit) get Machine rated voltage in the unit specified
double	getRating() get machine rating.
double	getRating(Unit.UnitType unit, double baseKva) get machine rating in the unit specified.
double	getSpeed() Returns the value of the 'Speed' attribute.
MachineController	getStabilizer() get machine stabilizer
Vector_dq	getVdq() get Machine Vdq
double	getVMultiFactor() A multiplying factors to transfer V from machine base to system base
double	getX0() get machine paramter X0
double	getX2() get machine paramter X2
org.apache.commons.math3.complex.Complex	getYgen() Machine equivalent Y on system base
double	getZMultiFactor() A multiplying factors to transfer Z from machine base to system base
boolean	hasExciter() check if the machine has exciter
boolean	hasGovernor() check if the machine has governor
boolean	hasStabilizer() check if the machine has stabilizer
void	setAngle(double value) Sets the value of the 'Angle' attribute.
void	setBusAcscInfo() transfer machine data as AcscBus info to the parent DStabBus
void	setD(double d) set machine paramter Damping
void	setEfd(double value) Sets the value of the 'Efd' attribute.
void	setFG(Matrix_xy value) Sets the value of the 'FG' attribute.
void	setH(double m) set machine paramter H
void	setMachData(MachineData value) Sets the value of the 'Mach Data' containment reference.
void	setMachType(MachineModelType value) Sets the value of the 'Mach Type' attribute.
void	setPe_NegSeq(double value) Sets the value of the 'Pe Neg Seq' attribute.
void	setPe(double value) Sets the value of the 'Pe' attribute.
void	setPm(double value) Sets the value of the 'Pm' attribute.
void	setPoles(int s) set machine number of poles
void	setQGen(double value) Sets the value of the 'QGen' attribute.
void	setRa(double r) set machine paramter Ra
void	setRatedVoltage(double v) set Machine rated voltage in volts
void	setRatedVoltage(double v, Unit.UnitType unit) set Machine rated voltage in the unit specified
void	setRating(double r, Unit.UnitType unit, double baseKva) set machine rating in the unit specified.
void	setSpeed(double value) Sets the value of the 'Speed' attribute.
void	setX0(double x0) set machine paramter X0
void	setX2(double x2) set machine paramter X2

Methods inherited from interface com.interpss.dstab.device.DynamicGenDevice

getParentGen, setParentGen

Methods inherited from interface com.interpss.dstab.device.DynamicBusDevice

getDeviceType, getDStabBus, setDeviceType, setDStabBus

Methods inherited from interface com.interpss.dstab.device.DynamicDevice

getExtendedDeviceId, getScripts, setExtendedDeviceId, setScripts

Methods inherited from interface com.interpss.core.net.NameTag

checkData, checkData, getDesc, getId, getName, getNumber, getStatusChangeInfo, hzCopy, isActive, isStatus, jsonCopy, setDesc, setId, setName, setNumber, setStatus, setStatusChangeInfo

Methods inherited from interface com.hazelcast.nio.serialization.DataSerializable

readData, writeData

Methods inherited from interface com.interpss.dstab.algo.IDynamicSimulation

afterStep, getOutput, getOutput, getOutputList, getOutputObject, getStates, getStates, initStates, initStates, initStates, nextStep, nextStep, nextStepElectrical, nextStepMechanical, updateAttributes

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

getMachType

MachineModelType getMachType()

Returns the value of the 'Mach Type' attribute. The default value is "EConstant". The literals are from the enumeration MachineModelType.

If the meaning of the 'Mach Type' attribute isn't clear, there really should be more of a description here...

machine type

Returns:

the value of the 'Mach Type' attribute.

See Also:

MachineModelType, setMachType(MachineModelType), DstabMachPackage.getMachine_MachType()

setMachType

void setMachType(MachineModelType value)

Sets the value of the 'Mach Type' attribute.

Parameters:

value - the new value of the 'Mach Type' attribute.

See Also:

MachineModelType, getMachType()

getSpeed

double getSpeed()

Returns the value of the 'Speed' attribute.

If the meaning of the 'Speed' attribute isn't clear, there really should be more of a description here...

Generator Speed in pu

Returns:

the value of the 'Speed' attribute.

See Also:

setSpeed(double), DstabMachPackage.getMachine_Speed()

setSpeed

void setSpeed(double value)

Sets the value of the 'Speed' attribute.

Parameters:

value - the new value of the 'Speed' attribute.

See Also:

getSpeed()

getAngle

double getAngle()

Returns the value of the 'Angle' attribute.

If the meaning of the 'Angle' attribute isn't clear, there really should be more of a description here...

machine angle in pu

Returns:

the value of the 'Angle' attribute.

See Also:

setAngle(double), DstabMachPackage.getMachine_Angle()

setAngle

void setAngle(double value)

Sets the value of the 'Angle' attribute.

Parameters:

value - the new value of the 'Angle' attribute.

See Also:

getAngle()

getEfd

double getEfd()

Returns the value of the 'Efd' attribute.

If the meaning of the 'Efd' attribute isn't clear, there really should be more of a description here...

machine excitation emf in pu

Returns:

the value of the 'Efd' attribute.

See Also:

setEfd(double), DstabMachPackage.getMachine_Efd()

setEfd

void setEfd(double value)

Sets the value of the 'Efd' attribute.

Parameters:

value - the new value of the 'Efd' attribute.

See Also:

getEfd()

getPm

double getPm()

Returns the value of the 'Pm' attribute.

If the meaning of the 'Pm' attribute isn't clear, there really should be more of a description here...

machine mechanical power in pu

Returns:

the value of the 'Pm' attribute.

See Also:

setPm(double), DstabMachPackage.getMachine_Pm()

setPm

void setPm(double value)

Sets the value of the 'Pm' attribute.

Parameters:

value - the new value of the 'Pm' attribute.

See Also:

getPm()

getMachData

MachineData getMachData()

Returns the value of the 'Mach Data' containment reference.

If the meaning of the 'Mach Data' containment reference isn't clear, there really should be more of a description here...

reference to the machine data object

Returns:

the value of the 'Mach Data' containment reference.

See Also:

setMachData(MachineData), DstabMachPackage.getMachine_MachData()

setMachData

void setMachData(MachineData value)

Sets the value of the 'Mach Data' containment reference.

Parameters:

value - the new value of the 'Mach Data' containment reference.

See Also:

getMachData()

getControllerList

org.eclipse.emf.common.util.EList<MachineController> getControllerList()

Returns the value of the 'Controller List' containment reference list. The list contents are of type MachineController. It is bidirectional and its opposite is 'Machine'.

If the meaning of the 'Controller List' containment reference list isn't clear, there really should be more of a description here...

machine controller list, such as exc, gov, pss

Returns:

the value of the 'Controller List' containment reference list.

See Also:

DstabMachPackage.getMachine_ControllerList(), MachineController.getMachine()

getRating

double getRating()

get machine rating. Machine rating in PU based on system BaseKva. All machine parameters are based on the machine rating

getRating

double getRating(Unit.UnitType unit,
                 double baseKva)

get machine rating in the unit specified. Machine rating in PU based on system BaseKva. All machine parameters are based on the machine rating

setRating

void setRating(double r,
               Unit.UnitType unit,
               double baseKva)

set machine rating in the unit specified.

getRatedVoltage

double getRatedVoltage()

get Machine rated voltage in volts

getRatedVoltage

double getRatedVoltage(Unit.UnitType unit)

get Machine rated voltage in the unit specified

setRatedVoltage

void setRatedVoltage(double v,
                     Unit.UnitType unit)

set Machine rated voltage in the unit specified

setRatedVoltage

void setRatedVoltage(double v)

set Machine rated voltage in volts

getPoles

int getPoles()

get machine number of poles

setPoles

void setPoles(int s)

set machine number of poles

getZMultiFactor

double getZMultiFactor()

A multiplying factors to transfer Z from machine base to system base

getIMultiFactor

double getIMultiFactor()

A multiplying factors to transfer I from machine base to system base

getVMultiFactor

double getVMultiFactor()

A multiplying factors to transfer V from machine base to system base

calMultiFactors

void calMultiFactors()

Set V, I and Z multi factors. It has to be called after the rating and rated voltage have been set.

getH

double getH()

get machine paramter H

setH

void setH(double m)

set machine paramter H

getD

double getD()

get machine paramter Damping

setD

void setD(double d)

set machine paramter Damping

getX0

double getX0()

get machine paramter X0

setX0

void setX0(double x0)

set machine paramter X0

getX2

double getX2()

get machine paramter X2

setX2

void setX2(double x2)

set machine paramter X2

getRa

double getRa()

get machine paramter Ra

setRa

void setRa(double r)

set machine paramter Ra

getGrounding

BusScGrounding getGrounding()

get machine grounding data object

calculateIfd

double calculateIfd(MachineIfdBase base)

calculate machine Ifd

hasExciter

boolean hasExciter()

check if the machine has exciter

getExciter

MachineController getExciter()

get machine exciter

hasStabilizer

boolean hasStabilizer()

check if the machine has stabilizer

getStabilizer

MachineController getStabilizer()

get machine stabilizer

hasGovernor

boolean hasGovernor()

check if the machine has governor

getGovernor

MachineController getGovernor()

get machine governor

getIdq

Vector_dq getIdq()

get Machine Idq

getIxy

org.apache.commons.math3.complex.Complex getIxy()

get Machine stator current in system xy coordinate

getInitIdq

Vector_dq getInitIdq()

calculate and return Machine Idq for machine state initialization.

getPe

double getPe()

Returns the value of the 'Pe' attribute. machine electric power in pu

Returns:

the value of the 'Pe' attribute.

See Also:

setPe(double), DstabMachPackage.getMachine_Pe()

setPe

void setPe(double value)

Sets the value of the 'Pe' attribute.

Parameters:

value - the new value of the 'Pe' attribute.

See Also:

getPe()

getPe_NegSeq

double getPe_NegSeq()

Returns the value of the 'Pe Neg Seq' attribute. machine electric power in pu

Returns:

the value of the 'Pe Neg Seq' attribute.

See Also:

setPe_NegSeq(double), DstabMachPackage.getMachine_Pe_NegSeq()

setPe_NegSeq

void setPe_NegSeq(double value)

Sets the value of the 'Pe Neg Seq' attribute.

Parameters:

value - the new value of the 'Pe Neg Seq' attribute.

See Also:

getPe_NegSeq()

getQGen

double getQGen()

Returns the value of the 'QGen' attribute. machine terminal q

Returns:

the value of the 'QGen' attribute.

See Also:

setQGen(double), DstabMachPackage.getMachine_QGen()

setQGen

void setQGen(double value)

Sets the value of the 'QGen' attribute.

Parameters:

value - the new value of the 'QGen' attribute.

See Also:

getQGen()

getFG

Matrix_xy getFG()

Returns the value of the 'FG' attribute. for storing Fx, Fy, Gx, Gy for implicit intgration implementation

Returns:

the value of the 'FG' attribute.

See Also:

setFG(Matrix_xy), DstabMachPackage.getMachine_FG()

setFG

void setFG(Matrix_xy value)

Sets the value of the 'FG' attribute.

Parameters:

value - the new value of the 'FG' attribute.

See Also:

getFG()

getVdq

Vector_dq getVdq()

get Machine Vdq

setBusAcscInfo

void setBusAcscInfo()

transfer machine data as AcscBus info to the parent DStabBus

getIgen

org.apache.commons.math3.complex.Complex getIgen()

Machine equivalent current on system base

getYgen

org.apache.commons.math3.complex.Complex getYgen()

Machine equivalent Y on system base