Cable Parameter Calculator
Compute RLC matrices and frequency-dependent parameters of cable arrangement
Since R2022b
Description
The Cable Parameter Calculator app computes the RLGC matrices and the WB frequency-dependent cable parameters of a group of aerial cables, underground cables, or cables in a metal pipe. The cables are single-core and can made up of any number of concentric conductors and insulators.
The parameters computed by the app can be used in the PI Section Line block, Distributed Parameter Line block, and Distributed Parameter Line Frequency Dependent Line block to model a single-phase or multi-phase cable arrangement.
Open the Cable Parameter Calculator App
powergui Block Parameters dialog box: On the Tools tab, click Cable Parameter Calculator.
MATLAB® command prompt: Enter
powerCableParameters
.
Parameters
Parameters|Load typical
— Load typical parameters
Load typical cable parameters provided with Simscape™
Electrical™ Specialized Power Systems software. This command opens a browser window
where you can select typical underground, aerial, or pipe cable configurations. By
default, the app is configured with the parameters of the
Param_4cablesUnderground2cond.mat
file.
Parameters|Load user defined
— Load user parameters
Opens a browser window where you can select your own cable data. Select the desired MAT file.
Parameters|Save
— Save cable parameters
Saves your cable data by generating a MAT file that contains the app information and cable data.
Configuration|Underground cables
— Underground cables configuration
The Cable Configuration table assumes that the cables are
buried below the ground level. Any previous edited parameters in the table are lost. The
position of the cables is specified by V (m) and H
(m) parameters. Aerial cables cannot be defined in this configuration. The
title of the table is Cable Configuration: Underground
. Default
configuration of the app.
Note
If you set this configuration, you must possess a license for Optimization Toolbox™ to simulate your model.
Configuration|Aerial cables
— Aerial cables configuration
The Cable Configuration table assumes that the cables are
aerial. Any previously edited parameters in the table are lost. The position of the
cables is specified by V (m) and H (m)
parameters. Underground cables cannot be defined in this configuration. The title of the
table is Cable Configuration: Aerial
.
Configuration|Cables in a pipe
— Cables in pipe configuration
The Cable Configuration table assumes that the cables are
inside a metallic pipe. Any previously edited parameters in the table are lost. The
position of the cables is specified by X (m) and Angle
(deg) parameters. Aerial and underground cables cannot be defined in this
configuration. The title of the table is Cable Configuration: Inside a
pipe
.
Help
— App documentation
Open the documentation page of the app.
Geometry Tab
General ParametersUser comments
— User comments
Free space to write comments related to the cable arrangement modeled by the app.
Ground resistivity (ohm.m)
— Ground resistivity
100 (default) | positive scalar
Ground resistivity in ohm-meters.
Number of cables
— Number of cables
4 (default) | integer
Specify how many cables are in the cable configuration. A cable is an arrangement of concentric conductors separated with insulators.
If you increase the value of the Number of Cables parameter, additional lines are added to the Cable Configuration table. The App automatically duplicate the parameter values of the last cable in the table and increment the Phase Number values accordingly. Depending on the cable configuration, the H (m) parameter value or the Angle (deg) parameter value is computed to not overlap position of other cables in the table.
Number of cable types
— Number of cable types
1 (default) | integer
Number of cable types. Specify how many different types of cables you have in your cable arrangement.
Frequency range logspace(X1,X2,N)
— Frequency range logspace(X1,X2,N)
[-4,5,400] (default) | 3-element vector
Specify a vector of three elements 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.
Cable length (km)
— Cable length
6 (default) | positive scalar
Specify the length of the cable arrangement in kilometers. All the cables contained in the arrangement have the same length.
Compute
— Compute frequency-dependent model parameters button
button
Computes the WB structure variable that contains the frequency-dependent parameters for the cable model. RLGC matrices are also computed at the frequency specified in the Frequency (Hz) parameter. After computing the parameters, the app displays the results in the Computed Parameters tab.
Frequency (Hz)
— Cable frequency
60 (default) | positive scalar
Frequency in hertz that is used to evaluate RLC parameters.
Compute
— Compute RLGC matrices
button
Computes the R, L, G and C matrices for a given cable. After computing the parameters, the app displays the results in the Computed Parameters tab.
Cross-bond the sheaths
— Cross-bond sheaths
cleared (default) | checkbox
When selected the elements of the RLGC matrices are averaged to reflect cross-bonding the sheaths. The sheath conductors correspond to the conductor no.2 of the cables. The cable can have more than two conductors; however, to use the option all the additional conductors (3,4, …) of each cables need to be grounded, i.e., associated to phase number 0 in the Phase Number parameter vector.
The electric power losses in a cable system dependent on the induced currents flowing in the metallic sheaths. These induced currents depend on the coupling between phase and sheath conductors. For example, in a three-phase cable, if sheaths are not cross-bonded a flat formation will produce higher induced sheath voltages than a trefoil formation. This will in turn result in higher sheath circulating currents and higher losses if the sheaths are bonded (grounded) at both ends. To decrease sheath induced voltage and currents, cross-bonding of sheaths is performed on minor cable sections, like transposition of three-phase aerial transmission lines.
Select this option as an alternative to model all minor sections of cables with physical transposition of sheaths. This will result in approximately same induced voltage and currents in the sheaths while simulating much faster because the model size is reduced, and a longer cable length allows using a larger sample time.
Dependencies
To enable this parameter,
All the cables in the Cable Configuration table must be set to the same Cable Type value.
The Cable Type value must correspond to a cable type having two or more conductors.
All conductors outside the sheath must be grounded (Phase Number value set to 0).
V (m)
— Cable vertical position
-2 (default) | scalar
Vertical position of the center of the cable.
When you select Aerial cables configuration in the Configuration menu, all the V values in the table must be finite positive values. When you select Underground cables configuration in the Configuration menu, all the V values in the table must be finite negative values.
The app does not allow a mix of aerial and underground cables.
Dependencies
To enable this parameter, select Aerial cables or Underground cables options in the Configuration menu.
H (m)
— Cable horizontal position
0 (default) | scalar
Represent the horizontal position of the cable.
H value can be negative, 0, or positive. You can define the horizontal mark position 0 anywhere in your cable arrangement and define the position of the cables according to this mark. For example, the position 0 can be defined in the center of the cable arrangement, so the cables placed on the left will have a negative H (m) value and those on the right will have a positive H (m) value.
Dependencies
To enable this parameter, select Aerial cables or Underground cables options in the Configuration menu.
X (m)
— Cable position inside pipe
0.00331 (default) | positive scalar
Cable position relative to the center of the pipe, in meters.
Specify the position of the center of the cable relative to the center of the pipe.
Dependencies
To enable this parameter, select Cables in a pipe in the Configuration menu.
Angle (deg)
— Cable position inside pipe
60 (default) | positive scalar
Position angle of the cable inside the pipe, in degrees.
Specify the angle of the imaginary line that represent the distance between the center of the pipe and the center of the cable.
Dependencies
To enable this parameter, select Cables in a pipe in the Configuration menu.
R_out (m)
— Cable external radius
0.0389 (default) | positive scalar
External radius of the cable.
The radius of the of the outer insulation of the cable.
Cable type
— Type of cable
1 (default) | positive integer
Value corresponding to the cable type number defined in the Cable types table.
Phase Number
— Conductor phase numbers
[1,2] (default) | vector of positive integer
Associate each conductor of the cable to the electrical phases of the network. All the conductors for all the cables in the cable configuration need to be associated to an unique phase number. The only exception is phase 0 (meaning that the conductor is grounded) that can be specified for several conductors in several cables.
Phase numbers start with 1 (or 0 if you have grounded conductors) and increase consecutively. The phase numbers do not need to be specified in the numerical order in the table. For example, the following configuration is correct: we have a total of 7 conductors; two are grounded, and all the other conductors are uniquely attributed to a phase number 1,2,3,4, and 5 :
Show cable type
— Number of cable types
1 (default) | list
Select the cable type number and the Cable Types table will show its parameters. The drop-down menu lists all the cable type numbers, from 1 to Number of cable types.
Number of conductors—
— Number of conductors of selected cable type
2 (default) | positive integer
Specify how many concentric conductors exist in the selected cable. When the number of conductors parameter is increased, the app automatically adds a new line in the table with similar parameters as of the previous conductor, and it resizes the R_in and R_out dimensions proportionally..
R_in (m)
— Inside conductor radius
0 (default) | positive scalar
Inside radius of the conductor.
Specify the distance from the center of the cable to the inner part of the conductor. For the first conductor, this value is usually set to 0.
R_out (m)
— Outside conductor radius
0.01265 (default) | positive scalar
Outside radius of the conductor.
Specify the distance from the center of the cable to the outer part of the conductor.
Rho (Ohm.m)
— Conductor resistivity
2.69e-08 (default) | positive scalar
Conductor resistivity.
The resistivity of the conductor in ohm.m
MUE
— Conductor relative permeability
1 (default) | positive scalar
Conductor relative permeability.
The relative permeability of the conductor.
MUE_IN
— Insulation relative permeability
1 (default) | positive scalar
Surrounding insulation relative permeability.
The relative permeability of the insulation that is surrounding the conductor.
EPS_IN
— Insulator relative permittivity
2.3 (default) | positive scalar
Surrounding insulation relative permittivity.
The relative permittivity of the insulation that surrounds the conductor.
LFCT_IN
— Insulator loss factor
0 (default) | positive scalar
Surrounding insulation loss factor.
The loss factor of the insulation that is surrounding the conductor.
A loss factor of 0.001 means that the active power losses (in watts) inside the dielectric is the 0.1% of the reactive power (in vars) associated with the Conductor1-Conductor 2 capacitance.
Pipe Parameters
R_in (m)
— Internal radius
0.24 (default) | positive scalar
Internal radius of the metallic pipe in meters.
R_out (m)
— External metallic pipe radius
0.25 (default) | positive scalar
External radius of the metallic pipe in meters.
R_ext
— Pipe external radius
0.27 (default) | positive scalar
External radius of the outer insulator.
V_depth (m)
— Pipe depth
-2.107 (default) | negative scalar
Depth of center of the pipe below the ground level.
MUE
— Metallic pipe relative permeability
1 (default) | positive scalar
Metallic pipe relative permeability.
MUE_in
— Inner insulation relative permeability
1 (default) | positive scalar
Inside insulation relative permeability.
EPS_in
— Inner insulation relative permittivity
1 (default) | positive scalar
Inside insulation relative permittivity.
LFCT_in
— Inner insulation loss factor
0.001 (default) | positive scalar
Inside insulation loss factor.
Rho (ohm.m)
— Metallic pipe resistivity
1.8e-08 (default) | positive scalar
Pipe resistivity.
The resistivity of the metallic pipe.
MUE_out
— Outer insulation relative permeability
1 (default) | positive scalar
Outside insulation relative permeability.
EPS_out
— Outer insulation relative permittivity
2 (default) | positive scalar
Outside insulation relative permittivity.
LFCT_out
— Outer insulation loss factor
0.001 (default) | positive scalar
Outside insulation loss factor.
Phase number
— Pipe phase number
7 (default) | integer
Phase number connected to the metallic pipe.
Specify a value of 0 to connect the metallic pipe to the electrical ground. Specify a positive integer value between 1 and N+1, where N is the maximum phase number value that is specified in the Phase Number column of the Cable Configuration table.
Computer Parameters Tab
Display the R, L, G, and C matrices resulting of the Compute buttons.
Send to workspace
— Send RLGC, and WB to workspace
button
Sends the R, L, G, C , and WB parameters to the MATLAB workspace. The app creates the variables R, L, G, C, and WB in your workspace.
Block
— Block selector
button
Confirms the block selection. The name of the selected block appears in the Send to block edit parameter.
Block Name
— Selected block name
char string
Edit box to either manually specify the name of a PI Section Line block, Distributed Parameters Line, or Distributed Parameters Line Frequency Dependent block where the RLGC or WB parameters will be sent when the user click the Send button. By default, it displays: – No block specified, and the Send button is grayed out and unavailable.
Send to block
— Send RLGC matrices to the selected block
button
Sends the RLC parameters to the Distributed Parameter Line or Pi Section Line blocks specified in the Send to block parameter. Send the WB parameters via a mat file to the Distributed Parameter Line Frequency Dependent block specified in the Send to block parameter.
Version History
Introduced in R2022b
See Also
Apps
Functions
Blocks
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)
Asia Pacific
- Australia (English)
- India (English)
- New Zealand (English)
- 中国
- 日本Japanese (日本語)
- 한국Korean (한국어)