Engee documentation

Thyristor (Piecewise Linear)

Page in progress.

A thyristor with a piecewise linear VAC.

blockType: AcausalElectricPowerSystems.Semiconductors.Ideal.PiecewiseLinearThyristor

Path in the library:

/Physical Modeling/Electrical/Semiconductors & Converters/Thyristor (Piecewise Linear)

Description

Block Thyristor (Piecewise Linear) It simulates a thyristor with a piecewise linear volt-ampere characteristic (VAC). The VAC of the thyristor is such that the thyristor is open if the gate-cathode voltage exceeds the set unlocking voltage at the control electrode. The thyristor is closed if the load current drops below the set holding current value.

igbt ideal switching 1

To set a tabular VAC, check the box Enable thermal port, and for the parameter On-state behavior and switching losses set the value Tabulate.

In the open state, the anode-cathode channel behaves like a linear diode with a direct voltage drop. and resistance in the open state . However, if the thermal port of the unit is open and the device is parameterized using a tabular VAC, then the tabular resistance will be a function of temperature and current. In the closed state, the anode-cathode channel behaves like a linear resistor with low conductivity in the closed state. .

The equations for the anode-cathode current are written as follows:

if and one of two conditions is fulfilled.: or ,

in all other cases ,

where

  • — anode-cathode voltage;

  • — direct voltage;

  • — gate voltage;

  • — unlocking voltage control;

  • — anode-cathode current;

  • — holding current;

  • — resistance in the open state;

  • — conductivity in the closed state.

Using the parameters Integral Diode, an internal protective diode can be switched on. The integrated diode protects the semiconductor device by providing a conduction channel for reverse current. An inductive load can create a large reverse voltage surge when a semiconductor device abruptly turns off the voltage supply to the load.

Set the parameter value Integral protection diode depending on the purpose.

Goal Value for selection Internal protective diode

The priority of the simulation speed.

Diode with no dynamics

An indoor unit is being added Diode (Advanced).

The priority of modeling accuracy is to accurately indicate the charge dynamics in the reverse mode.

Diode with charge dynamics

An indoor unit is being added Diode (Advanced) taking into account the charge dynamics.

Simulation of the gate port and thermal effects

You can choose a directional input or electrical port to control the gate and use the thermal port to simulate the heat generated by switching processes and conduction losses. To select the shutter control port, set the parameter Gate-control port meaning Signal control port or Electrical control port. To use the thermal port, check the box Enable thermal port.

Heat losses

Switching losses are the main sources of thermal losses in semiconductors. During each on-off switch, the parasitic elements of the thyristor accumulate and then dissipate energy.

Switching losses depend on the voltage in the closed state and the current in the open state. When switching on a switching device, the power loss depends on the initial voltage in the closed state on the device and the final current in the open state when the device is fully open.

This unit accounts for switching losses by increasing the transition temperature by an amount equal to the losses divided by the total heat capacity of the transition. It is necessary to specify the energy dissipated in one turn-on. It is also necessary to specify the corresponding values of voltage in the closed state and current in the open state, at which losses are calculated. You can parameterize the power-on loss depending on the available data. Use tabular data, if available.

  • To set the scalar value of the power-on loss, set the parameter On-state behavior and switching losses meaning Specify constant values. Parameter value Switch-on loss sets the amount of power loss. The unit scales voltage losses in the closed state and current in the open state.

  • To set the switching losses as a function of the junction temperature and the current in the open state, set the parameter On-state behavior and switching losses in the value Tabulate. Parameter Switch-on loss, Eon(Tj,Iak) sets the amount of losses. The unit scales voltage losses in the closed state.

When the current drops below the parameter value Holding current, the device turns off. Parameter value Natural commutation rectification loss detects losses during shutdown. The unit does not scale these losses in terms of voltage in the closed state or current in the open state, since it is impossible to determine when to measure the initial current or the final voltage for rectification losses.

Reverse recovery losses can be a significant source of heat loss in diodes. The diode dissipates energy each time it is switched off, switching from a conductive state to an open circuit state. To simulate reverse recovery losses:

  • Check the box Enable thermal port.

  • Set for the parameter Integral protection diode meaning Diode with no dynamics.

If for the parameter Reverse recovery loss model the value is set Tabulated loss, parameter value Reverse recovery loss table, Erec(Tj, If) defines the dissipated energy as a function of the junction temperature and forward current immediately before the switching event. The voltage in the closed state linearly scales the losses relative to the parameter value Turn-off voltage when measuring recovery loss, Vrec. The table uses the delayed values of current and voltage. To use a value close to instantaneous in the table, set the parameter Filter time constant for voltage and current values a value less than the fastest switching period.

If for the parameter Reverse recovery loss model the value is set Fixed loss, the value of the parameter Reverse recovery loss determines the energy dissipated with each shutdown. If the check box is selected Scale reverse recovery loss with current and voltage, then the block linearly scales the value of current losses in the open state and voltage in the closed state. To use scaling values close to instantaneous, set the filter time constant for voltage and current values to a value lower than the fastest switching period.

As an alternative method for reverse recovery modeling, you can set the parameter Integral protection diode meaning Diode with charge dynamics. However, this approach requires shorter modeling time steps than using the first approach.

