From File

Загрузите данные из файла MAT в модель Simulink

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

  • From File block

Описание

Блок From File считывает данные в Simulink® модель из файла MAT и обеспечивает данные как сигнал или шину в блоке выход. Можно загрузить данные из файла MAT, который включен или от MATLAB® path. Модель может содержать несколько блоков From File, которые загружают данные из того же файла MAT.

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

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

Данные о файле MAT

Блок From File может загрузить данные из файла MAT, который хранится в timeseries возразите или в массиве, где первая строка содержит данные времени, и последующие строки содержат данные для скалярного или векторного сигнала. Загрузка данных сохранена в timeseries поддержка объектов более широкая область значений данных и выходных типов и требует, чтобы файлом MAT была Версия 7.3.

Примечание

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

Фактор данных

timeseries Формат

Формат массивов

Поддерживаемые типы данных сигнала

  • Любые встроенные типы данных кроме halfint64, и uint64

  • Перечислимый тип данных

  • Тип данных с фиксированной точкой с до 32-битного размера слова

double

Сложность данных сигнала

Действительный или комплексный

Действительный

Требования данных сигнала

Не должен содержать NaNInf, или -Inf значения

Не должен содержать NaNInf, или -Inf значения

Тип выхода

  • Скаляр, вектор или многомерный сигнал

  • Шина

Скалярный или векторный сигнал

Требования к данным времени

  • Типом данных должен быть double

  • Значения должны увеличиться монотонно

  • Типом данных должен быть double

  • Значения должны увеличиться монотонно

'MATFileVersion'

Версия 7.3

Все версии

Блок From File загружает данные только из одной переменной в файле MAT, независимо от количества переменных, которые содержит файл MAT. Когда вы загружаете данные из файла MAT Версии 7.3, который содержит несколько переменных, блок From File загружает данные в переменной, которая является первой в алфавитном порядке. Алгоритм упорядоченного расположения, используемый Версией 7.0 и более ранними файлами MAT, более сложен, поэтому гарантируйте, что файл MAT только содержит данные для одной переменной, когда вы загружаете данные из Версии 7.0 или более раннего файла MAT.

'MATFileVersion'

Версия файла MAT также влияет, как блок From File загружает данные. Когда вы загружаете данные из файла MAT Версии 7.3, данные загружаются инкрементно в процессе моделирования. Когда вы загружаете данные из Версии 7.0 или более раннего файла MAT, все данные загружаются в память в начале симуляции.

Чтобы преобразовать файл MAT в Версию 7.3, используйте load функционируйте, чтобы загрузить данные в Версии 7.0 или более раннем файле MAT в базовое рабочее пространство, затем сохранить данные к файлу MAT Версии 7.3 с помощью save функция с версией, заданной как '-v7.3'. Например, предположите, что вы хотите преобразовать файл myData.mat это содержит переменную inputData к Версии 7.3. Используйте эти команды:

load('myData.mat');
save('myData.mat','inputData','-v7.3');

Для получения дополнительной информации см. Версии MAT-файла.

Порты

Вывод

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

Выведите созданные данные об использовании, загруженные из заданного файла MAT. В зависимости от данных вы загружаете, выход может быть скалярным или многомерным сигналом или шиной. Поддержки блока From File, загружающие действительные и комплексные данные всех встроенных типов данных кроме halfint64, и uint64.

Типы данных: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean | fixed point | enumerated | bus
Поддержка комплексного числа: Да

Параметры

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

Имя файла MAT или путь к файлу MAT с данными вы хотите загрузить. Задайте путь к файлу, когда файл не будет на пути MATLAB или в текущей рабочей директории.

Можно ввести путь или имя файла в текстовое поле, или можно просмотреть к файлу MAT путем нажатия кнопки Browse for a MAT-file. На UNIX® системы, путь может запуститься с тильды (~), который указывает на вашу домашнюю папку.

Вы не можете загрузить данные от файла до который данные логов модели.

