Record

Журнал данных в рабочей области, в файл или и то, и другое одновременно

развернуть все на странице
  • Библиотека:

  • Simulink/Раковины

  • Record block

Описание

Можно использовать блок Record для записи данных в рабочую область, в файл или в рабочую область и в файл. При регистрации данных в файле можно выбрать вход в файл MAT, файл MLDATX или Excel® файл. Сигналы, подключенные к блоку Record, всегда регистрируются в Данные моделирования Inspector. Если вы решили, что вам нужно сохранить данные после симуляции, можно экспортировать данные из блока Record в рабочую область или в любой поддерживаемый тип файла.

Можно также использовать блок Record для визуализации связанных сигналов. Чтобы просмотреть данные для сигналов, подключенных к блоку Record, дважды кликните блок. У вас есть доступ к элементам управления симуляцией, таким как кнопка Run, во время просмотра данных в блоке Record.

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

Визуализация сборки

Блок Record поддерживает все визуализации, доступные в Данные моделирования Inspector. Когда для данных имеет смысл другая визуализация, можно изменить размещение графика и типы графика с помощью опции Layouts и селектора типов графиков, помеченных Sparklines по умолчанию. Используйте список Layouts, чтобы выбрать размещение подграфиков. Чтобы изменить тип графика подграфика, выберите подграфик, а затем выберите требуемый тип графика из селектора типов графика.

Для получения дополнительной информации смотрите Журнал данных в рабочей области и Файл с использованием блока записи. Для примеров, которые показывают, как использовать каждый тип визуализации, смотрите:

Порты

Вход

расширить все

Сигнал к записи. Можно добавить порты к блоку Record путем перетаскивания линий к ребру блока или с помощью параметра Ports.

Блок Record поддерживает регистрацию сигналов переменного размера, но не поддерживает визуализацию сигналов переменного размера.

Совет

Чтобы записать данные на основе фрейма, задайте параметр Input Processing для каждого порта, который получает сигнал на основе фрейма.

Типы данных: single | double | half | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | enumerated | bus
Поддержка комплексного числа: Да

Параметры

расширить все

Для изменения параметров Record блоков используйте Property Inspector.

Главный

Количество входа портов, заданное в виде целого числа между 1 и 100, включительно.

Программное использование

Параметры блоков: 'NumPorts'
Тип: integer | character vector
Значения: целое число в области значений [1, 100]
По умолчанию: 1

Используйте параметры Port и Input Processing вместе, чтобы задать режим обработки входа для порта. Режим обработки входов определяет, как блок Record интерпретирует матричные данные:

  • Основанная на выборке - Каждый элемент матрицы является отдельным каналом.

  • Основанный на кадрах - Каждый столбец в матрице является отдельным каналом.

По умолчанию каждый порт обрабатывает входной сигнал как основанный на дискретизации.

Для изменения режима обработки входов для порта:

  1. Выберите номер порта с помощью параметра Port.

  2. Выберите режим обработки входа с помощью параметра Input Processing.

Программное использование

Программно задайте режим входной обработки для каждого порта путем определения FrameSettings параметр как вектор-строка с таким количеством элементов, как блок порты. Индекс элемента соответствует номеру порта в блоке. Задайте 1 использовать основанную на кадрах входную обработку для порта и 0 использовать обработку на основе выборки.

Параметры блоков: 'FrameSettings'
Тип: логический массив
Значения: 1-by- n вектор-строка, где n равно количеству портов
По умолчанию: 0

Используйте параметры Port и Input Processing вместе, чтобы задать режим обработки входа для порта. Режим обработки входов определяет, как блок Record интерпретирует матричные данные:

  • Основанная на выборке - Каждый элемент матрицы является отдельным каналом.

  • Основанный на кадрах - Каждый столбец в матрице является отдельным каналом.

По умолчанию каждый порт обрабатывает входной сигнал как основанный на дискретизации.

Для изменения режима обработки входов для порта:

  1. Выберите номер порта с помощью параметра Port.

  2. Выберите режим обработки входа с помощью параметра Input Processing.

Программное использование

Программно задайте режим входной обработки для каждого порта путем определения FrameSettings параметр как вектор-строка с таким количеством элементов, как блок порты. Индекс элемента соответствует номеру порта в блоке. Задайте 1 использовать основанную на кадрах входную обработку для порта и 0 использовать обработку на основе выборки.

Параметры блоков: 'FrameSettings'
Тип: логический массив
Значения: 1-by- n вектор-строка, где n равно количеству портов
По умолчанию: 0

Запись

Опция логгирования рабочей области. По умолчанию Record блок журналов данные только в Данные моделирования Inspector. Выберите Record to Workspace, чтобы записать данные для сигналов, подключенных к блоку Record к MATLAB® рабочая область в Simulink.SimulationData.Dataset объект.

Используйте параметр Workspace Variable Name, чтобы задать имя Dataset объект, который содержит записанные в журнал Record блочные данные.

Совет

  • Когда вы записываете данные в рабочую область, способ доступа к данным зависит от строения модели. По умолчанию модели предоставляют все записанные данные в одной выходной переменной как Simulink.SimulationOutput объект. Вы можете получить доступ к данным блоков Record с помощью get функцию или точку с именем переменной рабочей области блока Record. Когда опция Single simulation output отключена, данные регистрации появляются в отдельных переменных в рабочей области, и вы получаете прямой доступ к данным блока Record.

  • Можно использовать один блок Record для регистрации данных в Данные моделирования Inspector, в рабочей области и в файле.

