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

В COMTRADE

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

Тип: SubSystem

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

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

Описание

Блок В 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

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

Нет

Параметры

Основные

# Включить аналоговый вход — включить вход Analogs аналоговых сигналов

Details

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

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

true (включено)

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

enable_analog_input

Вычисляемый

Да

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

Details

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

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

true (включено)

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

enable_discrete_input

Вычисляемый

Да

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

Details

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

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

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

"untitled"

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

files_path

Вычисляемый

Да

# Период дискретизации, с — период дискретизации, с

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

0.001

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

sample_time

Вычисляемый

Да

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

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

3.0

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

time_zone_offset

Вычисляемый

Да

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

# Название подстанции — имя подстанции

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

"Engee"

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

station_name

Вычисляемый

Да

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

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

"Engee"

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

rec_dev_id

Вычисляемый

Да

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

Details
Значения

1999 | 2013

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

2013

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

rev_year

Вычисляемый

Да

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

Details

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

Значения

ASCII | BINARY | BINARY32 | FLOAT32

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

ASCII

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

ft

Вычисляемый

Да

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

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

50.0

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

lf

Вычисляемый

Да

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

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

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

Вычисляемый

Да

Аналоговые

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

Details

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

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

-1

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

analogs_ch_id_vector

Вычисляемый

Да

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

Details

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

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

-1

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

analogs_ph_vector

Вычисляемый

Да

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

Details

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

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

-1

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

analogs_uu_vector

Вычисляемый

Да

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

Details

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

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

-1

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

analogs_primary_vector

Вычисляемый

Да

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

Details

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

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

-1

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

analogs_secondary_vector

Вычисляемый

Да

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

Details

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

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

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

-1

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

analogs_PS_vector

Вычисляемый

Да

Дискретные

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

Details

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

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

-1

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

discretes_ch_id_vector

Вычисляемый

Да

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

Details

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

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

-1

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

discretes_ph_vector

Вычисляемый

Да

# Нормальные состояния каналов [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