Record

Данные логов к рабочей области, к файлу или обоим

  • Библиотека:
  • Simulink / Приемники

  • Record block

Описание

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

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

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

Создайте визуализацию

Блок Record поддерживает всю визуализацию, доступную в Инспекторе Данных моделирования. То, когда различная визуализация целесообразна для ваших данных, можно изменить размещение графика и построить типы с помощью опции 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- n вектор-строка, где n равно количеству портов
Значение по умолчанию: 0

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

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

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

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

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

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

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

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

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

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

Запись

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

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

Советы

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

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

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

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

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

Зависимости

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

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

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

Регистрируйте, чтобы зарегистрировать опцию. По умолчанию, данные логов блока Record Инспектору Данных моделирования только. Выберите 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, Экспорте и Формате Логгирования.

  • Когда вы данные логов к файлу 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. Выбранные атрибуты сигнала появляются в столбце сигнала выше точки First Data согласно формату, описанному в Импорте Microsoft Excel, Экспорте и Формате Логгирования.

Зависимости

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

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

Типы данных

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

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

no

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

yes

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

no

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

no

Смотрите также

Инструменты

Блоки

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

Введенный в R2021a