Программное использование

Параметры блоков: 'RecordToWorkspace'
Тип: вектор символов | логический | числовой
Значения: 'on' | 'off' | true или 1 | false или 0
По умолчанию: 'off'

Имя переменной рабочей области, содержащей записанные в журнал блочные данные.

Зависимости

Чтобы включить этот параметр, выберите параметр Record to Workspace.

Программное использование

Параметры блоков: 'VariableName'
Тип: вектор символов | строка
По умолчанию: 'recordout'

Журнал в файл опции. По умолчанию Record блок журналов данные только в Данные моделирования Inspector. Выберите Record to File, чтобы записать данные для сигналов, подключенных к блоку Record в файл.

Совет

  • Используйте параметр File Name, чтобы задать имя для файла.

  • Используйте параметр File Type, чтобы указать, нужно ли регистрировать данные в файле MLDATX, файле MAT или файле Excel.

  • Используйте параметр File Location, чтобы задать путь к файлу.

Программное использование

Параметры блоков: 'RecordToFile'
Тип: вектор символов | логический | числовой
Значения: 'on' | 'off' | true или 1 | false или 0
По умолчанию: 'off'

Имя файла, содержащего записанные в записанные данные. Имя не должно включать расширение файла. Если вы действительно включите расширение файла в имя, убедитесь, что имя использует допустимое расширение для указанного File Type.

Совет

  • Если вы не меняете имя или местоположение файла, на который вы логгируете, от одного запуска до следующего, Record блок перезаписывает предыдущие данные в файле.

  • Когда вы хотите сохранить файл в расположении, отличном от вашей рабочей директории, используйте параметр File Location, чтобы задать путь к директории, где вы хотите сохранить файл.

Зависимости

Чтобы включить этот параметр, выберите параметр Record to File.

Программное использование

Используйте FileName параметр для задания параметров File Name, File Type и File Location. Включите расширение для желаемого типа файла в имя, которое вы передаете set_param. Когда вы хотите сохранить файл где-то кроме текущей рабочей директории, укажите путь с именем файла и расширением.

Параметры блоков: 'FileName'
Тип: вектор символов | строка
По умолчанию: 'recording.mldatx'

Используйте параметр File Type, чтобы указать, хотите ли вы записывать данные в файл MLDATX, файл MAT или файл Excel.

Совет

  • При регистрации данных в файле Excel данные форматируются так, как описано в Microsoft Excel Import, Export и Logging Format.

  • Когда вы записываете данные в файл Excel, можно задать, делиться ли временными столбцами с помощью параметра Time и какие атрибуты сигнала записывать с помощью параметра Attributes.

Зависимости

Чтобы включить этот параметр, выберите Record to File.

Программное использование

Используйте FileName параметр для задания параметров File Name, File Type и File Location. Включите расширение для желаемого типа файла в имя, которое вы передаете set_param. Когда вы хотите сохранить файл где-то кроме текущей рабочей директории, укажите путь с именем файла и расширением.

Параметры блоков: 'FileName'
Тип: вектор символов | строка
По умолчанию: 'recording.mldatx'

Используйте параметр File Location, чтобы указать место, где вы хотите сохранить файл с записанными данными, когда вы хотите сохранить файл где-то кроме рабочей директории. Убедитесь, что у вас есть разрешения на запись в указанной директории.

Зависимости

Чтобы включить этот параметр, выберите Record to File.

Программное использование

Используйте FileName параметр для задания параметров File Name, File Type и File Location. Включите расширение для желаемого типа файла в имя, которое вы передаете set_param. Когда вы хотите сохранить файл где-то кроме текущей рабочей директории, укажите путь с именем файла и расширением.

Параметры блоков: 'FileName'
Тип: вектор символов | строка
По умолчанию: 'recording.mldatx'

Используйте параметр Time, чтобы задать, как записывать данные времени сигнала при регистрации данных блока Record в файл Excel.

  • Shared Time Columns - Когда временные данные идентичны для нескольких сигналов, сигналы совместно используют один временной столбец в файле регистрации. Файл регистрации может все еще включать в себя несколько временных столбцов, если блок Record регистрирует данные для сигналов с уникальными временными данными.

  • Individual Time Columns - Каждый зарегистрированный сигнал всегда имеет свой собственный временной столбец в файле регистрации.

Зависимости

Чтобы включить этот параметр, выберите Record to File и задайте File Type следующим *.xlsx.

Выберите одни или несколько опций атрибута сигнала для включения в файл журнала при регистрации данных в файле Excel. Выбранные атрибуты сигнала появляются в столбце сигнала над первой точкой данных в соответствии с форматом, описанным в Microsoft Excel Import, Export и Logging Format.

Зависимости

Чтобы включить этот параметр, выберите Record to File и задайте File Type следующим *.xlsx.

Примеры моделей

Log Data to the Workspace and a File Using the Record Block

Журнал данных в рабочей области и файл с использованием блока записи

Используйте блок Record для регистрации данных в рабочей области, в файле или в рабочей области и в файле.

Характеристики блоков

Типы данных

Boolean | bus | double | enumerated | fixed point | half | integer | single | string

Прямое сквозное соединение

no

Многомерные сигналы

yes

Сигналы переменного размера

no

Обнаружение пересечения нулем

no

См. также

Инструменты

Блоки

Параметры конфигурации Simulink

Введенный в R2021a

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

Поддержка

Для просмотра документации необходимо авторизоваться на сайте