> 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/hypersim/model-and-simulation/edit-a-model-schematic/navigate-around-a-schematic/define-the-system-unit.md).

# Define the System Unit

## Overview

Depending on the component type, HYPERSIM provides different unit systems for entering parameter values.

<table><thead><tr><th width="120">Unit type</th><th>Description</th></tr></thead><tbody><tr><td><strong>SI</strong></td><td>Input parameters in <strong>International System</strong> of Units format (volt, ampere, watt, ohm, henry, farad)</td></tr><tr><td><strong>PU</strong></td><td>Input parameters in <strong>per-unit format</strong>; the choice of a reference base voltage, power and frequency is mandatory</td></tr><tr><td><strong>PQ</strong></td><td>Input parameters in <strong>active and reactive power</strong> format; the choice of a reference base voltage is mandatory</td></tr><tr><td><strong>A</strong></td><td>Used only for neutral impedance of transformers, input parameters in <strong>current ratio</strong></td></tr></tbody></table>

## PU system

Power transmission systems operate at voltage levels where the **kilovolt (kV)** is the most practical unit for expressing voltage. Because large amounts of power are transmitted, quantities such as **kilowatts (kW)**, **megawatts (MW)**, **kilovolt-amperes (kVA)**, and **megavolt-amperes (MVA)** are commonly used. However, electrical quantities such as voltage, current, power, and impedance are often expressed in the **per-unit (PU)** system relative to a chosen set of base values.

### Definition

The per-unit value of a quantity is defined as:

$$
\text{Per-unit value} = \frac{\text{Actual value}}{\text{Base value}}
$$

For example, if the base voltage is **120 kV**:

* 108 kV = 0.90 PU
* 120 kV = 1.00 PU
* 126 kV = 1.05 PU

Equivalent percentage values are 90%, 100%, and 105%, respectively.

Using per-unit values simplifies calculations by normalizing electrical quantities to common reference values. Unlike percentages, per-unit values can be multiplied and divided directly without additional scaling factors, making them especially convenient for power system analysis.

### Base Quantities

Four electrical quantities are related in the per-unit system:

* Voltage
* Current
* Apparent power (VA, kVA, or MVA)
* Impedance

Specifying any two base quantities automatically determines the other two. In power system studies, the most common approach is to specify:

* **Base voltage (kV)**
* **Base apparent power (MVA)**

The remaining base quantities are then calculated from these values.

The **base impedance** is the impedance that produces the base voltage drop when carrying the base current. For single-phase systems, or when three-phase quantities are expressed on a per-phase basis:

$$
\text{Base Power} = \text{Base Voltage} × \text{Base Current}
$$

From the selected base voltage and base power, the base current and base impedance can be derived using standard per-unit relationships.

