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.
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.
Calculation of equivalent circuit parameters’ values
This section describes calculation of equivalent circuit parameters’ values

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.
    - 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.
      - Ideal transformer
        This section describes ideal transformer
      - Ideal transformer with variable transfer ratio
        This section describes ideal transformer with variable transfer ratio
      - Phase-shifting Transformer
        Description of the Phase-shifting Transformer component in Schematic Editor
      - Single phase two winding transformer
        This section describes single phase two winding transformer
      - Single phase three winding transformer
        This section describes single phase three winding transformer
      - Single phase four winding transformer
        This section describes single phase four winding transformer
      - Three phase two winding transformer
        This section describes three phase two winding transformer
      - Three phase three winding transformer
        This section describes three phase three winding transformer
      - Three phase four winding transformer
        This section describes three phase four winding transformer
      - Calculation of equivalent circuit parameters’ values
        This section describes calculation of equivalent circuit parameters’ values
      - Single phase multi-winding transformer
        This section describes single phase multi-winding transformer
      - Single phase two winding variable ratio transformer
        This section describes the single phase two winding variable ratio transformer component
      - Three phase two winding variable ratio transformer
        This section describes the three phase two winding variable ratio transformer
    - 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.

Calculation of equivalent circuit parameters’ values

This section describes calculation of equivalent circuit parameters’ values

This section describes the method used to calculate equivalent circuit parameters’ values from SI units to per unit and vice versa.

A distinct base voltage, base impedance and base inductance are assigned to each of the transformer’s windings.

Single-phase transformers

When calculating equivalent circuit parameters’ values from SI units to per unit, the following expression is used:

x^{p u} = \frac{x^{S I}}{x_{b a s e}}

When calculating equivalent circuit parameters’ values from per unit to SI units, the following expression is used:

x^{S I} = x^{p u} ∙ x_{b a s e}

Base values:

Base power is transformer nominal power: $S_{b a s e} = S_{n}$
Base frequency is transformer nominal frequency: $f_{b a s e} = f_{n}$
Base voltages are transformer nominal winding voltages: $V_{b a s e}^{i} = V_{n}^{i}$
Base impedances are calculated in the following way: $Z_{b a s e}^{i} = \frac{{(V_{b a s e}^{i})}^{2}}{S_{b a s e}}$
Base inductances are calculated in the following way: $L_{b a s e}^{i} = \frac{Z_{b a s e}^{i}}{2 π f_{b a s e}}$

In the expressions above, i represents the index number of a transformer’s winding.

Three-phase transformers

When calculating equivalent circuit parameters’ values from SI units to per unit, the following expression is used:

x^{p u} = \frac{x^{S I}}{k ∙ x_{b a s e}}

When calculating equivalent circuit parameters’ values from per unit to SI units, the following expression is used:

x^{S I} = k ∙ x^{p u} ∙ x_{b a s e}

In the expressions above, k is determined by

k = \{\begin{matrix} 1, i f t h e w i n d i n g i s w y e c o n n e c t e d \\ 3, i f t h e w i n d i n g i s d e l t a c o n n e c t e d \end{matrix}

Base values:

Base power is transformer nominal three-phase power: : $S_{b a s e} = S_{n}$
Base frequency is transformer nominal frequency: $f_{b a s e} = f_{n}$
Base voltages are transformer nominal phase-to-phase winding voltages: $V_{b a s e}^{i} = V_{n}^{i}$
Base impedances are calculated in the following way: $Z_{b a s e}^{i} = \frac{{(V_{b a s e}^{i})}^{2}}{S_{b a s e}}$
Base inductances are calculated in the following way: $L_{b a s e}^{i} = \frac{Z_{b a s e}^{i}}{2 π f_{b a s e}}$

In the expressions above, i represents the index number of a transformer’s winding.