<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/datasets/blob/v4.9.10/tensorflow_datasets/core/dataset_utils.py#L166-L202) |

Converts a [`tf.data.Dataset`](https://www.tensorflow.org/api_docs/python/tf/data/Dataset) to an iterable of NumPy arrays.

    tfds.as_numpy(
        dataset: Tree[TensorflowElem]
    ) -> Tree[NumpyElem]

### Used in the notebooks

| Used in the tutorials |
|---|
| - [TensorFlow Datasets](https://www.tensorflow.org/datasets/overview) - [Text Classification with Movie Reviews](https://www.tensorflow.org/hub/tutorials/tf2_text_classification) - [Assess privacy risks with the TensorFlow Privacy Report](https://www.tensorflow.org/responsible_ai/privacy/tutorials/privacy_report) - [Distributed Inference with JAX](https://www.tensorflow.org/probability/examples/Distributed_Inference_with_JAX) - [Generating Images with BigBiGAN](https://www.tensorflow.org/hub/tutorials/bigbigan_with_tf_hub) |

`as_numpy` converts a possibly nested structure of [`tf.data.Dataset`](https://www.tensorflow.org/api_docs/python/tf/data/Dataset)s
and [`tf.Tensor`](https://www.tensorflow.org/api_docs/python/tf/Tensor)s to iterables of NumPy arrays and NumPy arrays, respectively.

Note that because TensorFlow has support for ragged tensors and NumPy has
no equivalent representation,
[`tf.RaggedTensor`s](https://www.tensorflow.org/api_docs/python/tf/RaggedTensor)
are left as-is for the user to deal with them (e.g. using `to_list()`).
In TF 1 (i.e. graph mode), [`tf.RaggedTensor`](https://www.tensorflow.org/api_docs/python/tf/RaggedTensor)s are returned as
`tf.ragged.RaggedTensorValue`s.

#### Example:

    ds = tfds.load(name="mnist", split="train")
    ds_numpy = tfds.as_numpy(ds)  # Convert `tf.data.Dataset` to Python generator
    for ex in ds_numpy:
      # `{'image': np.array(shape=(28, 28, 1)), 'labels': np.array(shape=())}`
      print(ex)

<br />

<br />

<br />

| ## Args ||
|---|---|
| `dataset` | a possibly nested structure of [`tf.data.Dataset`](https://www.tensorflow.org/api_docs/python/tf/data/Dataset)s and/or [`tf.Tensor`](https://www.tensorflow.org/api_docs/python/tf/Tensor)s. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A structure matching `dataset` where [`tf.data.Dataset`](https://www.tensorflow.org/api_docs/python/tf/data/Dataset)s are converted to generators of NumPy arrays and [`tf.Tensor`](https://www.tensorflow.org/api_docs/python/tf/Tensor)s are converted to NumPy arrays. ||

<br />