Spec-Zone.ru › TensorFlow 2.9

tf.signal.frame

Просмотреть исходный код на GitHub

Расширяет размерность signal в кадры размером frame_length.

Просмотр псевдонимов

Псевдонимы для миграции

Дополнительную информацию см. в руководстве по миграции.

tf.compat.v1.signal.frame

tf.signal.frame(
    signal,
    frame_length,
    frame_step,
    pad_end=False,
    pad_value=0,
    axis=-1,
    name=None
)

Проводит окно размером frame_length по размерности signal с шагом frame_step, заменяя размерность axis на [frames, frame_length] кадров.

Если pad_end равно True, позиции окна, которые выходят за пределы размерности axis, заполняются значениями pad_value, пока окно полностью не выйдет за пределы размерности. В противном случае генерируются только позиции окна, которые полностью перекрывают размерность axis.

Например:

# A batch size 3 tensor of 9152 audio samples.
audio = tf.random.normal([3, 9152])

# Compute overlapping frames of length 512 with a step of 180 (frames overlap
# by 332 samples). By default, only 49 frames are generated since a frame
# with start position j*180 for j > 48 would overhang the end.
frames = tf.signal.frame(audio, 512, 180)
frames.shape.assert_is_compatible_with([3, 49, 512])

# When pad_end is enabled, the final two frames are kept (padded with zeros).
frames = tf.signal.frame(audio, 512, 180, pad_end=True)
frames.shape.assert_is_compatible_with([3, 51, 512])

Если размерность по axis равна N, и pad_end=False, количество кадров может быть вычислено следующим образом:

num_frames = 1 + (N - frame_size) // frame_step

Если pad_end=True, количество кадров может быть вычислено следующим образом:

num_frames = -(-N // frame_step) # ceiling division
Аргументы
signal [..., samples, ...] Tensor. Ранг и размерности могут быть неизвестны. Ранг должен быть не менее 1.
frame_length Длина кадра в выборках. Целое или скалярное значение Tensor.
frame_step Размер шага кадра в выборках. Целое или скалярное значение Tensor.
pad_end Нужно ли заполнять конец signal значениями pad_value.
pad_value Необязательное скалярное значение Tensor для использования, когда входной сигнал отсутствует, если pad_end равно True.
axis Необязательное скалярное целое число Tensor, указывающее ось для разбиения на кадры. По умолчанию последняя ось. Поддерживаются отрицательные значения для индексации с конца.
name Необязательное имя операции.
Возвращаемое значение
Tensor кадров со структурой [..., num_frames, frame_length, ...].
Исключения
ValueError Если frame_length, frame_step, pad_value, или axis не являются скалярными.

© 2022 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 4.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.9/api_docs/python/tf/signal/frame

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API