<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.15.1/tensorflow/dtensor/python/api.py#L167-L188) |

Copies a tf.Tensor onto the DTensor device with the given layout.

```python
tf.experimental.dtensor.copy_to_mesh(
    tensor: Any,
    layout: `tf.experimental.dtensor.Layout`,
    source_layout: Optional[`tf.experimental.dtensor.Layout`] = None
) -> `tf.Tensor`
```

Copies a regular tf.Tensor onto the DTensor device. Use the mesh attached to
`layout` as target mesh. This method currently only supports replicated
layouts, or one-to-one copies for sharded layouts.

<br />

<br />

<br />

| ## Args ||
|---|---|
| `tensor` | A regular tf.Tensor to be copied as a DTensor. |
| `layout` | Target layout (and mesh) for the result DTensor. |
| `source_layout` | Source layout of the tensor before copy. This argument is deprecated. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A DTensor on the DTensor device with the given layout. ||

<br />