master:tline_interface parametersPSCAD Transmission Line Interface

Every parameter of the PSCAD Transmission Line Interface (master:tline_interface): 13 names, with the unit, the default and the meaning PSCAD gives each one. Copy a name into parameters().

What master:tline_interface is

Transmission Line Interface (Transmission Line Interface (1 of 2)), a component of PSCAD's Master Library, filed under lines, cables and towers.

Definition
master:tline_interface
PSCAD name
Transmission Line Interface
Category
Lines, cables and towers
Parameters
13, in 2 groups
Read from
PSCAD 5.0.0, 2026-11-07

Read and write master:tline_interface 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:tline_interface"):   # the exact definition, namespace first
    params = comp.parameters()           # every parameter, as PSCAD holds it
    print(str(params["c_port"]))         # Client Port

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

Configuration

ParameterUnitDefaultDescription
NCChoice·3Number of Equivalent ConductorsWritten as 1 = 1, 2 = 2, 3 = 3, 4 = 4, 5 = 5, 6 = 6, 7 = 7, 8 = 8, 9 = 9, 10 = 10, 11 = 11, 12 = 12, 13 = 13, 14 = 14, 15 = 15, 16 = 16, 17 = 17, 18 = 18, 19 = 19, 20 = 20, 21 = 21, 22 = 22, 23 = 23, 24 = 24, 25 = 25, 26 = 26, 27 = 27, 28 = 28, 29 = 29, 30 = 30
NameText·TLineName (Same as Configuration)Enter a name, which matches the associated transmission line configuration component (wire).Range 0 to 0
ViewChoice·INDIVIDUAL_PHASESGraphics DisplayChoose from Single line or Individual phasesWritten as INDIVIDUAL_PHASES (Individual phases view), SINGLE_LINE (Single line view)
dim_rInteger·0Receiving Signal DimensionEnter the dimension of optional non-electrical signal to be received from the other end of the lineRange 0 to 1024
dim_sInteger·0Sending Signal DimensionEnter the dimension of optional non-electrical signal to be transferred to the other end of the lineRange 0 to 1024
recv_defaultReal·0.0Receiving Signal Default ValueThe default value for the receiving signal at TIME 0Used when dim_r>0&&recv_default_type==0
recv_default_typeChoice·DIRECT_ENTRYReceiving Signal Default EntryThe Entry type for the receiving signal TIME 0 value.Written as DIRECT_ENTRY (Direct Entry), SIGNAL_INPUT (Signal Input)Used when dim_r>0
send_recvChoice·AUTOMATICSegment End SpecificationSpecify which end of the transmission segment this is: Sending or receiving. It is only necessary to specify if the associated segment is part of a mutually coupled group of segments. Otherwise, you can leave this option as automatic. Specifying endpoints is necessary in order to ensure proper node/subsystem mapping and accurate runtime results.Written as AUTOMATIC (automatic), SENDING (sending), RECEIVING (receiving)

Inter Application Configuration

ParameterUnitDefaultDescription
alienChoice·NONEEnd TypeThis option should be set to Server or Client for inter-application simulations, set to None if both ends of the line are in a single PSCAD.Written as SERVER (Server), CLIENT (Client), NONE (None)
autoportChoice·AUTO_ASSIGNAuto Assign Port for ServerUser may choose to let PSCAD assign ports for Server connection, or may assign themselves for port whitelisting.Written as AUTO_ASSIGN (Auto Assign Port), USER_DEFINED (User Defined Port)Used when alien==0
c_portInteger·0Client PortEnter the Port to which client should attempt to connect.Range -2147483648 to 2147483647Used when alien==1
ipaddressText··Host (IP Address)Enter the IP Address of the host where Server is running.Range 0 to 40Used when alien==1
s_portInteger·0Server PortEnter the Port that is open for communication.Range -2147483648 to 2147483647Used when autoport==1

Related

← master:tline_interface_v2 tline_interface_v2 · master:svcalloc1 TSC/TCR Non-Linear Susceptance Characteristics →