Документация Engee

Fault

Короткое замыкание (КЗ) с управлением по времени, диапазону значений или по внешнему триггеру.

Тип: AcausalElectricPowerSystems.Utilities.Fault

Путь в библиотеке:

/Physical Modeling/Electrical/Utilities/Fault

Описание

Блок Fault моделирует короткое замыкание (КЗ) в виде мгновенного изменения сопротивления. Вы можете использовать его для воспроизведения поведения как разрыва цепи, так и КЗ. Блок поддерживает следующие варианты срабатывания:

  • В определенное время. Блок также может снять КЗ по истечении заданного времени.

  • При выходе за пределы заданного диапазона напряжения или тока.

  • Если входной сигнал становится больше или меньше заданного порогового значения.

Параметр Fault resets when fault trigger reverts также позволяет сбрасывать КЗ, когда значение внешнего сигнала F перестает удовлетворять условие External fault trigger. Вы можете включать или отключать все три триггера по отдельности. Если при моделировании требуется более одного триггера, вы можете использовать их вместе.

Когда КЗ не активно, сопротивление между двумя электрическими портами определяется значением параметра Unfaulted resistance. Значение по умолчанию для этого параметра равно inf, то есть цепь разомкнута.

При возникновении КЗ блок изменяет сопротивление между двумя электрическими портами на значение параметра Faulted resistance. Значение по умолчанию для этого параметра равно 1e-3 Ом, то есть порты закорочены.

Выходной сигнал X передает состояние блока; если блок находится в КЗ, то выходной сигнал равен 1, в противном случае 0. Входной сигнал на порту F является внешним сигналом запуска КЗ и используется только в том случае, если установлен флажок Enable external fault trigger.

Порты

Ненаправленные

# + — положительный
электричество

Details

Электрический порт, представляет положительную клемму блока.

Имя для программного использования

p

# — отрицательный
электричество

Details

Электрический порт, представляет отрицательную клемму блока.

Имя для программного использования

n

Выход

# X — состояние КЗ
скаляр

Details

Порт вывода сигнала для сообщения о состоянии КЗ:

  • 1 — короткое замыкание.

  • 0 — без изменений.

Типы данных

Float64

Поддержка комплексных чисел

Нет

Вход

# F — внешний вызов КЗ
скаляр

Details

Внешний сигнал для вызова КЗ.

Зависимости

Чтобы использовать этот порт, установите флажок Enable external fault trigger.

Типы данных

Float64

Поддержка комплексных чисел

Нет

Параметры

Основные

# Unfaulted resistance — сопротивление без КЗ
Ohm | mOhm | kOhm | MOhm | GOhm

Details

Сопротивление между портами + и при отсутствии КЗ.

Единицы измерения

Ohm | mOhm | kOhm | MOhm | GOhm

Значение по умолчанию

Inf Ohm

Имя для программного использования

R_unfaulted

Вычисляемый

Да

# Faulted resistance — сопротивление при КЗ
Ohm | mOhm | kOhm | MOhm | GOhm

Details

Сопротивление между портами + и при активном КЗ.

Единицы измерения

Ohm | mOhm | kOhm | MOhm | GOhm

Значение по умолчанию

1e-3 Ohm

Имя для программного использования

R_faulted

Вычисляемый

Да

Управление по времени

# Enable temporal fault trigger — запуск КЗ по времени

Details

Установите этот флажок, чтобы включить запуск КЗ по времени.

Значение по умолчанию

false (выключено)

Имя для программного использования

temporal

Вычисляемый

Нет

# Simulation time for fault event — время начала КЗ
s | ns | us | ms | min | hr | d

Details

Время моделирования, при наступлении которого блок переходит в состояние КЗ.

Зависимости

Чтобы использовать этот параметр, установите флажок Enable temporal fault trigger.

Единицы измерения

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

Значение по умолчанию

1.0 s

Имя для программного использования

start_time

Вычисляемый

Да

# Fault duration — продолжительность КЗ
s | ns | us | ms | min | hr | d

Details

Время продолжительности моделирования КЗ. Блок выходит из состояния КЗ по истечении заданного времени.

Зависимости

Чтобы использовать этот параметр, установите флажок Enable temporal fault trigger.

Единицы измерения

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

Значение по умолчанию

Inf s

Имя для программного использования

duration

Вычисляемый

Да

Управление по событию

