Из файла

Загрузите данные из MAT-файла

Библиотека:
Simulink / Источники

Описание

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

Значок блока From File показывает имя MAT-файла, который снабжает данными к блоку.

У вас могут быть несколько От блоков Файла, которые загружают из того же MAT-файла.

Поддерживаемыми версиями MAT-файла является Версия 7.0 или ранее и Версия 7.3. Блок From File инкрементно загружает данные из файлов Версии 7.3.

Можно задать, как данные загружаются, включая:

'SampleTime'
Как обработать данные для пропавших без вести точек данных
Использовать ли обнаружение пересечения нулем

Для получения дополнительной информации смотрите, что Данные о Загрузке Используют От Блока Файла.

Порты

Вывод

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

`Port_1` — Данные о файле
скаляр | вектор | матрица | массив N-D

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

Параметры

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

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

Путь или имя файла MAT-файла, который содержит входные данные. Задайте путь или имя файла одним из этих способов:

Просмотрите к папке, которая содержит допустимый MAT-файл.
В системах UNIX^® путь может запустить с тильды (~) символ, что означает вашу домашнюю папку.
Введите путь для файла в текстовом поле.

Именем файла по умолчанию является untitled.mat. Если вы задаете имя файла без информации о пути, Simulink^® загружает файл в текущей папке или на пути MATLAB. (Чтобы определить текущую папку, в подсказке команды MATLAB вводят pwd.)

После того, как вы зададите File name, можно использовать кнопку представления (), чтобы предварительно просмотреть сигнал из MAT-файла. Для получения дополнительной информации смотрите Данные сигнала Предварительного просмотра.

Зависимости

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

Чтобы сгенерировать код, который создает ERT или цели GRT или использует SIL или режимы PIL симуляции, MAT-файл должен содержать непустую, конечную, действительную матрицу по крайней мере с двумя строками.

Для получения дополнительной информации о генерации кода C/C++ с блоком From File смотрите Генерацию кода.

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

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

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

Значения: имя MAT-файла

Значение по умолчанию: 'untitled.mat'

`Output data type` — Тип выходных данных
`Inherit: auto` (значение по умолчанию) | `double` | `single` | `int8` | `uint8` | `int16` | `uint16` | `int32` | `uint32` | `int64` | `uint64` | `boolean` | `fixdt(1,16,0)` | `fixdt(1,16,2^0,0)` | `Enum: <class_name>` | `Bus: <bus_object>` | `<data type expression>`

Тип данных для данных, что блок From File выходные параметры. Для типов нешины можно использовать Inherit: auto, чтобы пропустить любую верификацию типа данных. Если вы задаете тип выходных данных, то блок From File проверяет, что данные в файле совпадают с заданным типом данных. Для получения дополнительной информации смотрите Типы данных Управляющего сигнала.

Если вы устанавливаете Output data type как объект шины, объект шины должен быть доступным, когда вы компилируете модель. Для каждого сигнала в данных о шине блок From File проверяет, что тип данных, размерности и сложность являются тем же самым для данных и для объекта шины.

Нажмите кнопку Show data type assistant, чтобы отобразить Data Type Assistant, который помогает вам установить атрибуты типа данных. Для получения дополнительной информации смотрите, Задают Типы данных Используя Ассистент Типа данных.

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

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

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

Значения:

'Inherit: auto' | 'double' | 'single' | 'int8' | 'uint8' | 'int16' | 'uint16' | 'int32' | 'uint32' | 'int64' | 'uint64' | 'boolean' | 'fixdt(1,16,0)' | 'fixdt(1,16,2^0,0)' | 'Enum: <class name>' | 'Bus: <object name>' | '<data type expression>'

Значение по умолчанию: 'Inherit: auto'

`'SampleTime'` Выборка периода и смещения
`0` | скаляр | вектор

Задайте демонстрационный период и сместите.

Блок From File загружает данные из MAT-файла, с помощью шага расчета что также:

Вы задаете для блока From File.
Блок From File наследовался блокам, в которые блок From File подает данные.

Шагом расчета по умолчанию является 0, который задает время непрерывной выборки. MAT-файл загружается на основном (самом быстром) уровне модели. Для получения дополнительной информации см. Настройку времени выборки.

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

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

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

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

Значение по умолчанию: '0'

`Data extrapolation before first data point` — Метод экстраполяции для времен симуляции перед начальной меткой времени в MAT-файле
`Linear extrapolation` (значение по умолчанию) | `Hold first value` | `Ground value`

Метод экстраполяции для времени симуляции совершил нападки, который происходит перед начальной меткой времени в MAT-файле. Выберите один из следующих методов экстраполяции.

