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

Direct Lookup Table (n-D)

Индексирование n-мерной таблицы для получения скаляра, вектора или двумерной матрицы.

direct lookup table n d

Описание

Блок Direct Lookup Table (n-D) индексирует n-мерную таблицу для извлечения скаляра, вектора или двумерной матрицы. Первый индекс выбора соответствует верхнему (или левому) порту ввода. Вы можете указать данные таблицы в качестве входных данных блока или определить данные таблицы в диалоговом окне блока. Количество входных портов и размер выхода зависят от количества размеров таблицы и выбранного выходного среза.

Блок Direct Lookup Table поддерживает символьные размеры.

Входы и выходы блока

Блок Direct Lookup Table (n-D) использует входы в качестве индексов в n-мерной таблице (отсчет с нуля). Количество входов зависит от размерности выходного сигнала: скаляр, вектор или двумерная матрица.

В параметре Table data задается набор выходных значений. Первый вход задает индекс по размерности таблицы, которая на единицу выше размерности выходного сигнала (отсчет с нуля). Следующий вход задает индекс по следующей размерности таблицы, и так далее.

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

Скаляр

0

1

Вектор

1

2

Матрица

2

3

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

Входной порт…​ индексирует …​ размерность таблицы

1

2

2

3

3

4

Изменение внешнего вида значка блока

В зависимости от заданных параметров значок блока изменяет свой внешний вид. Для размеров таблицы более 4 значок соответствует 4D версии, но с текстом "N-D" в верхней части.

Порты

Вход

Port_1 — индекс i1 входных значений
скаляр | вектор | матрица

Для алгоритма column-major первым входом является порт, задающий индекс по размерности таблицы, которая на единицу выше размерности выходного сигнала (отсчет с нуля; 0, 1 или 2). Следующий входной порт задает индекс нулевой размерности следующей таблицы, и так далее. Все индексы входных значений должны быть вещественными.

Типы данных: Float16, Float32, Float64, Int8, Int16, Int32, Int64, Int128, UInt8, UInt16, UInt32, UInt64, UInt128

Поддержка комплексных чисел: Да

Port_N — индекс N входных значений
скаляр | вектор

N-й входной порт, задающий индекс по размерности таблицы, которая на единицу выше размерности выходного сигнала (отсчет с нуля; 0, 1 или 2). Количество входов зависит от размерности выходного сигнала. Все индексы входных значений должны быть вещественными.

Типы данных: Float16, Float32, Float64, Int8, Int16, Int32, Int64, Int128, UInt8, UInt16, UInt32, UInt64, UInt128

Поддержка комплексных чисел: Да

Выход

Port_1 — выходной скаляр, вектор или двумерная матрица
скаляр | вектор | матрица

Выходной сигнал, предоставляемые в виде скаляра, вектора или двумерной матрицы. Размер выходных данных определяется настройкой параметра Inputs select this object from table. Тип выходных данных совпадает с типом данных таблицы.

Типы данных: Float64

Параметры

Number of table dimensions — количество измерений таблицы
2 (по умолчанию) | скаляр

Задает количество измерений таблицы.

Это значение определяет количество независимых переменных для таблицы и количество входов блока.

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

Параметр блока

NumberOfTableDimensions

Значения

1 | 2 | 3 | 4 | …​ | 30

По умолчанию

2
Table data — определение таблицы выходных значений
[4 5 6; 16 19 20; 10 18 23] по умолчанию) | скаляр, вектор, матрица или многомерный массив

Укажите таблицу выходных значений. Размер таблицы должен соответствовать размерам параметра Number of table dimensions.

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

Параметр блока

Table

Значения

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

По умолчанию

[4 5 6;16 19 20;10 18 23]
Inputs select this object from table — что будет выводится: скаляр, вектор или двумерная матрица
Element (по умолчанию) | Vector | 2-D Matrix

Укажите, что является выходными данными: скаляр, вектор или двумерная матрица. Количество входных портов для индексов зависит от значения этого параметра.

  • Element — значение параметра Number of table dimensions

  • Vector — значение параметра Number of table dimensions − 1

  • 2-D Matrix — значение параметра Number of table dimensions − 2

Например, для четырехмерной таблицы:

Для доступа к…​ Укажите…​ Как в…​

Элемент

Четыре индекса

Array(1,2,3,4)

Вектор

Три индекса

Array(:,2,3,4)

Двумерная матрица

Два индекса

Array(:,:,3,4)
Программное использование

Параметр блока

InputsSelectThisObjectFromTable

Значения

Element | Vector | 2-D Matrix

По умолчанию

Element
Diagnostic for out-of-range input — поведение блока при выходе за пределы диапазона
None (по умолчанию) | Error

Поведение блока при выходе за пределы диапазона определяется следующим образом:

  • None — Не отображает предупреждение или ошибку.

  • Error — Отображает ошибку и указывает на выход за пределы диапазона.

Примеры