tf.compat.v1.summary.audio

Выводит буфер протокола Summary с аудио.

tf.compat.v1.summary.audio(
    name, tensor, sample_rate, max_outputs=3, collections=None, family=None
)

Переход на TF2

Для обеспечения совместимости при вызове в TF2, когда внешний контекст работает в режиме eager, этот API проверяет наличие подходящего контекста средства записи сводок TF2 и, если он есть, перенаправляет вызов этому средству записи. Подходящий контекст средства записи — это контекст, в котором средство записи задано как средство записи по умолчанию и для step имеется соответствующее непустое значение (см. tf.summary.SummaryWriter.as_default, tf.summary.experimental.set_step или, как альтернативный вариант, tf.compat.v1.train.create_global_step). При перенаправлении аргументы этого вызова передаются реализации TF2 для tf.summary.audio, а возвращаемым значением будет тензор с пустой строкой байтов, чтобы избежать повторной записи сводки. Такое перенаправление выполняется по возможности, и не все аргументы сохраняются. Кроме того:

Операция TF2 выводит данные под одним тегом, который содержит несколько образцов, а не под несколькими тегами (то есть без суффиксов «/0» или «/1»).

Для перехода на TF2 используйте tf.summary.audio. Конкретные шаги по переходу см. в разделе «Перенос использования tf.summary на TF 2.0».

Сопоставление аргументов

Имя аргумента TF1	Имя аргумента TF2	Примечание
`name`	`name`	-
`tensor`	`data`	Теперь для этого аргумента на вход требуется трехмерный `[k, t, c]`, где `k` — число аудиоклипов, `t` — число кадров, а `c` — число каналов. Двумерные входные данные больше не поддерживаются.
`sample_rate`	`sample_rate`	-
-	`step`	Явное монотонное значение шага, которое можно привести к int64. Если оно не указано, используется значение по умолчанию — `tf.summary.experimental.get_step()`.
`max_outputs`	`max_outputs`	-
`collections`	Не поддерживается	-
`family`	Удалено	Для управления префиксом имени сводки используйте `tf.name_scope`.
-	`encoding`	Необязательная константная строка для желаемой кодировки. Актуальный список поддерживаемых аудиоформатов см. в документации `tf.summary.audio`.
-	`description`	Необязательное развернутое описание `str` для сводки. Поддерживается Markdown. По умолчанию — пустая строка.

Описание

Сводка содержит до max_outputs значений сводки с аудио. Аудио создается из tensor, размерность которого должна быть равна 3, а форма — [batch_size, frames, channels], либо размерность должна быть равна 2, а форма — [batch_size, frames]. Предполагается, что значения находятся в диапазоне [-1.0, 1.0], а частота дискретизации равна sample_rate.

Значение tag в выходных protobuf-сообщениях Summary.Value создается на основе имени; суффикс зависит от параметра max_outputs:

Если max_outputs равно 1, тег значения сводки имеет вид «name/audio».
Если max_outputs больше 1, теги значений сводки создаются последовательно: «name/audio/0», «name/audio/1» и т. д.

Аргументы
`name`	Имя создаваемого узла. Также будет использоваться как имя серии в TensorBoard.
`tensor`	Трехмерный `float32` `Tensor` формы `[batch_size, frames, channels]` или двумерный `float32` `Tensor` формы `[batch_size, frames]`.
`sample_rate`	Скалярный `float32` `Tensor`, указывающий частоту дискретизации сигнала в герцах.
`max_outputs`	Максимальное число элементов пакета, для которых создается аудио.
`collections`	Необязательный список ops.GraphKeys. Коллекции, в которые нужно добавить сводку. По умолчанию — [_ops.GraphKeys.SUMMARIES]
`family`	Необязательный параметр; если указан, используется как префикс имени тега сводки и определяет имя вкладки для отображения в TensorBoard.

Возвращает
Скалярный `Tensor` типа `string`. Сериализованный буфер протокола `Summary`.

© 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/api_docs/python/tf/compat/v1/summary/audio