master:multimass parametersPSCAD Torsional Shaft Model

Every parameter of the PSCAD Torsional Shaft Model (master:multimass): 221 names, with the unit, the default and the meaning PSCAD gives each one. Copy a name into parameters().

What master:multimass is

Torsional Shaft Model (Torsional Shaft Model (Obsolete)), a component of PSCAD's Master Library, filed under control blocks.

Definition
master:multimass
PSCAD name
Torsional Shaft Model
Category
Control blocks
Parameters
221, in 12 groups; 30 carry a unit
Read from
PSCAD 5.0.0, 2026-11-07

Read and write master:multimass in Python

import mhi.pscad

pscad = mhi.pscad.connect()              # the PSCAD that is open; launch() starts one
project = pscad.project("my_case")       # a case loaded in the workspace

for comp in project.find_all("master:multimass"):   # the exact definition, namespace first
    params = comp.parameters()           # every parameter, as PSCAD holds it
    print(str(params["F"]))              # Electrical base frequency, in Hz

comp = project.find_all("master:multimass")[0]
comp.parameters(F="120 [Hz]")            # a value that carries a unit is written with it
  • A parameter is named exactly as in the table, letter case included: parameters() gives every one of them in a dictionary, and a name the component does not have is refused.
  • A value that carries a unit comes back as a number whose unit is only in its text, so read it as text first (str(...)) or the unit is lost. PSCAD keeps a written unit as it is given: "2500 [mohm]" stays in mohm.
  • A Choice is read and written as its symbol (the capitals in "Written as"), not as the words PSCAD shows in the dialog.
  • find_all() takes the exact definition only. A wildcard or a bare name without master: comes back empty; the Builder's px_find walks the pages for those.

The Builder's runtime does the same with the unit handled for you: px_get(comp, "F") and px_set(...), which also records the old value so the case is put back at the end. Getting started shows them.

Configuration

ParameterUnitDefaultDescription
EnabIntegerยท1Initialization switch: 0-Init;1-ReleaseRange 0 to 1
ExcChoiceยทYESModel Exciter MassSelect whether to model the exciter mass or notWritten as NO (No), YES (Yes)Used when SQC==0
FRealHz60.0Electrical base frequencyEnter the electrical base frequencyAt least 1e-307
MVARealMVA892.4Machine total MVAEnter the MVA rating of the machineAt least 1e-307
NIntegerยท4Number of TurbinesEnter the number of turbines (number of masses other than machine and exciter) in the multimass systemRange 1 to 25
RPMRealrev/min3600.0Machine mechanical synchronous speedEnter the mechanical synchronous speed of massesAt least 1e-307
SQCChoiceยทSYNCHRONOUS_MACHINEFor Use With ...Select the type of machine this component is connectedWritten as SYNCHRONOUS_MACHINE (Synchronous Machine), INDUCTION_MACHINE (Induction Machine), DC_MACHINE (DC Machine), PM_MACHINE (PM Machine)
UnitsChoiceยทS_KPU_DPUUnit System Number (see help)Choose the appropriate unit system usedWritten as LBFTFT_KLBFT_RAD (1 : H(lb.ft.ft.) K(lb.ft/rad)), INLBFS_2_KLBFIN_RAD (2 : H(in.lbf.s^2) K(lbf.in/rad)), LBININ_KLBFIN_RAD (3 : H(lb.in.in.) K(lbf.in/rad)), S_KPU (4 : H(s) K(pu)), KGM_2_KNM_RAD (5 : H(kg.m^2) K(N.m/rad)), LBFT_2_KLBFT_RAD_DLBFFTS_RAD (6 : H(lb.ft^2) K(lb.ft/rad) D(lbf.ft.s/rad)), INLBFS_2_KLBFIN_RAD_DLBFINS_RAD (7 : H(in.lbf.s^2) K(lbf.in/rad) D(lbf.in.s/rad)), LBIN_2_KLBFIN_RAD_DLBFINS_RAD (8 : H(lb.in^2) K(lbf.in/rad) D(lbf.in.s/rad)), S_KPU_DPU (9 : H(s) K(pu) D(pu)), KGM_2_KNM_RAD_DNMS_RAD (10 : H(kg.m^2) K(N.m/rad) D(N.m.s/rad))
spdiniRealpu1Machine initial electrical speedEnter the initial electrical speedRange 0 to 2