Советы

  • Поддержки блока From File, загружающие данные из файла, созданного с помощью блока To File без любой модификации к данным или файлу.

  • Чтобы определить текущую рабочую директорию, введите pwd в командное окно MATLAB.

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

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

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

Тип данных данных в файле MAT загружен блоком From File. По умолчанию блок From File наследовал тип данных выходного сигнала от данных в файле или от нисходящего блока, который задает тип данных для сигнала. Ошибка происходит, если тип данных данных в файле MAT не совпадает с наследованным типом данных.

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

Чтобы загрузить данные для шины, установите Output data type на Bus: <bus object> и задайте имя Simulink.Bus объект, который задает выходную шину.

Чтобы загрузить перечисленные данные, установите Output data type на Enum: <class name> и задайте имя класса перечисления, который задает перечислимые значения данных.

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

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

Параметры блоков: OutDataTypeStr
Ввод: символьный вектор
Значения: 'Inherit: auto' | 'double' | 'single' | 'int8' | 'uint8' | 'int16' | 'uint16' | 'int32' | 'uint32' | 'boolean' | 'fixdt(1,16,0)' | 'fixdt(1,16,2^0,0)' | 'Enum: <class name>' | 'Bus: <object name>' | '<data type expression>'
Значение по умолчанию: 'Inherit: auto'

Параметр Sample time задает, когда блок вычисляет новое выходное значение в процессе моделирования. Для получения дополнительной информации см. Настройку времени выборки.

Задайте параметр Sample time как скаляр, когда вы не захотите, чтобы выход возместил время. Чтобы добавить смещение времени к выходу, задайте параметр Sample time как 1- 2 вектор, где первым элементом является период выборки и второй элемент, является смещением.

По умолчанию значением параметров Sample time является 0, который указывает время непрерывной выборки без смещения времени. Для дискретного сигнала задайте Sample time как дискретный интервал выборки. Например, задайте Sample time как 0.1 смоделировать дискретный сигнал произвело каждые 100 мс. Задайте Sample time как -1 наследовать значение.

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

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

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

МетодОписаниеПример
Linear extrapolation

Как блок решает, что выходное значение зависит от типа данных в файле MAT.

  • Для double данные, блок From File линейно экстраполирует выходное значение с помощью первых двух выборок.

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

  • Для всех других встроенных типов данных, блока From File:

    1. Upcasts данные к double.

    2. Линейно экстраполирует выходное значение с помощью первых двух выборок в данных о файле MAT.

    3. Downcasts экстраполируемое значение данных к исходному типу данных.

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

Не используйте Linear extrapolation опция, когда загрузки блока From File данные перечисленной или фиксированной точки.

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

Plot that shows the output for a From File block configured to linearly extrapolate the output value for simulation times before the first sample in the loaded data. The block loads data that starts 2 seconds into the simulation.

Hold first value

Блок From File использует значение First Data в файле MAT как выходное значение.

Plot that shows the output for a From File block configured to hold the first value in the loaded data for simulation times before the first sample in the loaded data. The block loads data that starts 2 seconds into the simulation.

Ground value

Выходное значение блока From File зависит от типа данных в файле MAT.

  • Встроенные числовые типы — 0

  • Boolean ложь

  • Типы данных с фиксированной точкой — Представление для значения 0, который не может быть точно 0 из-за масштабирования и ограниченной точности.

  • Перечислимые типы данных — Значение по умолчанию

Plot that shows the output for a From File block configured to use the ground value as the output value for simulation times before the first sample in the loaded data. The block loads data that starts 2 seconds into the simulation.

Советы

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

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

Параметры блоков: ExtrapolationBeforeFirstDataPoint
Ввод: символьный вектор
Значения: 'Linear extrapolation' | 'Hold first value' | 'Ground value'
Значение по умолчанию: 'Linear extrapolation'

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

МетодОписаниеПример
Linear interpolation

