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.
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.
Grid simulator
Description of the Grid Simulator component in Schematic Editor

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.
    - 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.
      - Grid simulator
        Description of the Grid Simulator component in Schematic Editor
      - DC Meter
        Description of the DC Meter component in Schematic Editor Library
      - Anti-islanding Container
        Description of the Anti-islanding Container component in Schematic Editor.
      - Grid Fault
        Description of the Grid Fault component in Schematic Editor Library
      - Dynamic Grid Fault
        Description of the Dynamic Grid Fault component in Schematic Editor.
      - FRT Container
        Description of the Fault Ride Through Container (FRT) component in Schematic Editor
    - 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.
- 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.

Grid simulator

Description of the Grid Simulator component in Schematic Editor

The Grid Simulator is a component which consists of three single phase voltage sources, series resistances and inductances. It is used to simulate a three phase symmetric or asymmetric grid.

Figure 1. Component Icon

The internal structure of the Grid Simulator, with phase voltage, line voltage and phase current measurements included is shown in Figure 2.

Figure 2. Schematic diagram of the Grid Simulator component

The list of measurements available in the grid simulator is shown in Internal analog measurements of the grid simulator.

Calculation from S-U to R-L

$R = \frac{p f ∙ {V_{b}}^{2}}{S_{b}}$

$L = \frac{\frac{{V_{b}}^{2}}{S_{b}} ∙ {(1 - {p f}^{2})}^{0.5}}{2 ∙ π ∙ f}$

Calculation from S-U and X/R to R-L

$R = \frac{{V_{b}}^{2}}{S_{b} ∙ {(1 + {(X / R)}^{2})}^{0.5}}$

$L = R ∙ \frac{X / R}{2 ∙ π ∙ f}$

R - resistance
L - inductance
Vb - nominal line voltage
f - frequency
Sb - short circuit capacity
pf - inductive power factor
X/R - x/r ratio

Internal analog measurements of the grid simulator


Analog output variable name	Description
*(name).I_phase_A*	Phase A current.
*(name).I_phase_B*	Phase B current.
*(name).I_phase_C*	Phase C current.
*(name).V_phase_A*	Phase A voltage.
*(name).V_phase_B*	Phase B voltage.
*(name).V_phase_C*	Phase C voltage.
*(name).V_source_phase_A*	Phase A source voltage.
*(name).V_source_phase_B*	Phase B source voltage.
*(name).V_source_phase_C*	Phase C source voltage.
*(name).V_AB*	A-B line voltage.
*(name).V_BC*	B-C line voltage.
*(name).V_CA*	C-A line voltage.

Ports

A (electrical)
- AC side port - phase A

B (electrical)
- AC side port - phase B

C (electrical)
- AC side port - phase C

N (electrical)
- Neutral point port

Parameters

Model definiton
- Specifies the set of parameters by choosing between R-L, S-U, and S-U and X/R.

Nominal line voltage
- Specifies nominal line voltage.
Nominal frequency
- Specifies nominal frequency.
Resistance per phase
- Available only if Model definition is set to R-L.
- Specifies resistance per phase.
Inductance per phase
- Available only if Model definition is set to R-L.
- Specifies inductance per phase.
Short circuit capacity
- Available if Model definition is set to S-U or S-U and X/R.
- Specifies short circuit capacity.
Inductive power factor
- Available only if Model definition is set to S-U.
- Specifies inductive power factor.
X/R ration
- Available only if Model definition is set to S-U and X/R.
- Specifies ratio between X and R values.