Inertia Constants

ParameterUnitDefaultDescription
H1Realยท0.0929Turbine #1 Inertia ConstantAt least 0
H10Realยท0.0Turbine #10 Inertia ConstantAt least 0Used when (N>=10)
H11Realยท0.0Turbine #11 Inertia ConstantAt least 0Used when (N>=11)
H12Realยท0.0Turbine #12 Inertia ConstantAt least 0Used when (N>=12)
H13Realยท0.0Turbine #13 Inertia ConstantAt least 0Used when (N>=13)
H14Realยท0.0Turbine #14 Inertia ConstantAt least 0Used when (N>=14)
H15Realยท0.0Turbine #15 Inertia ConstantAt least 0Used when (N>=15)
H16Realยท0.0Turbine #16 Inertia ConstantAt least 0Used when (N>=16)
H17Realยท0.0Turbine #17 Inertia ConstantAt least 0Used when (N>=17)
H18Realยท0.0Turbine #18 Inertia ConstantAt least 0Used when (N>=18)
H19Realยท0.0Turbine #19 Inertia ConstantAt least 0Used when (N>=19)
H2Realยท0.1556Turbine #2 Inertia ConstantAt least 0Used when (N>=2)
H20Realยท0.0Turbine #20 Inertia ConstantAt least 0Used when (N>=20)
H21Realยท0.0Turbine #21 Inertia ConstantAt least 0Used when (N>=21)
H22Realยท0.0Turbine #22 Inertia ConstantAt least 0Used when (N>=22)
H23Realยท0.0Turbine #23 Inertia ConstantAt least 0Used when (N>=23)
H24Realยท0.0Turbine #24 Inertia ConstantAt least 0Used when (N>=24)
H25Realยท0.0Turbine #25 Inertia ConstantAt least 0Used when (N>=25)
H3Realยท0.8587Turbine #3 Inertia ConstantAt least 0Used when (N>=3)
H4Realยท0.8842Turbine #4 Inertia ConstantAt least 0Used when (N>=4)
H5Realยท0.0Turbine #5 Inertia ConstantAt least 0Used when (N>=5)
H6Realยท0.0Turbine #6 Inertia ConstantAt least 0Used when (N>=6)
H7Realยท0.0Turbine #7 Inertia ConstantAt least 0Used when (N>=7)
H8Realยท0.0Turbine #8 Inertia ConstantAt least 0Used when (N>=8)
H9Realยท0.0Turbine #9 Inertia ConstantAt least 0Used when (N>=9)

Generator and Exciter Data

ParameterUnitDefaultDescription
HERealยท0.0342Exciter Inertia ConstantAt least 0Used when (Exc)&&(SQC==0)
HGRealยท0.8685Generator Inertia ConstantAt least 0
KGERealยท1064.0Spring Constant From Generator to ExciterAt least 0Used when (Exc)&&(SQC==0)
KLGRealยท26713.0Spring Constant From Last Turbine to GeneratorAt least 0
MDGERealยท0.0Damping Between Generator and ExciterAt least 0Used when (Exc)&&(SQC==0)&&(Units>5)
MDLGRealยท0.0Damping Between Last Turbine and GeneratorAt least 0Used when (Units>5)
SDERealยท0.0Exciter Self DampingAt least 0Used when (Exc)&&(SQC==0)&&(Units>5)
SDGRealยท0.0Generator Self DampingAt least 0Used when (Units>5)

Shaft Spring Constant

