> 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/courseware/electric-courseware/fundamentals-of-electrical-engineering/virtual-laboratory-overview.md).

# Virtual Laboratory Overview

## Introduction <a href="#id-1.-introduction-describing-the-main-contents-of-the-laboratories-inlineextension" id="id-1.-introduction-describing-the-main-contents-of-the-laboratories-inlineextension"></a>

The purpose of this **virtual laboratory** is to assimilate and apply theoretical knowledge. In particular, it involves understanding how processes work, implementing devices and equipment, using instrumentation, and processing measurements.

The laboratory aims to facilitate the acquisition of knowledge and the conduct of experiments by providing a guiding framework that allows students to focus on the experiment’s subject without initially having to worry about all the components needed for the experiments.

This virtual laboratory is designed to provide exercises to improve the understanding and mastery of the fundamental principles of electrical engineering . Laboratory exercises are an essential complement to the theory. They allow students to experiment with various circuits and applications. Therefore, users can take advantage of this virtual simulator to understand their behavior with varying levels of complexity.

This courseware will cover the following subjects:

1. Single-Phase Systems
2. Three-Phase Systems
3. Single-Phase Transformer&#x20;
4. Three-Phase Transformer&#x20;
5. Harmonics (Coming soon)

## Discover the virtual laboratory&#x20;

### General electrical diagram

The overall electrical diagram of the laboratory can be configured interactively using contactors, as shown in **Figure 1** below. It provides the ability to adjust the voltage source in either single-phase or three-phase mode, whether it is balanced or not, with adjustable or non-adjustable harmonic components. Additionally, it is possible to control the tension engagement angle. Transformers supplied by these networks undergo standardized identification tests, such as short-circuit tests and no-load tests.

<figure><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2F9BT4IDByYJ0a7yAS9Ow7%2Fimage.png?alt=media&amp;token=fb41925e-ec98-43eb-bca9-5897153c600d" alt=""><figcaption><p><em><strong>Figure 1:</strong> Complete electrical diagram</em></p></figcaption></figure>

The main elements of the laboratory are as follows:

* A **three-phase network** with three adjustable sources for both the fundamental and harmonics.
* A **circuit breaker** with adjustable parameters.
* A **transformer** that can be deactivated by short-circuiting it or by creating an open circuit.
* Two blocks of **series and parallel resistors**.
* Six **measurement points** for voltage, current, and power for each phase. There is also the Fortescue transformation of the network.
* **Contactors** to create different circuits, with lamps to indicate open and closed switches.

This interactive display of the electrical diagram with lamps indicating open and closed contactors allows the user to quickly grasp the structure of the entire laboratory circuit. This diagram enables the creation of both single-phase and three-phase circuits.

<figure><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FXxuCXnEdOclvODYgaJgH%2Fimage.png?alt=media&amp;token=a5982450-792e-40bc-a84d-3cbcda452fb6" alt=""><figcaption><p><strong>Figure 2:</strong> Methodology for transitioning from a three-phase circuit topology to that of a single-phase circuit</p></figcaption></figure>

### Configuration types <a href="#id-2.2-different-types-of-configurations-inlineextension" id="id-2.2-different-types-of-configurations-inlineextension"></a>

In general, there are three components that can be modified to achieve the desired circuit and scenario.

#### &#x20;**1- Network**

The network is designed so that you can adjust the frequency, amplitude, and phase shift of each phase. The voltage source operates in either single-phase or three-phase mode. Furthermore, the network’s measurement values are displayed directly.

The network is equipped with a circuit breaker, which is part of the standard protection equipment. It allows for circuit interruption in case of overload or short circuit. Generally, it consists of a thermal trip and a magnetic trip. In this laboratory, a functionality has been added to trip the circuit breaker if the voltage drops below a certain threshold.

#### **2- Transformer**

Experiments can be conducted with a transformer by configuring it in various ways to achieve the desired setup. When it is not in use, it is short-circuited, and passive loads are supplied power without the transformer. In this case, the windings are isolated to avoid interfering with the rest of the circuit. By also short-circuiting the loads, short-circuit tests can be performed.

<figure><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FwhVRUcTtMosPCwQ1ZkYN%2Fimage.png?alt=media&amp;token=8f01180d-c40c-4411-a43e-db7b82f857cc" alt="" width="563"><figcaption><p><em><strong>Figure 3:</strong> Topology of the transformer</em></p></figcaption></figure>

#### **3- Passive Load**

**a) Single Phase**

There are six branches of passive loads available, each consisting of a series RLC load and a parallel RLC load, as well as three passive loads in the neutral wires. These loads can be modified and arranged based on the state of the contactors and **Figure 2** to create different couplings. As mentioned, when the single-phase option is chosen, the additional sources are automatically grounded and nullified for single-phase couplings. The different possible single-phase couplings are illustrated below:

<figure><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FqllLL1HpB9bBVjpO0FqI%2Fimage.png?alt=media&amp;token=39e5144d-45bf-4bea-93d0-fb73377af564" alt=""><figcaption><p><em><strong>Figure 4:</strong> State of the switches and configurations of single phase loads</em></p></figcaption></figure>

**b) Three-Phase**

There are six branches of passive loads available, each consisting of a series RLC load and a parallel RLC load, as well as three passive loads in the neutral wires. These loads can be modified and arranged based on the state of the contactors and **Figure 2** to create different couplings. The different possible three-phase couplings are illustrated below:

<figure><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FGNIOHUlcuH6nGULnkIRU%2Fimage.png?alt=media&amp;token=13f9abf6-3725-4173-b51e-f939f0a069b3" alt=""><figcaption><p><em><strong>Figure 5:</strong> State of the switches and configurations of three phase loads</em></p></figcaption></figure>


---

# 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/courseware/electric-courseware/fundamentals-of-electrical-engineering/virtual-laboratory-overview.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.
