# tf.contrib.framework.nest.flatten_with_tuple_paths

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v1.15.0/tensorflow/python/util/nest.py#L1307-L1327) |

Returns a list of `(tuple_path, leaf_element)` tuples.

    tf.contrib.framework.nest.flatten_with_tuple_paths(
        structure, expand_composites=False
    )

The order of pairs produced matches that of [`nest.flatten`](https://www.tensorflow.org/api_docs/python/tf/nest/flatten). This allows you
to flatten a nested structure while keeping information about where in the
structure each data element was located. See `nest.yield_flat_paths`
for more information about tuple paths.

<br />

<br />

<br />

| ## Args ||
|---|---|
| `structure` | the nested structure to flatten. |
| `expand_composites` | If true, then composite tensors such as tf.SparseTensor and tf.RaggedTensor are expanded into their component tensors. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A list of `(tuple_path, leaf_element)` tuples. Each `tuple_path` is a tuple of indices and/or dictionary keys that uniquely specify the path to `leaf_element` within `structure`. ||

<br />