The current after switching is not known during the simulation, so the unit registers the current in the open state when its value exceeds the holding current for a time exceeding the value set by the parameter. Wait time before switch-on current measurement. Similarly, the unit registers the voltage in the closed state when the devices are switched on. For this reason, the recorded data does not report switching losses in the thermal model until the next switching cycle.

If you are using tabular data to model switching losses or reverse recovery losses, then make sure that the temperature and current are within the range you specified. If you do not define a realistic thermal model, for example, if the heat capacity of the junction or the conductivity between the junction and the housing is too low, then the temperature may exceed the range you specified, which may lead to extrapolation of losses to non-physical values.

Ports

Conserving

# A — The anode
electricity

Details

The port connected to the anode.

Program usage name

anode

# K — The cathode
electricity

Details

The port connected to the cathode.

Program usage name

cathode

# H — thermal port
warmth

Details

The thermal port.

Dependencies

To use this port, check the box Enable thermal port.

Program usage name

thermal_port

# G — the shutter
electricity

Details

The port connected to the gate.

Dependencies

To enable this port, set the parameter Gate-control port meaning Electrical control port.

Program usage name

gate

Input

# G — the shutter
scalar

Details

The port connected to the gate.

Dependencies

To enable this port, set the parameter Gate-control port meaning Signal control port.

Data types

Float64

Complex numbers support

No

Parameters

Main

# Gate-control port — option to specify the type of shutter port
Signal control port | Electrical control port

Details

Option to specify the shutter control port of the switch:

  • Signal control port — The unit uses a directional input port to control the shutter;

  • Signal control port — The unit uses a non-directional electrical port to control the shutter.

Values

Signal control port | Electrical control port

Default value

Signal control port

Program usage name

control_type

Evaluatable

No

# Gate trigger voltage, Vgt — unlocking voltage control
V | MV | kV | mV

Details

The gate-cathode threshold voltage. The device turns on when the gate-cathode voltage exceeds this value.

Units

V | MV | kV | mV

Default value

6.0 V

Program usage name

V_GT

Evaluatable

Yes

# Holding current — holding current
A | MA | kA | mA | nA | pA | uA

Details

The current threshold value. The device remains switched on if the current exceeds this value, even if the gate-cathode voltage drops below the unlocking control voltage.

Units

A | MA | kA | mA | nA | pA | uA

Default value

1.0 A

Program usage name

I_H

Evaluatable

Yes

# On-state behavior and switching losses — operating mode behavior and switching losses
Specify constant values | Tabulate

Details

Parameterization method for operating mode behavior and switching losses:

  • Specify constant values — Use scalar values to set the output current and losses when switching on and off. The block assumes that the energy dissipated during a single on or off switch is linearly dependent on the voltage in the off state and the current in the on state. The block also assumes that losses are independent of temperature.

  • Tabulate — Use vectors to specify output current and temperature data. Use arrays to specify data about power-on and power-off losses.

Dependencies

To use this option, check the box Enable thermal port.

Values

Specify constant values | Tabulate

Default value

Specify constant values

Program usage name

thermal_loss_option

Evaluatable

No

# Forward voltage, Vf — forward voltage
V | MV | kV | mV

Details

The forward voltage at which the device turns on.

Dependencies

To use this parameter:

  • uncheck the box Enable thermal port.

or:

  • check the box Enable thermal port, and for the parameter On-state behavior and switching losses set the value Specify constant values.

Units

V | MV | kV | mV

Default value

0.8 V

Program usage name

V_f

Evaluatable

Yes

# On-state resistance — resistance in the open state
Ohm | GOhm | MOhm | kOhm | mOhm

Details

The resistance of the open anode-cathode channel.

Dependencies

To use this parameter:

  • uncheck the box Enable thermal port.

or:

  • check the box Enable thermal port, and for the parameter On-state behavior and switching losses set the value Specify constant values.

Units

Ohm | GOhm | MOhm | kOhm | mOhm

Default value

0.001 Ohm

Program usage name

R_on

Evaluatable

Yes

# On-state voltage, Vak(Tj,Iak) — voltage in the open state
V | MV | kV | mV

Details

The matrix of voltage drops on the device in an open conductive state. This parameter depends on the temperature Temperature vector, Tj and the final output current in the open state Anode-cathode current vector, Iak.

Dependencies

To use this option, check the box Enable thermal port, and for the parameter On-state behavior and switching losses set the value Tabulate.

Units

V | MV | kV | mV

Default value

[0.0 0.1 0.6 0.8 1.0 1.3 1.6 2.0 2.4; 0.0 0.1 0.7 1.0 1.2 1.5 1.9 2.4 2.8] V

Program usage name

V_on_matrix

Evaluatable

Yes

# Temperature vector, Tj — temperature values
K | degC | degF | degR | deltaK | deltadegC | deltadegF | deltadegR

Details

The vector of temperature values at which the voltage is set in the open state On-state voltage, Vak(Tj,Iak).

Dependencies

To use this option, check the box Enable thermal port, and for the parameter On-state behavior and switching losses set the value Tabulate.

Units

K | degC | degF | degR | deltaK | deltadegC | deltadegF | deltadegR

Default value

[298.15, 398.15] K

Program usage name

T_vector

