tf.summary.audio
Stay organized with collections
Save and categorize content based on your preferences.
Outputs a Summary
protocol buffer with audio.
tf.summary.audio(
name, tensor, sample_rate, max_outputs=3, collections=None, family=None
)
The summary has up to max_outputs
summary values containing audio. The
audio is built from tensor
which must be 3-D with shape [batch_size,
frames, channels]
or 2-D with shape [batch_size, frames]
. The values are
assumed to be in the range of [-1.0, 1.0]
with a sample rate of
sample_rate
.
The tag
in the outputted Summary.Value protobufs is generated based on the
name, with a suffix depending on the max_outputs setting:
- If
max_outputs
is 1, the summary value tag is 'name/audio'.
- If
max_outputs
is greater than 1, the summary value tags are
generated sequentially as 'name/audio/0', 'name/audio/1', etc
Args |
name
|
A name for the generated node. Will also serve as a series name in
TensorBoard.
|
tensor
|
A 3-D float32 Tensor of shape [batch_size, frames, channels]
or a 2-D float32 Tensor of shape [batch_size, frames] .
|
sample_rate
|
A Scalar float32 Tensor indicating the sample rate of the
signal in hertz.
|
max_outputs
|
Max number of batch elements to generate audio for.
|
collections
|
Optional list of ops.GraphKeys. The collections to add the
summary to. Defaults to [_ops.GraphKeys.SUMMARIES]
|
family
|
Optional; if provided, used as the prefix of the summary tag name,
which controls the tab name used for display on Tensorboard.
|
Returns |
A scalar Tensor of type string . The serialized Summary protocol
buffer.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2020-10-01 UTC.
[null,null,["Last updated 2020-10-01 UTC."],[],[],null,["# tf.summary.audio\n\n\u003cbr /\u003e\n\n|-----------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------|\n| [TensorFlow 2 version](/api_docs/python/tf/summary/audio) | [View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v1.15.0/tensorflow/python/summary/summary.py#L184-L230) |\n\nOutputs a `Summary` protocol buffer with audio.\n\n#### View aliases\n\n\n**Compat aliases for migration**\n\nSee\n[Migration guide](https://www.tensorflow.org/guide/migrate) for\nmore details.\n\n[`tf.compat.v1.summary.audio`](/api_docs/python/tf/compat/v1/summary/audio)\n\n\u003cbr /\u003e\n\n tf.summary.audio(\n name, tensor, sample_rate, max_outputs=3, collections=None, family=None\n )\n\nThe summary has up to `max_outputs` summary values containing audio. The\naudio is built from `tensor` which must be 3-D with shape `[batch_size,\nframes, channels]` or 2-D with shape `[batch_size, frames]`. The values are\nassumed to be in the range of `[-1.0, 1.0]` with a sample rate of\n`sample_rate`.\n\nThe `tag` in the outputted Summary.Value protobufs is generated based on the\nname, with a suffix depending on the max_outputs setting:\n\n- If `max_outputs` is 1, the summary value tag is '*name*/audio'.\n- If `max_outputs` is greater than 1, the summary value tags are generated sequentially as '*name* /audio/0', '*name*/audio/1', etc\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Args ---- ||\n|---------------|---------------------------------------------------------------------------------------------------------------------------------|\n| `name` | A name for the generated node. Will also serve as a series name in TensorBoard. |\n| `tensor` | A 3-D `float32` `Tensor` of shape `[batch_size, frames, channels]` or a 2-D `float32` `Tensor` of shape `[batch_size, frames]`. |\n| `sample_rate` | A Scalar `float32` `Tensor` indicating the sample rate of the signal in hertz. |\n| `max_outputs` | Max number of batch elements to generate audio for. |\n| `collections` | Optional list of ops.GraphKeys. The collections to add the summary to. Defaults to \\[_ops.GraphKeys.SUMMARIES\\] |\n| `family` | Optional; if provided, used as the prefix of the summary tag name, which controls the tab name used for display on Tensorboard. |\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Returns ------- ||\n|---|---|\n| A scalar `Tensor` of type `string`. The serialized `Summary` protocol buffer. ||\n\n\u003cbr /\u003e"]]