ParameterUnitDefaultDescription
K10_Realยท0.0Spring Constant From Turbine #10 to #11At least 0Used when (N>=11)
K11_Realยท0.0Spring Constant From Turbine #11 to #12At least 0Used when (N>=12)
K12Realยท7277.0Spring Constant From Turbine #1 to #2At least 0Used when (N>=2)
K12_Realยท0.0Spring Constant From Turbine #12 to #13At least 0Used when (N>=13)
K13_Realยท0.0Spring Constant From Turbine #13 to #14At least 0Used when (N>=14)
K14_Realยท0.0Spring Constant From Turbine #14 to #15At least 0Used when (N>=15)
K15_Realยท0.0Spring Constant From Turbine #15 to #16At least 0Used when (N>=16)
K16_Realยท0.0Spring Constant From Turbine #16 to #17At least 0Used when (N>=17)
K17_Realยท0.0Spring Constant From Turbine #17 to #18At least 0Used when (N>=18)
K18_Realยท0.0Spring Constant From Turbine #18 to #19At least 0Used when (N>=19)
K19_Realยท0.0Spring Constant From Turbine #19 to #20At least 0Used when (N>=20)
K20_Realยท0.0Spring Constant From Turbine #20 to #21At least 0Used when (N>=21)
K21_Realยท0.0Spring Constant From Turbine #21 to #22At least 0Used when (N>=22)
K22_Realยท0.0Spring Constant From Turbine #22 to #23At least 0Used when (N>=23)
K23Realยท13168.0Spring Constant From Turbine #2 to #3At least 0Used when (N>=3)
K23_Realยท0.0Spring Constant From Turbine #23 to #24At least 0Used when (N>=24)
K24_Realยท0.0Spring Constant From Turbine #24 to #25At least 0Used when (N>=25)
K34Realยท19618.0Spring Constant From Turbine #3 to #4At least 0Used when (N>=4)
K45Realยท0.0Spring Constant From Turbine #4 to #5At least 0Used when (N>=5)
K5_Realยท0.0Spring Constant From Turbine #5 to #6At least 0Used when (N>=6)
K6_Realยท0.0Spring Constant From Turbine #6 to #7At least 0Used when (N>=7)
K7_Realยท0.0Spring Constant From Turbine #7 to #8At least 0Used when (N>=8)
K8_Realยท0.0Spring Constant From Turbine #8 to #9At least 0Used when (N>=9)
K9_Realยท0.0Spring Constant From Turbine #9 to #10At least 0Used when (N>=10)

Mutual Damping

ParameterUnitDefaultDescription
MD10_Realยท0.0Damping Between Turbine #10 and #11At least 0Used when (N>=11)
MD11_Realยท0.0Damping Between Turbine #11 and #12At least 0Used when (N>=12)
MD12Realยท0.0Damping Between Turbine #1 and #2At least 0Used when (N>=2)
MD12_Realยท0.0Damping Between Turbine #12 and #13At least 0Used when (N>=13)
MD13_Realยท0.0Damping Between Turbine #13 and #14At least 0Used when (N>=14)
MD14_Realยท0.0Damping Between Turbine #14 and #15At least 0Used when (N>=15)
MD15_Realยท0.0Damping Between Turbine #15 and #16At least 0Used when (N>=16)
MD16_Realยท0.0Damping Between Turbine #16 and #17At least 0Used when (N>=17)
MD17_Realยท0.0Damping Between Turbine #17 and #18At least 0Used when (N>=18)
MD18_Realยท0.0Damping Between Turbine #18 and #19At least 0Used when (N>=19)
MD19_Realยท0.0Damping Between Turbine #19 and #20At least 0Used when (N>=20)
MD20_Realยท0.0Damping Between Turbine #20 and #21At least 0Used when (N>=21)
MD21_Realยท0.0Damping Between Turbine #21 and #22At least 0Used when (N>=22)
MD22_Realยท0.0Damping Between Turbine #22 and #23At least 0Used when (N>=23)
MD23Realยท0.0Damping Between Turbine #2 and #3At least 0Used when (N>=3)
MD23_Realยท0.0Damping Between Turbine #23 and #24At least 0Used when (N>=24)
MD24_Realยท0.0Damping Between Turbine #24 and #25At least 0Used when (N>=25)
MD34Realยท0.0Damping Between Turbine #3 and #4At least 0Used when (N>=4)
MD45Realยท0.0Damping Between Turbine #4 and #5At least 0Used when (N>=5)
MD5_Realยท0.0Damping Between Turbine #5 and #6At least 0Used when (N>=6)
MD6_Realยท0.0Damping Between Turbine #6 and #7At least 0Used when (N>=7)
MD7_Realยท0.0Damping Between Turbine #7 and #8At least 0Used when (N>=8)
MD8_Realยท0.0Damping Between Turbine #8 and #9At least 0Used when (N>=9)
MD9_Realยท0.0Damping Between Turbine #9 and #10At least 0Used when (N>=10)

