# tfr.data.parse_from_tf_example

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/ranking/blob/v0.5.3/tensorflow_ranking/python/data.py#L1348-L1395) |

Parse function to convert [`tf.train.Example`](https://www.tensorflow.org/api_docs/python/tf/train/Example) to feature maps.

    tfr.data.parse_from_tf_example(
        serialized,
        context_feature_spec=None,
        example_feature_spec=None,
        size_feature_name=None,
        mask_feature_name=None
    )

<br />

<br />

<br />

| ## Args ||
|---|---|
| `serialized` | ([`tf.train.Example`](https://www.tensorflow.org/api_docs/python/tf/train/Example)) A serialized proto object containing context and example features. |
| `context_feature_spec` | (dict) A mapping from feature keys to `FixedLenFeature`, `VarLenFeature` or `RaggedFeature` values for context in [`tf.train.Example`](https://www.tensorflow.org/api_docs/python/tf/train/Example) proto. |
| `example_feature_spec` | (dict) A mapping from feature keys to `FixedLenFeature`, `VarLenFeature` or `RaggedFeature` values for examples in [`tf.train.Example`](https://www.tensorflow.org/api_docs/python/tf/train/Example) proto. |
| `size_feature_name` | (str) Name of feature for example list sizes. Populates the feature dictionary with a [`tf.int32`](https://www.tensorflow.org/api_docs/python/tf#int32) Tensor of shape \[batch_size\] for this feature name. If None, which is default, this feature is not generated. |
| `mask_feature_name` | (str) Name of feature for example list masks. Populates the feature dictionary with a [`tf.bool`](https://www.tensorflow.org/api_docs/python/tf#bool) Tensor of shape \[batch_size, list_size\] for this feature name. If None, which is default, this feature is not generated. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A mapping from feature keys to `Tensor`, `SparseTensor` or `RaggedTensor`. ||

<br />