# Enable behavioral fault trigger — запуск КЗ по событию

Details

Установите этот флажок, чтобы включить запуск КЗ по событию.

Значение по умолчанию

false (выключено)

Имя для программного использования

behavioral

Вычисляемый

Нет

# Permissible voltage range — допустимый диапазон напряжений
V | uV | mV | kV | MV

Details

Укажите вектор из двух элементов, который определяет допустимый диапазон напряжений. Если напряжение находится за пределами этого диапазона дольше, чем указано в параметре Time to fail when exceeding voltage range, то блок переходит в состояние КЗ.

Зависимости

Чтобы использовать этот параметр, установите флажок Enable behavioral fault trigger.

Единицы измерения

V | uV | mV | kV | MV

Значение по умолчанию

[-100.0, 100.0] V

Имя для программного использования

permissible_voltage_range

Вычисляемый

Да

# Time to fail when exceeding voltage range — время до КЗ при выходе из допустимого диапазона значений
s | ns | us | ms | min | hr | d

Details

Установите максимальный промежуток времени, в течение которого напряжение может выходить за пределы допустимого диапазона без возникновения КЗ.

Зависимости

Чтобы использовать этот параметр, установите флажок Enable behavioral fault trigger.

Единицы измерения

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

Значение по умолчанию

1.0 s

Имя для программного использования

time_fail_on_voltage

Вычисляемый

Да

# Permissible current range — допустимый диапазон силы тока
A | pA | nA | uA | mA | kA | MA

Details

Укажите вектор из двух элементов, который определяет допустимый диапазон силы тока. Если сила тока находится за пределами этого диапазона дольше, чем указано в параметре Time to fail when exceeding current range, то блок переходит в состояние КЗ.

Зависимости

Чтобы использовать этот параметр, установите флажок Enable behavioral fault trigger.

Единицы измерения

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

Значение по умолчанию

[-1.0, 1.0] A

Имя для программного использования

permissible_current_range

Вычисляемый

Да

# Time to fail when exceeding current range — время до КЗ при выходе из допустимого диапазона значений
s | ns | us | ms | min | hr | d

Details

Установите максимальный промежуток времени, в течение которого сила тока может выходить за пределы допустимого диапазона без возникновения КЗ.

Зависимости

Чтобы использовать этот параметр, установите флажок Enable behavioral fault trigger.

Единицы измерения

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

Значение по умолчанию

1.0 s

Имя для программного использования

time_fail_on_current

Вычисляемый

Да

Внешнее управление

# Enable external fault trigger — запуск КЗ по внешнему сигналу

Details

Установите этот флажок, чтобы включить запуск КЗ по внешнему сигналу F.

Значение по умолчанию

false (выключено)

Имя для программного использования

external

Вычисляемый

Нет

# External fault trigger — условие КЗ
Faulted if F ≥ Fault threshold | Faulted if F ≤ Fault threshold

Details

Выберите условие КЗ:

  • Faulted if F ≥ Fault threshold — КЗ возникает, когда значение внешнего сигнала F становится больше или равно значению параметра Fault threshold.

  • Faulted if F ≤ Fault threshold — КЗ возникает, когда значение внешнего сигнала F становится меньше или равно значению параметра Fault threshold.

Зависимости

Чтобы использовать этот параметр, установите флажок Enable external fault trigger.

Значения

Faulted if F ≥ Fault threshold | Faulted if F ≤ Fault threshold

Значение по умолчанию

Faulted if F ≥ Fault threshold

Имя для программного использования

condition

Вычисляемый

Нет

# Fault threshold — пороговое значение, вызывающее КЗ

Details

КЗ возникает, когда внешний сигнал пересекает пороговое значение в направлении, указанном в условии КЗ (External fault trigger).

Зависимости

Чтобы использовать этот параметр, установите флажок Enable external fault trigger.

Значение по умолчанию

0.5

Имя для программного использования

control_signal_threshold

Вычисляемый

Да

# Fault resets when fault trigger reverts — прекращение КЗ при восстановлении сигнала срабатывания

Details

Установите этот флажок для прекращения КЗ в момент, когда значение внешнего сигнала F перестает удовлетворять условию External fault trigger.

Зависимости

Чтобы использовать этот параметр, установите флажок Enable external fault trigger.

Значение по умолчанию

false (выключено)

Имя для программного использования

resettable

Вычисляемый

Нет