# tf.data.experimental.parse_example_dataset

<br />

|---|---|
| [![](https://www.tensorflow.org/images/tf_logo_32px.png) TensorFlow 2 version](https://www.tensorflow.org/api_docs/python/tf/data/experimental/parse_example_dataset) | [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v1.15.0/tensorflow/python/data/experimental/ops/parsing_ops.py#L101-L146) |

A transformation that parses `Example` protos into a `dict` of tensors.

#### View aliases


**Compat aliases for migration**

See
[Migration guide](https://www.tensorflow.org/guide/migrate) for
more details.

[`tf.compat.v1.data.experimental.parse_example_dataset`](https://www.tensorflow.org/api_docs/python/tf/data/experimental/parse_example_dataset), \`tf.compat.v2.data.experimental.parse_example_dataset\`

<br />

    tf.data.experimental.parse_example_dataset(
        features, num_parallel_calls=1
    )

Parses a number of serialized `Example` protos given in `serialized`. We refer
to `serialized` as a batch with `batch_size` many entries of individual
`Example` protos.

This op parses serialized examples into a dictionary mapping keys to `Tensor`
and `SparseTensor` objects. `features` is a dict from keys to `VarLenFeature`,
`SparseFeature`, and `FixedLenFeature` objects. Each `VarLenFeature`
and `SparseFeature` is mapped to a `SparseTensor`, and each
`FixedLenFeature` is mapped to a `Tensor`. See [`tf.io.parse_example`](https://www.tensorflow.org/versions/r1.15/api_docs/python/tf/io/parse_example) for more
details about feature dictionaries.

<br />

<br />

<br />

| ## Args ||
|---|---|
| `features` | A `dict` mapping feature keys to `FixedLenFeature`, `VarLenFeature`, and `SparseFeature` values. |
| `num_parallel_calls` | (Optional.) A [`tf.int32`](https://www.tensorflow.org/versions/r1.15/api_docs/python/tf#int32) scalar [`tf.Tensor`](https://www.tensorflow.org/versions/r1.15/api_docs/python/tf/Tensor), representing the number of parsing processes to call in parallel. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A dataset transformation function, which can be passed to [`tf.data.Dataset.apply`](https://www.tensorflow.org/versions/r1.15/api_docs/python/tf/data/Dataset#apply). ||

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `ValueError` | if features argument is None. |

<br />