Internal Output Variable Names - 2

ParameterUnitDefaultDescription
P1TextยทยทMechanical Position of Mass 1 relative to Generator
P10TextยทยทMechanical Position of Mass 10 relative to Generator
P11TextยทยทMechanical Position of Mass 11 relative to Generator
P12TextยทยทMechanical Position of Mass 12 relative to Generator
P13TextยทยทMechanical Position of Mass 13 relative to Generator
P14TextยทยทMechanical Position of Mass 14 relative to Generator
P15TextยทยทMechanical Position of Mass 15 relative to Generator
P16TextยทยทMechanical Position of Mass 16 relative to Generator
P17TextยทยทMechanical Position of Mass 17 relative to Generator
P18TextยทยทMechanical Position of Mass 18 relative to Generator
P19TextยทยทMechanical Position of Mass 19 relative to Generator
P2TextยทยทMechanical Position of Mass 2 relative to Generator
P20TextยทยทMechanical Position of Mass 20 relative to Generator
P21TextยทยทMechanical Position of Mass 21 relative to Generator
P22TextยทยทMechanical Position of Mass 22 relative to Generator
P23TextยทยทMechanical Position of Mass 23 relative to Generator
P24TextยทยทMechanical Position of Mass 24 relative to Generator
P25TextยทยทMechanical Position of Mass 25 relative to Generator
P26TextยทยทMechanical Position of Mass 26 relative to Generator
P3TextยทยทMechanical Position of Mass 3 relative to Generator
P4TextยทยทMechanical Position of Mass 4 relative to Generator
P5TextยทยทMechanical Position of Mass 5 relative to Generator
P6TextยทยทMechanical Position of Mass 6 relative to Generator
P7TextยทยทMechanical Position of Mass 7 relative to Generator
P8TextยทยทMechanical Position of Mass 8 relative to Generator
P9TextยทยทMechanical Position of Mass 9 relative to Generator

Self Damping

ParameterUnitDefaultDescription
SD1Realยท0.0Turbine #1 Self DampingAt least 0
SD10Realยท0.0Turbine #10 Self DampingAt least 0Used when (N>=10)
SD11Realยท0.0Turbine #11 Self DampingAt least 0Used when (N>=11)
SD12Realยท0.0Turbine #12 Self DampingAt least 0Used when (N>=12)
SD13Realยท0.0Turbine #13 Self DampingAt least 0Used when (N>=13)
SD14Realยท0.0Turbine #14 Self DampingAt least 0Used when (N>=14)
SD15Realยท0.0Turbine #15 Self DampingAt least 0Used when (N>=15)
SD16Realยท0.0Turbine #16 Self DampingAt least 0Used when (N>=16)
SD17Realยท0.0Turbine #17 Self DampingAt least 0Used when (N>=17)
SD18Realยท0.0Turbine #18 Self DampingAt least 0Used when (N>=18)
SD19Realยท0.0Turbine #19 Self DampingAt least 0Used when (N>=19)
SD2Realยท0.0Turbine #2 Self DampingAt least 0Used when (N>=2)
SD20Realยท0.0Turbine #20 Self DampingAt least 0Used when (N>=20)
SD21Realยท0.0Turbine #21 Self DampingAt least 0Used when (N>=21)
SD22Realยท0.0Turbine #22 Self DampingAt least 0Used when (N>=22)
SD23Realยท0.0Turbine #23 Self DampingAt least 0Used when (N>=23)
SD24Realยท0.0Turbine #24 Self DampingAt least 0Used when (N>=24)
SD25Realยท0.0Turbine #25 Self DampingAt least 0Used when (N>=25)
SD3Realยท0.0Turbine #3 Self DampingAt least 0Used when (N>=3)
SD4Realยท0.0Turbine #4 Self DampingAt least 0Used when (N>=4)
SD5Realยท0.0Turbine #5 Self DampingAt least 0Used when (N>=5)
SD6Realยท0.0Turbine #6 Self DampingAt least 0Used when (N>=6)
SD7Realยท0.0Turbine #7 Self DampingAt least 0Used when (N>=7)
SD8Realยท0.0Turbine #8 Self DampingAt least 0Used when (N>=8)
SD9Realยท0.0Turbine #9 Self DampingAt least 0Used when (N>=9)

