# xarray.Dataset.swap_dims

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

Returns 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.

### Examples

<div class="try_examples_button_container"><button class="try_examples_button" onclick="window.tryExamplesShowIframe('0cd95441-9e09-4f80-9a83-542f9ee90444','af7dc0b7-4778-4787-9624-7fafd822229d','7862b579-3f87-4e81-9487-4054f00308e3','../lite/tree/../notebooks/index.html?path=208b10f7_1505_40a2_9f6a_166e5914fb2f.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="7862b579-3f87-4e81-9487-4054f00308e3" class="try_examples_outer_iframe  hidden"><div class="try_examples_button_container"><button class="try_examples_button" onclick="window.tryExamplesHideIframe('0cd95441-9e09-4f80-9a83-542f9ee90444','7862b579-3f87-4e81-9487-4054f00308e3')">Go Back</button><button class="try_examples_button" onclick="window.openInNewTab('0cd95441-9e09-4f80-9a83-542f9ee90444','7862b579-3f87-4e81-9487-4054f00308e3')">Open In Tab</button></div><div id="af7dc0b7-4778-4787-9624-7fafd822229d" class="jupyterlite_sphinx_iframe_container"></div></div><script>document.addEventListener("DOMContentLoaded", function() {window.loadTryExamplesConfig("../try_examples.json");});</script>

#### 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)