Как блок решает, что выходное значение зависит от типа данных в файле MAT.

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

  • Для всех других встроенных типов числовых данных, блока From File:

    1. Upcasts данные к double.

    2. Линейно интерполирует выходное значение с помощью значений данных файла MAT до и после времени симуляции, которому нужно выходное значение.

    3. Downcasts экстраполируемое значение данных к исходному типу данных.

  • Для Boolean данные, если время симуляции между двумя точками данных рабочей области с различными значениями, блок From File, располагают переход значения на полпути между точками данных файла MAT. Например, если переходы данных от true к false, блок From File обеспечивает выходное значение true для времен симуляции в первой половине интервала между точками данных файла MAT и выходным значением false для времен симуляции в последней половине интервала.

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

Не используйте Linear interpolation опция, когда блок From File загружает перечисленные данные.

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

Plot that shows the output for a From File block configured to linearly interpolate the output value for simulation times between the samples in the loaded data.

Zero order hold

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

Plot that shows the output for a From File block configured to use zero-order-hold interpolation for simulation times between the samples in the loaded data.

Советы

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

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

Параметры блоков: InterpolationWithinTimeRange
Ввод: символьный вектор
Значения: 'Linear interpolation' | 'Zero order hold'
Значение по умолчанию: 'Linear interpolation'

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

МетодОписаниеПример
Linear extrapolation

Как блок решает, что выходное значение зависит от типа данных в файле MAT.

  • Для double данные, блок From File линейно экстраполирует выходное значение с помощью последних двух выборок в файле MAT.

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

  • Для всех других встроенных типов данных, блока From File:

    1. Upcasts данные к double.

    2. Линейно экстраполирует выходное значение с помощью последних двух выборок в данных о файле MAT.

    3. Downcasts экстраполируемое значение данных к исходному типу данных.

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

Не используйте Linear extrapolation опция, когда блок From File загружает перечисленные данные.

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

Plot that shows the output for a From File block configured to linearly interpolate the output value for simulation times after the last sample in the loaded data. The block loads data that ends 2 seconds before the end of the simulation.

Hold last value

Блок From File использует последнее значение данных в файле MAT как выходное значение.

Plot that shows the output for a From File block configured to hold the last output value for simulation times after the last sample in the loaded data. The block loads data that ends 2 seconds before the end of the simulation.

Ground value

Выходное значение блока From File зависит от типа данных в файле MAT.

  • Встроенные числовые типы — 0

  • Boolean ложь

  • Типы данных с фиксированной точкой — Представление для значения 0, который не может быть точно 0 из-за масштабирования и ограниченной точности.

  • Перечислимые типы данных — Значение по умолчанию

Plot that shows the output for a From File block configured to use the ground value as the output value for simulation times after the last sample in the loaded data. The block loads data that ends 2 seconds before the end of the simulation.

Советы

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

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

Параметры блоков: ExtrapolationAfterLastDataPoint
Ввод: символьный вектор
Значения: 'Linear extrapolation' | 'Hold last value' | 'Ground value'
Значение по умолчанию: 'Linear extrapolation'

Обнаружение пересечения нулем определяет местоположение разрывов или zero crossings, в блоке выход и предотвращает чрезмерно маленькие временные шаги около разрывов, которые могут замедлить симуляцию. Можно включить обнаружение пересечения нулем для блока From File, когда параметр Sample time устанавливается на 0 в течение времени непрерывной выборки.

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

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

Блок From File может также создать разрывы в выходе на основе того, как вы конфигурируете интерполяцию и экстраполяцию.

  • Установка Data extrapolation before first data point к Ground value может создать разрыв на первой выборке в загруженных данных.

  • Установка Data extrapolation after the last data point к Ground value может создать разрыв на последней выборке в загруженных данных.

  • Установка Data interpolation within time range к Zero-order hold создает разрыв на каждой выборке в загруженных данных, включая последнее.

Для получения дополнительной информации смотрите Обнаружение Пересечения нулем.

Советы

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

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

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

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

Типы данных

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

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

no

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

yes

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

no

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

yes

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

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

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