Internal Output Variable Names - 1

ParameterUnitDefaultDescription
T10_TextยทยทTorque on Shaft from Mass 10 - 11
T11_TextยทยทTorque on Shaft from Mass 11 - 12
T12TextยทยทTorque on Shaft from Mass 1 - 2
T12_TextยทยทTorque on Shaft from Mass 12 - 13
T13_TextยทยทTorque on Shaft from Mass 13 - 14
T14_TextยทยทTorque on Shaft from Mass 14 - 15
T15_TextยทยทTorque on Shaft from Mass 15 - 16
T16_TextยทยทTorque on Shaft from Mass 16 - 17
T17_TextยทยทTorque on Shaft from Mass 17 - 18
T18_TextยทยทTorque on Shaft from Mass 18 - 19
T19_TextยทยทTorque on Shaft from Mass 19 - 20
T20_TextยทยทTorque on Shaft from Mass 20 - 21
T21_TextยทยทTorque on Shaft from Mass 21 - 22
T22_TextยทยทTorque on Shaft from Mass 22 - 23
T23TextยทยทTorque on Shaft from Mass 2 - 3
T23_TextยทยทTorque on Shaft from Mass 23 - 24
T24_TextยทยทTorque on Shaft from Mass 24 - 25
T25_TextยทยทTorque on Shaft from Mass 25 - 26
T34TextยทยทTorque on Shaft from Mass 3 - 4
T45TextยทยทTorque on Shaft from Mass 4 - 5
T56TextยทยทTorque on Shaft from Mass 5 - 6
T6_TextยทยทTorque on Shaft from Mass 6 - 7
T7_TextยทยทTorque on Shaft from Mass 7 - 8
T8_TextยทยทTorque on Shaft from Mass 8 - 9
T9_TextยทยทTorque on Shaft from Mass 9 - 10

Turbine Torque Share

