mpl-multitab 0.0.1

Tabbed figure manager for matplotlib using pyQt

mpl-multitab

Tabbed figure manager for matplotlib using pyQt

Ever struggle to navigate between a myriad of open matplotlib figures? I know your pain...

mpl-multitab is a simple application that allows you to embed mutliple figures in a tabbed figure manager, keeping everything neatly in one place.

Install

Using pip:

pip install mpl-multitab

Alternatively, clone the repo, then run the setup.py script

git clone https://github.com/astromancer/mpl-multitab.git
cd mpl-multitab
python setup.py install

Use

Interactive use

At the start of your jupyter notebook, or ipython session, run the line magic to set the qt5 backend

%matplotlib qt5

Then

from mpl_multitab import MplMultiTab


ui = MplMultiTab()

n = 100
colours = 'rgb'
for c in colours:
    fig, ax = plt.subplots()
    ax.scatter(*np.random.randn(2, n), color=c)
    ui.add_tab(fig, c)
ui.show()

In a script

import sys
from mpl_multitab import MplMultiTab, QtWidgets


app = QtWidgets.QApplication(sys.argv)
ui = MplMultiTab()

n = 100
colours = 'rgb'
for c in colours:
    fig, ax = plt.subplots()
    ax.scatter(*np.random.randn(2, n), color=c)
    ui.add_tab(fig, c)
ui.show()
sys.exit(app.exec_())

Groups of Figures

You can group multiple related figures together using the MplMultiTab2D class. This is useful for visualising, for example, multiple datasets each having multiple observations.

ui = MplMultiTab2D()

n = 100
colours = 'rgb'
markers = '123'
for c, m in itt.product(colours, markers):
    fig, ax = plt.subplots()
    ax.scatter(*np.random.randn(2, n), color=c, marker=f'${m}$')
    ui.add_tab(fig, f'Dataset {c.upper()}', f'Observation {m}')
ui.show()

In this example all the datasets contain the same number of obervations, but this need not be the case in general.

Test

Current tests are just the scripted examples above

python tests/test_multitab.py
python tests/test_multitab_2d.py

Contribute

Contributions are welcome!

1. Fork it!
2. Create your feature branch
   git checkout -b feature/rad
3. Commit your changes
   git commit -am 'Add some cool feature 😎'
4. Push to the branch
   git push origin feature/rad
5. Create a new Pull Request

Contact

• e-mail: [e-mail]

License

• see LICENSE

Version

This project uses semantic versioning. The latest version is

• 0.0.1