Image viewer mk2

Viewer for spectral images, in particular suitable from multispectral optoacoustic tomography.

Installation

pip install image-viewer-mk2

Additional dependencies must be installed separately: happy (currently not publicly available), optional: PyTorch (for GPU-based rendering), pywin32 (Windows clipboard functionality)

Usage

From command line as a standalone application.

> imvmk2 [-i filename] [-c config_filename] [-g (GPU) | -ng (No GPU)] [-d (debug)]

From within python scripts and interactive sessions. The viewer can be either used as an interactive image viewer, giving the user the ability to manually adjust the settings. The rendered image is returned back so that it can be further used inside the script.

import image_viewer_mk2.app as imv

img = np.zeros((height, width, channels))
render = imv.start(image=img)

Alternatively, it can be used to apply existing configuration and directly return a rendered image without opening the interactive GUI:

import image_viewer_mk2.app as imv

img = np.zeros((height, width, channels))
render = imv.render(image=img, config_filename='config.json')

Configuration files can be saved from the interactive GUI or they can be returned as a second return value in the script by passing parameter return_config=True to the call imv.start().

Troubleshooting

TclError: image "pyimageXX" doesn't exist

When using in interactive session, all other matplotlib figures have to be closed. Calling matplotlib.pyplot.close(fig='all') should do the trick.

Credits

This software reuses code and icons produced by: cilame, Benjamin Johnson, Remin Emonet, Icon home, Gregor Cresnar, Freepik, Google, Uptal Barman and Pancracysdh

License

The software is provided under the MIT open license.

Citation

If you use this software for your research, please cite it as:

Kukačka, Jan (2021). Image Viewer MK2 (v0.2.4) [Computer software]. https://github.com/jankukacka/image_viewer_mk2