https://github.com/rosalindfranklininstitute/okapi-em
A napari plugin for processing serial-FIB-SEM data.
A full description of this software is presented in biorXiv preprint paper:
https://doi.org/10.1101/2022.12.15.520541
This napari plugin contains the following tools:
- slice alignment using constrained SIFT
- two charge artifact suppression filters
- directional fourier bandapass filter
- line-by-line filter function optimiser and subtraction (requires charge artifact labels) - uses chafer
- fourier ring correlation (FRC) resolution estimation - uses quoll
This napari plugin was generated with Cookiecutter using @napari's cookiecutter-napari-plugin template.
You can install okapi-em via pip:
>pip install okapi-em
or using napari's plugin installation engine Plugins->Install/Uninstall Plugins... and filter for Okapi-EM.
For installing in development mode , clone this package then navigate to the cloned okapi-em folder and run:
>pip install -e .
Okapi-EM is a napari plugin. Launching napari is therefore required.
>napari
and then navigate Menu->Plugins->Okapi-EM
Note that to launch napari in older versions of python (<=3.7) you will need to use the command:
>python -m napari
Okapi-EM does not require powerful computers to run. None of the tools use GPU accelaration.
The minimum recommended RAM depends on the size of the data being used in napari. For a full image stack of 1Gb, it is recommended that user ensure that 3Gb of RAM is available or can be used. Modern OS's can extend physical RAM using swap memory (Linux) or cache (in Windows and also known as virtual memory), but processing can be significantly slower.
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.
Distributed under the terms of the Apache Software License 2.0 license, "okapi-em" is free and open source software
Please cite usage using the following reference.
Perdigão, L. M. A. et al. Okapi-EM – a napari plugin for processing and analysing cryogenic serial FIB/SEM images. 2022.12.15.520541 Preprint at https://doi.org/10.1101/2022.12.15.520541 (2022).
There is currently a known issue with napari running in Linux machines, that it does not find the OpenGL driver correctly. This will hopefully be resolved in the near future. If you bump into this issue we recommend trying to downgrade the python version. This is not an Okapi-EM problem.
If you encounter any problems, please file an issue along with a detailed description.