К файлу

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

Библиотека:
Симулинк/раковины
Кодер/приемники HDL

Описание

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

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

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

При указании интервалов регистрации данных с помощью параметра «Параметры конфигурации» > «Импорт/экспорт данных» > «Интервалы регистрации» блок «В файл» регистрирует только данные внутри интервалов. Например, блок не регистрирует данные, если интервалы пусты ([]). Блок сохраняет записанные данные в файле, связанном с блоком, а не в переменной, указанной для параметра Single simulation output.

Для решателей с переменными шагами для управления объемом данных, доступных блоку «В файл», используйте параметр «Параметры конфигурации» > «Импорт/экспорт данных» > «Дополнительные параметры» > «Параметры вывода». Например, чтобы записать данные в идентичные моменты времени по нескольким моделированиям, выберите Produce specified output only вариант.

Параметры блока также управляют объемом сохраненных данных. См. раздел Прореживание и время выборки.

Приостановка моделирования

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

При приостановке с помощью степпера моделирования блок «В файл» фиксирует данные моделирования до точки паузы. При выполнении шага назад файл данных «В файл» больше не содержит данных моделирования за новое сокращенное время последнего вывода.

Ограничения

Если блок «В файл» находится в ссылочной модели, эта модель должна быть моделью с одним экземпляром. В иерархии модели может существовать только один экземпляр такой модели. Дополнительные сведения см. в разделе Повторное использование модели.

Порты

Вход

развернуть все

`Port_1` - Входной сигнал
скаляр | вектор | матрица | массив N-D

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

Параметры

развернуть все

`File name` - Путь или имя файла
`untitled.mat` (по умолчанию) | Путь или имя файла MAT

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

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

Параметр блока: FileName

Текст: символьный вектор

Значения: Путь или имя файла MAT

По умолчанию: 'untitled.mat'

`Variable name` - Наименование матрицы
`ans` (по умолчанию) | символьный вектор

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

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

Параметр блока: MatrixName

Текст: символьный вектор

Значения: символьный вектор

По умолчанию: 'ans'

`Save format` - Формат данных
`Timeseries` (по умолчанию) | `Array`

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

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

Для Timeseries формат, блок «В файл»:

Запись данных в MATLAB timeseries объект.
Поддерживает запись многомерных, вещественных или комплексных выходных значений.
Поддерживает запись выходных значений, имеющих любой встроенный тип данных, включая Boolean, перечислено (enum) и данные с фиксированной точкой с длиной слова до 32 бит.
Для входных сигналов виртуальной и невиртуальной шины создает структуру MATLAB, соответствующую иерархии шины. Каждый лист структуры представляет собой MATLAB timeseries объект.

Для Array формат, блок «В файл»:

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

$[\begin{matrix} _{} & _{t1t2} & . & ._{.} \\ _{} & _{} & {tfinalu11u12}_{. . .} \\ _{} & {u1final}_{.} & . & ._{} \end{matrix} un1un2$ ... uninal]
Программное обеспечение Simulink записывает один столбец в матрицу для каждого образца данных. Первый элемент столбца содержит отметку времени. Остальная часть столбца содержит данные для соответствующих выходных значений.
Поддерживает запись одномерных, двойных и несложных данных.

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

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

В следующей таблице показано, как поддержка режима моделирования зависит от значения «Сохранить формат».

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

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

Параметр блока: SaveFormat

Текст: символьный вектор

Значения: 'Timeseries' | 'Array'

По умолчанию: 'Timeseries'

`Decimation` - коэффициент прореживания, определяющий время записи данных;
1 (по умолчанию) | скаляр | вектор

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

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

Параметр блока: Decimation

Текст: символьный вектор

Значения: скаляр | вектор

По умолчанию: '1'

`Sample time` - Период выборки и смещение
-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-файл для каждого блока «В файл» по сравнению с одним MAT-файлом, который используется при регистрации в постоянном хранилище.
Дополнительные сведения см. в разделе Запись данных в постоянное хранилище.
Чтобы избежать накладных расходов при сжатии данных в реальном времени, блок To File записывает несжатый MAT-файл версии 7.3. Чтобы сжать данные в MAT-файле, загрузите и сохраните файл в MATLAB. Повторно сохраненный файл меньше исходного MAT-файла, созданного блоком «В файл», поскольку команда «Сохранить» сжимает данные в MAT-файле.

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

