> For the complete documentation index, see [llms.txt](https://www.opal-rt.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/basics/passives/series-rlc-branch.md).

# Series RLC Branch

## Description

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-b6229f55e958d09d27ec11383738693919cf9046%2Fserie_RLC_load_block.png?alt=media" alt=""><figcaption></figcaption></figure>

The **Series RLC Branch** block, located in the **OPAL-RT SPS Software/Passives** library, implements a single resistor, inductor, or capacitor, or a series combination of these. Use the **Branch type** parameter to select elements you want to include in the branch.

Negative values are allowed for resistance, inductance, and capacitance.

## Ports

### Conserving

<table><thead><tr><th width="191.59991455078125">Port</th><th>Description</th></tr></thead><tbody><tr><td><strong>+</strong> — Positive terminal<br>specialized electrical</td><td>Specialized electrical conserving port associated with the positive terminal.</td></tr><tr><td><strong>-</strong> — Negative terminal<br>specialized electrical</td><td>Specialized electrical conserving port associated with the negative terminal.</td></tr></tbody></table>

## Parameters

<table><thead><tr><th width="202">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Branch type</strong> — Branch type<br>RLC (default) | R | L | C | RL | <a data-footnote-ref href="#user-content-fn-1">RC </a>| <a data-footnote-ref href="#user-content-fn-2">LC </a>| Open circuit</td><td>Elements you want to include in the branch. The R letter defines the resistor, the L letter defines the inductor, and the C letter defines the capacitor. Set this parameter to Open circuit to define an open circuit (R=0, L=0, C=inf). The block icon displays only existing elements.</td></tr><tr><td><strong>Resistance (Ohms)</strong> — Branch resistance<br>1 (default) | scalar</td><td>Branch resistance, in Ohms.<br><strong>Dependencies</strong>: To enable this parameter, set the <strong>Branch type</strong> parameter to RLC, R, RL, or RC.</td></tr><tr><td><strong>Inductance (H)</strong> — Branch inductance<br>1e-3 (default) | scalar</td><td>Branch inductance, in H.<br><strong>Dependencies</strong>: To enable this parameter, set the <strong>Branch type</strong> parameter to RLC, L, RL, or LC.</td></tr><tr><td><strong>Set the initial inductor current</strong> — Option to set the initial inductor current<br>off (default) | on</td><td>Select this option to specify the initial inductor current. If you clear this parameter, the software calculates the initial inductor current in order to start the simulation in steady state.<br><strong>Dependencies</strong>: To enable this parameter, set the <strong>Branch type</strong> parameter to RLC, L, RL, or LC.</td></tr><tr><td><strong>Inductor initial current (A)</strong> — Initial inductor current<br><code>0</code> (default) | scalar</td><td>Initial inductor current, in A, to use at the start of the simulation.<br><strong>Dependencies</strong>: To enable this parameter, select the <strong>Set the initial inductor current</strong> parameter.</td></tr><tr><td><strong>Capacitance (F)</strong> — Branch capacitance<br>1e-6 (default) | scalar</td><td>Branch capacitance, in F.<br><strong>Dependencies</strong>: To enable this parameter, set the <strong>Branch type</strong> parameter to RLC, C, RC, or LC.</td></tr><tr><td><strong>Set the initial capacitor voltage</strong> — Option to set the initial capacitor voltage<br>off (default) | on</td><td>Select this option to specify the initial capacitor voltage. If you clear this parameter, the software calculates the initial capacitor voltage in order to start the simulation in steady state.<br><strong>Dependencies</strong>: To enable this parameter, set the <strong>Branch type</strong> parameter to RLC, C, RC, or LC.</td></tr><tr><td><strong>Capacitor initial voltage (V)</strong> — Capacitor initial voltage<br>0 (default) | scalar</td><td>Initial capacitor voltage, in V, to use at the start of the simulation.<br><strong>Dependencies</strong>: To enable this parameter, select the <strong>Set the initial capacitor voltage</strong> parameter.</td></tr><tr><td><strong>Measurements</strong> — Measurements<br>None (default) | Branch voltage | Branch current | Branch voltage and current</td><td>Measurements to use during simulation. Set this parameter to Branch voltage to measure the voltage across the terminals. Set this parameter to Branch current to measure the current flowing through the block. Set this parameter to Branch voltage and current to measure the voltage across the terminals and the current flowing through the block. Place a Multimeter block in your model to display the selected measurements during the simulation. In the <strong>Available Measurements</strong> list box of the Multimeter block, the measurement is identified by a label followed by the block name.</td></tr></tbody></table>

Measurement labels in the Multimeter block:

| Measurement    | Label |
| -------------- | ----- |
| Branch voltage | Ub:   |
| Branch current | Ib:   |

## Examples

Obtain the frequency response of a fifth-harmonic filter (tuned frequency = 300 Hz) connected on a 60 Hz power system. This example is available in the power\_seriesbranch model.

The network impedance in the Laplace domain is

$$
Z(s) = \frac{V(s)}{I(s)} = \frac{LCs^{2} + RCs + 1}{Cs}.
$$

To obtain the frequency response of the impedance you have to get the state-space model (A B C D matrices) of the system.

This system is a one-input (Vsource) and one-output (Current Measurement block) system.

{% hint style="info" %}
If you have Control System Toolbox™ software installed, you can use the `bode` function to get the transfer function Z(s) from the state-space matrices as follows:
{% endhint %}

```matlab
[A,B,C,D] = power_analyze('power_seriesbranch');
freq = logspace(1,4,500);
w = 2*pi*freq;
[Ymag,Yphase] = bode(A,B,C,D,1,w);
% invert Y(s) to get Z(s)
Zmag = 1./Ymag;
Zphase = -Yphase;
subplot(2,1,1)
loglog(freq,Zmag)
grid
title('5th harmonic filter')
xlabel('Frequency, Hz')
ylabel('Impedance Zmag')
subplot(2,1,2)
semilogx(freq,Zphase)
xlabel('Frequency, Hz')
ylabel('phase Z')
grid
```

You can also use the Impedance Measurement block and the Powergui block to plot the impedance as a function of frequency. In order to measure the impedance you must disconnect the voltage source.

[^1]: **RC** refers to a circuit configuration that includes a resistor (R) and a capacitor (C) connected in series or parallel. This configuration is commonly used in filtering applications, where it can help manage signal frequencies by allowing certain frequencies to pass while attenuating others. In simulations, RC circuits can be adjusted for resistance and capacitance values to achieve desired filtering effects.

[^2]: **LC** refers to a type of electrical filter that combines an inductor (L) and a capacitor (C) in series or parallel configurations. This filter is commonly used in power electronics to reduce noise and smooth out voltage and current waveforms. In the context of simulations, an LC filter can help manage the output ripple from inverters, enhancing performance by filtering high-frequency noise and stabilizing the output signals.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/basics/passives/series-rlc-branch.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
