Set the positions of all axes within the current plot based on a previously defined layout.

To apply a layout, use:

>>> l = m.get_layout()
>>> m.set_layout(l)
To save a layout to disc and apply it at a later stage, use
>>> m.get_layout(filepath=<FILEPATH>)
>>> m.set_layout(<FILEPATH>)


The returned list is only a snapshot of the current layout. It can only be re-applied to a given figure if the order at which the axes are created remains the same!


layout (dict, str or pathlib.Path) –

If a dict is provided, it is directly used to define the layout.

If a string or a pathlib.Path object is provided, it will be used to read a previously dumped layout (e.g. with m.get_layout(filepath))