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。

解析一個(gè)Example原型。

類似于parse_example，但以下情況除外：

對(duì)于密集張量，返回的Tensor與parse_example的輸出相同，除了沒有批處理維度，輸出shape與dense_shape中給出的shape相同。

對(duì)于SparseTensors，刪除索引矩陣的第一個(gè)（批處理）列（索引矩陣是列向量），值向量不變，并且shape向量的第一個(gè)（batch_size）條目被刪除（它現(xiàn)在是單個(gè)元素向量）。

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

參數(shù)：

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

返回：

一個(gè)dict映射功能鍵到Tensor和SparseTensor值。

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

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