power_cableparam

Compute RLC parameters and frequency-dependent model parameters of a group of cables

Syntax

power_cableparam

DATA = power_cableparam(‘new’)

DATA = power_cableparam(CableData)

Description

power_cableparam opens the Power Cable Parameters app with the default cable parameter values that the Simscape™ Electrical™ Specialized Power Systems software provides.

DATA = power_cableparam(‘new’) returns a structure variable with default cable geometry parameters. You can use DATA as a template variable to configure a new cable geometry and to compute the cable parameters.

DATA = power_cableparam(CableData) computes the cable parameters for the geometric cable parameters given in the CableData structure. The function computes the R, L, C, and G fields of DATA structure as N-by-N matrices where N is the number of phases defined in the cable arrangement. The WB field of the DATA structure variable containing the frequency-dependent model parameters for the given frequency-range.

If you specify the DATA structure in the format of R2022a, the function assumes that a cable consists of an inner copper phase conductor with an outer screen conductor, using cross-linked polyethylene (XLPE) insulator material. The R, L, C, and Z parameters are then computed as in R2022a. The G and WB parameters are not computed.

Input Arguments

CableData — Cable geometry parameters characteristics

structure

Conductor and insulator characteristics for a set of cables, specified as a structure with these fields:

Field	Description
configuration	Specify the configuration of the cable arrangement: 'underground', 'aerial', 'pipe'.
cables	Structure specifying the cable arrangement geometry.
types	Structure specifying the geometrical and electrical parameters of the cable types.
pipe	Structure specifying the parameters of the pipe.
crossbondTheSheaths	Set to 1 to cross bound the sheaths. See the documentation of the Power Cable Parameters app for more information on how to use this parameter.
frequency	The frequency, in hertz, at which to evaluate the RLC cable arrangement parameters.
frequencyRange	Specify a vector of three elements [X1,X2,N] to define a frequency vector in the logspace(X1, X2,N) format, consisting of N logarithmically equally spaced points between 10^X1 and 10^X2.
length	Length of the cable arrangement in meters.
groundResistivity	Ground resistivity in ohm-meters. Set to 0 to specify perfectly conducting ground.
comments	Comments related to the cable arrangement.

The cables field of CableData is a structure with the fields in this table. The length of the cables structure corresponds to the number of cables in your cable arrangement.

Field	Description
Vdist	When the configuration field is set to aerial or underground, specify the vertical position of the center of the cable in meters. When the configuration field is set to pipe specify the cable position relative to the center of the pipe in meters.
Hdist	When the configuration field is set to aerial or underground, specify the horizontal position of the center of the cable in meters. When the configuration field is set to pipe specify the position angle of the cable inside the pipe in meters.
Rout	Specify the external radius of the cable.
type	Specify the cable type as an integer between 1 and Number of Types.
phase	Associate each conductor of the cable to an electrical phase of the network.

The types field of CableData is a structure with the fields in this table. The length of the types structure corresponds to the number of cable types that are defined in your cable arrangement.

Field	Description
conductors	Geometric and electric parameters of the cable

The conductors field of CableData.types contains a structure with the fields in this table. The length of the conductor structure corresponds to the number of conductors of each cable type in your cable arrangement.

Field	Description
R_in	Inside radius of the conductor
R_out	Outside radius of the conductor
Rho	Conductor resistivity
MUE	Conductor relative permeability
MUE_IN	Surrounding insulation relative permeability
EPS_IN	Surrounding insulation relative permittivity
LFCT_IN	Surrounding insulation loss factor

pipe is a structure with the fields in this table.

Field	Description
R_in	Internal radius of the metallic pipe in meters
R_out	External radius of the metallic pipe
R_ext	External radius of the outer insulator
V_dpth	Depth of center of the pipe below the ground level
Rho	Pipe resistivity
MUE	Metallic pipe relative permeability
MUE_in	Inside insulation relative permeability
EPS_IN	Inside insulation relative permeability
LFCT_IN	Inside insulation loss factor
MUE_out	Outside insulation relative permeability
EPS_out	Outside insulation relative permeability
LFCT_out	Outside insulation loss factor
phase	Phase number connected to the metallic pipe

Output Arguments

DATA — Cable parameters

structure

Cable parameters, returned as a structure with these fields:

Field	Description
R	Resistance per unit length matrix of the cable arrangement
L	Inductance per unit length matrix of the cable arrangement
C	Capacitance per unit length matrix of the cable arrangement
G	Admittance per unit length matrix of the cable arrangement
WB	Frequency dependent parameters of the cable arrangement