# tf.data.experimental.parse_example_dataset

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.14.0/tensorflow/python/data/experimental/ops/parsing_ops.py#L105-L161) |

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

#### 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)

<br />

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

> [!WARNING]
> **Deprecated:** THIS FUNCTION IS DEPRECATED. It will be removed in a future version. Instructions for updating: Use `tf.data.Dataset.map(tf.io.parse_example(...))` instead.

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`,
`SparseTensor`, and `RaggedTensor` objects. `features` is a dict from keys to
`VarLenFeature`, `RaggedFeature`, `SparseFeature`, and `FixedLenFeature`
objects. Each `VarLenFeature` and `SparseFeature` is mapped to a
`SparseTensor`; each `RaggedFeature` is mapped to a `RaggedTensor`; and each
`FixedLenFeature` is mapped to a `Tensor`. See [`tf.io.parse_example`](https://www.tensorflow.org/versions/r2.14/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`, `RaggedFeature`, and `SparseFeature` values. |
| `num_parallel_calls` | (Optional.) A [`tf.int32`](https://www.tensorflow.org/versions/r2.14/api_docs/python/tf#int32) scalar [`tf.Tensor`](https://www.tensorflow.org/versions/r2.14/api_docs/python/tf/Tensor), representing the number of parsing processes to call in parallel. |
| `deterministic` | (Optional.) A boolean controlling whether determinism should be traded for performance by allowing elements to be produced out of order if some parsing calls complete faster than others. If `deterministic` is `None`, the [`tf.data.Options.deterministic`](https://www.tensorflow.org/versions/r2.14/api_docs/python/tf/data/Options#deterministic) dataset option (`True` by default) is used to decide whether to produce elements deterministically. |

<br />

<br />

<br />

<br />

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

<br />

<br />

<br />

<br />

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

<br />