阅读(10k) 书签 (0)

TensorFlow函数教程:tf.io.parse_single_example

2019-02-21 16:21 更新

tf.io.parse_single_example函数

别名:

  • tf.io.parse_single_example
  • tf.parse_single_example
tf.io.parse_single_example(
    serialized,
    features,
    name=None,
    example_names=None
)

定义在:tensorflow/python/ops/parsing_ops.py。

解析一个Example原型。

类似于parse_example,但以下情况除外:

对于密集张量,返回的Tensor与parse_example的输出相同,除了没有批处理维度,输出shape与dense_shape中给出的shape相同。

对于SparseTensors,删除索引矩阵的第一个(批处理)列(索引矩阵是列向量),值向量不变,并且shape向量的第一个(batch_size)条目被删除(它现在是单个元素向量)。

人们可能会通过用parse-example对Example原型进行批处理,可以看到性能优势,而不是直接使用此函数来看到性能优势。

参数:

  • serialized:标量字符串Tensor,单个序列化Example。
  • features:dict映射功能键到FixedLenFeature或VarLenFeature值。
  • name:此操作的名称(可选)。
  • example_names:(可选)标量字符串Tensor,关联名称。

返回:

一个dict映射功能键到Tensor和SparseTensor值。

可能引发的异常:

  • ValueError:如果任何功能无效。