Home
Typhoon HIL Software Manual
Schematic Editor Component Libraries
Detailed functionality and use of the pre-built Component Libraries in Schematic Editor
Component Library
Description of the general properties of the component library in Schematic Editor, including a list of the main types of components available in it.
Microgrid
This section describes the Microgrid library category in Typhoon HIL Schematic Editor.
Loads
Schematic Editor components available in the Loads sub-category of the Microgrid library category
VBR Variable Load
Description of the legacy voltage behind reactance variable load component from the Microgrid library.

Typhoon HIL Software Manual
- Introduction
  Overview of the categories covered in the Typhoon HIL Software Manual
- System Requirements
  Guidelines for the hardware and/or software environment necessary to run Typhoon HIL software, for both PC and Test Server/Virtual Machine-based setups.
- Typhoon HIL Quick Start Guide
  Instructions in this section should help you quickly install all necessary software tools and setup hardware components in order to run an example model, either in real-time simulation or TyphoonSim.
- Typhoon HIL Toolboxes
  List of the Toolbox Packages available in the Typhoon HIL software suite
- Connecting to your HIL device
  Guidelines on how to connect to a HIL device using either USB or Ethernet ports.
- Device Manager
  Device Manager is used to create, manipulate, and activate HIL device setups.
- Typhoon HIL Control Center
  This section provides a general description of Typhoon HIL Control Center and lists the main software components accessible from it, as well as additional software tools which can be invoked from its interface.
- TyphoonSim
  This section provides a general description of the TyphoonSim software, which is available as both a standalone software and integrated in Typhoon HIL Control Center.
- Example Explorer
  General Description of the Typhoon HIL Control Center Example Explorer.
- Signal Access Management
  This feature allows you to change the visibility of signals
- Schematic Editor
  Introduction to the Schematic Editor tool in Typhoon HIL software toolchain
- TyphoonSim Solver Engine
  Summary of the TyphoonSim solver engine algorithms and capabilities as well as its modeling principles and simulation workflow.
- Simulation context definitions
  Introductory overview of the different simulation contexts - Real-time (VHIL) and TyphoonSim. Core library component and feature availability and visibility for each of these contexts are explained in detail.
- Schematic Editor Component Libraries
  Detailed functionality and use of the pre-built Component Libraries in Schematic Editor
  - Modeling principles
    This section describes modeling principles used in Typhoon HIL's software.
  - Model partitioning
    This section describes the general motivation and gives some practical guidelines for model partitioning.
  - Component Library
    Description of the general properties of the component library in Schematic Editor, including a list of the main types of components available in it.
    - Circuit breakers
      This section describes the general properties of all circuit breaker components in Typhoon HIL Schematic Editor. There are currently 2 different circuit breaker components in Schematic Editor.
    - Communication
      Summary of the Communication components available in Schematic Editor
    - Contactors
      This section provides a general description of contactors components in Typhoon HIL Schematic Editor
    - Converters
      This section provides a general description of converter components in Typhoon HIL Schematic Editor
    - Converters - extras
      This section describes additional components related to converter modeling.
    - HIL Interfaces
      This section describes the HIL Interface components in Typhoon HIL Schematic Editor.
    - Machines
      This section describes the concepts used in the modeling and implementation of electrical machine components in Typhoon HIL Schematic Editor.
    - Measurements
      This section describes measurement components in Schematic Editor, including voltage and current measurements and RMS measurements.
    - Microgrid
      This section describes the Microgrid library category in Typhoon HIL Schematic Editor.
      - Distributed Energy Resources
        Schematic Editor components available in the Distributed Energy Resources (DER) sub-category of the Microgrid library category
      - FACTS
        Schematic Editor components available in the FACTS sub-category of the Microgrid library category
      - Grid
        Schematic Editor components available in the Grid sub-category of the Microgrid library category
      - Loads
        Schematic Editor components available in the Loads sub-category of the Microgrid library category
        Constant Impedance Load
        Description of the Constant Impedance Load component, for representing a three-phase balanced or unbalanced constant impedance load.
        Single-phase Variable Load
        Description of the Single-phase Variable Load component in Schematic Editor.
        Three-phase Variable Load
        Description of the Three-phase Variable Load component in Schematic Editor.
        Variable Load (Generic)
        Description of the Variable Load (Generic) component in Schematic Editor.
        VBR Variable Load
        Description of the legacy voltage behind reactance variable load component from the Microgrid library.
      - Meter
        Schematic Editor components available in the Meter sub-category of the Microgrid library category
      - Protection
        Schematic Editor components available in the Protection sub-category of the Microgrid library category
    - Model Partitioning Components
      This section describes the general properties of circuit properties components in Typhoon HIL's Schematic Editor, such as core couplings, device couplings, core markers, device markers, etc.
    - Passive components
      This section describes passive components, including linear passive components, nonlinear passive components, and variable passive components.
    - PHIL Interfaces
      This section describes the general properties of Power Hardware-In-the-Loop (PHIL) interface components.
    - Port components
      Description of the collection of Port components in Schematic Editor, which are used to connect internal subsystem elements to the outside schematic.
    - Signal Processing Components
      This section describes the general properties of all signal processing components in the Typhoon HIL Schematic Editor core library.
    - Sources
      This section describes source components in Schematic Editor, including independent sources, controlled sources, externally controlled sources, signal controlled sources, batteries, photovoltaic panels, constant power loads/sources, and engine-generator sources.
    - System
      This section describes additional components in the System library in Schematic Editor
    - Test Suite
      This section describes the Test Suite components of Typhoon HIL's built in Schematic Editor Library, which currently includes the grid simulator, DC measurements, anti-islanding container, and grid fault components.
    - Transformers
      This section describes the general properties of all transformer components in Typhoon HIL's Schematic Editor, such as an ideal transformer, a single-phase three winding transformer, a three-phase four winding transformer, etc.
    - Transmission lines
      This section describes the general properties of all transmission line components in Typhoon HIL's Schematic Editor. There are currently 3 different transmission line components in Schematic Editor.
    - TyphoonSim
      This section describes general properties of the TyphoonSim specific components in Typhoon HIL's Schematic Editor
    - Component additional information
      This section describes the general properties of several components in Typhoon HIL's Schematic Editor whose feature set and capabilities require separate sections.
  - References
    This section describes references
