To File

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

Библиотека:
Simulink/Раковины
HDL-кодер/приемники

Описание

Блок 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 находится в модели-ссылке, эта модель должна быть моделью с одним экземпляром. В иерархии модели может существовать только один образец такой модели. Смотрите Повторное использование модели для получения дополнительной информации.

Порты

Вход

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

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

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

Параметры

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

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

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

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

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

Тип: Вектор символов

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

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

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

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

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

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

Тип: Вектор символов

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

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

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

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

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

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

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

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

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

$[\begin{matrix} t_{1} & t_{2} & \dots & t_{f i n a l} \\ u 1_{1} & u 1_{2} & \dots & u 1_{f i n a l} \\ \dots \\ u n_{1} & u n_{2} & \dots & u n_{f i n a l} \end{matrix}]$
Программное обеспечение Simulink записывает один столбец в матрицу для каждой выборки данных. Первый элемент столбца содержит временную метку. Остальная часть столбца содержит данные для соответствующих выходных значений.
Поддерживает запись данных, которые являются одномерными, двойными и некомплексными.

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

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

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

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

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

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

Тип: Вектор символов

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

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

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

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

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

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

Тип: Вектор символов

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

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

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

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

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

Параметры блоков: SampleTime

Тип: Вектор символов

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

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

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

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

Блоки How To Workspace и To File записывают данные в рабочую область и в файл соответственно.

Открыть скрипт

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

Типы данных	`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-файле.

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

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

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

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

Чтобы сгенерировать код для блока To File, на панели Code Generation > Interface, выберите параметр конфигурации MAT-файл регистрации (Simulink Coder).

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

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

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

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

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

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

To File

Описание

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

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

Ограничения

Порты

Вход

`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++ с помощью Coder™ Simulink ®

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

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

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

См. также

Темы

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

Поддержка

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

To File

Описание

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

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

Ограничения

Порты

Вход

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++ с помощью Coder™ Simulink ®

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

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

Преобразование с фиксированной точкой Разрабатывайте и моделируйте системы с фиксированной точкой с помощью Fixed-Point 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++ с помощью Coder™ Simulink ®

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

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

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