Skip to main content

iterlab

You are a scientist, not a software developer, focus on what matters to you! Science and research are iterative processes and they require a lot of graphs, plots and inputs, data processing and algorithm revisions. IterLab is the tool that lets you focus on your work, not on the visualization and GUI code - those are made for you seamlessly.

What this means in practice

  • Layout is drawn, never programmed. Drag, drop, resize. No GUI code, ever.
  • Add code? Change layout? No problem! — We know science is iterative and constantly changes. Start with one plot and go from there. The magic happens because we create two separate files, a .yaml and a .py sharing a name. Rearranging the interface cannot disturb your code, and editing your code cannot disturb the interface. The only link between them is an element's tag.
  • No need to re-run the script when you change code! Yes you heard correctly, change your algorithm, add axis labels, no need to re-run the app, no need to reload from scratch! save hours and hours without losing anything already in memory — loaded data, computed results, and plots already drawn all survive.
  • Made a bug? Just fix it without re-running heavy code Code bugs and typos are part of life, that doesn’t mean you should waste time re-running heavy code. Everything survives and stays in memory until you fix the code and continue from where you left off. Restarting is the cost the tool exists to remove.

Usage

pip install iterlab
iterlab demo

One command. A new interface opens in editor mode: a blank canvas, a palette of element types, and a properties panel. Drag out an axes and a button, tag them, then click the toggle in the top-left corner to switch to GUI mode and use what you drew.

demo.py is yours. iterlab appends a handler stub for the elements that need one, and never touches anything else. Assume an axes tagged spectrum and a button tagged run_fit:

import numpy as np

def on_startup(ev):
    ev.x = np.linspace(0, 10, 500)      # loaded once per session, accessible from anywhere in your code
    ev.spectrum.plot(ev.x, np.sin(ev.x))

def on_clicked_run_fit(ev, event):
    ev.spectrum.clear()
    ev.spectrum.plot(ev.x, np.sin(2 * ev.x))

Edit that file while the window is open, click the button, and the new code runs — no restart, and ev.x is never reloaded. Make a typo and the session survives, tells you what broke, and lets you fix it and carry on.

ev is yours to fill: anything you assign to it lives for the session. Each element is reachable on it under the tag you gave it in the designer, and an axes is a matplotlib Axes — not a wrapper around one — so every call you already know works, and any library taking an ax= argument accepts it.

On Linux, tkinter is packaged separately: apt install python3-tk or dnf install python3-tkinter.

New here? GUIDE.md walks through installing, drawing your first interface, and the code API for every element.

Status

Early, and honest about it. The end-to-end loop is implemented and tested, with five element types: axes, button, label, text box, number box. Checkboxes, radio buttons, dropdowns, lists and sliders are next.

Built on

Tk and matplotlib, both used deliberately: Tk for every control, matplotlib for plots only.

License

Apache License 2.0. You may use, modify, and redistribute this code, including in closed-source and commercial work. If you do, you must retain the copyright notice, the license, and the NOTICE file, and state which files you changed.

Metadata

Release files for iterlab 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iterlab 1.0.0
File Size Uploaded Provenance
iterlab-1.0.0.tar.gz 279.6 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for iterlab 1.0.0
File Interpreter ABI Platform
iterlab-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 462.3 kB

Release files / iterlab-1.0.0.tar.gz

Download URL iterlab-1.0.0.tar.gz
Size 279.6 kB
Tags Source
SHA-256 checksum
How to use checksums
0a048944c93b2f8f897bcba8565228d68bb8953949649f36e1c86fad9c0aea9d
BLAKE2b-256 checksum
How to use checksums
c0bf13d452d2973fc44fd226e460e71b268a50f5bdc407261bedb2e2a50c8d17
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.9

Release files / iterlab-1.0.0-py3-none-any.whl

Download URL iterlab-1.0.0-py3-none-any.whl
Size 182.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b625351b150717560c8a39cba8a032c7e608db3e34ed463e6aec988c7ddf9461
BLAKE2b-256 checksum
How to use checksums
63548461d6c5e4f0ff0d209facbf34a609e0b001933126c2025f5ec2738bed91
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.9

Security for iterlab 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page