Метод Описание

Метод	Описание
`Linear extrapolation`	(Значение по умолчанию) Если MAT-файл содержит только одну выборку, то блок From File выводит соответствующее значение данных. Если MAT-файл содержит больше чем одну выборку, то блок From File линейно экстраполирует использование первых двух выборок: Для данных `double`, линейно экстраполирует значение с помощью первых двух выборок Для данных `Boolean`, выводит значение First Data Для встроенного типа данных кроме `double` или `Boolean`, блока From File: Upcasts данные к `double` Выполняет линейную экстраполяцию (как описано для данных `double`) Downcasts экстраполируемое значение данных к исходному типу данных Вы не можете использовать опцию `Linear extrapolation` с перечислимым (`enum`) данные. Все сигналы в шине используют ту же установку экстраполяции. Если какой-либо сигнал в шине использует данные `enum`, то вы не можете использовать опцию `Linear extrapolation`.
`Hold first value`	Использует значение First Data в файле
`Ground value`	Использует значение, которое зависит от типа данных значений выборочных данных MAT-файла: Типы данных с фиксированной точкой — Использование наземное значение Числовые типы кроме фиксированной точки — Использование `0` `Boolean` — Использование `false` Перечислимые типы данных — значение по умолчанию Использования

Linear extrapolation

(Значение по умолчанию)

Если MAT-файл содержит только одну выборку, то блок From File выводит соответствующее значение данных.

Если MAT-файл содержит больше чем одну выборку, то блок From File линейно экстраполирует использование первых двух выборок:

Для данных double, линейно экстраполирует значение с помощью первых двух выборок
Для данных Boolean, выводит значение First Data
Для встроенного типа данных кроме double или Boolean, блока From File:
- Upcasts данные к double
- Выполняет линейную экстраполяцию (как описано для данных double)
- Downcasts экстраполируемое значение данных к исходному типу данных

Вы не можете использовать опцию Linear extrapolation с перечислимым (enum) данные. Все сигналы в шине используют ту же установку экстраполяции. Если какой-либо сигнал в шине использует данные enum, то вы не можете использовать опцию Linear extrapolation.

Hold first value

Использует значение First Data в файле

Ground value

Использует значение, которое зависит от типа данных значений выборочных данных MAT-файла:

Типы данных с фиксированной точкой — Использование наземное значение
Числовые типы кроме фиксированной точки — Использование 0
Boolean — Использование false
Перечислимые типы данных — значение по умолчанию Использования

Зависимости

Чтобы сгенерировать код, который создает ERT или цели GRT или использует SIL или режимы PIL симуляции, необходимо установить этот параметр на Linear extrapolation. Для получения дополнительной информации о генерации кода C/C++ с блоком From File смотрите Генерацию кода.

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

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

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

Значения: 'Linear extrapolation' | 'Hold first value' | 'Ground value'

Значение по умолчанию: 'Linear extrapolation'

`Data interpolation within time range` — Метод интерполяции для времен симуляции, которые падают между двумя метками времени в MAT-файле
`Linear interpolation` (значение по умолчанию) | `Zero order hold`

Метод интерполяции, который Simulink использует для хита времени симуляции между двумя метками времени в MAT-файле. Выберите один из этих методов интерполяции.

Метод Описание

Метод	Описание
`Linear interpolation`	(Значение по умолчанию) Блок From File интерполирует использование двух соответствующих выборок MAT-файла: Для данных `double`, линейно интерполирует значение с помощью двух соответствующих выборок Для данных `Boolean`, `false` использования для первой половины выборки и `true` для второй половины. Для встроенного типа данных кроме `double` или `Boolean`, блока From File: Upcasts данные к `double` Выполняет линейную интерполяцию, как описано для данных `double` Downcasts интерполированное значение к исходному типу данных
`Zero order hold`	Использует данные из первой из этих двух выборок

Linear interpolation

(Значение по умолчанию)

Блок From File интерполирует использование двух соответствующих выборок MAT-файла:

Для данных double, линейно интерполирует значение с помощью двух соответствующих выборок
Для данных Boolean, false использования для первой половины выборки и true для второй половины.
Для встроенного типа данных кроме double или Boolean, блока From File:
- Upcasts данные к double
- Выполняет линейную интерполяцию, как описано для данных double
- Downcasts интерполированное значение к исходному типу данных

Zero order hold

Использует данные из первой из этих двух выборок

Ограничения

