Считайте данные из электронной таблицы
Simulink / Источники
Блок From Spreadsheet считывает данные из Microsoft® Excel® (все платформы), или CSV (платформа MicrosoftWindows® с Microsoft Office установила только), электронные таблицы, и выводит данные как сигнал. Блок From Spreadsheet не поддерживает графики электронной таблицы Microsoft Excel.
Значок From Spreadsheet отображает имя файла электронной таблицы и имя листа, заданное в параметрах блока File name и Sheet name.
Данные, что чтения блока From Spreadsheet из электронной таблицы должны быть соответственно отформатированы.
Для электронных таблиц Microsoft Excel:
Блок From Spreadsheet интерпретирует первую строку как имя сигнала. Если вы не задаете имя сигнала, блок From Spreadsheet присваивает по умолчанию с Сигналом формата ## шаг с каждым дополнительным сигналом без имени.
Блок From Spreadsheet интерпретирует первый столбец как время. В этом столбце должны монотонно увеличиться временные стоимости.
Блок From Spreadsheet интерпретирует остальные столбцы как сигналы.
Этот пример показывает приемлемо отформатированную электронную таблицу Microsoft Excel. Первый столбец время, и первая строка содержит имена сигнала. Каждый рабочий лист содержит группу сигнала.
Для текстовых файлов CSV (платформа Microsoft с Microsoft Office установила только):
Блок From Spreadsheet интерпретирует первый столбец как время. В этом столбце должны увеличиться временные стоимости.
Блок From Spreadsheet интерпретирует остальные столбцы как сигналы.
Каждый столбец должен иметь то же количество записей.
Блок From Spreadsheet интерпретирует каждый файл как одну группу сигнала.
Этот пример показывает приемлемо отформатированный файл CSV. Содержимое представляет одну группу сигнала.
0,0,0,5,0 1,0,1,5,0 2,0,1,5,0 3,0,1,5,0 4,5,1,5,0 5,5,1,5,0 6,5,1,5,0 7,0,1,5,0 8,0,1,5,1 9,0,1,5,1 10,0,1,5,0
Блок From Spreadsheet инкрементно считывает данные из электронной таблицы в процессе моделирования.
Параметр Sample time задает шаг расчета что использование блока From Spreadsheet, чтобы считать данные из электронной таблицы. Для получения дополнительной информации смотрите Параметры. Метки времени в файле должны монотонно не уменьшаться.
Для каждого хита времени симуляции, для которого электронная таблица не содержит метки времени соответствия, программное обеспечение Simulink® интерполирует или экстраполирует, чтобы получить необходимые данные с помощью выбранного метода. Для получения дополнительной информации смотрите Хиты Времени симуляции, Которые Не Имеют Никаких Соответствующих Меток времени электронной таблицы.
Если хит времени симуляции не имеет соответствующей метки времени электронной таблицы, блок From Spreadsheet вывел, зависит от:
Происходит ли хит времени симуляции перед первой меткой времени в области значений меток времени, или после последней метки времени
Методы интерполяции или экстраполяции, которые вы выбираете
Тип данных данных об электронной таблице
Для получения дополнительной информации об опциях интерполяции и экстраполяции, см. описания этих параметров:
Иногда электронная таблица включает два или больше значения данных, которые имеют ту же метку времени. В таких случаях действие блока From Spreadsheet зависит от того, когда хит времени симуляции происходит относительно дублирующихся меток времени в электронной таблице.
Например, предположите, что электронная таблица содержит эти данные. Три значения данных имеют значение метки времени 2.
time stamps: 0 1 2 2 2 3 4 data values: 2 3 6 4 9 1 5
Таблица описывает блок From Spreadsheet выход.
| Время симуляции, относительно дублирующихся значений метки времени в электронной таблице | От действия блока электронной таблицы |
|---|---|
| Перед дублирующимися метками времени |
Выполняет те же действия как тогда, когда метки времени отличны, с помощью первого из дублирующихся значений метки времени как базис для интерполяции. (В этом примере значением метки времени является |
| В или после дублирующихся меток времени |
Выполняет те же действия как тогда, когда штампы времен отличны, с помощью последнего из дублирующихся значений метки времени как базис для интерполяции. (В этом примере тем значением метки времени является |
File name — Полный путь и имя файлаuntitled.xlsx (значение по умолчанию) | полный путь и имя файлаВведите полный путь и имя файла файла электронной таблицы, включая расширение файла. Если вы не включаете расширение файла, блок принимает .xlsx как расширение.
Этот блок поддерживает неанглийские полные пути и имена файлов только на платформах Microsoft.
Параметры блоков: FileName |
| Ввод: символьный вектор |
| Значение: полный путь и имя файла |
Значение по умолчанию: 'untitled.xlsx' |
Sheet name — Имя листа в электронной таблицеSheet1 (значение по умолчанию) | покрывает имяВведите имя листа в электронной таблице. Можно ввести имя листа в этом окне редактирования или выбрать имя листа после того, как вы откроете лист.
Если ваша электронная таблица является форматом CSV, блок заполняет этот параметр с именем файла CSV без расширения. Не изменяйте это значение.
Чтобы открыть лист, щелкнуть
. В листе можно выбрать область значений данных путем перетаскивания в желаемой области значений значений.
В качестве альтернативы можно выбрать область значений данных путем указания диапазона значений в параметре Range.
Параметры блоков: SheetName |
| Ввод: символьный вектор |
| Значение: Покройте имя |
Значение по умолчанию: 'Sheet1' |
Range — Диапазон ячеекA1:B3,D1:D3,A7:B9,D7:D9 | список, разделенный запятыми column:rowЧтобы указать диапазон, используйте формат column:rowA1:B3,D1:D3,A7:B9,D7:D9. Если незаданный, или пустой, блок автоматически обнаруживает используемую область значений, которая является всеми данными в листе.
Если выборы перекрываются, блок разрешает информацию о выборе как соответствующую. Например, если вы указываете несколько диапазонов, которые перекрываются, такие как A1:B4,B1:E7, блок разрешает выбор к A1 к E7, включительно.
Альтернатива к использованию параметра Range должна открыть лист путем нажатия. В листе можно выбрать область значений данных путем перетаскивания в желаемой области значений значений.
Параметры блоков: Range |
| Ввод: символьный вектор |
| Значение: Диапазон ячеек |
Значение по умолчанию: '' |
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> | <data type expression>Тип данных для блока From Spreadsheet выводится. Блок From Spreadsheet принимает электронные таблицы, которые содержат много типов данных. Однако блок читает тип данных электронной таблицы, как удваивается. Это затем выводит тип данных согласно значению Output data type.
Если вы хотите задать различные типы данных для каждого сигнала, рассмотрите Output Data Type выбора> Inherit: auto. Эта опция разрешает назад типы данных сигнала с помощью обратного распространения. Например, примите, что существует два сигнала в блоке From Spreadsheet, In1 и In2, который блок отправляет в порты, которые имеют int8 и булевы типы данных. С обратным распространением блок переделывает In1 как int8 и In2 как булевская переменная.
Чтобы позволить блоку бросать тип выходных данных, чтобы совпадать с тем из блока получения, используйте Inherit: auto.
Для получения дополнительной информации смотрите Типы данных Управляющего сигнала.
Параметры блоков: 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>' | '<data type expression>' |
Значение по умолчанию: 'Inherit: auto' |
Treat first column as — Время или данныеTime (значение по умолчанию) | DataВыберите, как блок должен обработать первый столбец электронной таблицы:
Time — Обработайте первый столбец как время.
Data — Обработайте первый столбец как данные.
Когда вы выбираете Data, блок отключает:
Data extrapolation before first data point
Data interpolation within time range
Data extrapolation after last data point
И включает:
Output after last data point
Параметры блоков: TreatFirstColumnAs |
| Ввод: символьный вектор |
Значение: 'Time' | 'Data' |
Значение по умолчанию: 'Time' |
Sample time — Выборка периода и смещенияПериод расчета и смещение.
Блок From Spreadsheet считывает данные из электронной таблицы с помощью шага расчета что также:
Вы задаете для блока From Spreadsheet
Блок From Spreadsheet наследовался блокам, в которые блок From Spreadsheet подает данные
Значением по умолчанию является 0, который задает время непрерывной выборки. Электронная таблица читается на основном (самом быстром) уровне модели. Для получения дополнительной информации см. Настройку времени выборки.
Параметр:
SampleTime
|
| Ввод: символьный вектор |
| Значения: скаляр | вектор |
Значение по умолчанию:
'0'
|
Data extrapolation before first data point — Метод экстраполяции для времен симуляции перед начальной меткой времени в MAT-файлеLinear extrapolation (значение по умолчанию) | Hold first value | Ground valueМетод экстраполяции, который использование Simulink для времени симуляции поражает, который является перед первой меткой времени в электронной таблице. Выберите один из этих методов экстраполяции.
| Метод | Описание |
|---|---|
Linear extrapolation | (Значение по умолчанию) Если электронная таблица содержит только одну выборку, блок From Spreadsheet выводит соответствующее значение данных. Если электронная таблица содержит больше чем одну выборку, блок From Spreadsheet линейно экстраполирует использование первых двух выборок:
Вы не можете использовать |
Hold first value | Использует значение First Data в файле |
Ground value | Использует значение, которое зависит от типа данных значений выборочных данных электронной таблицы:
|
Чтобы включить этот параметр, установите Treat first column as на Time.
Параметр:
ExtrapolationBeforeFirstDataPoint
|
| Ввод: символьный вектор |
Значения:
'Linear extrapolation' | 'Hold first value' | 'Ground value'
|
Значение по умолчанию:
'Linear extrapolation'
|
Data interpolation within time range — Метод интерполяции для времен симуляции, которые падают между двумя метками времени в MAT-файлеLinear interpolation (значение по умолчанию) | Zero order holdМетод интерполяции, который Simulink использует для хита времени симуляции между двумя метками времени в электронной таблице. Выберите один из следующих методов интерполяции.
| Метод | Описание |
|---|---|
Linear interpolation | (Значение по умолчанию) Блок From Spreadsheet интерполирует использование двух соответствующих выборок электронной таблицы:
Вы не можете использовать |
Zero order hold | Использует данные из первой из этих двух выборок |
Чтобы включить этот параметр, установите Treat first column as на Time.
Параметр:
InterpolationWithinTimeRange
|
| Ввод: символьный вектор |
Значения:
'Linear interpolation' | 'Zero order hold'
|
Значение по умолчанию:
'Linear interpolation'
|
Data extrapolation after last data point — Метод экстраполяции для времен симуляции после последней метки времени в MAT-файлеLinear extrapolation (значение по умолчанию) | Hold last value | Ground valueМетод экстраполяции, который использование Simulink для времени симуляции поражает, который является после последней метки времени в электронной таблице. Выберите один из следующих методов экстраполяции.
| Метод | Описание |
|---|---|
Linear extrapolation | (Значение по умолчанию) Если электронная таблица содержит только одну выборку, блок From Spreadsheet выводит соответствующее значение данных. Если электронная таблица содержит больше чем одну выборку, блок From Spreadsheet линейно экстраполирует значения данных использования последних двух выборок:
Вы не можете использовать |
Hold last value | Использует последнее значение данных в файле |
Ground value | Использует значение, которое зависит от типа данных значений выборочных данных электронной таблицы:
|
Чтобы включить этот параметр, установите Treat first column as на Time.
Параметр:
ExtrapolationAfterLastDataPoint
|
| Ввод: символьный вектор |
Значения:
'Linear extrapolation' | 'Hold last value' | 'Ground value'
|
Значение по умолчанию:
'Linear extrapolation'
|
Output after last data point — Действие после последней точки данныхRepeating sequence (значение по умолчанию) | Hold final value | Ground valueВыберите действие после последней точки данных:
Repeating sequence — Повторите последовательность путем чтения данных из первой строки диапазона, указанного в Range
Hold final value — Выведите последнее заданное значение для остатка от симуляции.
Ground value — Выведите наземное значение в зависимости от значения типа данных, заданного в Output data type.
Чтобы включить этот параметр, установите Treat first column as на Data.
Параметр:
OutputAfterLastPoint
|
| Ввод: символьный вектор |
Значения:
'Repeating sequence' | 'Hold final value' | 'Ground value'
|
Значение по умолчанию:
'Repeating sequence'
|
Enable zero-crossing detection — Включите обнаружение пересечения нулемoff (значение по умолчанию) | onВыберите, чтобы включить обнаружение пересечения нулем.
Параметр Обнаружения Пересечения нулем применяется, только если параметр Sample time устанавливается на 0 (непрерывный).
Simulink использует метод, который, как известно как обнаружение пересечения нулем, определял местоположение точно разрыва, не обращаясь к чрезмерно маленьким временным шагам. В этом контексте пересечение нулем используется, чтобы представлять разрывы.
Для блока From Spreadsheet обнаружение пересечения нулем может только произойти в метках времени в файле. 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
Блок применяет следующие правила при определении когда:
Пересечение нулем происходит впервые штамп
Для меток времени между первой и последней меткой времени
В последний раз штамп
| Метка времени | Когда обнаружение пересечения нулем происходит |
|---|---|
Сначала | Data extrapolation before first data point установлен в |
Между в общем и целом | Data interpolation within time range установлен в |
В последний раз | Один или обе из этих настроек происходите:
|
Следующая фигура иллюстрирует обнаружение пересечения нулем для данных, к которым получает доступ блок From Spreadsheet, который имеет эти настройки:
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 Spreadsheet. Блок имеет эти настройки для меток времени (точки):
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
Параметры блоков: ZeroCross |
| Ввод: символьный вектор |
Значения: 'off' | 'on' |
Значение по умолчанию: 'off' |
