Network Coupler (Inductor)

Split network at an electrical connection by replacing an inductor

Since R2022a

• 

Libraries:
Simscape / Utilities / Network Couplers

Description

The Network Coupler (Inductor) block uses a line inductance to break a network connection. It can be useful for breaking both AC and DC network connections.

Both of the port interfaces of the Network Coupler (Inductor) block are implemented as current sources. Therefore:

• You cannot connect other inductors or current sources in series with the Network Coupler (Inductor) block because this would cause an Index-2 topology (for more information, see Avoiding Numerical Simulation Issues). If you can, lump all series inductances into one block and split the network using this block.

• The connection made with the Network Coupler (Inductor) block conveys no referencing information. If you split all connections between two networks using this block, then both networks must contain at least one Electrical Reference block. When this is not the case, consider using one of the other electrical coupler blocks for at least one of the connections.

Working with the Block on the Model Canvas

When you add the block to your model and double-click it, the Network Coupler (Inductor) subsystem opens.

The Port 1 Interface block contains the dynamics that break the algebraic loop. Double-click this block to set all of the Network Coupler (Inductor) subsystem parameters and view the derived values.

The rate transition blocks are, by default, commented through. Uncomment them if at least one of the coupled networks is running fixed step.

Using the Derived Values to Estimate Block Parameters

On the Analysis tab of the Port 1 Interface block dialog box, the Derived values section contains a list of recommended values that you can use when specifying block parameters. For example, use the Recommended max discrete sample time (s) derived value to verify that your Port 1 network discrete sample time (s) and Port 2 network discrete sample time (s) parameter values are within acceptable limits.

The derived values list is based on the chosen block configuration.

If both networks are running variable step, then the Analysis tab is empty, and there are no restrictions on the inductance value you specify.

If one or both networks are running fixed step, then the resulting RL time constant arising from the inductor and connected network resistance must not be faster than can be adequately sampled by the fixed step rate. The Analysis tab provides assistance on the recommended maximum sample time, based on the inductance value and the approximate connected network resistance value specified. If the resistances of the two networks differ, provide the lower value.

The Update button lets you recalculate the derived values after you change the parameters of the connected networks.

Ports

Conserving

1 — Connect this port to the variable-step network, or to the fixed-step network with the smaller sample time

electrical

If one of the coupled networks is running variable step, connect it to port 1 of the Network Coupler (Inductor) block. If both networks are running fixed step, connect this port to the network with the smaller sample time. If both networks are running variable step, or fixed step with the same step size, then the block polarity does not matter.

2 — Connect this port to the fixed-step network with the larger sample time

electrical

If one of the coupled networks is running variable step, connect port 2 of the Network Coupler (Inductor) block to the fixed-step network. If both networks are running fixed step, connect this port to the network with the larger sample time.

Parameters

Main

Inductance (H) — Specify inductance value

1e-3 (default) | positive scalar

Specify the inductance value. Use the Inductance parameter value from the Inductor block being replaced, converting it to H, if necessary.

Sampling type — Select sampling types scenario for coupled networks

Variable step at ports 1 and 2 (default) | Variable step at port 1 and fixed step at port 2 | Fixed step both ports with common sample time | Fixed step both ports with faster sampling at port 1

Select how the coupled networks are sampled:

• Variable step at ports 1 and 2 — Both networks are variable-step.

• Variable step at port 1 and fixed step at port 2 — Network 1 is variable-step and Network 2 is fixed-step.

• Fixed step both ports with common sample time — Both networks are fixed-step, with the same step size.

• Fixed step both ports with faster sampling at port 1 — Both networks are fixed-step, with different step sizes.

Port 1 network discrete sample time (s) — Specify sample time for Network 1

0.0002 (default) | positive scalar

Specify sample time for Network 1, in seconds.

Dependencies

To enable this parameter, set the Sampling type parameter to Fixed step both ports with common sample time or Fixed step both ports with faster sampling at port 1.

Port 2 network discrete sample time (s) — Specify sample time for Network 2

0.001 (default) | positive scalar

Specify sample time for Network 2, in seconds.

Dependencies

To enable this parameter, set the Sampling type parameter to Variable step at port 1 and fixed step at port 2 or Fixed step both ports with faster sampling at port 1.

Use prediction when connecting fixed step to variable step — Lets you enable the prediction (discrete->continuous) algorithm

off (default) | on

Select this check box to enable the prediction (discrete->continuous) algorithm. For more information, see Prediction and Smoothing.

Dependencies

To display this option, set the Sampling type parameter to Variable step at port 1 and fixed step at port 2.

Use smoothing when connecting variable step to fixed step — Lets you enable the smoothing (continuous->discrete) algorithm

off (default) | on

Select this check box to enable the smoothing (continuous->discrete) algorithm. For more information, see Prediction and Smoothing.

Dependencies

To display this option, set the Sampling type parameter to Variable step at port 1 and fixed step at port 2.

Smoothing time constant (s) — Specify time constant for the first-order filter

0.01 (default) | positive scalar

Specify time constant, in seconds, for the first-order filter that the smoothing algorithm uses to remove unwanted high-frequency information.

Dependencies

To enable this parameter, select the Use smoothing when connecting variable step to fixed step check box.

Use prediction when connecting slow to fast sample times — Lets you enable the prediction (slow->fast) algorithm

off (default) | on

Select this check box to enable the prediction (slow->fast) algorithm. For more information, see Prediction and Smoothing.

Dependencies

To display this option, set the Sampling type parameter to Fixed step both ports with faster sampling at port 1.

Use smoothing when connecting fast to slow sample times — Lets you enable the smoothing (fast->slow) algorithm

off (default) | on

Select this check box to enable the smoothing (fast->slow) algorithm. For more information, see Prediction and Smoothing.

Dependencies

To display this option, set the Sampling type parameter to Fixed step both ports with faster sampling at port 1.

Number of samples over which to smooth — Specify number of samples for averaging

1 (default) | positive scalar

The smoothing algorithm works by averaging the last N samples. You specify N by using this parameter.

Dependencies

To enable this parameter, select the Use smoothing when connecting fast to slow sample times check box.

Analysis

Approximate connected network resistance (ohms) — Specify approximate resistance of connected network

0.1 (default) | positive scalar

Specify approximate resistance of the connected network, in ohm. If the resistances of the two networks differ, provide the lower value.

Dependencies

To enable this parameter, set the Sampling type parameter to Variable step at port 1 and fixed step at port 2, Fixed step both ports with common sample time, or Fixed step both ports with faster sampling at port 1.

For information on how to use the Derived values section, see Using the Derived Values to Estimate Block Parameters.

Initial Conditions

Initial current (A) — Specify initial current transmitted by the inductor

0 (default) | positive scalar

Specify initial condition for the current transmitted by the inductor, in A.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2022a