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

Direct Lookup Table (n-D)

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

Тип: LookupNDDirect

Путь в библиотеке:

/Basic/Lookup Tables/Direct Lookup Table (n-D)

Описание

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

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

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

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

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

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

Скаляр

0

1

Вектор

1

2

Матрица

2

3

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

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

1

2

2

3

3

4

Порты

Выход

# OUT_1 — выходной сигнал
скаляр | вектор | матрица

Details

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

Типы данных

Float16, Float32, Float64, Int8, Int16, Int32, Int64, Int128, UInt8, UInt16, UInt32, UInt64, UInt128

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

Да

Вход

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

Details

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

Типы данных

Float16, Float32, Float64, Int8, Int16, Int32, Int64, Int128, UInt8, UInt16, UInt32, UInt64, UInt128

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

Да

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

Details

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

Типы данных

Float16, Float32, Float64, Int8, Int16, Int32, Int64, Int128, UInt8, UInt16, UInt32, UInt64, UInt128

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

Да

Параметры

Данные таблицы

# Number of table dimensions — количество измерений таблицы
Real number

Details

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

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

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

2

Имя для программного использования

NumberOfTableDimensions

Настраиваемый

Нет

Вычисляемый

Да

# Table data — определение таблицы выходных значений
Scalar / array of real and/or complex numbers

Details

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

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

[4 5 6; 16 19 20; 10 18 23]

Имя для программного использования

Table

Настраиваемый

Да

Вычисляемый

Да

Алгоритм

# Inputs select this object from table — размерность выходного сигнала
Element | Vector | 2-D Matrix

Details

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

Количество входных портов для индексов зависит от значения этого параметра.

  • 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)

Значения

Element | Vector | 2-D Matrix

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

Element

Имя для программного использования

InputsSelectThisObjectFromTable

Настраиваемый

Нет

Вычисляемый

Нет

# Diagnostic for out-of-range input — поведение блока при выходе за пределы диапазона
None | Warning | Error

Details

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

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

  • Warning — отображает предупреждение и продолжает симуляцию.

  • Error — отображает ошибку и прерывает симуляцию.

Значения

None | Warning | Error

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

Warning

Имя для программного использования

DiagnosticForOutOfRangeInput

Настраиваемый

Нет

Вычисляемый

Нет