- Ready-to-Use Surge Arrester / Lightning Arrester Block in HYPERSIM
Yes, HYPERSIM has standard, ready-to-use Surge Arrester (Metal-Oxide Varistor / MOV) components built directly into its library.
Component Overview:
The block implements a metal-oxide surge arrester used to protect electrical equipment against overvoltages by modeling non-linear V\text{--}I characteristics.
It supports single-phase (1ph_arrester) and three-phase (3ph_arrester) configurations.
Parameters include rated voltage, number of phases, reference currents, and customizable V\text{--}I lookup tables or segment parameters (k and \alpha).
Library Location:
You can find it in the HYPERSIM Schematic Editor under the Passives (or Power System / Passives) library group, as well as under the Universal Database (UDB_arresters.clf).
Documentation Reference:
The Confluence page you referenced (
Surge Arrester
) is indeed the official documentation for HYPERSIM’s native Surge Arrester block. You can directly drag and drop it from the library sidebar into your HYPERSIM model.
- Creating & Reusing Custom Library Blocks in HYPERSIM
Yes, you can create custom library blocks (subcircuits/subsystems) in HYPERSIM and save them into custom library files (.clf) for reuse across multiple projects.
Step-by-Step Workflow:
Create the Subcircuit / Subsystem:
Assemble the components and logic in your schematic.
Add Port Connectors (Control Input/Output ports or Power/Network pins) for external connections.
Highlight the components, right-click, and select Create Subcircuit Block… (or use the Subcircuit Wizard in the options toolbar).
Define Custom Parameters & Mask (Generic View / Form Editor):
Right-click the subcircuit and select Open Parameter Form…
Declare the variables/parameters you want users to configure at the top level.
Inside the subcircuit, link internal block parameters to these mask variables (e.g., setting a parameter to =var_name).
Custom forms and masks can be tailored using the built-in Form Editor or CustomView (supporting sliders, drop-down menus, tooltips, and parameter constraints).
Save into a Custom Library (.clf file):
In the Subcircuit Wizard or block options, check Save subcircuit in a library or click Options > Make unique type.
Specify the library name and save the block into a Component Library File (.clf).
You can open this .clf file in any HYPERSIM project or configure HYPERSIM to open your custom library automatically at startup for team-wide sharing.
Advanced Reusable Blocks (UCMs / C-Code / DLLs):
For proprietary algorithms or C-code/DLL black boxes, HYPERSIM also supports User-Coded Models (UCM) encapsulated inside a masked Subcircuit and saved in a .clf library.
