Main Content

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(DATA)

Description

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

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

DATA = power_cableparam(DATA) Computes the cable parameters for the geometric cable parameters given in the CableData structure. 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. Returns 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

collapse all

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 DATA 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 DATA 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 DATA.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 permeability

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

The function computes and return the cable parameters on the fields in this table:

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

Examples

For an example using the power_cableparam function, see the power_cable model.