Evaluatable

Yes

# Anode-cathode current vector, Iak — values of the anode-cathode current
A | MA | kA | mA | nA | pA | uA

Details

The vector of values of the anode-cathode current at which the voltage is set in the open state On-state voltage, Vak(Tj,Iak). The first element must be zero.

Dependencies

To use this option, check the box Enable thermal port, and for the parameter On-state behavior and switching losses set the value Tabulate.

Units

A | MA | kA | mA | nA | pA | uA

Default value

[0.0, 0.1, 1.0, 5.0, 10.0, 20.0, 40.0, 70.0, 100.0] A

Program usage name

I_vector

Evaluatable

Yes

# Off-state conductance — closed state conductivity
S | mS | nS | uS | 1/Ohm

Details

The anode-cathode conductivity is in the closed state. The value of this parameter should be less than , where — parameter value On-state resistance.

Units

S | mS | nS | uS | 1/Ohm

Default value

1e-05 1/Ohm

Program usage name

G_off

Evaluatable

Yes

Switching Losses

# Switch-on loss, Eon(Tj,Iak) — switching loss matrix
Btu_IT | J | MJ | MWh | Wh | eV | kJ | kWh | mJ | mWh

Details

Energy dissipated during a single switch-on as a function of temperature Temperature vector for switching losses, Tj and the final output current in the open state Anode-cathode current vector for switching losses, Iak.

Dependencies

To use this option, check the box Enable thermal port, and for the parameter On-state behavior and switching losses set the value Tabulate.

Units

Btu_IT | J | MJ | MWh | Wh | eV | kJ | kWh | mJ | mWh

Default value

[0.0 0.0024 0.024 0.12 0.2 0.48 1.04 2.16 3.24; 0.0 0.003 0.03 0.15 0.25 0.6 1.3 2.7 4.05] * 1.0e-3 J

Program usage name

E_turn_on_losses_matrix

Evaluatable

Yes

# Temperature vector for switching losses, Tj — vector of temperature values
K | degC | degF | degR | deltaK | deltadegC | deltadegF | deltadegR

Details

The vector of temperature values at which the losses are set when switching on and off Switch-on loss, Eon(Tj,Iak).

Dependencies

To use this option, check the box Enable thermal port, and for the parameter On-state behavior and switching losses set the value Tabulate.

Units

K | degC | degF | degR | deltaK | deltadegC | deltadegF | deltadegR

Default value

[298.15, 398.15] K

Program usage name

T_losses_vector

Evaluatable

Yes

# Anode-cathode current vector for switching losses, Iak — values of the anode-cathode current
A | MA | kA | mA | nA | pA | uA

Details

The vector of values of the anode-cathode current, at which the losses are set when switching on and off Switch-on loss, Eon(Tj,Iak). The first element must be zero.

Dependencies

To use this option, check the box Enable thermal port, and for the parameter On-state behavior and switching losses set the value Tabulate.

Units

A | MA | kA | mA | nA | pA | uA

Default value

[0.0, 0.1, 1.0, 5.0, 10.0, 20.0, 40.0, 70.0, 100.0] A

Program usage name

I_losses_vector

Evaluatable

Yes

# Switch-on loss — switching losses
Btu_IT | J | MJ | MWh | Wh | eV | kJ | kWh | mJ | mWh

Details

The energy dissipated during a single power-on.

Dependencies

To use this option, check the box Enable thermal port, and for the parameter On-state behavior and switching losses set the value Specify constant values.

Units

Btu_IT | J | MJ | MWh | Wh | eV | kJ | kWh | mJ | mWh

Default value

0.02286 J

Program usage name

E_turn_on_losses_const

Evaluatable

Yes

# Natural commutation rectification loss — natural switching rectification losses
Btu_IT | J | MJ | MWh | Wh | eV | kJ | kWh | mJ | mWh

Details

Rectification losses that occur when the device is switched off when the current drops below the holding current. This parameter is set as a scalar value.

Dependencies

To use this option, check the box Enable thermal port.

Units

Btu_IT | J | MJ | MWh | Wh | eV | kJ | kWh | mJ | mWh

Default value

0.01 J

Program usage name

E_off_natural_commutation

Evaluatable

Yes

# Off-state voltage for switching loss data — voltage in the closed state for loss data
V | MV | kV | mV

Details

The output voltage of the device is in the closed state. This is the locking voltage at which the on and off losses are determined.

Dependencies

To use this option, check the box Enable thermal port.

Units

V | MV | kV | mV

Default value

300.0 V

Program usage name

V_off_losses

Evaluatable

Yes

# On-state current for switching loss data — Output current
A | MA | kA | mA | nA | pA | uA

Details

The output current for which the on loss, off loss, and open voltage are determined. Set this parameter to a scalar value.

This parameter is measured at the moment when the gate voltage drops below the parameter value. Gate trigger voltage, Vgt. The duration of the switching pulse exceeds the time required for the current to reach its maximum value.

Dependencies

To use this option, check the box Enable thermal port.

Units

A | MA | kA | mA | nA | pA | uA

Default value

600.0 A

Program usage name

I_losses_const

Evaluatable

Yes

# Wait time before switch-on current measurement — time to measure the current in the open state
d | s | hr | ms | ns | us | min