Вы не можете использовать опцию Linear interpolation с перечислимым (enum) данные. Все сигналы в шине используют ту же установку интерполяции. Если какой-либо сигнал в шине использует данные enum, то вы не можете использовать опцию Linear interpolation.

Зависимости

Чтобы сгенерировать код, который создает ERT или цели GRT или использует SIL или режимы PIL симуляции, необходимо установить этот параметр на Linear interpolation. Для получения дополнительной информации о генерации кода C/C++ с блоком From File смотрите Генерацию кода.

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

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

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

Значения: 'Linear interpolation' | 'Zero order hold'

Значение по умолчанию: 'Linear interpolation'

`Data extrapolation after last data point` — Метод экстраполяции для времен симуляции после последней метки времени в MAT-файле
`Linear extrapolation` (значение по умолчанию) | `Hold last value` | `Ground value`

Метод экстраполяции для времени симуляции совершил нападки, который происходит после последней метки времени в MAT-файле. Выберите один из этих методов экстраполяции.

Метод Описание

Метод	Описание
`Linear extrapolation`	(Значение по умолчанию) Если MAT-файл содержит только одну выборку, то блок From File выводит соответствующее значение данных. Если MAT-файл содержит больше чем одну выборку, то блок From File линейно экстраполирует значения данных использования последних двух выборок: Для данных `double`, экстраполирует значение с помощью последних двух выборок. Для данных `Boolean`, выводит значение First Data. Для встроенных типов данных кроме двойного или `Boolean`: Upcasts данные к `double` Выполняет линейную экстраполяцию, как описано для данных `double` Downcasts экстраполируемое значение к исходному типу данных
`Hold last value`	Использует последнее значение данных в файле
`Ground value`	Использует значение, которое зависит от типа данных значений выборочных данных MAT-файла: Типы данных с фиксированной точкой — Использование наземное значение Числовые типы кроме фиксированной точки — Использование `0` `Boolean` — Использование `false` Перечислимые типы данных — значение по умолчанию Использования

Linear extrapolation

(Значение по умолчанию)

Если MAT-файл содержит только одну выборку, то блок From File выводит соответствующее значение данных.

Если MAT-файл содержит больше чем одну выборку, то блок From File линейно экстраполирует значения данных использования последних двух выборок:

Для данных double, экстраполирует значение с помощью последних двух выборок.
Для данных Boolean, выводит значение First Data.
Для встроенных типов данных кроме двойного или Boolean:
- Upcasts данные к double
- Выполняет линейную экстраполяцию, как описано для данных double
- Downcasts экстраполируемое значение к исходному типу данных

Hold last value

Использует последнее значение данных в файле

Ground value

Использует значение, которое зависит от типа данных значений выборочных данных MAT-файла:

Типы данных с фиксированной точкой — Использование наземное значение
Числовые типы кроме фиксированной точки — Использование 0
Boolean — Использование false
Перечислимые типы данных — значение по умолчанию Использования

Ограничения

Зависимости

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

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

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

Значения: 'Linear extrapolation' | 'Hold last value' | 'Ground value'

Значение по умолчанию: 'Linear extrapolation'

`Enable zero-crossing detection` — Включите обнаружение пересечения нулем
`off` (значение по умолчанию) | `on`

Включает обнаружение пересечения нулем.

Параметр Обнаружения Пересечения нулем применяется, только если параметр Sample time устанавливается на (непрерывный) 0.

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

Для блока From File обнаружение пересечения нулем происходит только в метках времени в файле. Simulink исследует только метки времени, не значения данных.

Для сигналов шины Simulink обнаруживает нулевые пересечения через все листовые элементы шины.

Если входной массив содержит дублирующиеся метки времени (больше чем одна запись с той же меткой времени), Simulink обнаруживает нуль, пересекающийся в тех метках времени. Например, предположите, что входной массив имеет эти данные.

time:     0 1 2 2 3
signal:   2 3 4 5 6

Во время 2, существует нуль, пересекающийся от разрыва входного сигнала.

Для недублирующихся меток времени обнаружение пересечения нулем зависит от настроек этих параметров:

Data extrapolation before first data point
Data interpolation within time range
Data extrapolation after last data point

Определение блока From File того, когда пересечение нулем происходит, зависит от метки времени.

Метка времени	Установка
Сначала	Data extrapolation before first data point установлен в `Ground value`.
Между в общем и целом	Data interpolation within time range установлен в `Zero-order hold`.
В последний раз	Один или обе из этих настроек применяйтесь: Data extrapolation after last data point установлен в `Ground value`. Data interpolation within time range установлен в `Zero-order hold`.

