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

Pad

Дополнение или усечение указанной размерности или размерностей.

Тип: Pad

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

/Signal Operations/Signal Operations/Pad

Описание

Блок Pad дополняет последовательность одинаковыми отсчетами заданного значения или усекает ее до заданной длины по столбцам, строкам, столбцам и строкам или по любым другим указанным вами размерностям.

Блок усекает входной сигнал, когда вы указываете выходные размерности, которые меньше соответствующих входных размерностей. Если размерность входных и выходных данных одинакова, блок действует как сквозной.

Значение дополняемых отсчетов можно ввести в параметре Pad value блока или через порт ввода. Можно ввести выходную размерность в параметре блока или указать блоку увеличивать указанную размерность до тех пор, пока ее длина не будет равна следующей степени двойки.

Параметр Pad signal at управляет тем, будет ли блок дополнять или усекать размерность входного сигнала в начале, в конце или в обоих местах. Для нечетных значений размерности дополнения или усечения в конце сигнала используется дополнительное значение размерности. Когда блок находится в режиме Specified dimensions, вы можете указать либо выходной размер, либо размер дополнения.

Вы можете настроить блок на выдачу ошибки при усечении входного сигнала с помощью параметра Action when truncation occurs.

Порты

Выход

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

Details

Дополненный или усеченный выходной сигнал. Размер и размерность выходных данных зависят от того, был ли дополнен или усечен входной сигнал по заданной размерности. Тип и сложность выходных данных соответствуют входным.

Типы данных

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

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

Да

Вход

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

Details

Входной сигнал, заданный в виде скаляра, вектора, матрицы или многомерного массива.

Типы данных

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

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

Да

# PVal — значение для дополнения
скаляр

Details

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

Зависимости

Чтобы использовать этот порт, установите для параметра Pad value source значение Input port.

Типы данных

Float64

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

Нет

Параметры

Основные

# Pad over — тип размерности, по которой будет производиться дополнение или усечение
Columns | Rows | Columns and rows | None | Specified dimensions

Details

Тип размерности, по которой будет производиться дополнение или усечение:

  • Columns — столбцы;

  • Rows — строки;

  • Columns and rows — столбцы и строки;

  • None — нет;

  • Specified dimensions — указывается пользователем в виде скаляра для количества столбцов, двухэлементного вектора — количества столбцов и строк и -элементного вектора — количества элементов многомерного массива.

Значения

Columns | Rows | Columns and rows | None | Specified dimensions

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

Columns

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

PadOver

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

Нет

Вычисляемый

Нет

# Dimensions to pad — размерность, по которой будет производиться дополнение или усечение
Int64 integer

Details

Укажите размерность (размерности), по которой следует выполнять дополнение или усечение. Значение этого параметра может быть скаляром или вектором:

  • 1 — дополнить столбцы;

  • (1 2) — дополнить столбцы и строки;

  • (1 3 5) — дополнить первое, третье и пятое измерения.

Зависимости

Чтобы использовать этот параметр, установите для параметра Pad over значение Specified dimensions.

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

1

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

DimensionsToPad

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

Нет

Вычисляемый

Да

# Pad value source — источник значения дополнения
Specify via dialog | Input port

Details

Источники значения для дополнения:

  • Specify via dialog — значение вводится в поле параметра Pad value;

  • Input port — значение подается на порт PVal.

Значения

Specify via dialog | Input port

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

Specify via dialog

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

PadValueSource

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

Нет

Вычисляемый

Нет

# Pad value — значение для дополнения
Real or complex number

Details

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

Зависимости

Чтобы использовать этот параметр, установите для параметра Pad value source значение Specify via dialog.

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

0

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

PadValue

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

Нет

Вычисляемый

Да

# Output column mode — режим задания длины столбца на выходе
User-specified | Next power of two

Details

Способы формирования длины столбца на выходе:

  • User-specified — указывается пользователем;

  • Next power of two — определяется как ближайшая степень двойки. Блок дополняет выходные столбцы до тех пор, пока их длина не станет следующей наибольшей степенью двойки. Если длина столбца уже равна степени двойки, блок не будет дополнять столбцы.

Зависимости

Чтобы использовать этот параметр, установите для параметра Pad over значение Columns или Columns and rows.

Значения

User-specified | Next power of two

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

User-specified

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

OutputColumnMode

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

Нет

Вычисляемый

Нет

# Column size — длина столбца на выходе
Int64 integer

Details

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

Зависимости

Чтобы использовать этот параметр, установите для параметра Output column mode значение User-specified.

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

1

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

ColumnSize

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

Нет

Вычисляемый

Да

# Output row mode — режим задания длины строки на выходе
User-specified | Next power of two

Details

Способы формирования длины строки на выходе:

  • User-specified — указывается пользователем;

  • Next power of two — определяется как ближайшая степень двойки. Блок дополняет выходные строки до тех пор, пока их длина не станет следующей наибольшей степенью двойки. Если длина строки уже равна степени двойки, блок не будет дополнять строки.

Зависимости