Details

The waiting time before measuring the current in the open state.

Dependencies

To use this option, check the box Enable thermal port.

Units

d | s | hr | ms | ns | us | min

Default value

0.0001 s

Program usage name

t_current_measurement_delay

Evaluatable

Yes

Integral Diode

# Integral protection diode — internal protective diode (suppressor)
External Diode | Diode with no dynamics | Diode with charge dynamics

Details

The default value is External Diode.

If it is necessary to turn on the internal protective diode, then there are two possible options:

  • Diode with no dynamics.

  • Diode with charge dynamics.

Values

External Diode | Diode with no dynamics | Diode with charge dynamics

Default value

External Diode

Program usage name

integral_protection_diode

Evaluatable

No

# Diode model — the diode model
Piecewise linear | Tabulated I-V curve

Details

Choose one of the diode models:

  • Piecewise linear — a diode with a piecewise linear VAC is used, for more information, see Piecewise linear VAC diode

  • Tabulated I-V curve — a diode with a tabulated VAC is used for forward bias and constant conductivity for reverse bias.

Dependencies

To use this option, check the box Enable thermal port, and for the parameter Integral protection diode set the value Diode with no dynamics or Diode with charge dynamics.

Values

Piecewise linear | Tabulated I-V curve

Default value

Piecewise linear

Program usage name

diode_parameterization

Evaluatable

No

# Table type — tabular function
Table in If(Tj, Vf) form | Table in Vf(Tj, If) form

Details

Select a tabular function: current as a function of temperature and voltage, or voltage as a function of temperature and current.

Dependencies

To use this parameter, set:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics or Diode with charge dynamics;

  • for the parameter Diode model meaning Tabulated I-V curve.

Values

Table in If(Tj, Vf) form | Table in Vf(Tj, If) form

Default value

Table in If(Tj, Vf) form

Program usage name

tabulated_diode_parameterization

Evaluatable

No

# Forward currents, If(Tj, Vf) — the matrix of direct currents
A | MA | kA | mA | nA | pA | uA

Details

Forward current values as a function of temperature Junction temperatures, Tj and tension Forward voltages, Vf.

Dependencies

To use this parameter, set:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics or Diode with charge dynamics;

  • for the parameter Diode model meaning Tabulated I-V curve;

  • for the parameter Table type meaning Table in If(Tj, Vf) form.

Units

A | MA | kA | mA | nA | pA | uA

Default value

[0.07 0.12 0.19 1.75 4.24 7.32 11.20; 0.16 0.30 0.72 2.14 4.02 6.35 9.12] A

Program usage name

I_f_matrix_diode

Evaluatable

Yes

# Forward voltages, Vf(Tj, If) — forward voltage matrix
V | MV | kV | mV

Details

Forward voltage values as a function of temperature Junction temperatures, Tj and current Forward currents, If.

Dependencies

To use this parameter, set:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics or Diode with charge dynamics;

  • for the parameter Diode model meaning Tabulated I-V curve;

  • for the parameter Table type meaning Table in Vf(Tj, If) form.

Units

V | MV | kV | mV

Default value

[0.9 1.15 1.25 1.5 1.75 2.17 2.6 2.85; 0.58 0.68 0.75 1.1 1.38 1.77 2.27 2.7] V

Program usage name

V_f_matrix_diode

Evaluatable

Yes

# Junction temperatures, Tj — vector of transition temperature values
K | degC | degF | degR | deltaK | deltadegC | deltadegF | deltadegR

Details

Vector of transition temperature values at which forward voltages are set Forward voltages, Vf(Tj, If) or direct currents Forward currents, If(Tj, Vf). This vector must contain at least two elements.

Dependencies

To use this parameter, set:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics or Diode with charge dynamics;

  • for the parameter Diode model meaning Tabulated I-V curve.

Units

K | degC | degF | degR | deltaK | deltadegC | deltadegF | deltadegR

Default value

[25.0, 125.0] degC

Program usage name

T_j_vector_diode

Evaluatable

Yes

# Forward voltages, Vf — vector of forward voltage values
V | MV | kV | mV

Details

The vector of forward voltage values at which forward currents are set Forward currents, If(Tj, Vf). This vector must contain at least three non-negative elements.

Dependencies

To use this parameter, set:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics or Diode with charge dynamics;

  • for the parameter Diode model meaning Tabulated I-V curve;

  • for the parameter Table type meaning Table in If(Tj, Vf) form.

Units

V | MV | kV | mV

Default value

[0.5, 0.7, 0.9, 1.3, 1.7, 2.1, 2.5] V

Program usage name

V_f_vector_diode

Evaluatable

Yes

# Forward currents, If — vector of forward current values
A | MA | kA | mA | nA | pA | uA

Details

The vector of forward current values at which forward voltages are set Forward voltages, Vf(Tj, If). This vector must contain at least three non-negative elements.

Dependencies

To use this parameter, set:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics or Diode with charge dynamics;

  • for the parameter Diode model meaning Tabulated I-V curve;

  • for the parameter Table type meaning Table in Vf(Tj, If) form.

Units

A | MA | kA | mA | nA | pA | uA

Default value

