master:vdcl parametersPSCAD Voltage Dependent Current Limits

Every parameter of the PSCAD Voltage Dependent Current Limits (master:vdcl): 11 names, with the unit, the default and the meaning PSCAD gives each one. Copy a name into parameters().

What master:vdcl is

Voltage Dependent Current Limits, a component of PSCAD's Master Library, filed under control blocks.

Definition
master:vdcl
PSCAD name
Voltage Dependent Current Limits
Category
Control blocks
Parameters
11, in 2 groups; 6 carry a unit
Read from
PSCAD 5.0.0, 2026-11-07

Read and write master:vdcl 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:vdcl"):   # the exact definition, namespace first
    params = comp.parameters()           # every parameter, as PSCAD holds it
    print(str(params["CPU"]))            # Current Limit, in pu

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

Main Data

ParameterUnitDefaultDescription
CPURealpu0.2Current LimitRange 0 to 1
RampIRealpu/s10.0Current Order Recovery RateRange 0 to 1000
TLReals0.02Lag Time ConstantRange 0 to 1
VOffRealpu0.7Volts for Removing LimitRange -1 to 1
VOnRealpu0.5Volts for Applying LimitRange -1 to 1

Configuration

ParameterUnitDefaultDescription
HystChoice·HYSTERISISHysterisis or Straight LineWritten as STRAIGHT_LINE (Straight Line), HYSTERISIS (Hysterisis)
NVGInteger·2Number of Valve GroupsRange 1 to 10
NameText··Name for IdentificationEnter a name for identification
RampChoice·RAMPCurrent Recovery (Ramp or Lag)Written as LAG (Lag), RAMP (Ramp)
TLFncChoice·LAGDelay or Lag FunctionWritten as DELAY (Delay), LAG (Lag)
VRVGRealkV250.0Voltage Rating / GroupRange 0 to 1000

Related

← master:vco Voltage Controlled Oscillator · master:xy_transfer_function X-Y Transfer Function →