> 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/rt-lab/simulink-blocks-reference/artemis-library/artemis-vbr-synchronous-machine.md).

# ARTEMIiS VBR Synchronous Machine

## Description

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-36cf7623fe33c47b86afdaf02f40731ff12b127d%2FArtemis_VBR_sync_machine_block.png?alt=media" alt="" width="119"><figcaption></figcaption></figure>

The **3-Phase Synchronous Machine (VBR)** block, located in the **ARTEMiS/Tools/VBR Machines** library, implements a three-phase synchronous machine modeled in the d–q rotor reference frame using the Voltage Behind Reactance (VBR) formulation. The stator windings are wye-connected to an internal neutral point. All parameters must be entered as fundamental parameters referred to the stator. The model supports 5th- or 6th-order configurations with one damper winding on the d-axis and one or two damper windings on the q-axis (round-rotor or salient-pole machines). An optional power port can be added to access the machine neutral point. Saturation is supported using total flux in both d–q axes.

VBR stands for Voltage Behind Reactance. In this approach, the internal model behaves like a voltage source in series with a reactance/impedance, which typically offers better stability than SPS machine models that inject a current source internally.

{% hint style="danger" %}
This block requires a valid RT-LAB license on the simulator with the feature ARTEMiS enabled. Refer to[ ARTEMiS Requirements](https://www.opal-rt.com/docs/rt-lab/model-and-simulation/power-systems-with-artemis/artemis-requirements.md) for details.
{% endhint %}

## Mask parameters

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-560caa49d2c01a8c2157cc888b1d794bf50d9c3d%2FArtemis_VBR_sync_machine_mask.png?alt=media" alt="" width="512"><figcaption></figcaption></figure>

<table data-search="false"><thead><tr><th width="256.4000244140625">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><br><strong>Nominal values</strong><br></td><td>Power(Va), Voltage (Vrms LL), Frequency (Hz), Field Current (A), pair of poles (pp)<br>The field current corresponds to the point on the saturation curve where the nominal terminal voltage is reached at no load. For a non-saturated machine, it is not used in calculations; however, it defines the stator-to-field transformation ratio.</td></tr><tr><td><strong>Stator parameters (SI)</strong></td><td>Rs (ohms), Ll (H), Lmd (H), Lmq(H)<br>Stator resistance and leakage inductance, and magnetization inductances for the d–q axes.</td></tr><tr><td><strong>Field parameters</strong></td><td><p>Rf (ohms), Llfd(H)</p><p>Field resistance and leakage inductance (referred to the stator).</p></td></tr><tr><td><strong>Damper parameters</strong></td><td>Rkd(ohms), Llkd(H), Rkq (ohms), Llkq(H), Rkq2(ohms), Llkq2(H)<br>Damper resistances and leakage inductances for the d–q axes (referred to the stator).</td></tr><tr><td><strong>Initial conditions</strong></td><td>Field current (A), mechanical rotor angle (deg), Peak values Ia, Ib, Ic(A), current angles(deg)<br>Initial conditions for the field current, rotor mechanical angle, and stator phase currents (peak values and angles).</td></tr><tr><td><strong>Saturation curve</strong></td><td>Vectors of field current (A) and terminal voltage (Vrms LL). These are visible and used only when saturation is enabled. The vectors cannot be empty or null.</td></tr><tr><td><strong>Time Step (Ts)</strong></td><td>Sample time of the model in seconds.</td></tr><tr><td><strong>Compensation</strong></td><td>factor Kr, compensation mechanical angle (deg)<br>Normally disabled (Kr = 1, compensation mechanical angle = 0). The first factor compensates losses due to stator resistance at very large Ts. The second adds or subtracts a mechanical angle to the rotor. These parameters are visible only when compensation is enabled.</td></tr></tbody></table>

<details>

<summary>Calculation of initial conditions</summary>

For the following machine parameters and operation point:

**Vn =** 24 kV ; **Lmd =** 4.5696 mH ; **Lmq =** 4.432 mH ; **Llf =** 0.4545 mH

**Ifo =**&#x31;281 A ; **Ia =** 8216.8 A (peak value) , **φa =** -0.067º ; **Ib =** 8216.8 A (peak value) , **φb =** -120.067º ; **Ic =** 8216.8 A (peak value) , **φc =** 119.933º ; **Rotor initial mechanical angle, φr =** -68.9004º ; **Ifn =**&#x31;300 A ; **fn =** 60 Hz

**current DQ calculations**

**Iq =** -2/3•(Ia•sin(φa)•cos(φr)+ Ib•sin(φb)•cos(φr-120º)+ Ic•sin(φc)•cos(φr+120º)) = -7662.44 A

**Id =** -2/3•(Ia•sin(φa)•sin(φr)+ Ib•sin(φb)•sin(φr-120º)+ Ic•sin(φc)•sin(φr+120º)) = -2966.93 A

**Field current (referenced to stator)**

**If' =** 2/3•Ifo•Nf/Ns ; Ns/Nf = 0.8165•Lmd•Ifn•(2•π•fn)/Vn = 0.0762 ; **If' =** 2/3•Ifo•1/0.0762 = 11208.82 A

**Intial Flux linkages calculations**

**λkq =** Lmq•Iq = -33.959 Wb

**λkd =** Lmd•(Id+If')= 37.662 Wb

**λf =** λkd + Llf•If'= 42.756 Wb

</details>

## Inputs

<table><thead><tr><th width="250">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>Vf</strong></td><td>Field voltage referred to the stator (V).</td></tr><tr><td><strong>wm</strong></td><td><p>Mechanical speed (rad/s). Typically provided by a separate mechanical model that uses the electric torque (Te) from this block.</p><p>A simple mechanical model is available in rotating machines using SSN section.</p></td></tr></tbody></table>

## Outputs

<table><thead><tr><th width="250">Output</th><th>Description</th></tr></thead><tbody><tr><td><strong>measures</strong></td><td><p>Measurements available as outputs:</p><p><strong>Vabc</strong>: Stator abc line-to-neutral voltages (V)</p><p><strong>Iabc</strong>: Stator abc currents coming out of the machine (A)</p><p><strong>Vqd</strong>: Stator qd voltages (V)</p><p><strong>Iqd</strong>: Stator qd currents (A)</p><p><strong>If</strong>: Field current (A)</p><p><strong>Te</strong>: Electric torque (N·m)</p><p><strong>Pe</strong>: Total electrical power generated (W)</p><p><strong>phimqd</strong>: Magnetizing flux linkages (Wb)</p></td></tr></tbody></table>


---

# 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/rt-lab/simulink-blocks-reference/artemis-library/artemis-vbr-synchronous-machine.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.