[0.1, 0.2, 0.5, 1.0, 2.0, 4.0, 7.0, 10.0] A

Program usage name

I_f_vector_diode

Evaluatable

Yes

# Forward voltage — direct current voltage
V | MV | kV | mV

Details

The minimum voltage between the anode and the cathode of the diode in order for the gradient of the volt-ampere characteristic of the diode to be equal to 1/ , where — parameter value On resistance.

Dependencies

To use this parameter:

  • uncheck the box Enable thermal port;

  • set for the parameter Integral protection diode meaning Diode with no dynamics or Diode with charge dynamics;

or install:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics or Diode with charge dynamics;

  • for the parameter Diode model meaning Piecewise linear.

Units

V | MV | kV | mV

Default value

0.8 V

Program usage name

V_f_diode

Evaluatable

Yes

# On resistance — resistance when switched on directly
Ohm | GOhm | MOhm | kOhm | mOhm

Details

The resistance of the diode is in the open state when the voltage is higher than the value set by the parameter Forward voltage.

Dependencies

To use this parameter:

  • uncheck the box Enable thermal port;

  • set for the parameter Integral protection diode meaning Diode with no dynamics or Diode with charge dynamics;

or install:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics or Diode with charge dynamics;

  • for the parameter Diode model meaning Piecewise linear.

Units

Ohm | GOhm | MOhm | kOhm | mOhm

Default value

0.001 Ohm

Program usage name

R_on_diode

Evaluatable

Yes

# Off conductance — closed state conductivity
S | mS | nS | uS | 1/Ohm

Details

The conductivity of the diode when it is switched back on.

Dependencies

To use this parameter, set for the parameter Integral protection diode meaning Diode with no dynamics or Diode with charge dynamics.

Units

S | mS | nS | uS | 1/Ohm

Default value

1e-05 1/Ohm

Program usage name

G_off_diode

Evaluatable

Yes

# Junction capacitance — transfer capacity
F | mF | nF | pF | uF

Details

The value of the capacitance characteristic of the transition from the depleted zone, acting as a dielectric and separating the connections of the anode and cathode.

Dependencies

To use this parameter, set for the parameter Integral protection diode meaning Diode with charge dynamics.

Units

F | mF | nF | pF | uF

Default value

50e-9 F

Program usage name

C_diode

Evaluatable

Yes

# Peak reverse current, iRM — peak reverse current
A | MA | kA | mA | nA | pA | uA

Details

The peak return current measured by the external test circuit. This value must be less than zero.

Dependencies

To use this parameter, set for the parameter Integral protection diode meaning Diode with charge dynamics.

Units

A | MA | kA | mA | nA | pA | uA

Default value

-235.0 A

Program usage name

i_rm_diode

Evaluatable

Yes

# Initial forward current when measuring iRM — initial forward current during iRM measurement
A | MA | kA | mA | nA | pA | uA

Details

The initial forward current (at the initial moment of the switch-on time) when measuring the peak reverse current. This value must be greater than zero.

Dependencies

To use this parameter, set for the parameter Integral protection diode meaning Diode with charge dynamics.

Units

A | MA | kA | mA | nA | pA | uA

Default value

300.0 A

Program usage name

i_f_diode

Evaluatable

Yes

# Rate of change of current when measuring iRM — the rate of change of current during iRM measurement
A/s | A/us

Details

The rate of change of the current when measuring the peak reverse current. This value must be less than zero.

Dependencies

To use this parameter, set for the parameter Integral protection diode meaning Diode with charge dynamics.

Units

A/s | A/us

Default value

-50.0 A/us

Program usage name

diode_current_change_rate

Evaluatable

Yes

# Reverse recovery time parameterization — type of reverse recovery time determination
Specify stretch factor | Specify reverse recovery time directly | Specify reverse recovery charge

Details

When selecting an option Specify stretch factor or Specify reverse recovery charge the value that is used by the block to calculate the reverse recovery time is specified.

Dependencies

To use this parameter, set for the parameter Integral protection diode meaning Diode with charge dynamics.

Values

Specify stretch factor | Specify reverse recovery time directly | Specify reverse recovery charge

Default value

Specify stretch factor

Program usage name

t_rr_diode_parameterization

Evaluatable

No

# Reverse recovery time stretch factor — the stretching coefficient of the reverse recovery time

Details