ParameterUnitDefaultDescription
TF1Realpu0.30Torque Share for Turbine #1Range 0 to 1Used when (N>1)
TF10Realpu0.0Torque Share for Turbine #10Range 0 to 1Used when (N>=10)
TF11Realpu0.0Torque Share for Turbine #11Range 0 to 1Used when (N>=11)
TF12Realpu0.0Torque Share for Turbine #12Range 0 to 1Used when (N>=12)
TF13Realpu0.0Torque Share for Turbine #13Range 0 to 1Used when (N>=13)
TF14Realpu0.0Torque Share for Turbine #14Range 0 to 1Used when (N>=14)
TF15Realpu0.0Torque Share for Turbine #15Range 0 to 1Used when (N>=15)
TF16Realpu0.0Torque Share for Turbine #16Range 0 to 1Used when (N>=16)
TF17Realpu0.0Torque Share for Turbine #17Range 0 to 1Used when (N>=17)
TF18Realpu0.0Torque Share for Turbine #18Range 0 to 1Used when (N>=18)
TF19Realpu0.0Torque Share for Turbine #19Range 0 to 1Used when (N>=19)
TF2Realpu0.26Torque Share for Turbine #2Range 0 to 1Used when (N>=2)
TF20Realpu0.0Torque Share for Turbine #20Range 0 to 1Used when (N>=20)
TF21Realpu0.0Torque Share for Turbine #21Range 0 to 1Used when (N>=21)
TF22Realpu0.0Torque Share for Turbine #22Range 0 to 1Used when (N>=22)
TF23Realpu0.0Torque Share for Turbine #23Range 0 to 1Used when (N>=23)
TF24Realpu0.0Torque Share for Turbine #24Range 0 to 1Used when (N>=24)
TF25Realpu0.0Torque Share for Turbine #25Range 0 to 1Used when (N>=25)
TF3Realpu0.22Torque Share for Turbine #3Range 0 to 1Used when (N>=3)
TF4Realpu0.22Torque Share for Turbine #4Range 0 to 1Used when (N>=4)
TF5Realpu0.0Torque Share for Turbine #5Range 0 to 1Used when (N>=5)
TF6Realpu0.0Torque Share for Turbine #6Range 0 to 1Used when (N>=6)
TF7Realpu0.0Torque Share for Turbine #7Range 0 to 1Used when (N>=7)
TF8Realpu0.0Torque Share for Turbine #8Range 0 to 1Used when (N>=8)
TF9Realpu0.0Torque Share for Turbine #9Range 0 to 1Used when (N>=9)

Internal Output Variable Names - 3

ParameterUnitDefaultDescription
W1TextยทยทDelta Mechanical Speed of Mass 1
W10TextยทยทDelta Mechanical Speed of Mass 10
W11TextยทยทDelta Mechanical Speed of Mass 11
W12TextยทยทDelta Mechanical Speed of Mass 12
W13TextยทยทDelta Mechanical Speed of Mass 13
W14TextยทยทDelta Mechanical Speed of Mass 14
W15TextยทยทDelta Mechanical Speed of Mass 15
W16TextยทยทDelta Mechanical Speed of Mass 16
W17TextยทยทDelta Mechanical Speed of Mass 17
W18TextยทยทDelta Mechanical Speed of Mass 18
W19TextยทยทDelta Mechanical Speed of Mass 19
W2TextยทยทDelta Mechanical Speed of Mass 2
W20TextยทยทDelta Mechanical Speed of Mass 20
W21TextยทยทDelta Mechanical Speed of Mass 21
W22TextยทยทDelta Mechanical Speed of Mass 22
W23TextยทยทDelta Mechanical Speed of Mass 23
W24TextยทยทDelta Mechanical Speed of Mass 24
W25TextยทยทDelta Mechanical Speed of Mass 25
W26TextยทยทDelta Mechanical Speed of Mass 26
W3TextยทยทDelta Mechanical Speed of Mass 3
W4TextยทยทDelta Mechanical Speed of Mass 4
W5TextยทยทDelta Mechanical Speed of Mass 5
W6TextยทยทDelta Mechanical Speed of Mass 6
W7TextยทยทDelta Mechanical Speed of Mass 7
W8TextยทยทDelta Mechanical Speed of Mass 8
W9TextยทยทDelta Mechanical Speed of Mass 9
WbasTextยทยทRated Mechanical Speed of the System

Uniform Modal Damping

ParameterUnitDefaultDescription
sigmaReal1/s0.0Modal Damping for all modesAt least 0Used when (Units<=5)

Initialization Data Interface

ParameterUnitDefaultDescription
teiChoiceยทNOInput initialized steady Electrical TorqueSelect Yes or NoWritten as NO (No), YES (Yes)
tmiChoiceยทNOOutput initialized Mechanical TorqueSelect Yes or NoWritten as NO (No), YES (Yes)

Related

โ† master:timerdefn timerdefn ยท master:multimass2 Torsional Shaft Model โ†’