Skip to content

wright-group/bluesky-cmds

Repository files navigation

bluesky-cmds

PyPI Conda black

A qt-based graphical client for bluesky-queueserver with a focus on coherent multidimensional spectroscopy in the Wright Group.

screenshot

installation

Install the latest released version from PyPI:

$ python3 -m pip install bluesky-cmds

conda-forge and separately installable versions coming soon!

Use flit to install from source.

$ git clone https://github.com/wright-group/bluesky-cmds.git
$ cd bluesky-cmds
$ flit install -s

configuration

bluesky-cmds requires access to two ports:

  • bluesky re-manager
  • bluesky zmq proxy

By default, bluesky-cmds uses the default ports on localhost. This works for most applications. If you require alternatives, configure bluesky-cmds with the following command:

$ bluesky-cmds edit-config

This will open a toml file which you must format as follows:

[bluesky]
re-manager = "localhost:60615"
zmq-proxy = "localhost:5568"

The default values are shown above.

usage

First start bluesky re-manager and zmq-server. You may wish to use bluesky-in-a-box. Then start bluesky-cmds.

Use the queue tab to add or change plans on the queueserver. Note that bluesky-cmds is designed for usage with wright-plans. wright-plans are specialized for coherent multidimensional spectroscopy.

Use the plot tab to watch raw data streaming from bluesky.

Note that direct hardware interaction or configuration is not supported by bluesky-cmds. This application is only for interacting with the queueserver. You may be interested in yaqc-qtpy.

citation

This project is archived using Zenodo. Please use DOI: 10.5281/zenodo.1198910 to cite bluesky-cmds.