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 вместо этого. Пожалуйста, ознакомьтесь с Migrating tf.summary usage to 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`	Необязательное подробное описание сводки. Поддерживается Markdown. По умолчанию пустое.

Описание

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

tag в протоколах Summary.Value, выводимых в результате, генерируется на основе имени с суффиксом, зависящим от значения max_outputs:

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

Аргументы
`name`	Имя сгенерированного узла. Также будет использоваться в качестве имени серии в TensorBoard.
`tensor`	3-мерный `float32` `Tensor` формы `[batch_size, frames, channels]` или 2-мерный `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