To File

Запись данных в файл

  • Библиотека:
  • Simulink/Раковины

    HDL-кодер/приемники

  • To File block

Описание

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

Значок To File блока показывает имя выходного файла.

Управление объемом сохраненных данных

Если вы задаете интервалы логгирования данных с помощью параметра Configuration Parameters Data Import/Export > Logging intervals > To File блок регистрирует только данные внутри интервалов. Например, блок не регистрирует данные, если интервалы пусты ([]). Блок хранит записанные данные в файле, сопоставленном с блоком, а не в переменной, которую вы задаете для параметра Single simulation output.

Для решателей с переменным шагом, чтобы контролировать объем данных, доступных блоку To File, используйте параметр Configuration Parameters Data Import/Export > Additional parameters > Output options >. Для примера, чтобы записать данные в одинаковое время точек в нескольких симуляциях, выберите Produce specified output only опция.

Параметры блоков также контролируют объем сохраненных данных. См. Десятикратное уменьшение и шаг расчета.

Симуляция паузы

После паузы симуляции не изменяйте файл, в который входит блок To File. Например, не сохранять такой файл с MATLAB® save команда. Изменение файла может вызвать ошибку, когда вы возобновите симуляцию. Если вы хотите изменить файл после паузы, скопируйте файл и работайте с копией файла.

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

Ограничения

Когда блок To File находится в модели-ссылке, эта модель должна быть моделью с одним экземпляром. В иерархии модели может существовать только один образец такой модели. Смотрите Повторное использование модели для получения дополнительной информации.

Порты

Вход

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

Сигнал для хранения в файле. Каждая выборка состоит из временной метки и связанного значения данных. Данные могут быть в формате массива или MATLAB timeseries формат. Блок To File принимает реальные или комплексные данные сигналов любого типа данных, которые Simulink® программное обеспечение поддерживает, кроме данных с фиксированной точкой с размером слова более 32 бит.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | enumerated | bus

Параметры

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

Укажите путь или имя файла MAT-файла, в котором будут храниться выходы. В UNIX® системы, имя может начинаться с символа tilde (~), обозначающего вашу домашнюю папку. Если вы задаете имя файла без информации о пути, программное обеспечение Simulink сохраняет файл в рабочей папке MATLAB. (Для определения рабочей папки в командной строке MATLAB введите pwd.) Если файл существует, программа Simulink перезаписывает его.

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

Параметры блоков: FileName
Тип: Вектор символов
Значения: MAT-файл путь или имя
По умолчанию: 'untitled.mat'

Укажите имя матрицы, содержащейся в файле.

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

Параметры блоков: MatrixName
Тип: Вектор символов
Значения: Вектор символов
По умолчанию: 'ans'

Укажите формат данных, который используется блоком To File для записи данных.

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

Для Timeseries формат, блок To File:

  • Запись данных в timeseries MATLAB объект.

  • Поддерживает запись многомерных, вещественных или комплексных выходных значений.

  • Поддерживает запись выходных значений, которые имеют любой встроенный тип данных, включая Boolean, перечисленный (enum) и данные с фиксированной точкой с размером слова до 32 бит.

  • Для входных сигналов виртуальной и невиртуальной шины создает структуру MATLAB, которая соответствует иерархии шины. Каждый лист структуры является MATLAB timeseries объект.

Для Array формат, блок To File:

  • Запись данных в матрицу, содержащую две или более строк. Матрица имеет следующую форму:

    [t1t2tfinalu11u12u1finalun1un2unfinal]

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

  • Поддерживает запись данных, которые являются одномерными, двойными и некомплексными.

Блок From File может использовать данные, записанные блоком To File в любом формате (Timeseries или Array) без каких-либо изменений данных или других специальных положений.

Блок From Workspace может считать данные, которые находятся в Array формат и является транспонированием данных, записанных блоком To File. Чтобы предоставить необходимый формат, используйте команды MATLAB для загрузки и транспонирования данных из MAT-файла.

Следующая таблица показывает, как поддержка режима симуляции зависит от значения Save format.

Режим симуляцииTimeseriesArray
НормальныйПоддержанныйПоддержанный
АкселераторПоддержанныйПоддержанный
Быстрый AcceleratorПоддержанныйПоддержанный
Программа в цикле (SIL) Не поддерживаетсяПоддерживается, если включено логгирование MAT-файлов
Процессор в цикле (PIL)Не поддерживаетсяПоддерживается, если доступно и включено логгирование MAT-файлов
ВнешнийНе поддерживаетсяПоддерживается, если включено логгирование MAT-файлов
Объект RSimПоддержанныйПоддерживается, если включено логгирование MAT-файлов

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

Параметры блоков: SaveFormat
Тип: Вектор символов
Значения: 'Timeseries' | 'Array'
По умолчанию: 'Timeseries'

Задайте коэффициент десятикратного уменьшения, n, который записывает данные в каждый n момент времени, когда блок выполняется. Значение по умолчанию имеет этот блок записи данных в каждый временной шаг.

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

Параметры блоков: Decimation
Тип: Вектор символов
Значения: скаляр | вектор
По умолчанию: '1'

Задает период дискретизации и смещение, при которых осуществляется сбор точек данных. Этот параметр полезен, когда вы используете решатель с переменным шагом, где интервал между временными шагами не является постоянным. Значение по умолчанию заставляет блок наследовать шаг расчета от ведущего блока. См. «Задание шага расчета».

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

Параметры блоков: SampleTime
Тип: Вектор символов
Значения: скаляр | вектор
По умолчанию: '-1'

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

Типы данных

Boolean | bus | double | enumerated | фиксированную точку[a] | integer | single

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

no

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

yes

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

no

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

no

[a] Поддерживает до 32-битных типов данных с фиксированной точкой.

Совет

  • Если MATLAB сталкивается с проблемами памяти, когда вы записываете много сигналов в долгую симуляцию, которая имеет много временных шагов, рассмотрите логгирование в постоянное хранилище. Когда вы логгируете в постоянное хранилище, Dataset форматные данные логгирования хранятся в MAT-файле. По сравнению с логгированием в постоянном хранилище, подключение блока To File к сигналам:

    • Является подходом по сигналу, который может загромождать модель с несколькими блоками To File, присоединенными к отдельным сигналам.

    • Создает отдельный MAT-файл для каждого блока To File по сравнению с одним MAT-файлом, который используется при регистрации в постоянном хранилище.

    Для получения дополнительной информации смотрите Журнал данных в постоянное хранилище.

  • Чтобы избежать накладных расходов на сжатие данных в режиме реального времени, блок To File записывает несжатый MAT-файл версии 7.3. Чтобы сжать данные в MAT-файле, загрузите и сохраните файл в MATLAB. Восстановленный файл меньше исходного MAT-файла, который создал To File блок, потому что команда Save сжимает данные в MAT-файле.

Расширенные возможности

.

Генерация кода ПЛК
Сгенерируйте структурированный текстовый код с помощью Coder™ Simulink ® PLC

.
Представлено до R2006a