The value that the block uses for calculation Reverse recovery time, trr. This value must be greater than `1'. Specifying the stretching coefficient is an easier way to parameterize the reverse recovery time than specifying the reverse recovery charge. The higher the value of the stretching coefficient, the longer it takes for the reverse recovery current to dissipate.

Dependencies

To use this parameter, set for the parameter Integral protection diode meaning Diode with charge dynamics, and for the parameter Reverse recovery time parameterization meaning Specify stretch factor.

Default value

3.0

Program usage name

t_rr_factor_diode

Evaluatable

Yes

# Reverse recovery time, trr — reverse recovery time
d | s | hr | ms | ns | us | min

Details

The amount of time it takes for a diode to turn off when the voltage across it reverses from forward bias to reverse.

The interval between the moment of the initial transition of the current through zero (when the diode turns off) and the moment the current drops to less than 10% of the peak current. Parameter value Reverse recovery time, trr there must be more than the parameter value. Peak reverse current, iRM, divided by the parameter value Rate of change of current when measuring iRM.

Dependencies

To use this parameter, set for the parameter Integral protection diode meaning Diode with charge dynamics, and for the parameter Reverse recovery time parameterization meaning Specify reverse recovery time directly.

Units

d | s | hr | ms | ns | us | min

Default value

15.0 us

Program usage name

t_rr_diode

Evaluatable

Yes

# Reverse recovery charge, Qrr — reverse recovery charge
C | Ah | mC | nC | uC | MAh | kAh | mAh | s*uA

Details

The value that the block uses for calculation Reverse recovery time, trr. Use this parameter if the reverse recovery charge value is specified in the block parameters as the type of reverse recovery time determination instead of the reverse recovery time value.

The reverse recovery charge is the total charge that continues to dissipate after the diode is turned off. The value must be less than , where:

  • — the value specified for the parameter Peak reverse current, iRM;

  • — the value specified for the parameter Rate of change of current when measuring iRM.

Dependencies

To use this parameter, set for the parameter Integral protection diode meaning Diode with charge dynamics, and for the parameter Reverse recovery time parameterization meaning Specify reverse recovery charge.

Units

C | Ah | mC | nC | uC | MAh | kAh | mAh | s*uA

Default value

1500.0 s*uA

Program usage name

Q_rr_diode

Evaluatable

Yes

# Reverse recovery loss model — reverse recovery loss model
Fixed loss | Tabulated loss

Details

Choose how to model losses during reverse recovery: as a fixed value or as a tabular function.

Dependencies

To use this option, check the box Enable thermal port, and for the parameter Integral protection diode set the value Diode with no dynamics.

Values

Fixed loss | Tabulated loss

Default value

Fixed loss

Program usage name

reverse_recovery_loss_model_diode

Evaluatable

No

# Reverse recovery loss — reverse recovery losses
Btu_IT | J | MJ | MWh | Wh | eV | kJ | kWh | mJ | mWh

Details

The energy dissipated at each shutdown, regardless of the state of the diode before or after switching.

Dependencies

To use this parameter, set:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics;

  • for the parameter Reverse recovery loss model meaning Fixed loss.

Units

Btu_IT | J | MJ | MWh | Wh | eV | kJ | kWh | mJ | mWh

Default value

0.0 J

Program usage name

reverse_recovery_loss_const_diode

Evaluatable

Yes

# Scale reverse recovery loss with current and voltage — scaling of reverse recovery losses using current and voltage

Details

Select this option to enable scaling of reverse recovery losses using current and voltage.

Dependencies

To use this parameter, set:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics;

  • for the parameter Reverse recovery loss model meaning Fixed loss.

Default value

true (switched on)

Program usage name

scale_reverse_recovery_loss_diode

Evaluatable

No

# Reverse recovery loss table, Erec(Tj, If) — reverse recovery loss matrix
Btu_IT | J | MJ | MWh | Wh | eV | kJ | kWh | mJ | mWh

Details

Dissipated energy as a function of current Forward current vector for recovery loss table, If just before the switching and temperature event Temperature vector for recovery loss table, Tj.

Dependencies

To use this parameter, set:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics;

  • for the parameter Reverse recovery loss model meaning Tabulated loss.

Units

Btu_IT | J | MJ | MWh | Wh | eV | kJ | kWh | mJ | mWh

Default value

zeros(2, 3) J

Program usage name

reverse_recovery_loss_matrix_diode

Evaluatable

Yes

# Temperature vector for recovery loss table, Tj — vector of temperature values
K | degC | degF | degR | deltaK | deltadegC | deltadegF | deltadegR

Details

Vector of temperature values at which reverse recovery losses are set Reverse recovery loss table, Erec(Tj, If).

Dependencies

To use this parameter, set:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics;

  • for the parameter Reverse recovery loss model meaning Tabulated loss.

Units

K | degC | degF | degR | deltaK | deltadegC | deltadegF | deltadegR

Default value

[298.15, 398.15] K

Program usage name

T_losses_vector_diode

Evaluatable

Yes

# Forward current vector for recovery loss table, If — vector of forward current values
A | MA | kA | mA | nA | pA | uA

Details

Vector of forward current values at which reverse recovery losses are specified Reverse recovery loss table, Erec(Tj, If).

Dependencies

To use this parameter, set:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics;

  • for the parameter Reverse recovery loss model meaning Tabulated loss.

Units

A | MA | kA | mA | nA | pA | uA

Default value

[0.1, 1.0, 10.0] A

Program usage name

I_f_losses_vector_diode

Evaluatable

Yes

# Forward current when measuring recovery loss, Irec — direct current when measuring recovery losses
A | MA | kA | mA | nA | pA | uA

Details

Direct current through the diode to reverse recovery, which the unit uses to measure recovery losses.

Dependencies

To use this parameter, set:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics;

  • for the parameter Reverse recovery loss model meaning Fixed loss;

  • the flag Scale reverse recovery loss with current and voltage.

Units

A | MA | kA | mA | nA | pA | uA

Default value

10.0 A

Program usage name

I_forward_recovery_loss_const_diode

Evaluatable

Yes

# Turn-off voltage when measuring recovery loss, Vrec — Shutdown voltage when measuring recovery losses
V | MV | kV | mV

Details

The voltage across the diode after reverse recovery is used to measure recovery losses.

Dependencies

To use this parameter, set:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics;

  • for the parameter Reverse recovery loss model meaning Fixed loss;

  • the flag Scale reverse recovery loss with current and voltage;

or install:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics;

  • for the parameter Reverse recovery loss model meaning Tabulated loss.

Units

V | MV | kV | mV

Default value

10.0 V

Program usage name

V_off_recovery_loss_const_diode

Evaluatable

Yes

# Filter time constant for voltage and current values — filter time constant for voltage and current values
d | s | hr | ms | ns | us | min

Details

The filter time constant for the voltage and current values used to calculate reverse recovery losses. Set the value of this parameter lower than the fastest switching period.

Dependencies

To use this parameter, set:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics;

  • for the parameter Reverse recovery loss model meaning Fixed loss;

  • the flag Scale reverse recovery loss with current and voltage;

or install:

  • the flag Enable thermal port;

  • for the parameter Integral protection diode meaning Diode with no dynamics;

  • for the parameter Reverse recovery loss model meaning Tabulated loss.

Units

d | s | hr | ms | ns | us | min

Default value

1.0 / 1000.0 / 100.0 s

Program usage name

tau_filter_diode

Evaluatable

Yes

Thermal Port

# Enable thermal port — turning on the heat port

Details

Select this option to use the thermal port of the unit and simulate the effect of the generated heat and the temperature of the device.

Default value

false (switched off)

Program usage name

has_thermal_port

Evaluatable

No

# Thermal network — choosing an internal thermal model
Specify junction and case thermal parameters | Cauer model | Cauer model parameterized with Foster coefficients | External

Details

Choose an internal thermal model:

  • Specify junction and case thermal parameters;

  • Cauer model;

  • Cauer model parameterized with Foster coefficients;

  • External.

Values

Specify junction and case thermal parameters | Cauer model | Cauer model parameterized with Foster coefficients | External

Default value

External

Program usage name

thermal_network_parameterization

Evaluatable

No

# Junction-case and case-ambient (or case-heatsink) thermal resistances, [R_JC R_CA] — the vector of thermal resistances
K/W

Details

The vector [R_JC R_CA] consists of two values of thermal resistance. The first value of `R_JC' is the thermal resistance between the junction and the housing. The second value, `R_CA', is the thermal resistance between the H port and the device body.