Создание кода C/C + +
Создайте код C и C++ с помощью Simulink ® Coder™

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

Генерация кода для цели RSim обеспечивает такую же поддержку, как Simulink; все остальные цели генерации кода поддерживают только двойные одномерные реальные сигналы в массиве с форматом времени.

Чтобы создать код для блока «В файл», на панели «Создание кода» > «Интерфейс» выберите параметр конфигурации «Ведение журнала файлов MAT» (Simulink Coder).

Создание кода HDL
Создание кода Verilog и VHDL для проектов FPGA и ASIC с использованием Coder™ HDL.

Этот блок может использоваться для записи результатов моделирования в файл при использовании с подсистемами, генерирующими код HDL, но не включенными в аппаратную реализацию

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

Преобразование с фиксированной точкой
Проектирование и моделирование систем с фиксированной точкой с помощью Designer™ с фиксированной точкой.

Поддерживает до 32-разрядных типов данных с фиксированной точкой.

См. также

Из файла | Из рабочей области | Отчет | К рабочему пространству

Темы

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

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

К файлу

Описание

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

Приостановка моделирования

Ограничения

Порты

Вход

`Port_1` - Входной сигнал
скаляр | вектор | матрица | массив N-D

Параметры

`File name` - Путь или имя файла
`untitled.mat` (по умолчанию) | Путь или имя файла MAT

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

`Variable name` - Наименование матрицы
`ans` (по умолчанию) | символьный вектор

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

`Save format` - Формат данных
`Timeseries` (по умолчанию) | `Array`

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

`Decimation` - коэффициент прореживания, определяющий время записи данных;
1 (по умолчанию) | скаляр | вектор

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

`Sample time` - Период выборки и смещение
-1 (по умолчанию) | скаляр | вектор

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

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

Выходные данные моделирования с блоками

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

Совет

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

Создание кода C/C + +
Создайте код C и C++ с помощью Simulink ® Coder™

Создание кода HDL
Создание кода Verilog и VHDL для проектов FPGA и ASIC с использованием Coder™ HDL.

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

Преобразование с фиксированной точкой
Проектирование и моделирование систем с фиксированной точкой с помощью Designer™ с фиксированной точкой.

См. также

Темы

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

Поддержка

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

К файлу

Описание

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

Приостановка моделирования

Ограничения

Порты

Вход

Port_1 - Входной сигнал скаляр | вектор | матрица | массив N-D

Параметры

File name - Путь или имя файла untitled.mat (по умолчанию) | Путь или имя файла MAT

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

Variable name - Наименование матрицы ans (по умолчанию) | символьный вектор

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

Save format - Формат данных Timeseries (по умолчанию) | Array

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

Decimation - коэффициент прореживания, определяющий время записи данных; 1 (по умолчанию) | скаляр | вектор

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

Sample time - Период выборки и смещение -1 (по умолчанию) | скаляр | вектор

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

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

Выходные данные моделирования с блоками

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

Совет

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

Создание кода C/C + + Создайте код C и C++ с помощью Simulink ® Coder™

Создание кода HDL Создание кода Verilog и VHDL для проектов FPGA и ASIC с использованием Coder™ HDL.

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

Преобразование с фиксированной точкой Проектирование и моделирование систем с фиксированной точкой с помощью Designer™ с фиксированной точкой.

См. также

Темы

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

Поддержка

`Port_1` - Входной сигнал
скаляр | вектор | матрица | массив N-D

`File name` - Путь или имя файла
`untitled.mat` (по умолчанию) | Путь или имя файла MAT

`Variable name` - Наименование матрицы
`ans` (по умолчанию) | символьный вектор

`Save format` - Формат данных
`Timeseries` (по умолчанию) | `Array`

`Decimation` - коэффициент прореживания, определяющий время записи данных;
1 (по умолчанию) | скаляр | вектор

`Sample time` - Период выборки и смещение
-1 (по умолчанию) | скаляр | вектор

Создание кода C/C + +
Создайте код C и C++ с помощью Simulink ® Coder™

Создание кода HDL
Создание кода Verilog и VHDL для проектов FPGA и ASIC с использованием Coder™ HDL.

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

Преобразование с фиксированной точкой
Проектирование и моделирование систем с фиксированной точкой с помощью Designer™ с фиксированной точкой.