Skip to content

PyPI PyPI - Python Version PyPI - Status License CI codecov uv Ruff Checked with mypy Conventional Commits

redsun

Project status

redsun is usable today, but it's still maturing, so expect breaking changes.

redsun is a Python toolkit for building your own modular software for scientific data acquisition. It builds on the Bluesky ecosystem and makes no assumptions about your hardware, so each lab can build the control software its experiments need.

To learn redsun, start with the tutorials, where you build one application step by step without any hardware.

About redsun

You describe your instrument in Python, and redsun assembles it into an application with a graphical interface. With redsun you can:

  • describe an instrument as devices, presenters and views, and let a session build and connect them;
  • change settings from a session file, without touching code;
  • start and stop the services that drive your hardware, together with the application;
  • run acquisitions as bluesky plans, each with a plan widget built from its parameters;
  • use the built-in components for common tasks, so you write only what is specific to your instrument;
  • give every acquisition file a place and a name, under one folder per session;
  • search past runs in a catalog, if you choose to keep one.

The parts specific to your instrument come from you, or from a plugin you install: the devices and the services behind them, the presenters and views, and the plans for your acquisitions.

redsun isn't a ready-made microscope program. It comes with no hardware drivers and no image viewer, and it leaves writing the data to your devices. Why redsun exists has the details, and compares its parts with those of Micro-Manager.

How the documentation is structured

The documentation follows the Diataxis format and is split into the four sections below. The glossary defines the technical terms it uses.

  • Tutorials


    If you're new to redsun, start here: nine tutorials that build one application step by step.

    Tutorials

  • How-to Guides


    Step-by-step guides, each for one task.

    How-to Guides

  • Explanations


    How redsun works and why it works that way, plus the glossary.

    Explanations

  • Reference


    Facts to look up, such as the API and the release notes.

    Reference