Dependencies

To use this parameter, set for the parameter Thermal network meaning Specify junction and case thermal parameters.

Units

K/W

Default value

[0.08, 0.5] K/W

Program usage name

thermal_resistance_vector

Evaluatable

Yes

# Thermal resistances, [R1 R2 ... Rn] — the vector of thermal resistances for the Kauer model
K/W

Details

Vector from the values of the thermal resistances represented by the Kauer elements in the heating network. All these values must be greater than zero.

Dependencies

To use this parameter, set for the parameter Thermal network meaning Cauer model.

Units

K/W

Default value

[0.08, 0.1, 0.5] K/W

Program usage name

thermal_resistance_cauer_vector

Evaluatable

Yes

# Thermal resistances, [R1 R2 ... Rn] — the vector of thermal resistances for the Foster model
K/W

Details

Vector from the values of thermal resistances represented by the coefficients of the Foster model in the heating network. All these values must be greater than zero.

Dependencies

To use this parameter, set for the parameter Thermal network meaning Cauer model parameterized with Foster coefficients.

Units

K/W

Default value

[0.08, 0.14, 0.22, 0.16] K/W

Program usage name

thermal_resistance_foster_vector

Evaluatable

Yes

# Thermal mass parameterization — parameterization of heat capacity
By thermal time constants | By thermal mass

Details

Choose a method for setting the heat capacity:

  • By thermal time constants — parameterization of heat capacity in terms of thermal time constants. This value is used by default.

  • By thermal mass — setting the heat capacity values.

Dependencies

To use this parameter, set for the parameter Thermal network meaning Specify junction and case thermal parameters, Cauer model or Cauer model parameterized with Foster coefficients.

Values

By thermal time constants | By thermal mass

Default value

By thermal time constants

Program usage name

thermal_mass_parameterization

Evaluatable

No

# Junction and case thermal time constants, [t_J t_C] — vector of thermal time constants
d | s | hr | ms | ns | us | min

Details

