tf.summary.text
Stay organized with collections
Save and categorize content based on your preferences.
Write a text summary.
tf.summary.text(
name, data, step=None, description=None
)
Used in the notebooks
See also tf.summary.scalar
, tf.summary.SummaryWriter
, tf.summary.image
.
Writes text Tensor values for later visualization and analysis in TensorBoard.
Writes go to the current default summary writer. Like tf.summary.scalar
points, text points are each associated with a step
and a name
.
All the points with the same name
constitute a time series of text values.
For Example:
test_summary_writer = tf.summary.create_file_writer('test/logdir')
with test_summary_writer.as_default():
tf.summary.text('first_text', 'hello world!', step=0)
tf.summary.text('first_text', 'nice to meet you!', step=1)
The text summary can also contain Markdown, and TensorBoard will render the
text
as such.
with test_summary_writer.as_default():
text_data = '''
| *hello* | *there* |
|---------|---------|
| this | is |
| a | table |
'''
text_data = '\n'.join(l.strip() for l in text_data.splitlines())
tf.summary.text('markdown_text', text_data, step=0)
Since text is Tensor valued, each text point may be a Tensor of string values.
rank-1 and rank-2 Tensors are rendered as tables in TensorBoard. For higher
ranked
Tensors, you'll see just a 2D slice of the data. To avoid this, reshape the
Tensor
to at most rank-2 prior to passing it to this function.
Demo notebook at
"Displaying text data in
TensorBoard".
Arguments |
name
|
A name for this summary. The summary tag used for TensorBoard will be
this name prefixed by any active name scopes.
|
data
|
A UTF-8 string Tensor value.
|
step
|
Explicit int64 -castable monotonic step value for this summary. If
omitted, this defaults to tf.summary.experimental.get_step() , which must
not be None.
|
description
|
Optional long-form description for this summary, as a constant
str . Markdown is supported. Defaults to empty.
|
Returns |
True on success, or false if no summary was emitted because no default
summary writer was available.
|
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. Some content is licensed under the numpy license.
Last updated 2024-04-26 UTC.
[null,null,["Last updated 2024-04-26 UTC."],[],[],null,["# tf.summary.text\n\n\u003cbr /\u003e\n\n|----------------------------------------------------------------------------------------------------------------------------------|\n| [View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.16.1/tensorflow/python/summary/tb_summary.py#L306-L374) |\n\nWrite a text summary. \n\n tf.summary.text(\n name, data, step=None, description=None\n )\n\n### Used in the notebooks\n\n| Used in the tutorials |\n|------------------------------------------------------------------------------------------------|\n| - [Displaying text data in TensorBoard](https://www.tensorflow.org/tensorboard/text_summaries) |\n\nSee also [`tf.summary.scalar`](../../tf/summary/scalar), [`tf.summary.SummaryWriter`](../../tf/summary/SummaryWriter), [`tf.summary.image`](../../tf/summary/image).\n\nWrites text Tensor values for later visualization and analysis in TensorBoard.\nWrites go to the current default summary writer. Like [`tf.summary.scalar`](../../tf/summary/scalar)\npoints, text points are each associated with a `step` and a `name`.\nAll the points with the same `name` constitute a time series of text values.\n\n#### For Example:\n\n test_summary_writer = tf.summary.create_file_writer('test/logdir')\n with test_summary_writer.as_default():\n tf.summary.text('first_text', 'hello world!', step=0)\n tf.summary.text('first_text', 'nice to meet you!', step=1)\n\nThe text summary can also contain Markdown, and TensorBoard will render the\ntext\nas such. \n\n with test_summary_writer.as_default():\n text_data = '''\n | *hello* | *there* |\n |---------|---------|\n | this | is |\n | a | table |\n '''\n text_data = '\\n'.join(l.strip() for l in text_data.splitlines())\n tf.summary.text('markdown_text', text_data, step=0)\n\nSince text is Tensor valued, each text point may be a Tensor of string values.\nrank-1 and rank-2 Tensors are rendered as tables in TensorBoard. For higher\nranked\nTensors, you'll see just a 2D slice of the data. To avoid this, reshape the\nTensor\nto at most rank-2 prior to passing it to this function.\n\nDemo notebook at\n[\"Displaying text data in\nTensorBoard\"](https://www.tensorflow.org/tensorboard/text_summaries).\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Arguments --------- ||\n|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | A name for this summary. The summary tag used for TensorBoard will be this name prefixed by any active name scopes. |\n| `data` | A UTF-8 string Tensor value. |\n| `step` | Explicit `int64`-castable monotonic step value for this summary. If omitted, this defaults to [`tf.summary.experimental.get_step()`](../../tf/summary/experimental/get_step), which must not be None. |\n| `description` | Optional long-form description for this summary, as a constant `str`. Markdown is supported. Defaults to empty. |\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Returns ------- ||\n|---|---|\n| True on success, or false if no summary was emitted because no default summary writer was available. ||\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Raises ------ ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| `ValueError` | if a default writer exists, but no step was provided and [`tf.summary.experimental.get_step()`](../../tf/summary/experimental/get_step) is None. |\n\n\u003cbr /\u003e"]]