<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.21.0/tensorflow/python/distribute/coordinator/values.py#L152-L182) |

A container that holds a list of values, one value per worker.

#### View aliases


**Main aliases**

[`tf.distribute.coordinator.PerWorkerValue`](https://www.tensorflow.org/api_docs/python/tf/distribute/experimental/coordinator/PerWorkerValues)

<br />

    tf.distribute.experimental.coordinator.PerWorkerValues(
        values
    )

[`tf.distribute.experimental.coordinator.PerWorkerValues`](https://www.tensorflow.org/api_docs/python/tf/distribute/experimental/coordinator/PerWorkerValues) contains a collection
of values, where each of the values is located on its corresponding worker,
and upon being used as one of the `args` or `kwargs` of
[`tf.distribute.experimental.coordinator.ClusterCoordinator.schedule()`](https://www.tensorflow.org/api_docs/python/tf/distribute/experimental/coordinator/ClusterCoordinator#schedule), the
value specific to a worker will be passed into the function being executed at
that corresponding worker.

Currently, the only supported path to create an object of
[`tf.distribute.experimental.coordinator.PerWorkerValues`](https://www.tensorflow.org/api_docs/python/tf/distribute/experimental/coordinator/PerWorkerValues) is through calling
`iter` on a [`ClusterCoordinator.create_per_worker_dataset`](https://www.tensorflow.org/api_docs/python/tf/distribute/experimental/coordinator/ClusterCoordinator#create_per_worker_dataset)-returned
distributed dataset instance. The mechanism to create a custom
[`tf.distribute.experimental.coordinator.PerWorkerValues`](https://www.tensorflow.org/api_docs/python/tf/distribute/experimental/coordinator/PerWorkerValues) is not yet supported.