Neutrino in python

The neutrino module opens Neutrino windows from python: images are numpy arrays, the tools (pans) are driven by the names of their widgets, and the windows are Qt widgets of PySide6. It replaces the PyShell plugin (PythonQt).

from PySide6.QtWidgets import QApplication
import neutrino, numpy as np

app = QApplication([])
w = neutrino.Window()
w.addShowPhys(np.random.rand(512, 512))
w.bufferChanged.connect(lambda: print(w.currentBuffer().mean()))
neutrino.run()

neutrino.run() is app.exec() (it returns when the last window is closed), except in an interactive console: with python -i script.py or ipython -i script.py it returns at once and the console can be used while the windows work (in IPython it switches on %gui qt). In an IPython session started without a script, %gui qt does the same.

Installation

pip install neutrino-toolkit

or a wheel of the CI (pip install neutrino_toolkit-*.whl). It needs python >= 3.10 and installs PySide6 and numpy: the module uses the Qt of PySide6 (the wheels have no Qt). Wheels: Linux x86_64 and aarch64, macOS >= 15 (arm64 and x86_64), Windows x86_64.

From the sources (pip install . in the Neutrino folder, or the cmake build with -DNEUTRINO_PYTHON_MODULE=ON: PYTHONPATH=<build>/python), see CMakeLists.txt and Wheel.cmake here.

Without PySide6 (a module built against another Qt), neutrino.app() creates the QApplication and neutrino.exec() runs it.

Windows: neutrino.Window

• w = neutrino.Window() a new window; neutrino.windows() all of them
• w.addPhys(array, name), w.addShowPhys(array, name) add a 2D array (copied, as float64) and return the Image
• w.currentBuffer() the pixels of the shown image (a numpy copy), w.currentImage() the shown Image, w.images() all of them
• w.fileOpen(filename) returns the list of the Images of the file, w.fileSave(...)
• w.openPan(name) opens a tool (neutrino.plugins() the names), w.getPan(name), w.pans(), w.newPan("name") an empty tool with that name (its title, w.getPan("name")), for PySide widgets: see Pan below
• w.close(ask=False) closes it; w.askCloseUnsaved (False for the windows made in python) asks to save the images not saved
• w.widget() the PySide6 QMainWindow
• the slots of the window by name (e.g. w.getZoom()), Qt properties with w.property(name), w.setProperty(name, value)

Signals (connect(callable), disconnect(callable=None); the callable gets the arguments it accepts): bufferChanged (the Image), physAdd, physDel, physChanged, physReordered, panAdd, panDel, mouseAtMatrix, mouseAtWorld and mouseClickAtWorld ((x, y)), nZoom, colorValue, closeAll, destroyed.

Images: neutrino.Image

• img.array() (or np.asarray(img)) the pixels as a numpy copy, shape (height, width); img.shape
• img.update(array) replaces the pixels (the shape can change)
• img.name, img.shortName, img.origin, img.scale (read and write)
• img.scalePoly = ([c0, c1, c2, ...], [c0, c1, ...]) non-linear axes: along x (and y) the world coordinate is P(p) = c0 + c1·p + c2·p² + ... of the absolute pixel p with the origin at 0, P(p) − P(origin) + c0 otherwise (c0 is the value at the origin). []: linear axis; degree 1 sets the scale and the origin. img.scale is then the mean slope over the image. img.toWorld(x, y) and img.toPixel(wx, wy) convert with them
• img.properties(), img.property(name), img.setProperty(name, value) the properties of the image (e.g. read from the file)
• img.show(), img.close(ask=False), img.window(), img.valid (False once closed)

Tools: neutrino.Pan

• p.get("name"), p.set("name", value), p.button("name") (waits for the calculation it starts): the name of a widget is in square brackets in its tooltip; p.widgets() all the names
• p.getData(...), p.show(), p.close(), p.raise_(), p.window()
• p.results(what=None): the data calculated by the pan, a dict of numpy arrays. By default the curves of its plots ({plot: {graph: {"x": ..., "y": ...}}}, what the name of a plot); Visar gives {"visar": [{"time", "velocity", "velocityError", "reflectivity", ...}, ...], "sop": {...}}, with what "sop", a VISAR number (0 for the first) or its name ("Visar1"). A plugin gives its own by reimplementing nGenericPan::results(QVariant what)
• p.widget() the PySide6 QMainWindow of the tool (e.g. p.widget().findChild(QSpinBox, "name"), or p.widget().setCentralWidget(my_widget) in a pan of w.newPan); p.show() and not p.widget().show(): it also sets the title and the saved values, as for the other pans. A QToolBar added before p.show() with setObjectName("toolBar") gets the buttons of the pans (preferences, help and the gear menu: raise viewer, copy as python, widget names, screenshot, reset)
• its slots by name, Qt properties with p.property(name), p.setProperty(name, value)

From PyShell

Examples

examples/: mouse_follow.py (a PySide window following the mouse), blur.py (scipy filters in new windows), custom_pan.py (a tool with a PySide widget). tests/test_wheel.py is the test of the wheels.