Home
Typhoon HIL Software Manual
Schematic Editor Component Libraries
Detailed functionality and use of the pre-built Component Libraries in Schematic Editor
Component library
This section describes the general properties of the component library in Schematic Editor, and provides a list of main types of components available in it.
Microgrid
This section describes the Microgrid library category in Typhoon HIL Schematic Editor.
VBR Variable Load
This section describes the variable voltage behaind reactance load component from 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 Control Center, for both PC and Test Server/Virtual Machine-based setups.
- Typhoon HIL Quick Start Guide
- 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.
- 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 in Schematic Editor and HIL SCADA
- Schematic Editor
  Introduction to the Schematic Editor tool in Typhoon HIL Control Center
- 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
    This section describes the general properties of the component library in Schematic Editor, and provides a list of 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 describes the general properties of all contactor components in Typhoon HIL's Schematic Editor. There are currently 2 different contactor components in Schematic Editor.
    - Converters
      This section provided a general description of converters in Schematic Editor, including converter control options, thermal model, variable delay, and the Measurements tab.
    - 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. There are currently 26 different machine components.
    - 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.
      - Diesel Genset
        This section describes the Diesel Genset component in Schematic Editor.
      - Feeder protection relay (example)
        This section describes the feeder protection relay (example) component.
      - PV plant
        This section describes the PV plant component.
      - Wind power plant
        This section describes the wind power plant component.
      - Battery inverter
        This section describes the Battery inverter component.
      - NPC PV Inverter
        This section describes the 3-level NPC PV Inverter component.
      - ANSI protective functions
        This section describes the ANSI protective function components.
      - Back to back converter
        This section describes the back to back converter component.
      - Constant impedance load
        This section describes the constant impedance load component from microgrid library.
      - VBR Variable Load
        This section describes the variable voltage behaind reactance load component from microgrid library.
      - Single-Phase Meter
        This section describes the Single-phase Meter component located in the Microgrid category of the Schematic Editor core library.
      - Three-Phase Meter
        This section describes the three phase meter component from the microgrid library.
      - Meter Split
        This section describes the three-phase meter split component from the Microgrid library.
      - Simple battery inverter
        This section describes the simple battery inverter component.
      - PV inverter
        This section describes the PV inverter component.
      - DER (Generic) Control Join
        This section describes the DER (Generic) Control Join component from the Microgrid library.
      - Grid
        This section describes the Grid component.
      - PV Power Plant (Generic)
        Description of the PV Power Plant (Generic) component in Schematic Editor.
      - Battery ESS (Generic)
        Description of the Battery ESS (Generic) component in Schematic Editor
      - Wind Power Plant (Generic)
        Description of the Wind Power Plant (Generic) component in Schematic Editor
      - Diesel Genset (Generic)
        Description of the Diesel Genset (Generic) component in Schematic Editor.
      - Variable Load (Generic)
        Description of the Variable Load (Generic) component in Schematic Editor.
      - Bidirectional AC-DC Converter (Generic)
        Description of the Bidirectional AC-DC Converter (Generic) component in Schematic Editor
      - SEL-751 Relay Logic
        Description of the SEL-751 Relay Logic component in Schematic Editor
      - Series Compensator
        Description of the Series Compensator component in Schematic Editor.
      - 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.
    - Circuit 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.
    - PHIL Interfaces
      This section describes the general properties of Power Hardware-In-the-Loop (PHIL) interface components.
    - Passive components
      This section describes passive components, including linear passive components, nonlinear passive components and variable passive 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.
    - Interface components
      This section describes the general properties of all interface components in Typhoon HIL's Schematic Editor, such as voltage and current measurements, signal-controlled sources, contactors, etc. There are currently 4 different interface components in Schematic Editor.
    - 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. There are currently 9 different transformer components in Schematic Editor.
    - 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.
    - 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

This section describes the variable voltage behaind reactance load component from 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/