A simple plugin to use with napari to simulate raw image stacks in Structured illumination microscopy (SIM) with napari.
Project description
napari-generic-SIMulator
A napari plugin to simulate raw-image stacks of Structured illumination microscopy (SIM).
The simulation is originally based on the paper GPU-accelerated real-time reconstruction in Python of three-dimensional datasets from structured illumination microscopy with hexagonal patterns by Hai Gong, Wenjun Guo and Mark A. A. Neil (https://doi.org/10.1098/rsta.2020.0162).
The calculation can be GPU-accelerated if the CUPY (tested with cupy 8.3.0) is installed. In addition, the TORCH package can complete the acceleration both on CPU if TORCH is installed, and on GPU if TORCH is compiled with the CUDA (tested with torch v1.12.0+cu116) enabled.
Currently applies to:
- conventional 2-beam SIM data with 3 angles and 3 phases
- 3-beam hexagonal SIM data with 7 phases, as described in the paper
- 3-beam hexagonal SIM data with 5 phases at right-angles
This napari plugin was generated with Cookiecutter using @napari's cookiecutter-napari-plugin template.
Installation
You can install napari-generic-SIMulator
via pip:
pip install napari-generic-SIMulator
To install latest development version :
pip install git+https://github.com/Meizhu-Liang/napari-generic-SIMulator.git
Usage
-
Open napari and create the viewer.
-
Launch the widget in Plugin
-
Adjust the parameters in the widget and calculate the raw-image stack.
-
The sum, psf and otf can be showed. Note the all of these correspond the generated raw-image stack, so keep the parameters the same before showing the sum (or psf and otf).
-
The raw image stacks can be then processed by napari-sim-processor (https://www.napari-hub.org/plugins/napari-sim-processor).
Contributing
Contributions are very welcome. Tests can be run with tox, please ensure the coverage at least stays the same before you submit a pull request.
License
Distributed under the terms of the BSD-3 license, "napari-generic-SIMulator" is free and open source software
Issues
If you encounter any problems, please file an issue along with a detailed description.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for napari-generic-SIMulator-0.0.26.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | ac6ad94f3167c18150f46b11cdbf34090c1c035b85dae24b3a5a2984a5de8153 |
|
MD5 | 3e4d860cf4ff40c0c5fa2c55c8d2fa24 |
|
BLAKE2b-256 | 7c1005bf643ae2cd86f5458dcbe56b74b85db1c30a4243ba946e6c2e56be3e9e |
Hashes for napari_generic_SIMulator-0.0.26-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2f913fdf2d2f0d3dcec8b6c88e63afd58c17e500730100f595c8bd8f878f4fc1 |
|
MD5 | 4160779b6d9d49f6840efefc9a6357da |
|
BLAKE2b-256 | 7d37f11094fb33bad6c8756259600785adf64ac92a92529943eda9b8552b8c89 |