Индекс в n-мерную таблицу для извлечения элемента, вектора или 2-D матрицы
Simulink/Интерполяционные таблицы
HDL-кодер/интерполяционные таблицы
Блок Direct Интерполяционная Таблица (n-D) индексируется в n-мерную таблицу, чтобы извлечь элемент, вектор или 2-D матрицу. Первый индекс выбора соответствует верхнему (или левому) входному порту. Можно принять решение предоставить данные таблицы в качестве входов для блока или определить данные таблицы в диалоговом окне блока. Количество портов входа и размер выхода зависят от количества размеров таблицы и выхода среза вы выбираете.
Если вы выбираете вектор из 2-D таблицы, выходным вектором может быть столбец или строка, в зависимости от настройки параметра конфигурации модели Math and Data Types > Use algorithms optimized for row-major array layout. Блочные входы начинаются с нуля индексы (для получения дополнительной информации смотрите параметр Inputs select this object from table.
Блок Direct Lookup Table поддерживает символьные размерности.
Блок Direct Lookup Table (n-D) использует входы как нулевые индексы в n-мерную таблицу. Количество входов изменяется с формой выхода: элемент, вектор или 2-D матрица.
Набор выхода значений определяется как параметр Table data. Для поведения алгоритма основного столбца по умолчанию первый вход задает базовый индекс для размерности таблицы, которая на один выше, чем выход размерность. Следующий вход задает нулевой индекс для следующей размерности таблицы и так далее.
| Выход | Выходная размерность | Размерность таблицы, которое преобразуется в первый вход |
|---|---|---|
| Элемент | 0 | 1 |
| Вектор | 1 | 2 |
| Матрица | 2 | 3 |
Предположим, что вы хотите выбрать вектор значений из 4-D таблицы.
Применяется следующее отображение входного порта блока с размерностью таблицы.
| Этот входной порт... | Индекс для этой размерности таблицы... |
|---|---|
| 1 | 2 |
| 2 | 3 |
| 3 | 4 |
В зависимости от установленных параметров значок блока изменяет внешний вид. Для размерностей таблицы выше 4 значок совпадает с 4-D версией, но показывает точное количество размерностей в верхней части.
Когда вы используете параметр Table data, вы видите эти значки для поведения по умолчанию column-major. Некоторые значки отличаются, когда вы выбираете параметр конфигурации Math and Data Types > Use algorithms optimized for row-major array layout.
| Объект, который вводит выбор из таблицы | Количество Таблицы Размерностей | |||
|---|---|---|---|---|
| 1 | 2 | 3 | 4 | |
|
Элемент |
|
|
|
|
|
Вектор |
|
|
|
|
|
2-D матрица |
Не применяется |
|
|
|
Когда вы используете входной порт таблицы, вы видите эти значки.
| Объект, который вводит выбор из таблицы | Количество Таблицы Размерностей | |||
|---|---|---|---|---|
| 1 | 2 | 3 | 4 | |
|
Элемент |
|
|
|
|
|
Вектор |
|
|
|
|
|
2-D матрица |
Не применяется |
|
|
|
Number of table dimensions - Количество размерностей табличных данных2 (по умолчанию) | 1 | 3 | 4Количество размерностей, которое должен иметь параметр Table data. Это значение определяет количество независимых переменных для таблицы и количество входов в блок.
| Чтобы указать... | Делай это... |
|---|---|
|
1, 2, 3 или 4 |
Выберите значение из раскрывающегося списка. |
|
Большее количество размерностей таблицы |
Введите положительное целое число непосредственно в поле. Максимальное количество размерностей таблицы, поддерживаемых этим блоком, составляет 30. |
Параметры блоков:
NumberOfTableDimensions |
| Тип: Вектор символов |
Значения: '1' | '2' | '3' | '4' | ... |'30'| |
По умолчанию:
'2' |
Make table an input - Предоставьте данные таблицы как блочный входoff (по умолчанию) | onУстановите этот флажок, чтобы предоставить данные таблицы блоку Direct Lookup Table (n-D) в качестве входа. Когда вы устанавливаете этот флажок, новый входной порт, T, появляется. Используйте этот порт для ввода данных таблицы.
Параметры блоков:
TableIsInput |
| Тип: Вектор символов |
Значения: 'off' | 'on' |
По умолчанию:
'off' |
Table data - Таблица выходных значений[4 5 6; 16 19 20; 10 18 23] (по умолчанию) | scalar, vector, matrix, or N-D arrayЗадайте таблицу выхода значений. Размер таблицы должен совпадать с размерностями параметра Number of table dimensions.
Совет
Во время редактирования блока схемы можно оставить Table data поле пустым. Но для симуляции необходимо соответствовать количеству размерностей в Table data с Number of table dimensions. Для получения дополнительной информации о том, как создать многомерный MATLAB® массивы, см. «Многомерные массивы».
Щелкните Edit, чтобы открыть Редактор интерполяционных таблиц. Для получения дополнительной информации см. раздел «Редактирование интерполяционных таблиц».
Чтобы включить поле Table data, снимите флажок Make table an input.
Параметры блоков:
Table |
| Тип: Вектор символов |
Значения:
scalar, vector, matrix, or N-D array |
По умолчанию:
'[4 5 6;16 19 20;10 18 23]' |
Inputs select this object from table - Задайте, является ли вывод элементом, вектором или 2-D матрицейElement (по умолчанию) | Vector | 2-D MatrixЗадайте, являются ли выходные данные одним элементом, вектором или 2-D матрицей. Количество входа портов для индексации зависит от вашего выбора.
| Выбор | Количество портов Входа для индексации |
|---|---|
Element
| Количество размерностей в таблице |
Vector
| Количество размерностей таблицы -1 |
2-D Matrix
| Количество размерностей таблицы -2 |
Эта нумерация соответствует индексации MATLAB. Для примера, если у вас есть 4-D таблица данных, следуйте этим рекомендациям.
| Для доступа... | Укажите... | Как в... |
|---|---|---|
| Элемент | Четыре индекса |
array(1,2,3,4)
|
| Вектор | Три индекса |
array(:,2,3,4)(алгоритм основного столбца по умолчанию) |
| Матрица 2-D | Два индекса |
array(:,:,3,4)(алгоритм основного столбца по умолчанию) |
Когда задан параметр конфигурации Math and Data Types > Use algorithms optimized for row-major array layout, поведение блока Direct Интерполяционная Таблица изменяется с основного столбца на основную строку. Для этого блока алгоритмы основной и основной строки могут различаться семантически при выходных вычислениях, что приводит к различным числовым значениям. Например, предположим, что Inputs select this object from table параметр установлен на Vector. Элементы выбранного вектора смежны в памяти хранилища таблиц. В этой таблице показан алгоритм основной и основной строки в зависимости от размерности таблицы:
| Табличные Размерности | Алгоритм основного столбца | Алгоритм основной строки |
|---|---|---|
| 2-D таблица | Вектор-столбец выбран | Вектор-строка выбран |
| 3-D и более высокая таблица | Выходной вектор выбирается из первой размерности таблицы | Выходной вектор выбирается из последней размерности таблицы |
Рассмотрим алгоритмы прямого поиска основной строки и основной столбца с векторными выходами из 3-D таблицы. Последняя размерность является третьей размерностью 3-D таблицы. Из-за семантических изменений прямой поиск по основному столбцу и основной строке может вывести различные размер вектора и числовые значения.
Этот рисунок показывает блок Direct Lookup Table (n-D), сконфигурированный с таблицей 3-D и выходом вектора. По умолчанию значок блока показывает алгоритм основного столбца.
Чтобы иметь тот же блок, использующий алгоритм row-major, измените параметр Math and Data Types > Use algorithm optimized for row-major layout конфигурации модели и перекомпилируйте. Значок блока изменяется, чтобы отразить изменение алгоритма, оптимизированного для поведения основной строки.
Для получения дополнительной информации о поддержке основной строки смотрите Row-Major Array Layout: Упрощение интегрирования с внешним кодом C/C + + для интерполяционной таблицы и других блоков (Simulink Coder ).
Параметры блоков:
InputsSelectThisObjectFromTable |
| Тип: Вектор символов |
Значения:
'Element' | 'Vector' | '2-D Matrix' |
По умолчанию:
'Element' |
Diagnostic for out-of-range input - Блокируйте действие, когда вход вне области значенийWarning (по умолчанию) | None | ErrorУкажите, отображать ли предупреждение или ошибку, когда индекс находится вне области значений относительно размерности таблицы. Опции включают:
None - Нет ответа.
Warning - Отобразите предупреждение и продолжите симуляцию.
Error - Завершите симуляцию и отобразите ошибку.
Когда вы выбираете None или Warningблок зажимает индексы вне области допустимого для соответствия размерностям таблицы. Для примера, если заданный индекс равен 5,3, а максимальный индекс для этой таблицы размерности равен 4, блок зажимает индекс равным 4.
Параметры блоков:
DiagnosticForOutOfRangeInput |
| Тип: Вектор символов |
Значения:
'None' | 'Warning' | 'Error' |
По умолчанию:
'Warning' |
Sample time - Задайте время расчета как значение, отличное от -1-1 (по умолчанию) | скалярный вектор |Задайте шаг расчета как значение, отличное от -1. Для получения дополнительной информации см. Раздел «Задание шага расчета».
Этот параметр не отображается, если он явно не установлен на значение, отличное от -1. Для получения дополнительной информации смотрите Блоки, для которых шаг расчета не рекомендован.
Параметры блоков:
SampleTime |
| Тип: Вектор символов |
| Значения: скаляр или вектор |
По умолчанию:
'-1' |
Remove protection against out-of-range input in generated code - Удалите код, который проверяет входные значения вне области допустимогоoff (по умолчанию) | onУкажите, включать ли код, который проверяет значения входа вне области допустимого.
| Флажок | Результат | Когда использовать |
|---|---|---|
| Сгенерированный код не включает условные операторы для проверки входных входов точек прерывания вне области допустимого. Когда вход находится вне области допустимого, это может вызвать неопределенное поведение сгенерированного кода. | Для эффективности кода |
| Сгенерированный код включает условные операторы для проверки входных входов вне области допустимого. | Для критически важных приложений |
Если ваш вход не находится вне области значений, можно установить флажок Remove protection against out-of-range index in generated code для эффективности кода. По умолчанию этот флажок снимается. Для критически важных приложений не устанавливайте этот флажок. Если вы хотите установить флажок Remove protection against out-of-range index in generated code, сначала проверьте, что входы вашей модели находятся в области значений. Для примера:
Снимите флажок Remove protection against out-of-range index in generated code.
Установите параметр Diagnostic for out-of-range input равным Error.
Симулируйте модель в режим normal mode.
Если есть ошибки вне области допустимого, исправьте их, чтобы быть в области значений и запустите симуляцию снова.
Когда симуляция больше не генерирует входные ошибки вне области допустимого, установите флажок Remove protection against out-of-range index in generated code.
Примечание
Когда вы устанавливаете флажок Remove protection against out-of-range index in generated code, и вход находится вне области значений, поведение для сгенерированного кода не определено.
В зависимости от вашего приложения, можно запустить следующие проверки Model Advisor, чтобы проверить использование этого флажка:
By Product> Embedded Coder> Identify lookup table blocks that generate expensive out-of-range checking code
By Product> Simulink Check> Modeling Standards> DO-178C/DO-331 Checks> Check usage of lookup table blocks
Дополнительные сведения о Model Advisor см. в разделе Запуск проверок Model Advisor.
Кроме того, чтобы определить, безопасно ли устанавливать этот флажок, если у вас есть Simulink® Проектируйте Verifier™ лицензию, рассмотрите использование проверки Detect Block Input Range Violutions (Simulink Design Verifier).
Параметры блоков:
RemoveProtectionInput |
| Тип: Вектор символов |
Значения:
'off' | 'on' |
По умолчанию:
'off' |
Примечание
Параметры на панели Table Attributes недоступны, если вы выбираете Make table an input. В этом случае блок наследует все атрибуты таблицы от порта входа с меткой T.
Table minimum - Данные таблицы минимальных значений могут иметь[] (по умолчанию) | finite, real, double, scalarЗадайте минимальное значение для данных таблицы. Значение по умолчанию [] (не определено).
Параметры блоков:
TableMin |
| Тип: Вектор символов |
| Значения: скаляр |
По умолчанию:
'[]' |
Table maximum - Данные таблицы максимальных значений могут иметь[] (по умолчанию) | finite, real, double, scalarЗадайте максимальное значение для данных таблицы. Значение по умолчанию [] (не определено).
Параметры блоков:
TableMax |
| Тип: Вектор символов |
| Значения: скаляр |
По умолчанию:
'[]' |
Table data type - Тип данных табличных данныхInherit: Inherit from 'Table data' (по умолчанию) | double | single | half | int8 | uint8 | int16 | uint16 | int32 | uint32 | int64 | uint64 | boolean | fixdt(1,16) | fixdt(1,16,0) | fixdt(1,16,2^0,0) | Enum: <class name> | <data type expression>Задайте тип данных таблицы. Вы можете установить его на:
Правило, которое наследует тип данных, например Inherit: Inherit from 'Table data'
Имя встроенного типа данных, например single
Имя класса типа данных, например, класса перечисленных типов данных
Выражение, которое вычисляется как тип данных, например fixdt(1,16,0)
Нажмите кнопку Show data type assistant
, чтобы отобразить Data Type Assistant, которая помогает вам задать атрибуты type данных. Для получения дополнительной информации смотрите Задать типы данных Используя Data Type Assistant.
Параметры блоков:
TableDataTypeStr |
| Тип: Вектор символов |
Значения:
'Inherit: Inherit from 'Table data'' | 'double' | 'single' | 'half' | 'int8' | 'uint8' | 'int16' | 'uint16' | 'int32' | 'uint32' | 'int64' | 'uint64' | 'boolean' | 'fixdt(1,16)' | 'fixdt(1,16,0)' | 'fixdt(1,16,2^0,0)'|'Enum: <class name>'|'<data type expression>' |
По умолчанию:
'Inherit: Inherit from 'Table data'' |
Lock data type settings against changes by the fixed-point tools - Предотвратить переопределение типов данных инструментами с фиксированной точкойoff (по умолчанию) | onВыберите этот параметр, чтобы предотвратить переопределение инструментами с фиксированной точкой типов данных, заданных в этом блоке. Для получения дополнительной информации смотрите Блокировка настройки типа выходных данных (Fixed-Point Designer).
Параметры блоков: LockScale |
| Тип: Вектор символов |
Значения: 'off' | 'on' |
По умолчанию: 'off' |
