&VfERdZddlZddlmZddlmZddlm Z ddl m Z d dZ d dZ dS) zEText summaries and TensorFlow operations to create them, V2 versions.N)tf2) summary_pb2)metadata) tensor_utilctjd|}ttjjddptjj}||d||g5\}}tj|tj tj ||||cdddS#1swxYwYdS)am Write a text summary. 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: ```python 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. ```python 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"](https://www.tensorflow.org/tensorboard/text_summaries). 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. Raises: ValueError: if a default writer exists, but no step was provided and `tf.summary.experimental.get_step()` is None. N display_name description summary_scope text_summary)values)tagtensorstepr) rcreate_summary_metadatagetattrtfsummary experimentalr debugging assert_typestringwrite)namedatarr summary_metadatar r_s `/var/www/html/software/conda/lib/python3.11/site-packages/tensorboard/plugins/text/summary_v2.pytextrs v 7{  '$?? $ : # t^T4L A A A Xc1   ry111zDt6F                     sAB55B9<B9c tj|tj}n"#t$r}t d|d}~wwxYwt jd|}tj}|j ||||S)aCreate a text tf.Summary protobuf. Arguments: tag: String tag for the summary. data: A Python bytestring (of type bytes), a Unicode string, or a numpy data array of those types. description: Optional long-form description for this summary, as a `str`. Markdown is supported. Defaults to empty. Raises: TypeError: If the type of the data is unsupported. Returns: A `tf.Summary` protobuf object. )dtypeztensor must be of type stringNr)rrr) rmake_tensor_protonpobject_ TypeErrorrrrSummaryvalueadd)rrr rerrs rtext_pbr*ds <.t2:FFF <<<7;;;<7{!##G M#(8HHH Ns # A=A)NN)N)__doc__numpyr#tensorboard.compatrrtensorboard.compat.protortensorboard.plugins.textrtensorboard.utilrrr*rr3sLK((((((000000------((((((G G G G Tr2