tf.parse_single_example

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

解析一个示例原型。

类似parse_example，除了:

对于稠密张量，返回的张量与parse_example的输出相同，除了没有批处理维数，输出形状与dense_shape中给出的形状相同。

对于稀疏量，删除索引矩阵的第一个(batch)列(索引矩阵是列向量)，值向量不变，删除形状向量的第一个(batch_size)条目(现在是单个元素向量)。

可以通过使用parse_example批量处理示例原型而不是直接使用这个函数来看到性能优势。

参数:

• serialized: 一个标量字符串张量，一个序列化的例子。有关详细信息，请参见_parse_single_example_raw文档。
• features: dict将特性键映射到FixedLenFeature或VarLenFeature值。
• name: 此操作的名称(可选)。
• example_names: (可选)标量字符串张量，关联的名称。

返回值:

• 一个dict映射特征键到张量和稀疏张量值。

异常:

• ValueError: if any feature is invalid.