master:datamerge parametersPSCAD Data Merge

Every parameter of the PSCAD Data Merge (master:datamerge): 17 names, with the unit, the default and the meaning PSCAD gives each one. Copy a name into parameters().

What master:datamerge is

Data Merge (Merges data signals into an array), a component of PSCAD's Master Library, filed under control blocks.

Definition
master:datamerge
PSCAD name
Data Merge
Category
Control blocks
Parameters
17, in 1 group
Read from
PSCAD 5.0.0, 2026-11-07

Read and write master:datamerge 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:datamerge"):   # the exact definition, namespace first
    params = comp.parameters()           # every parameter, as PSCAD holds it
    print(str(params["Dim1"]))           # Dimension of 1st Element

comp = project.find_all("master:datamerge")[0]
comp.parameters(Dim1="2")                # written as text
  • 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, "Dim1") and px_set(...), which also records the old value so the case is put back at the end. Getting started shows them.

Configuration

ParameterUnitDefaultDescription
Dim1Integer·1Dimension of 1st ElementRange 1 to 2147483647
Dim10Integer·1Dimension of 10th ElementRange 1 to 2147483647Used when N>9
Dim11Integer·1Dimension of 11th ElementRange 1 to 2147483647Used when N>10
Dim12Integer·1Dimension of 12th ElementRange 1 to 2147483647Used when N>11
Dim2Integer·1Dimension of 2nd ElementRange 1 to 2147483647
Dim3Integer·1Dimension of 3rd ElementRange 1 to 2147483647Used when N>2
Dim4Integer·1Dimension of 4th ElementRange 1 to 2147483647Used when N>3
Dim5Integer·1Dimension of 5th ElementRange 1 to 2147483647Used when N>4
Dim6Integer·1Dimension of 6th ElementRange 1 to 2147483647Used when N>5
Dim7Integer·1Dimension of 7th ElementRange 1 to 2147483647Used when N>6
Dim8Integer·1Dimension of 8th ElementRange 1 to 2147483647Used when N>7
Dim9Integer·1Dimension of 9th ElementRange 1 to 2147483647Used when N>8
DispChoice·NODisplay Index Numbers?Select whether to display the index numbers or notWritten as NO (No), YES (Yes)
NChoice·3Number of Input TapsEnter the number of signals to be mergedWritten as MINIMUM (2 (minimum)), 3, 4, 5, 6, 7, 8, 9, 10, 11, MAXIMUM (12 (maximum))
NameText··Name for IdentificationEnter a name for identification
TypeChoice·REALOutput Data TypeSelect the type of the outputWritten as LOGICAL (Logical), INTEGER (Integer), REAL (Real), COMPLEX (Complex)
ViewChoice·SAME_SIDEInput Port LocationsSelect how input port locations are configuredWritten as SAME_SIDE (same side), ALTERNATE_SIDES (alternate sides)

Related

← master:current_scaler Current Scaling · master:deadband Deadband Controller →