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

To COMTRADE

Записывает данные в COMTRADE-файлы.

Тип: SubSystem

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

/Physical Modeling/Electrical/Control/Sinks/To COMTRADE

Описание

Блок To COMTRADE записывает значения входных сигналов в файлы осциллограмм формата COMTRADE:

  • файл конфигурации (.cfg),

  • файл данных (.dat).

Поддерживаемые ревизии COMTRADE: 1999 и 2013 годов. Поддерживаемые типы файлов данных: ASCII, BINARY, BINARY32, FLOAT32.

Данные записываются в файлы при срабатывании триггера. Файлы сохраняются после завершения симуляции. Если в течение симуляции триггер сработает несколько раз, будет записано несколько осциллограмм. Существующие выходные файлы будут перезаписаны.

Обратите внимание: входной порт Discretes имеет тип Bool. При необходимости измените тип сигнала с помощью блока Cast To Bool. Если не отключить вход Discretes и оставить его неподключенным, возникнет ошибка, так как тип входного сигнала будет определен как Float64.

Блок автоматически определяет количество сигналов во входных портах. Параметры каналов настраиваются на вкладке Channels. При значении по умолчанию −1 параметры каналов генерируются автоматически. Для подробной настройки необходимо задать вектор значений, длина которого должна совпадать с количеством сигналов.

Порты

Вход

# Analogs — входной сигнал
скаляр | вектор

Details

Вход для записи аналоговых сигналов COMTRADE-файлов.

Типы данных

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool

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

Нет

# Discretes — входной сигнал
скаляр | вектор

Details

Вход для записи дискретных сигналов COMTRADE-файлов.

Типы данных

Bool

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

Нет

# Trigger — входной сигнал
скаляр

Details

Вход для активации записи.

Типы данных

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool

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

Нет

Параметры

Основные

# Enable analog input — включить вход Analogs аналоговых сигналов

Details

Если этот флажок установлен, то при срабатывании триггера в COMTRADE-файлы будут записаны сигналы, поступающие на вход Analogs.

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

true (включено)

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

enable_analog_input

Вычисляемый

Да

# Enable discrete input — включить вход Discretes дискретных сигналов

Details

Если этот флажок установлен, то при срабатывании триггера в COMTRADE-файлы будут записаны сигналы, поступающие на вход Discretes.

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

true (включено)

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

enable_discrete_input

Вычисляемый

Да

# Files path — путь или имя файлов (без расширения)

Details

Задайте путь или имя файлов без расширения для сохраняемых осциллограмм. Существующие файлы будут перезаписаны. Если в течение симуляции триггер сработает несколько раз, будет записано несколько осциллограмм. К именам файлов второй и последующих осциллограмм будет добавлен суффикс _x, где x — номер осциллограммы.

Можно указать абсолютный путь, начинающийся с /user, или относительный. Относительный путь определяется от текущей директории (pwd).

При симуляции на КПМ «РИТМ» необходимо передавать полный путь к файлу, например joinpath("/home/ritm/build", engee.gcm().name, "untitled").
Значение по умолчанию

"untitled"

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

files_path

Вычисляемый

Да

# Sample time, s — период дискретизации, с

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

0.001

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

sample_time

Вычисляемый

Да

# Time zone offset, h — смещение относительно всемирного координированного времени (UTC), ч

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

3.0

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

time_zone_offset

Вычисляемый

Да

Конфигурация COMTRADE

# Station name — имя подстанции

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

"Engee"

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

station_name

Вычисляемый

Да

# Recording device — идентификационный номер или имя записывающего устройства

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

"Engee"

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

rec_dev_id

Вычисляемый

Да

# Standard revision — версия стандарта
1999 | 2013

Details
Значения

1999 | 2013

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

2013

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

rev_year

Вычисляемый

Да

# Data file type — тип файла данных
ASCII | BINARY | BINARY32 | FLOAT32

Details

Значения BINARY32 и FLOAT32 доступны только в стандарте версии 2013 года.

Значения

ASCII | BINARY | BINARY32 | FLOAT32

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

ASCII

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

ft

Вычисляемый

Да

# System frequency, Hz — номинальная частота сети или подсети в Гц, в которой записываются данные

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

50.0

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

lf

Вычисляемый

Да

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

# Trigger threshold — уставка срабатывания триггера

Details

Если значение входа Trigger равно заданному значению или превышает его, начинается запись данных для осциллограммы.

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

0.5

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

external_trigger_threshold

Вычисляемый

Да

Memory

# Enable recording buffer — включить буфер для записи осциллограмм

Details

Если этот флажок установлен, то для записи осциллограмм будет использоваться буфер, размер которого определяется параметром Total recording duration, s. Это позволяет заранее выделить необходимый объем памяти и избежать динамического выделения памяти во время выполнения модели в режиме реального времени.

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

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

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

enable_recording_buffer

Вычисляемый

Да

# Total recording duration, s — суммарная длительность записи, с

Details

Параметр, определяющий суммарный объем буфера для всех записей осциллограмм, произведенных в течение симуляции.

Зависимости

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

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

60.0

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

total_recording_duration

Вычисляемый

Да

Аналоговые

# Channels names ["AName1", "AName2" .. ] — имена каналов

Details

По умолчанию (−1) формируется вектор из имен Analog Signal x, где x — номер канала.

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

-1

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

analogs_ch_id_vector

Вычисляемый

Да

# Channels phase identifiers ["A", "B", "C" .. ] — идентификаторы фазы каналов

Details

По умолчанию (−1) формируется вектор из пустых строк.

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

-1

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

analogs_ph_vector

Вычисляемый

Да

# Channels units ["kV", "V", "kA" .. ] — единицы измерения каналов

Details

По умолчанию (−1) формируется вектор из строк NONE.

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

-1

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

analogs_uu_vector

Вычисляемый

Да

# Channels ratio primary factors [100.0, 200.0 .. ] — первичные номиналы измерительных трансформаторов напряжения или тока

Details

По умолчанию (−1) формируется вектор из единиц.

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

-1

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

analogs_primary_vector

Вычисляемый

Да

# Channels ratio secondary factors [1.0, 5.0 .. ] — вторичные номиналы измерительных трансформаторов напряжения или тока

Details

По умолчанию (−1) формируется вектор из единиц.

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

-1

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

analogs_secondary_vector

Вычисляемый

Да

# Data scaling identifiers ["P", "S" .. ] — идентификатор масштабирования данных

Details

В параметре символ P означает первичное значение, а символ S — вторичное.

По умолчанию (−1) формируется вектор из символов P.

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

-1

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

analogs_PS_vector

Вычисляемый

Да

Дискретные

# Channels names ["DName1", "DName2" .. ] — имена каналов

Details

По умолчанию (−1) формируется вектор из имен Discrete Signal x, где x — номер канала.

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

-1

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

discretes_ch_id_vector

Вычисляемый

Да

# Channels phase identifiers ["A", "B", "C" .. ] — идентификаторы фазы каналов

Details

По умолчанию (−1) формируется вектор из пустых строк.

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

-1

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

discretes_ph_vector

Вычисляемый

Да

# Normal states [1, 0 .. ] — нормальные состояния каналов

Details

По умолчанию (−1) формируется вектор из нулей.

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

-1

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

discretes_y_vector

Вычисляемый

Да

Литература

  1. IEEE Std. C37.111-1999 — IEEE Standard Common Format for Transient Data Exchange (COMTRADE) for Power Systems

  2. IEEE Std. C37.111-2013 — IEEE/IEC International Standard — Measuring relays and protection equipment — Part 24: Common format for transient data exchange (COMTRADE) for power systems