TensorFlow函數(shù)教程：tf.io.parse_single_example

tf.io.parse_single_example函數(shù)

別名：

• 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）條目被刪除（它現(xiàn)在是單個元素向量）。

人們可能會通過用parse-example對Example原型進行批處理，可以看到性能優(yōu)勢，而不是直接使用此函數(shù)來看到性能優(yōu)勢。

參數(shù)：

• serialized：標量字符串Tensor，單個序列化Example。
• features：dict映射功能鍵到FixedLenFeature或VarLenFeature值。
• name：此操作的名稱（可選）。
• example_names:（可選）標量字符串Tensor，關聯(lián)名稱。

返回：

一個dict映射功能鍵到Tensor和SparseTensor值。

可能引發(fā)的異常：

• ValueError：如果任何功能無效。