TypSym attributesPowerFactory Synchronous Machine Type

Every attribute of the PowerFactory Synchronous Machine Type (TypSym): 148 input parameters, with units and meaning. Copy a name into GetAttribute or SetAttribute.

What TypSym is

A synchronous machine type: rated power and voltage, power factor, the synchronous, transient and subtransient reactances and time constants, and the inertia H.

Class: TypSym, type class
PowerFactory name: Synchronous Machine Type
Used by: ElmSym
Attributes: 148 input parameters

Most used TypSym attributes

Attribute	Unit	Description	Where
`sgn`	MVA	Rated apparent power	input data
`ugn`	kV	Rated voltage	input data
`cosn`	·	Rated power factor	input data
`xd`	p.u.	xd	input data
`xq`	p.u.	xq	input data
`xds`	p.u.	xd'	input data
`xdss`	p.u.	xd''	input data
`tds`	s	Td'	input data
`tdss`	s	Td''	input data
`h`	s	Inertia constant H (rated to Sgn)inertia constant	input data
`xl`	p.u.	xl	input data
`rstr`	p.u.	rstr	input data

Read and write TypSym in Python

import powerfactory

app = powerfactory.GetApplication()          # GetApplicationExt() from outside PowerFactory

# Types live in the equipment library of the project.
types = app.GetProjectFolder("equip").GetContents("*.TypSym", 1)
for typ in types:
    print(typ.loc_name, typ.GetAttribute("sgn"))  # Rated apparent power, MVA

# An element points to its type with typ_id; t: reads a type value through the element.
for gen in app.GetCalcRelevantObjects("*.ElmSym"):
    print(gen.loc_name, gen.typ_id.loc_name, gen.GetAttribute("t:sgn"))

types[0].SetAttribute("h", 4.5)               # inertia constant 4.5 s: every element of this type changes

An input parameter is read and written with or without its e: prefix: GetAttribute("outserv") and GetAttribute("e:outserv") give the same value.
A type is shared: a change to it changes every element that uses it. Read a type value through an element with the t: prefix.

Input parameters148

TypSym input parameters

The element data, as typed in GetAttribute and SetAttribute (the e: prefix is optional). Setting one changes the model.

