To File

Запишите данные к файлу

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

    HDL Coder / Приемники

Описание

Блок 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 команда. Изменение файла может вызвать ошибку, когда вы возобновляете симуляцию. Если вы хотите изменить файл после приостановки, скопируйте файл и работайте с копией файла.

Если вы приостанавливаете использование Степпера Симуляции, блок 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® путь может начать с тильды (~) символ, показывающий вашу домашнюю папку. Если вы задаете имя файла без информации о пути, программное обеспечение Simulink хранит файл в MATLAB рабочая папка. (Чтобы определить рабочую папку, в командной строке MATLAB, вводят pwd.), Если файл существует, программное обеспечение Simulink перезаписывает его.

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

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

Задайте имя матрицы, содержавшейся в файле.

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

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

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

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

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

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

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

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

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

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

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

    [t1t2tfinalu11u12u1finalun1un2unfinal]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Типы данных

Boolean | bus | double | enumerated | fixed point[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. resaved файл меньше, чем исходный MAT-файл, который создал блок To File, потому что команда Save сжимает данные в MAT-файле.

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

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

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

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