Эта фигура иллюстрирует обнаружение пересечения нулем для данных, к которым получает доступ блок From File, который имеет эти настройки:

Data extrapolation before first data point — Linear extrapolation
Data interpolation within time range (для внутренних точек) — Zero order hold
Data extrapolation after last data point — Linear extrapolation

Эта фигура является другим рисунком обнаружения пересечения нулем для данных, к которым получает доступ блок From File. Блок имеет следующие настройки для меток времени (точки):

Data extrapolation before first data point — Hold first value
Data interpolation within time range — Zero order hold
Data extrapolation after last data point — Hold last value

Зависимости

Чтобы сгенерировать код, который создает ERT или цели GRT или использует SIL или режимы PIL симуляции, снимите этот флажок. Для получения дополнительной информации о генерации кода C/C++ с блоком From File смотрите Генерацию кода.

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

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

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

Значения: 'off' | 'on'

Значение по умолчанию: 'on'

Образцовые примеры

От данных о timeseries блочной загрузки файла

Создайте объект MATLAB timeseries со временем и значениями сигналов.

Скрипт Open Live Script

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

Типы данных	`Boolean` \| `bus` \| `double` \| `enumerated` \| `^{fixed point[a]}`\| `integer` \| `single`
Прямое сквозное соединение	`no`
Многомерные сигналы	`yes`
Сигналы переменного размера	`no`
Обнаружение пересечения нулем	`yes`
^[a] Поддержки до 32-битных типов данных с фиксированной точкой.

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

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

Не рекомендуемый для производственного кода.
Генерация кода для цели RSim оказывает идентичную поддержку как Simulink; все другие цели генерации кода поддерживают только двойные, одномерные, действительные сигналы в массиве с форматом времени.
Для блока From File, генерируя код, который создает ERT или цели GRT или использует SIL или режимы PIL симуляции, требует что:
- MAT-файл содержит непустую, конечную, действительную матрицу по крайней мере с двумя строками.
  - Используйте тип данных double для матрицы.
  - Не включайте NaN, Inf или-Inf элементы в матрице.
- В От диалогового окна параметров блоков Файла:
  - Установите Data extrapolation before first data point и параметры Data extrapolation after last data point к Linear extrapolation.
  - Установите параметр Data interpolation within time range на Linear interpolation.
  - Очистите параметр Enable zero-crossing detection.

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

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

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

Из файла

Описание

Порты

Вывод

`Port_1` — Данные о файле
скаляр | вектор | матрица | массив N-D

Параметры

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

Зависимости

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

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

`'SampleTime'` Выборка периода и смещения
`0` | скаляр | вектор

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

Зависимости

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

Ограничения

Зависимости

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

`Data extrapolation after last data point` — Метод экстраполяции для времен симуляции после последней метки времени в MAT-файле
`Linear extrapolation` (значение по умолчанию) | `Hold last value` | `Ground value`

Ограничения

Зависимости

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

`Enable zero-crossing detection` — Включите обнаружение пересечения нулем
`off` (значение по умолчанию) | `on`

Зависимости

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

Образцовые примеры

От данных о timeseries блочной загрузки файла

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

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

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

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

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

Темы

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

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

Поддержка

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

Из файла

Описание

Порты

Вывод

Port_1 — Данные о файле скаляр | вектор | матрица | массив N-D

Параметры

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

Зависимости

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

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

'SampleTime' Выборка периода и смещения 0 | скаляр | вектор

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

Data extrapolation before first data point — Метод экстраполяции для времен симуляции перед начальной меткой времени в MAT-файле Linear extrapolation (значение по умолчанию) | Hold first value | Ground value

Зависимости

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

Data interpolation within time range — Метод интерполяции для времен симуляции, которые падают между двумя метками времени в MAT-файле Linear interpolation (значение по умолчанию) | Zero order hold

Ограничения

Зависимости

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

Data extrapolation after last data point — Метод экстраполяции для времен симуляции после последней метки времени в MAT-файле Linear extrapolation (значение по умолчанию) | Hold last value | Ground value

Ограничения

Зависимости

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

Enable zero-crossing detection — Включите обнаружение пересечения нулем off (значение по умолчанию) | on

Зависимости

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

Образцовые примеры

От данных о timeseries блочной загрузки файла

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

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

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

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

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

Темы

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

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

Поддержка

`Port_1` — Данные о файле
скаляр | вектор | матрица | массив N-D

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

`'SampleTime'` Выборка периода и смещения
`0` | скаляр | вектор

`Enable zero-crossing detection` — Включите обнаружение пересечения нулем
`off` (значение по умолчанию) | `on`

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

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