- Third-party integrations
  This section provides an overview of the key third party integrations within Typhoon HIL's toolchain.
- HIL SCADA
  Description of the HIL SCADA tool in Typhoon HIL Control Center
- Waveform Generator
  This section describes the waveform generator tool in Typhoon HIL Control Center.
- Test and Calibration Tool
  Description of the Test and Calibration tool in Typhoon HIL Control Center
- TyphoonTest IDE
  This section describes TyphoonTest IDE
- Signal Analyzer
  This section describes the Signal Analyzer tool.
- Lookup table extraction tool
  Description of the Typhoon HIL Control Center tool for extracting characteristics (lookup tables) from datasheet graphs and charts into a format that can be imported by non-linear models.
- Package Manager
  Description of the Typhoon HIL Control Center tool for creating and managing Typhoon packages that contain Schematic examples, Schematic and widget libraries, documentation etc.
- Usage Logging
  This section briefly describes Typhoon HIL software logging feature.
- Python Interpreters
  Overview of how you can use Typhoon HIL Python Interpreters to further customize your test files.

VBR Variable Load

Description of the legacy voltage behind reactance variable load component from the Microgrid library.

The variable voltage behind reactance load component is located in Microgrid Library. Component icon and properties window are shown in Table 1. The variable voltage behind reactance load component represents a three-phase balanced variable load.

Table 1. Variable VBR load in the Schematic Editor core library
component	component dialog window	component parameters
		Property tabs: 1 - General 2 - Control 3 - Snubber

Figure 1. Variable VBR load component view under its mask

Tab: "General"

Figure 2. General properties window tab


Parameter	Code name	Description
Nominal voltage	Vn	Nominal voltage
Nominal power	Sn	Nominal power
Nominal frequency	fn	Nominal grid frequency.
Series inductance	L	Series inductance of the component, resistance is calculated using nominal power.
Execution rate	execution_rate	Execution rate in seconds.

Tab: "Control"

In this properties tab, it is defined gains for PI regulator for d and q axes.

Figure 3. Control properties window tab


Parameter	Code name	Description
d axis PI controller proportional gain	Id_Kp	Proportional gain for PI regulator in d axe.
d axis PI controller integral gain	Id_Ki	Integral gain for PI regulator in d axe.
q axis PI controller proportional gain	Iq_Kp	Proportional gain for PI regulator in q axe
q axis PI controller integral gain	Iq_Ki	Integral gain for PI regulator in q axe.
Automatically PI gains	PIgains	Combo box for calculation PI gains.
Display gains	display	Display button shows PI gains in message console

Tabs: "Snubber"

Snubber consists of three resistance in star topology, connected as shunt in system.

Figure 4. Properties for snubber device


Parameter	Code name	Description
Snubber resistance	Rsnub	Snubber resistance

Example

Overall behavior can be better understood with the use of the given variable VBR load example:

Model name: variable_load.tse

SCADA interface: SCADA_Panel.cus

Path: /examples/models/microgrid/variable_load/