> 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/sources/three-phase-source.md).

# Three Phase Source

## Description

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

The **Three Phase Source** block, located in the **OPAL-RT SPS Software/Sources** library, implements a balanced three-phase voltage source with an internal R-L impedance. The three voltage sources are connected in Y with a neutral connection that can be internally grounded or made accessible. You can specify the source internal resistance and inductance either directly by entering R and L values or indirectly by specifying the source inductive short-circuit level and X/R ratio.

## Ports

#### Conserving

<table data-header-hidden><thead><tr><th width="193.20001220703125"></th><th></th></tr></thead><tbody><tr><td><strong>A</strong> — A-phase<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the A-phase of the block.</td></tr><tr><td><strong>B</strong> — B-phase<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the B-phase of the block.</td></tr><tr><td><strong>C</strong> — C-phase<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the C-phase of the block.</td></tr><tr><td><strong>N</strong> — Neutral connection<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the neutral connection of the block.<br><strong>Dependencies</strong> To enable this port, set <strong>Configuration</strong> to <code>Yn</code>.</td></tr></tbody></table>

## Parameters

#### Parameters Tab

<table data-header-hidden><thead><tr><th width="220"></th><th></th></tr></thead><tbody><tr><td><strong>Configuration</strong> — Internal connection of three voltage sources<br><code>Yg</code> (default) | <code>Yn</code> | <code>Y</code></td><td>The internal connection of the three internal voltage sources. The block icon changes according to the source connection:<br><code>Y</code>:The block connects the three voltage sources in Y to an internal floating neutral.<br><code>Yn</code>: The block connects the three voltage sources in Y to a neutral connection which is accessible through a fourth terminal.<br><code>Yg</code>: Default. The block connects the three voltage sources in Y to an internally grounded neutral.</td></tr><tr><td><strong>Specify internal voltages for each phase</strong> — Option for internal voltages for each phase<br><code>off</code> (default) | <code>on</code></td><td>Option to specify the internal voltage for each phase.</td></tr><tr><td><strong>Phase-to-phase voltage (Vrms)</strong> — Internal phase-to-phase voltage<br><code>25e3</code> (default)</td><td>Internal phase-to-phase voltage, in volts RMS.<br><strong>Dependencies</strong> To enable this parameter, clear the <strong>Specify internal voltages for each phase</strong> parameter.</td></tr><tr><td><strong>Phase angle of phase A (degrees)</strong> — Phase angle of phase A<br><code>0</code> (default)</td><td>Phase angle of the internal voltage that phase A generates, in degrees. The three voltages are generated in a positive sequence. For this reason, phase B and phase C internal voltages lag phase A by 120 degrees and 240 degrees, respectively.<br><strong>Dependencies</strong> To enable this parameter, clear the <strong>Specify internal voltages for each phase</strong> parameter.</td></tr><tr><td><strong>Line-to-neutral voltages [Va Vb Vc] (Vrms)</strong> — Internal line-to-neutral voltages<br><code>[25e3 25e3 25e3]/sqrt(3)</code> (default)</td><td>Internal line-to-neutral voltage of phase A, B, and C, in volts RMS.<br><strong>Dependencies</strong> To enable this parameter, select the <strong>Specify internal voltages for each phase</strong> parameter.</td></tr><tr><td><strong>Phase angle of line-to-neutral voltages [phia phib phic] (deg)</strong> — Phase angle of line-to-neutral voltages<br><code>[0 -120 +120]</code> (default)</td><td>Phase angles of the internal voltages generated by phase A, B, and C, in degrees.<br><strong>Dependencies</strong> To enable this parameter, select the <strong>Specify internal voltages for each phase</strong> parameter.</td></tr><tr><td><strong>Frequency (Hz)</strong> — Source frequency<br><code>60</code> (default)</td><td>Source frequency, in hertz (Hz).</td></tr><tr><td><strong>Internal</strong> — Option to model internal RL inductance<br><code>on</code> (default) | <code>off</code></td><td>Whether to model an internal RL inductance.</td></tr><tr><td><strong>Specify short-circuit level parameters</strong> — Option to specify internal impedance<br><code>off</code> (default) | <code>on</code></td><td>Whether to specify internal impedance using the inductive short-circuit level and X/R ratio.<br><strong>Dependencies</strong> To enable this parameter, select the <strong>Internal</strong> parameter.</td></tr><tr><td><strong>Source resistance (Ohms)</strong> — Source internal resistance<br><code>0.8929</code> (default)</td><td>Source internal resistance, in ohms (Ω).<br><strong>Dependencies</strong> To enable this parameter, clear the <strong>Internal</strong> and <strong>Specify short-circuit level parameters</strong> parameters.</td></tr><tr><td><strong>Source inductance (H)</strong> — Source internal inductance<br><code>16.58e-3</code> (default)</td><td>Source internal inductance, in henries (H).<br><strong>Dependencies</strong> To enable this parameter, clear the <strong>Internal</strong> and <strong>Specify short-circuit level parameters</strong> parameters.</td></tr><tr><td><strong>3-phase short-circuit level at base voltage(VA)</strong> — Three-phase inductive short-circuit power<br><code>100e6</code> (default)</td><td><p>Three-phase inductive short-circuit power, in volts-amperes (VA), at specified base voltage. The block uses this value to compute the internal inductance L. This equation computers the internal inductance L (in H) from the inductive three-phase short-circuit power P<sub>sc</sub> (in VA), base voltage V<sub>base</sub> (in Vrms phase-to-phase), and source frequency f (in Hz):</p><p><span class="math">\\[4pt] L=\frac{V_{base}^2}{P_{sc}} \cdot \frac{1}{2\pi f}\\[4pt]</span></p><p><br><strong>Dependencies</strong> To enable this parameter, select the <strong>Internal</strong> and <strong>Specify short-circuit level parameters</strong> parameters.</p></td></tr><tr><td><strong>Base voltage (Vrms ph-ph)</strong> — Phase-to-phase base voltage<br><code>25e3</code> (default)</td><td>Phase-to-phase base voltage, in volts RMS. Use this parameter to specify the three-phase short-circuit level. Default is <code>25e3</code>. The base voltage is usually the nominal source voltage.<br><strong>Dependencies</strong> To enable this parameter, select the <strong>Internal</strong> and <strong>Specify short-circuit level parameters</strong> parameters.</td></tr><tr><td><strong>X/R ratio</strong> — X/R ratio at nominal source frequency<br><code>7</code> (default)</td><td><p>X/R ratio at nominal source frequency or quality factor of the internal source impedance. This equation computes the internal resistance R (in ohms) from the source reactance X (in ohms) at specified frequency, and X/R ratio:</p><p><span class="math">\\[4pt] R=\frac{X}{X/R}=\frac{2\pi fL}{X/R}\\[4pt]</span><br><strong>Dependencies</strong> To enable this parameter, select the <strong>Internal</strong> and <strong>Specify short-circuit level parameters</strong> parameters.</p></td></tr></tbody></table>

