gfile
模块解析单个Example协议。
tf.io.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值。返回值:
可能产生的异常:
ValueError
: if any feature is invalid.用于解析固定长度输入特性的配置。若要将稀疏输入视为密集输入,请提供default_value;否则,对于任何缺少此特性的示例,解析函数都将失败。
域:
shape
:输入数据的形状用于解析可变长度输入特性的配置。
域: