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

Pad

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

pad

Описание

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

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

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

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

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

Порты

Вход

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

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

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

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

Выход

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

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

Тип и сложность выходных данных соответствуют входным.

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

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

Параметры

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

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

  • Columns — столбцы.

  • Rows — строки.

  • Columns and Rows — столбцы и строки.

  • None — нет.

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

Dimensions to pad — размерность, по которой будет производиться дополнение или усечение
1 (по умолчанию) | скаляр | вектор

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

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

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

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

Зависимости

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

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

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

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

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

Pad value — значение для дополнения
0 (по умолчанию) | скаляр

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

Зависимости

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

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

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

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

Зависимости

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

Column size — длина столбца на выходе
1 | скаляр

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

Зависимости

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

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

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

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

Зависимости

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

Row size — длина строки на выходе
1 | скаляр

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

Зависимости

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

Specify — определить длину последовательности
Output size (по умолчанию) | Pad size

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

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

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

Зависимости

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

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

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

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

Зависимости

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

Output size — длина последовательности на выходе
1 | скаляр | вектор

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

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

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

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

Зависимости

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

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

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

Зависимости

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

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

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

Зависимости

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

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

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

  • End — в конце.

  • Beginning — в начале.

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

Зависимости

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

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

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

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

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

Зависимости

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