Live image¶
For scans containing image data, the image widget will be displayed automatically.
A specific widget will be created per detector.
Only the last retrieved data will be displayed, so for a time scan you have to create first ROIs on the MCAs to display data in time.
APIs¶
Here is the available commands which can be used from the BLISS shell.
Get the plot¶
The plot is reachable using the BLISS name of the detector.
f = flint()
ct(tomocam)
f.wait_end_of_scans()
p = f.get_live_plot(image_detector="tomocam")
Interactive data selection¶
This plot provides an API to interact with region of interest.
Colormap¶
An API is provided to custom the colormap.
ct(tomocam)
# Make sure the scan was also completed in flint side
f = flint()
ct(tomocam)
f.wait_end_of_scans()
p = f.get_live_plot(image_detector="tomocam")
p.set_colormap(lut="gray",
vmin=0, vmax="auto",
normalization="log",
autoscale_mode="stddev3")
Logbook¶
p.export_to_logbook()
Markers¶
A marker API is provider to create/update/remove permanent markers.
This markers are controller by BLISS and are persistent. Which is not the case for the interaction API also provided.
If this markers are editable (which is the default), the user can move them
manually with the mouse.
The user can also remove them using the GUI (this could be protected in the future, if requested by beamlines).
# Get a love plot
f = flint()
f.wait_end_of_scans()
ct(tomocam)
p = f.get_live_plot(image_detector="tomocam")
# Create a marker
p.update_marker("my-marker-id", (10, 11), editable=False, text="Hi mom!")
# Move a marker
p.update_marker("my-marker-id", (20, 21))
# Print the actual location of the marker
pos = p.marker_position("my-marker-id")
print(f"x-pos {pos[0]} and y-pos {pos[1]}")
# Remove a marker
p.remove_marker("my-marker-id")
Lima ROI edition¶
A live image widget is usually linked to a 2D Lima detector.
This widget will became the place to edit the ROIs of this detector if it triggered.