<table data-header-hidden data-search="false"><thead><tr><th width="239.77777099609375"></th><th></th></tr></thead><tbody><tr><td>Base current (A)</td><td>Base phase power [kVA] / Base voltage [kV<sub>LN</sub>]</td></tr><tr><td>Base impedance</td><td>= Base voltage [(V<sub>LN</sub>] / Base current [A]<br>= (Base voltage [kV<sub>LN</sub>])<sup>2</sup> x 1000 / Base phase power [kVA]<br>= (Base voltage [kV<sub>LN</sub>])<sup>2</sup> / Base phase power [MVA]</td></tr><tr><td>Base phase power [kW]</td><td>= Base phase power [kVA]</td></tr><tr><td>Base phase power [mW]</td><td>= Base phase power [mVA]</td></tr><tr><td>Per unit impedance of a circuit element</td><td>= Actual impedance (Ω) / Base impedance (Ω)</td></tr></tbody></table>

The per-unit system is widely used because it simplifies calculations, facilitates comparisons between equipment operating at different voltage levels, and makes the analysis of large power networks more intuitive.

## Examples

### Conversion Example Between SI, PU and PQ

As an example, the **RLC Load** parameter dialog box provides three parameterization options, as shown below.

When the **SI** unit system is selected, the user must enter the resistance, inductance, and capacitance values directly in **ohms (Ω)**, **henries (H)**, and **farads (F)**, respectively.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-f2f1f33cb832cbe0c949e4bf119b5f3d175338c5%2FRLC-unit-si.png?alt=media" alt=""><figcaption><p>In SI unit</p></figcaption></figure>

The same load can be parameterized in the **PU** system by defining its values relative to the selected **base voltage**, **base MVA**, and **base frequency**.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-5fe060cdeb2ef6eb3f800581cd962c542fbc97df%2FRLC-pu-unit.png?alt=media" alt=""><figcaption><p>In pu unit</p></figcaption></figure>

Finally, it is possible to set network load values in **active (P)** and in **reactive (Q)** power units.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-86930522c1bd01442a8fcb8fe0cdd800b85b1713%2FRLC-pq-unit.png?alt=media" alt=""><figcaption><p>in P and Q unit</p></figcaption></figure>

<details>

<summary><strong>Unit conversion equations</strong></summary>

$$R\_{Base \text{(per phase)}}= \frac{V^2}{P\_{Base \text{(per phase)}}}= \frac{(100e^3)^2}{100e^6}=100 \Omega$$

$$R=0.01 \Omega=0 \cdot 0001 \space \text{pu}$$

$$L\_{B a s e\space \text {(per phase)}}=\frac{R\_{\text {base}(\text {per phase})}}{2 \pi f(\text {per phase})}=0.265259 \mathrm{ H}$$

$$0.1 \text{H} \rightarrow 0 \cdot 37699 \space \text{pu}$$

$$C\_{B a s e \text {(per phase)}}=\frac{1}{R\_{base\text { (per phase} ) \mathrm{x} 2 \pi f}}=2.6252e^{-5} \text{ F}$$

$$1 e^{-7} \text{F}=3.809 e^{-3}$$

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-71e097747ec307bfc0a2e7d7b927ab219c62f909%2FRLC-pq-unit-options.png?alt=media" alt="" width="467"><figcaption></figcaption></figure>

$$I= \frac{V}{0 \cdot 01 \Omega \sqrt{(2 L-2 C)^{2}+R^{2}}}=3.775437 \text{ A}$$

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-f70bc504e698b15138b9e29eee4b57d37ee13b8b%2FRLC-unit-conversion.png?alt=media" alt="" width="133"><figcaption></figcaption></figure>

$$\sqrt{(2 L-2 C)^{2}+R^{2}}=26.4873 e^{3} \Omega$$

$$\frac{100 k V(p-t)}{26 \cdot 487 e^{3}}=3 \cdot 775437 \text{ A}$$

$$P=(R \text{ or } Z) \times I^{2}$$

$$P\_{MW}=\frac{0.01 \times(3.775437 A)^{2}}{1e^6}=1.4253 e^{-7} \text{ MW}$$

$$P\_{ZL}=\frac{37.7 \Omega \times(3.775437 A)^{2}}{1e^6}=0.0005373 \text{ MVAR}$$

$$P\_{ZC}=\frac{26525 \Omega \times(3.775437 A)^{2}}{1e^6}=0.37806 \text{ MVAR}$$

</details>

### Transformer Neutral Impedance

For transformers, the **base voltage** is determined by the selected winding (primary or secondary). In addition, because the **neutral impedance** is not associated with a specific winding, it can be specified either in **SI units** (volt, ampere, watt, ohm, henry, farad) or in **amperes (A)** the current ratio.

Users can choose the unit system that best suits their needs directly in the component parameter dialog box. Where supported, the displayed unit system can be changed by right-clicking the unit field associated with the parameter and selecting the desired option from the context menu.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-bf40b0d6da432de3d896413a8b5795ad8b1e6104%2Fimage%20(1037).png?alt=media" alt=""><figcaption></figcaption></figure>

<details>

<summary><strong>Unit conversion equations</strong></summary>

To determine the RLC parameters from the specified current ratio, the current flowing through each branch, $$I\_b$$​, is first calculated using the following expression:

$$\omega\_b=2\pi \cdot F\_b$$

$$X\_L=\omega\_b\cdot L$$

$$X\_C=\frac{1}{\omega\_b \cdot C}$$

$$Z\_b = \sqrt{ R^2 + \[X\_L - X\_C]^2 }$$

$$I\_b=\frac{V\_b}{Z\_b}$$

where $$V\_b$$​ and $$F\_b$$​ are the base voltage and base frequency, respectively.

The R, L, and C values can then be expressed in the **A** unit system using the following equations:

$$R => A = R \cdot \frac{I\_b^2}{ V\_b} \\$$

$$L => A = X\_L \cdot \frac{I\_b^2}{ V\_b} \\$$

$$C => A = X\_C \cdot \frac{I\_b^2}{ V\_b} \\$$

The **PQ** unit system is not available for neutral impedance. However, the equivalent parameters can be calculated using the following equations:

$$P = I\_b^2 \cdot R \text{ (W)}$$

$$Q\_L = I\_b^2 \cdot X\_L\text{ (VAR)}$$

$$Q\_C = I\_b^2 \cdot X\_C \text{ (VAR)}$$

</details>


---

# 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/hypersim/model-and-simulation/edit-a-model-schematic/navigate-around-a-schematic/define-the-system-unit.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.
