tf.io.parse_single_example
Parses a single Example proto.
tf.io.parse_single_example(
serialized, features, name=None, example_names=None
)
Similar to parse_example, except:
For dense tensors, the returned Tensor is identical to the output of parse_example, except there is no batch dimension, the output shape is the same as the shape given in dense_shape.
For SparseTensors, the first (batch) column of the indices matrix is removed (the indices matrix is a column vector), the values vector is unchanged, and the first (batch_size) entry of the shape vector is removed (it is now a single element vector).
One might see performance advantages by batching Example protos with parse_example instead of using this function directly.
| Args | |
|---|---|
serialized |
A scalar string Tensor, a single serialized Example. See _parse_single_example_raw documentation for more details. |
features |
A dict mapping feature keys to FixedLenFeature or VarLenFeature values. |
name |
A name for this operation (optional). |
example_names |
(Optional) A scalar string Tensor, the associated name. See _parse_single_example_raw documentation for more details. |
| Returns | |
|---|---|
A dict mapping feature keys to Tensor and SparseTensor values. |
| Raises | |
|---|---|
ValueError |
if any feature is invalid. |
© 2020 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r1.15/api_docs/python/tf/io/parse_single_example