Attribute	Unit	Description
`loc_name`	·	Name
`chr_name`	·	Characteristic Name
`for_name`	·	Foreign Key
`dat_src`	·	Data source
`model_inp`	·	Model
`manuf`	·	Manufacturer
`appr_modby`	·	Modified by
`iner_inp`	·	Input mode
`i_condenser`	·	Used as condenser
`iTdcManual`	·	Enter Tdc manually
`iamort`	·	with amortisseur windings
`iusesat`	·	Use saturated value
`satur`	·	Machine type IEC909/IEC60909
`iturbo`	·	Rotor type
`iuseXdk`	·	Ik" instead of reactances
`nphase`	·	No. of phases
`nslty`	·	Connection
`i_trans`	·	Use frequency transfer functions
`i_xl`	·	xl is current dependent
`iopt_data`	·	Input parameters
`appr_status`	·	Status
`i_speedD`	·	Speed deviation based on
`polepairs`	·	No. of pole pairs
`isat`	·	Main flux saturation
`isatSalient`	·	Saturation
`i_extModel`	·	Model
`i_exactConv`	·	Exact conversion of time constants
`i_xme2`	·	Consider negative sequence torque
`i_speedVar`	·	Effect of speed variation
`sgn`	MVA	Rated apparent power
`ugn`	kV	Rated voltage
`cosn`	·	Rated power factor
`tag`	s	Acceleration time const. Tag (rated to Pgn)
`tds`	s	Td'
`tqs`	s	Tq'
`tdss`	s	Td''
`Tdc`	s	Tdc
`tqss`	s	Tq''
`Ikd`	p.u.	Ikd
`xd`	p.u.	xd
`xds`	p.u.	xd'
`xdss`	p.u.	xd''
`xq`	p.u.	xq
`xqs`	p.u.	xq'
`xqss`	p.u.	xq''
`xdsat`	p.u.	Reciprocal of short-circuit ratio (xdsat)
`xdsss`	p.u.	saturated value xd''sat
`xtor`	·	Ratio X/R
`rstr`	p.u.	rstr
`x2sy`	p.u.	Reactance x2
`r2sy`	p.u.	Resistance r2
`x0sy`	p.u.	Reactance x0
`r0sy`	p.u.	Resistance r0
`q_min`	p.u.	Minimum value
`q_max`	p.u.	Maximum value
`Q_min`	Mvar	Minimum value
`Q_max`	Mvar	Maximum value
`curk`	kA	3-phase Ik"
`curk1p`	kA	1-phase Ik"
`curk2p`	kA	2-phase Ik"
`tds0`	s	Td0'
`tqs0`	s	Tq0'
`tdss0`	s	Td0''
`tqss0`	s	Tq0''
`depSmoothFac`	%	Dependency curve smoothing factor
`slipmin`	%	Minimum slip
`frequ`	Hz	Nominal frequency
`sg10`	p.u.	SG10
`sg12`	p.u.	SG12
`smoothFac`	%	Smoothing factor
`sg10q`	p.u.	SG10 q-axis
`sg12q`	p.u.	SG12 q-axis
`iinrush`	p.u.	Ratio Ip/In
`Tinrush`	s	Max. time
`Tcold`	s	Cold
`Thot`	s	Hot
`xstr`	p.u.	xstr
`xl`	p.u.	xl
`xrl`	p.u.	xrld
`xrlq`	p.u.	xrlq
`kw`	p.u.	kw
`xad`	p.u.	xad
`xaq`	p.u.	xaq
`xrl2d`	p.u.	xrl2d
`x1d`	p.u.	x1d
`r1d`	p.u.	r1d
`x2d`	p.u.	x2d
`r2d`	p.u.	r2d
`xfd`	p.u.	xfd
`rfd`	p.u.	rfd
`x1q`	p.u.	x1q
`r1q`	p.u.	r1q
`x2q`	p.u.	x2q
`r2q`	p.u.	r2q
`x3q`	p.u.	x3q
`r3q`	p.u.	r3q
`t1d`	s	t1d
`t2d`	s	t2d
`t3d`	s	t3d
`t4d`	s	t4d
`t5d`	s	t5d
`t6d`	s	t6d
`t7d`	s	t7d
`t8d`	s	t8d
`t1q`	s	t1q
`t2q`	s	t2q
`t3q`	s	t3q
`t4q`	s	t4q
`t5q`	s	t5q
`t6q`	s	t6q
`x1dc`	p.u.	x1dc
`x1de`	p.u.	x1de
`r1de`	p.u.	r1de
`xfde`	p.u.	xfde
`rfde`	p.u.	rfde
`x1qc`	p.u.	x1qc
`x1qe`	p.u.	x1qe
`r1qe`	p.u.	r1qe
`psim`	p.u.	Rotor flux
`dpu`	·	Turbine shaft friction torque coefficient
`dpe`	·	Damping torque coefficient based on power
`dkd`	·	Damping torque coefficient
`appr_modif`	·	Modified
`curTab`	p.u.	Current
`xlTab`	p.u.	xl
`satv`	p.u.	Term. voltage
`satse`	p.u.	SG(u)
`satvq`	p.u.	Term. voltage
`satseq`	p.u.	SG(u)
`typemetadata_version`	·	Version
`typemetadata_key`	·	Type Key
`typemetadata_changeLog`	·	Change Log
`desc`	·	Description
`fcharrstr`	ChaPol,ChaVec,ChaMat	rs(f)
`fcharlss`	ChaPol,ChaVec,ChaMat	l''(f)
`fcharr2`	ChaPol,ChaVec,ChaMat	r2(f)
`fcharl2`	ChaPol,ChaVec,ChaMat	l2(f)
`fcharr0`	ChaPol,ChaVec,ChaMat	r0(f)
`fcharl0`	ChaPol,ChaVec,ChaMat	l0(f)
`doc_id`	·	Additional Data
`cTdc`	s	Tdc
`tags`	s	Acceleration time const. Tag (rated to Sgn)
`h`	s	Inertia constant H (rated to Sgn)
`lss`	p.u.	l''
`hpn`	s	Inertia constant H (rated to Pgn)
`J`	kgm^2	Moment of inertia J
`ifd`	%	ie
`ifdq`	%	ie

← TypSwitch Switch Type · TypTow Tower Type →

TypSym attributesPowerFactory Synchronous Machine Type

What TypSym is

Most used TypSym attributes

Read and write TypSym in Python

TypSym input parameters

Related