> 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.md).

# Design a Schematic

{% stepper %}
{% step %}

## Choose your design preferences

Open an existing document or create a new one.

In the **Options ribbon**, click **Design Preferences** to open the dialog box, then choose your settings for the background grid, border, crosshairs, and other display options.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-1a149677c61f9c65991883097c21b7be42892469%2Fdesign-preferences-block.png?alt=media" alt="" width="497"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Adjust the work area

in the **View ribbon**, click **Reduce to fit** command (CtrlL+Shift+F) or use the **zoom** commands.
{% endstep %}

{% step %}

## Add blocks from library

Add blocks to the schematic by dragging them from the **Parts Library** into the work area.

Move a block by clicking and dragging it. Right-click a block to open the context menu, or use [keyboard shortcuts](https://www.opal-rt.com/docs/hypersim/model-and-simulation/edit-a-model-schematic/navigate-around-a-schematic/common-keyboard-shortcuts.md) to rotate, flip, copy, paste or delete it.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-5a08e1f627ef7734c16bf2e70da289c54718af07%2Fblock-menu-contextuel.png?alt=media" alt="" width="324"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Add the **Point-On-Wave (POW) block**

The [**Point-on-Wave (POW)**](https://www.opal-rt.com/docs/hypersim/library-blocks-reference/network-tools/point-on-wave-synchronization.md) block, located in the **Network Tools library**, is mandatory in all models that include **network blocks**. It is used to synchronize acquisition in time.

The POW block operates by monitoring the signal of one phase at the bus to which it is connected; therefore, ensure that the system is stable at that location. Placing it near a generator is recommended, as it helps maintain a stable voltage sine wave.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-b156947495b0ac3e7bf912278a7576e3211d4756%2Fadd-pow-example.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Set parameter values

Double-click the block to open its parameter dialog box. For more information on how to configure it, refer to the [Library Blocks Reference](broken://spaces/N9x5CUu79pubjsBH7Ja1/pages/CkgCJ6bLso31hzRDfitz) section.

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

Depending on the block type, users can choose the [**system units**](https://www.opal-rt.com/docs/hypersim/model-and-simulation/edit-a-model-schematic/navigate-around-a-schematic/define-the-system-unit.md) for parameter input.

Users can also specify values using [**variables or mathematical expressions**](https://github.com/Opal-RT-Technologies/product-docs-hypersim/tree/release-2026.4/model-and-simulation/use-variables-and-expressions/README.md), with or without references to other elements.
{% endstep %}

{% step %}

## Name devices

To rename a block, right-click the block and select **Name** from the context menu, or double-click the block’s name.

If the block name is not displayed, open the **Design** ribbon and select the **Show Device Names** command.

{% hint style="info" %}
Note that the following characters are not supported: " !@#$%^\~&\*-+=|\\/?\`:;,.<>()\[]{}|
{% endhint %}
{% endstep %}

{% step %}

## Add signals

In HYPERSIM, a signal represents an **electrical connection** linking any number of device pins. On a schematic, a signal may be depicted as a single line or a series of connected line segments.

### Connect blocks

To connect one block to another, hover over a block’s port, then click and drag to create the connection. The signal type is automatically adjust.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-6920fd5106235df03dd58364b2e3c4aca674fe37%2Fcreate-signal.gif?alt=media" alt=""><figcaption></figcaption></figure>

To view or change the signal type, right-click the signal and select the **Line Type** menu.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-00f544c094a7a5c7a5694859534b49da48c9e1b2%2Fline-type-menu.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Use the **Color** command in the context menu to change the color of the signal or signal group.

To assign a name to a signal, right-click the signal and select **Name** in the context menu. In the dialog box, select the **Visible** checkbox to display the name on the schematic.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-4fcc4c3ff1815af9ad835e5f63a560158d00e39f%2Fname-signal-dialogbox.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

For more complex designs, advanced representations—such as connection by name, buses, bundles, phases, cross-page connectors, and hierarchical blocks—can be used to simplify visualization and organization.

### Add a bus

To create a bus, go to the **Home** ribbon and click **Draw Signal**, then select the required signal type. Double-click the bus to open its dialog box and configure its parameters.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-81a3070e63a108e8766de292cbd274e2092be77d%2Fdesign-bus.gif?alt=media" alt=""><figcaption></figcaption></figure>

### Add a connection by name

In HYPERSIM, **connection by name** (also called virtual connection) allows you to connect signals without drawing physical lines between them — any signals that share the same visible name are automatically treated as connected, even if they're on different parts of the schematic or different pages.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-7810fd4b402ea11c71a1b27e453bbf8e4bf2d3ef%2Fconnection-by-name.png?alt=media" alt="" width="480"><figcaption><p>In this example, the top pin of the source AC1 is connected<br>to the positive pin of RLC1 using the signal name SOURCE.</p></figcaption></figure>

Double-click the SOURCE signal to display its virtual connections.

{% hint style="danger" %}
If a signal segment that was previously connected to other signals by name is renamed, the logical connection is broken.
{% endhint %}
{% endstep %}

{% step %}

## Add sensors

In HYPERSIM, sensors are used to **acquire data** for ScopeView and to **interface the simulation with I/O** through their data points. Without sensors selected, you won't be able to visualize any signals or interface with external hardware.

To add sensors to a block or signal, right-click the item and choose **Open Sensors Form**. Use the **Selected** checkbox to enable or disable individual sensors,then click **Apply** to save your changes. See [Manage Sensors](https://www.opal-rt.com/docs/hypersim/model-and-simulation/manage-sensors.md) section for more details.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-1f6970aa5016c757e9cc5cb29eaa1080208c4270%2Fadd-sensors-block.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# 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.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.
