Support : Knowledge base

Knowledge Base

Welcome to OPAL-RT’s Knowledge Base

OPAL-RT offers a repository of support information for optimal use of its technology.


Please note that OPAL-RT knowledge base is not fully optimized for mobile platforms.

For optimal experience, use a desktop computer.

Reference Number: AA-02079 // Views: 51 // Created: 2022-07-14 20:34:02 // Last Updated: 2023-04-06 17:35:19
How to Set a Fault Block In HYPERSIM

To set a fault in HYPERSIM follow the steps presented below. Additionally, it is strongly recommended to read the Fault Element Wiki page available at 3-Phase Fault Wiki Page.

1 – Run the circuit in steady state, without the fault application and make sure that it works properly.

2 – Place the fault element.

In the HYPERSIM library, there are two options for a fault element: 1-Phase fault and 3-Phase fault (which can be configured to be 1-phase, 2-phase or 3-phase).

3 – Open the Configuration Parameter and set the parameters:

General Operation: Enable

The behavior can be set as a breaker or a switch. Breaker: operates at first current zero-crossing point after POW sync . Switch: operates at exactly the moment control defines.

Check the enable boxes for the times that were set and choose the phases that will operate. Coloreds are the ones that will be activated in the fault, so it can be 1, 2 or 3 phases. In gray are the phases that are disabled.

For the time definition, there are four different syntaxes that are possible:

-        Fixed: inform just the time value or f:value

-        Incremental: i: initial_time/final_time/time_increment

-        Uniform: u: minimal_time/maximal_time

-        Uniform Gaussian: ug: minimal_time/maximal_time/dispersion

There is also the Phase/Command information. The Command (C) will execute the fault for the phases defined at the set time. Phase (P) operate at the time referenced to the component informed (in this case it is needed to fill the Referenced operations Component and Time columns), being used when the fault operation is associated to other equipment behavior. 

In General Tab inside of the fault configurations, choose control type as internal, since an internal control will be used.

4 – Add fault control

Add a constant block and a gain. In this way it is possible to set a gain of 1 and use the constant as the controllable unit.

The values of the control can change from 0 – no phase to 15 – ABCG (all possible configurations are available on the Wiki Page)

For a three phase fault, the control value should be 7.

5 – Define the variables that you want to monitor

Open the sensor form of the fault block (right click à Open Sensor Form) and choose the variables that you want to monitor.

6 – Run the simulation

7 – Open ScopeView

Choose the signals that should be sampled. After that, press the start button.

8 – Setting Scopeview

In the first moment the fault will not be seen in the scopes. Some Adjustments are required.

The time length should be adjusted in order to view the moment when the fault occurs (ex: in this example our fault occurs between 0.25 to 0.5 s), hence, one possibility is to set the Time Length  to 0.6 s. Also, select the trigger option.

After all these adjustments press again the play button of Scopeview.

9 – Now it is possible to see the results