master:oos_lens68 parametersPSCAD Lens 68

Every parameter of the PSCAD Lens 68 (master:oos_lens68): 19 names, with the unit, the default and the meaning PSCAD gives each one. Copy a name into parameters().

What master:oos_lens68 is

Lens 68 (Out of step relay - lens characteristics), a component of PSCAD's Master Library, filed under control blocks.

Definition
master:oos_lens68
PSCAD name
Lens 68
Category
Control blocks
Parameters
19, in 3 groups; 4 carry a unit
Read from
PSCAD 5.0.0, 2026-11-07

Read and write master:oos_lens68 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:oos_lens68"):   # the exact definition, namespace first
    params = comp.parameters()           # every parameter, as PSCAD holds it
    print(str(params["TM"]))             # Maximum Blocking Time, in s

comp = project.find_all("master:oos_lens68")[0]
comp.parameters(TM="4 [s]")              # 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, "TM") and px_set(...), which also records the old value so the case is put back at the end. Getting started shows them.

Main

ParameterUnitDefaultDescription
EPChoice·ENABLEEnable Power Swing BlockingSelect Enable or DisableWritten as DISABLE (Disable), ENABLE (Enable)
I0SETReal·2.0Residual Current SettingRange -1000 to 1000
NameText··Name for IdentificationEnter a name for identification
TMReals2.0Maximum Blocking TimeRange -1000 to 1000
TZ6Reals0.04Power Swing Blocking Time delayRange 0.03 to 0.08

Internal Timer Output

ParameterUnitDefaultDescription
INTDTText·IntDTPower Swing Blocking Timer
Z5Text·Z5Zone 5 Output
Z6Text·Z6Zone 6 Output

Configuration

ParameterUnitDefaultDescription
R5Real·0.6Zone 5 RadiusAt least 1E-307
R6Real·0.8Zone 6 RadiusAt least 1E-307
X1Real·0.2X of C1Used when xy==0
X2Real·0.9X of C2Used when xy==0
XYChoice·X_YCoordinates of the CentresSelect Cartesian or Polar CoordinatesWritten as X_Y ((X,Y)), Z_THETA ((Z,theta))
Y1Real·0.2Y of C1Used when xy==0
Y2Real·0.2Y of C2Used when xy==0
Z1Real·0.2828Z of C1Used when xy==1
Z2Real·0.922Z of C2Used when xy==1
theta1Realrad0.7854Theta of C1Used when xy==1
theta2Realrad0.2187Theta of C2Used when xy==1

Related

← master:Zleadlag Lead-Lag Pole · master:log Logarithm Fuction →