The vector [t_J t_C] consists of two values of the thermal time constants. The first value of t_J is the thermal transition time constant. The second value, `t_C', is the thermal time constant of the enclosure.

Dependencies

To use this parameter, set for the parameter Thermal network meaning Specify junction and case thermal parameters, and for the parameter Thermal mass parameterization meaning By thermal time constants.

Units

d | s | hr | ms | ns | us | min

Default value

[0.001, 0.2] s

Program usage name

thermal_time_constant_vector

Evaluatable

Yes

# Thermal time constants, [t1 t2 ... tn] — vector of thermal time constants for the Kauer model
d | s | hr | ms | ns | us | min

Details

Vector from values of thermal time constants, where this is the number of Kauer elements in the heating network. All these values must be greater than zero.

The value of the heat capacity is calculated as , where , and — heat capacity, thermal time constant and thermal resistance for - the go element of the Cowera.

Dependencies

To use this parameter, set for the parameter Thermal network meaning Cauer model, and for the parameter Thermal mass parameterization meaning By thermal time constants.

Units

d | s | hr | ms | ns | us | min

Default value

[0.001, 0.1, 0.2] s

Program usage name

thermal_time_constant_cauer_vector

Evaluatable

Yes

# Thermal time constants, [t1 t2 ... tn] — the vector of thermal time constants for the Foster model
d | s | hr | ms | ns | us | min

Details

Vector from values of thermal time constants, where this is the number of coefficients of the Foster model in the heating network. All these values must be greater than zero.

The value of the heat capacity is calculated as , where , and — heat capacity, thermal time constant and thermal resistance for - the go element of the Cowera.

Dependencies

To use this parameter, set for the parameter Thermal network meaning Cauer model parameterized with Foster coefficients, and for the parameter Thermal mass parameterization meaning By thermal time constants.

Units

d | s | hr | ms | ns | us | min

Default value

[7.0e-5, 7.0e-4, 0.01, 0.08] s

Program usage name

thermal_time_constant_foster_vector

Evaluatable

Yes

# Junction and case thermal masses, [M_J M_C] — vector of heat capacity values for the Kauer model
J/K | kJ/K

Details

The vector [M_J M_C] consists of two values of the heat capacity. The first value of M_J is the heat capacity of the junction. The second value, `M_C', is the heat capacity of the housing.

Dependencies

To use this parameter, set for the parameter Thermal network meaning Specify junction and case thermal parameters, and for the parameter Thermal mass parameterization meaning By thermal mass.

Units

J/K | kJ/K

Default value

[0.01, 0.5] J/K

Program usage name

thermal_mass_vector

Evaluatable

Yes

# Thermal masses, [M1 M2 ... Mn] — vector of heat capacity values for the Kauer model
J/K | kJ/K

Details

Vector from values of heat capacities, where this is the number of coefficients of the Kauer model in the heat network. All these values must be greater than zero.

Dependencies

To use this parameter, set for the parameter Thermal network meaning Cauer model, and for the parameter Thermal mass parameterization meaning By thermal mass.

Units

J/K | kJ/K

Default value

[0.01, 0.1, 0.5] J/K

Program usage name

thermal_mass_cauer_vector

Evaluatable

Yes

# Thermal masses, [M1 M2 ... Mn] — the vector of heat capacity values for the Foster model
J/K | kJ/K

Details

Vector from values of heat capacities, where this is the number of Foster elements in the heating network. All these values must be greater than zero.

Dependencies

To use this parameter, set for the parameter Thermal network meaning Cauer model parameterized with Foster coefficients, and for the parameter Thermal mass parameterization meaning By thermal mass.

Units

J/K | kJ/K

Default value

[0.001, 0.005, 0.05, 0.5] J/K

Program usage name

thermal_mass_foster_vector

Evaluatable

Yes

# Junction and case initial temperatures, [T_J T_C] — vector of thermal time constants
K | degC | degF | degR | deltaK | deltadegC | deltadegF | deltadegR

Details

The vector [t_J t_C] consists of two values of the thermal time constants. The first value of t_J is the thermal transition time constant. The second value, `t_C', is the thermal time constant of the enclosure.

Dependencies

To use this parameter, set for the parameter Thermal network meaning Specify junction and case thermal parameters, and for the parameter Thermal mass parameterization meaning By thermal time constants.

Units

K | degC | degF | degR | deltaK | deltadegC | deltadegF | deltadegR

Default value

[25.0, 25.0] degC

Program usage name

T_thermal_mass_vector_start

Evaluatable

Yes

# Thermal masses initial temperatures, [T1 T2 ... Tn] — initial temperature vector for the Kauer model
K | degC | degF | degR | deltaK | deltadegC | deltadegF | deltadegR

Details

The vector of temperature values. It corresponds to the temperature difference for each heat capacity in the model.

Dependencies

To use this parameter, set for the parameter Thermal network meaning Cauer model.

Units

K | degC | degF | degR | deltaK | deltadegC | deltadegF | deltadegR

Default value

[25.0, 25.0, 25.0] degC

Program usage name

T_thermal_mass_cauer_vector_start

Evaluatable

Yes

# Initial node temperatures, [T1 T2 ... Tn] — the initial temperature vector for the Foster model
K | degC | degF | degR | deltaK | deltadegC | deltadegF | deltadegR

Details

The vector of absolute temperature values of each element of the Foster model.

Dependencies

To use this parameter, set for the parameter Thermal network meaning Cauer model parameterized with Foster coefficients.

Units

K | degC | degF | degR | deltaK | deltadegC | deltadegF | deltadegR

Default value

[25.0, 25.0, 25.0, 25.0] degC

Program usage name

T_thermal_mass_foster_vector_start

Evaluatable

Yes

# Junction thermal mass — the heat capacity of the transition
J/K | kJ/K

Details

The heat capacity of the transition

Dependencies

To use this parameter, set for the parameter Thermal network meaning External.

Units

J/K | kJ/K

Default value

0.01 J/K

Program usage name

junction_thermal_mass

Evaluatable

Yes