## Load Flow

The Load Flow tool of the powergui block uses the parameters in this section. These load flow parameters are used for model initialization only, they have no impact on the block model and on the simulation performance.

The configuration of the **Load Flow** tab depends on the option you select for the **Generator type** parameter.

<table data-header-hidden><thead><tr><th width="180"></th><th></th></tr></thead><tbody><tr><td><strong>Generator type</strong> — Generator type of the voltage source<br><code>swing</code> (default) | <code>PV</code> | <code>PQ</code></td><td><p>Specify the generator type of the voltage source:</p><ul><li><code>swing</code> — Implement a generator controlling magnitude and phase angle of its terminal voltage. The <strong>Swing bus or PV bus voltage</strong> and <strong>Swing bus voltage angle</strong> parameters of the Load Flow Bus block connected to the voltage source terminals specify the reference voltage magnitude and angle.</li><li><code>PV</code> — Implement a generator controlling its output active power P and voltage magnitude V. The <strong>Active power generation P</strong> parameter of the block specifies the value of the output active power P. The <strong>Swing bus or PV bus voltage</strong> parameter of the Load Flow Bus block connected to the voltage source terminals specifies the value of the voltage magnitude V. You can control the minimum and maximum reactive power of this block by using the <strong>Minimum reactive power Qmin</strong> and <strong>Maximum reactive power Qmax</strong> parameters.</li><li><code>PQ</code> — Implement a generator controlling its output active power P and reactive power Q. The <strong>Active power generation P</strong> and <strong>Reactive power generation Q</strong> parameters of the block specify the values of the output active power P and reactive power Q, respectively.</li></ul></td></tr><tr><td><strong>Active power generation P (W)</strong> — Desired active power<br><code>10e3</code> (default)</td><td>Desired active power that the source generates, in watts.<br><strong>Dependencies</strong> To enable this parameter, set <strong>Generator type</strong> to <code>PV</code> or <code>PQ</code> and clear the** Specify internal voltages for each phase** parameter.</td></tr><tr><td><strong>Reactive power generation Q (var)</strong> — Desired reactive power<br><code>0</code> (default)</td><td>Desired reactive power that the source generates, in vars.<br><strong>Dependencies</strong> To enable this parameter, set <strong>Generator type</strong> to <code>PQ</code> and clear the** Specify internal voltages for each phase** parameter.</td></tr><tr><td><strong>Active power generation [Pa Pb Pc] (W)</strong> — Desired active power that each phase of source generates<br><code>[10e3, 10e3, 10e3]</code> (default)</td><td>Desired active power that each phase of the source generates, in watts.<br><strong>Dependencies</strong> To enable this parameter, set <strong>Generator type</strong> to <code>PV</code> or <code>PQ</code> and select the** Specify internal voltages for each phase** parameter.</td></tr><tr><td><strong>Reactive power generation [Qa Qb Qc] (var)</strong> — Desired reactive power that each phase of source generates<br><code>[0, 0, 0]</code> (default)</td><td>Desired reactive power that each phase of the source generates, in vars.<br><strong>Dependencies</strong> To enable this parameter, set <strong>Generator type</strong> to <code>PQ</code> and select the** Specify internal voltages for each phase** parameter.</td></tr><tr><td><strong>Minimum reactive power Qmin or [Qamin,Qbmin Qcmin] (var)</strong> — Minimum reactive power that source can generate<br><code>-inf</code> (default)</td><td>Minimum reactive power that the source can generate while keeping the terminal voltage at its reference value. The <strong>Swing bus or PV bus voltage</strong> parameter of the Load Flow Bus block connected to the source terminals specifies this reference voltage. The default value is <code>-inf</code>, which means that there is no lower limit on the reactive power output.<br><strong>Dependencies</strong> To enable this parameter, set <strong>Generator type</strong> to <code>PV</code>.</td></tr><tr><td><strong>Maximum reactive power Qmax or [Qamax,Qbmax Qcmax] (var)</strong> — Maximum reactive power that source can generate<br><code>inf</code> (default)</td><td>Maximum reactive power that the source can generate while keeping the terminal voltage at its reference value. The <strong>Swing bus or PV bus voltage</strong> parameter of the Load Flow Bus block connected to the source terminals specifies this reference voltage. The default value is <code>inf</code>, which means that there is no upper limit on the reactive power output.<br><strong>Dependencies</strong> To enable this parameter, set <strong>Generator type</strong> to <code>PV</code>.</td></tr></tbody></table>

## Examples

See the [Three-Phase Series Compensated Network](https://opal-rt.atlassian.net/wiki/spaces/PSPS/pages/1551800082/Three-Phase+Series+Compensated+Network) example, which uses a Three-Phase Source block to model a portion of a 735 kV system with a simplified R-L source. The source impedance is specified by using the three-phase short-circuit level (30,000 MVA) and X/R ratio (X/R = 10).


---

# 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/sources/three-phase-source.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.
