napari prism
A Python package for the inteRactive and Integrated analySis of Multiplexed tissue microarrays
NOTE: PRISM is still in heavy development. PRISM or napari-prism is a package and napari plugin designed for interactive processing, analysing and visualising multiplxed tissue microarrays.
Currently, end-to-end capabilities (i.e. starting from importing the raw image file, to basic spatial analysis of annotated cells) are available for images generated from the Akoya Phenocycler™-Fusion platform. However, the modular structure of the package allows for usage at any stage of processing and/or analysis, given a pre-built SpatialData object using readers from either spatialdata-io or sopa.
PRISM uses spatialdata as the core data framework, allowing for:
- The rich integration of tools from the (scverse) Python bioinformatics ecosystem with highly interactive graphical user interfaces from napari and napari-spatialdata.
- The storage of images, shapes, annotations and their linked
AnnData
objects in a standardized, FAIR-compliant data structure, addressing the non-standard and fragmented organization of files before, during, and after a multiplexed image analysis pipeline.
The package was designed to be used completely within the napari application and therefore require little to no knowledge of Python programming. Therefore, documentation for usage via the API is currently in progress.
Installation: CPU only¶
Install this package via pip:
pip install napari-prism
Install the latest development version:
pip install git+https://github.com/clinicalomx/napari-prism.git@main
Installation: GPU-accelerated¶
General computations with RAPIDS and rapids-singlecell¶
General larger scale and/or computationally demanding functions can be accelerated with the NVIDIA RAPIDS suite. We utilise some packages from this suite, as well as the GPU-accelerated implementation of scanpy with rapids-singlecell.
- Check and configure the system requirements from RAPIDS.
- Install the package together with RAPIDS and rapids-singlecell via pip:
pip install napari-prism[gpu] --extra-index-url=https://pypi.nvidia.com
Cell segmentation with Cellpose¶
To run cellpose on the GPU, install the CUDA version of PyTorch. You may need to remove any installed CPU versions of PyTorch.
Getting Started¶
To start using napari-prism
, please see the tutorials:
- Getting started
- To learn how to interactively analyse raw .qptiff TMAs, see TMA Image Analysis
- To learn how to interactively analyse AnnData-contained SpatialData objects, see Anndata Analysis
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 MIT license, "napari-prism" is free and open source software
Issues¶
If you encounter any problems, please file an issue along with a detailed description.
Citation¶
**tba
GitHub activity:
- Stars: 3
- Forks: 0
- Issues + PRs: 2
GitHub activity:
- Stars: 3
- Forks: 0
- Issues + PRs: 2
Requirements:
- numpy
- magicgui
- qtpy
- scikit-image
- spatialdata<=0.2.5.post0
- imagecodecs
- napari[all]>=0.4.19.post1
- napari_matplotlib<2.0.2
- napari_spatialdata
- qtpy
- matplotlib
- PyComplexHeatmap
- scikit-learn
- cellpose>=3.0.10
- scanpy>=1.10.0
- phenograph
- squidpy
- kneed
- xarray<=2024.7.0