Чтобы использовать этот параметр, установите для параметра Pad over значение Rows или Columns and rows.

Значения

User-specified | Next power of two

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

User-specified

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

OutputRowMode

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

Нет

Вычисляемый

Нет

# Row size — длина строки на выходе
Int64 integer

Details

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

Зависимости

Чтобы использовать этот параметр, установите для параметра Output row mode значение User-specified.

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

1

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

RowSize

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

Нет

Вычисляемый

Да

# Specify — определить длину последовательности
Output size | Pad size

Details

Формирует длину выходной последовательности посредством:

  • Output size — ее непосредственного указания;

  • Pad size — указания длин дополнения в начале и в конце последовательности.

Зависимости

Чтобы использовать этот параметр, установите для параметра Pad over значение Specified dimensions.

Значения

Output size | Pad size

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

Output size

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

Specify

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

Нет

Вычисляемый

Нет

# Output size mode — режим указания длины последовательности на выходе
User-specified | Next power of two

Details

Способы формирования длины последовательности на выходе:

  • User-specified — указывается пользователем;

  • Next power of two — определяется как ближайшая степень двойки. Блок дополняет указанные размерности до тех пор, пока их длина не станет следующей наибольшей степенью двойки. Если длина размерности уже равна степени двойки, блок не будет дополнять эти размерности.

Зависимости

Чтобы использовать этот параметр, установите для параметра Pad over значение Specified dimensions и для параметра Specify значение Output size.

Значения

User-specified | Next power of two

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

User-specified

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

OutputSizeMode

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

Нет

Вычисляемый

Нет

# Output size — длина последовательности на выходе
Int64 integer

Details

Укажите выходную длину по указанной размерности (размерностям).

Этот параметр должен быть скаляром или вектором с тем же количеством элементов, что и параметр Dimensions to pad.

Каждый элемент вектора Output size дает выходную длину для соответствующей размерности в векторе Dimensions to pad.

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

Зависимости

Чтобы использовать этот параметр, установите для параметра Pad over значение Specified dimensions, для параметра Specify значение Output size, а для параметра Dimensions to pad скалярное значение.

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

1

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

OutputSize

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

Нет

Вычисляемый

Да

# Pad size at beginning — количество значений для добавления к началу входного сигнала
Int64 integer

Details

Укажите, сколько значений нужно добавить к началу входного сигнала по указанным размерностям. Этот параметр должен быть скаляром или вектором с тем же количеством элементов, что и параметр Dimensions to pad. Каждый элемент параметра Pad size at beginning дает значение для добавления в начале соответствующей размерности в параметре Dimensions to pad. Значения этого параметра должны быть неотрицательными целыми числами.

Зависимости

Чтобы использовать этот параметр, установите для параметра Pad over значение Specified dimensions, для параметра Specify значение Pad size, а для параметра Dimensions to pad скалярное значение.

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

0

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

PadSizeAtBeginning

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

Нет

Вычисляемый

Да

# Pad size at end — количество значений для добавления к концу входного сигнала
Int64 integer

Details

Укажите, сколько значений нужно добавить к концу входного сигнала по указанным размерностям. Этот параметр должен быть скаляром или вектором с тем же количеством элементов, что и параметр Dimensions to pad. Каждый элемент параметра Pad size at beginning дает значение для добавления в конце соответствующей размерности в параметре Dimensions to pad. Значения этого параметра должны быть неотрицательными целыми числами.

Зависимости

Чтобы использовать этот параметр, установите для параметра Pad over значение Specified dimensions, для параметра Specify значение Pad size, а для параметра Dimensions to pad скалярное значение.

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

0

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

PadSizeAtEnd

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

Нет

Вычисляемый

Да

# Pad signal at — в каком месте нужно вставить или усечь сигнал
End | Beginning | Beginning and end

Details

Варианты дополнения отсчетами последовательности:

  • End — в конце;

  • Beginning — в начале;

  • Beginning and end — в начале и в конце. В этом случае половина длины дополнения добавляется к началу сигнала, а другая половина — к его концу. При нечетной длине дополнения дополнительное значение добавляется к концу сигнала. При задании усечения сигнала в этом режиме из начала и конца сигнала усекается равное количество значений. В случае нечетной длины усечения лишнее значение удаляется из конца сигнала.

Зависимости

Чтобы использовать этот параметр, установите для параметра Pad over значение Columns, Rows или Columns and rows.

Значения

End | Beginning | Beginning and end

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

End

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

PadSignalAt

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

Нет

Вычисляемый

Нет

# Action when truncation occurs — действие при возникновении усечения
None | Warning | Error

Details

Сообщения при усечении последовательности:

  • None — не выдаются;

  • Warning — выдается предупреждение;

  • Error — выдается сообщение об ошибке.

Зависимости

Чтобы использовать этот параметр, установите для параметра Pad over значение Columns, Rows или Columns and rows.

Значения

None | Warning | Error

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

None

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

ActionWhenTruncationOccurs

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

Нет

Вычисляемый

Нет