# xarray.Dataset.swap_dims

#### Dataset.swap_dims(dims_dict=None, \*\*dims_kwargs)[[source]](https://github.com/pydata/xarray/blob/main/xarray/core/dataset.py#L4630-L4735)

Return a new object with swapped dimensions.

* **Parameters:**
  * **dims_dict** ([dict-like](https://docs.python.org/3/glossary.html#term-mapping)) – Dictionary whose keys are current dimension names and whose values
    are new names.
  * **\*\*dims_kwargs** (`{existing_dim: new_dim, ...}`, *optional*) – The keyword arguments form of `dims_dict`.
    One of dims_dict or dims_kwargs must be provided.
* **Returns:**
  **swapped** ([`Dataset`](xarray.Dataset.html.md#xarray.Dataset)) – Dataset with swapped dimensions.

#### SEE ALSO
[`Dataset.rename`](xarray.Dataset.rename.html.md#xarray.Dataset.rename), [`DataArray.swap_dims`](xarray.DataArray.swap_dims.html.md#xarray.DataArray.swap_dims)

### Examples

<div class="try_examples_button_container"><button class="try_examples_button" onclick="window.tryExamplesShowIframe('f251c7bb-74f9-44d7-992c-fb69f081f273','f3aaf103-fc23-4b15-9887-3e7efa3f940b','c9f374a6-8e3f-44b0-8fa1-0bd0cc119257','../lite/tree/../notebooks/index.html?path=2627e1c8_e270_496b_a81d_9022f7139646.ipynb','None')">Try it in your browser!</button></div>
```pycon
>>> ds = xr.Dataset(
...     data_vars={"a": ("x", [5, 7]), "b": ("x", [0.1, 2.4])},
...     coords={"x": ["a", "b"], "y": ("x", [0, 1])},
... )
>>> ds
<xarray.Dataset> Size: 56B
Dimensions:  (x: 2)
Coordinates:
  * x        (x) <U1 8B 'a' 'b'
    y        (x) int64 16B 0 1
Data variables:
    a        (x) int64 16B 5 7
    b        (x) float64 16B 0.1 2.4
```

```pycon
>>> ds.swap_dims({"x": "y"})
<xarray.Dataset> Size: 56B
Dimensions:  (y: 2)
Coordinates:
  * y        (y) int64 16B 0 1
    x        (y) <U1 8B 'a' 'b'
Data variables:
    a        (y) int64 16B 5 7
    b        (y) float64 16B 0.1 2.4
```

```pycon
>>> ds.swap_dims({"x": "z"})
<xarray.Dataset> Size: 56B
Dimensions:  (z: 2)
Coordinates:
    x        (z) <U1 8B 'a' 'b'
    y        (z) int64 16B 0 1
Dimensions without coordinates: z
Data variables:
    a        (z) int64 16B 5 7
    b        (z) float64 16B 0.1 2.4
```

<div id="c9f374a6-8e3f-44b0-8fa1-0bd0cc119257" class="try_examples_outer_iframe  hidden"><div class="try_examples_button_container"><button class="try_examples_button" onclick="window.tryExamplesHideIframe('f251c7bb-74f9-44d7-992c-fb69f081f273','c9f374a6-8e3f-44b0-8fa1-0bd0cc119257')">Go Back</button><button class="try_examples_button" onclick="window.openInNewTab('f251c7bb-74f9-44d7-992c-fb69f081f273','c9f374a6-8e3f-44b0-8fa1-0bd0cc119257')">Open In Tab</button></div><div id="f3aaf103-fc23-4b15-9887-3e7efa3f940b" class="jupyterlite_sphinx_iframe_container"></div></div><script>document.addEventListener("DOMContentLoaded", function() {window.loadTryExamplesConfig("../try_examples.json");});</script>