napari ARCOS

arcos-gui

A napari plugin to detect and visualize collective signaling events

License PyPI conda-forge Python Version tests codecov napari hub

A napari plugin to detect and visualize collective signaling events


Automated Recognition of Collective Signalling (ARCOS) is an algorithm to identify collective spatial events in time series data. It is available as an R (ARCOS) and python (arcos4py) package. ARCOS can identify and visualize collective protein activation in 2- and 3D cell cultures over time.

This plugin integrates ARCOS into napari. Users can import tracked time-series data in CSV format or load data from napari-layer properties (such as the ones generated with napari-skimage-regionprops. The plugin provides GUI elements to process this data with ARCOS. Layers containing the detected collective events are subsequently added to the viewer.

Following analysis, the user can export the output as a CSV file with the detected collective events or as a sequence of images to generate a movie.

Watch full demo on youtube (older plugin version)

You can install arcos-gui via pip:

pip install arcos-gui

Or via conda-forge:

conda install -c conda-forge arcos-gui

Usage

The plugin can be started from the napari menu Plugins > ARCOS GUI. For detailed instructions on how to use the plugin, please refer to the Usage section of the documentation.

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. See the Contributing Guide for more information.

License

Distributed under the terms of the BSD-3 license, "arcos-gui" is free and open-source software

Issues

If you encounter any problems, please file an issue along with a detailed description.

Credits

We were able to develop this plugin in part due to funding from the CZI napari Plugin Foundation Grant.

This napari plugin was generated with Cookiecutter using @napari's cookiecutter-napari-plugin template.

Citation

If you use this plugin in your research, please cite the following paper:

@article{10.1083/jcb.202207048,
    author = {Gagliardi, Paolo Armando and Grädel, Benjamin and Jacques, Marc-Antoine and Hinderling, Lucien and Ender, Pascal and Cohen, Andrew R. and Kastberger, Gerald and Pertz, Olivier and Dobrzyński, Maciej},
    title = "{Automatic detection of spatio-temporal signaling patterns in cell collectives}",
    journal = {Journal of Cell Biology},
    volume = {222},
    number = {10},
    pages = {e202207048},
    year = {2023},
    month = {07},
    abstract = "{Increasing experimental evidence points to the physiological importance of space–time correlations in signaling of cell collectives. From wound healing to epithelial homeostasis to morphogenesis, coordinated activation of biomolecules between cells allows the collectives to perform more complex tasks and to better tackle environmental challenges. To capture this information exchange and to advance new theories of emergent phenomena, we created ARCOS, a computational method to detect and quantify collective signaling. We demonstrate ARCOS on cell and organism collectives with space–time correlations on different scales in 2D and 3D. We made a new observation that oncogenic mutations in the MAPK/ERK and PIK3CA/Akt pathways of MCF10A epithelial cells hyperstimulate intercellular ERK activity waves that are largely dependent on matrix metalloproteinase intercellular signaling. ARCOS is open-source and available as R and Python packages. It also includes a plugin for the napari image viewer to interactively quantify collective phenomena without prior programming experience.}",
    issn = {0021-9525},
    doi = {10.1083/jcb.202207048},
    url = {https://doi.org/10.1083/jcb.202207048},
    eprint = {https://rupress.org/jcb/article-pdf/222/10/e202207048/1915749/jcb/_202207048.pdf},
}

Version:

  • 0.1.4

Last updated:

  • 12 September 2024

First released:

  • 24 February 2022

License:

Supported data:

  • Information not submitted

Plugin type:

GitHub activity:

  • Stars: 6
  • Forks: 1
  • Issues + PRs: 0

Python versions supported:

Operating system:

Requirements:

  • arcos4py>=0.2.3
  • matplotlib>=3.3.4
  • napari>=0.4.14
  • pandas>=1.3.5
  • pyarrow>=11.0.0
  • scipy>=1.7.3
  • napari-timestamper
  • numpy<2,>=1.22.2; python_version < "3.10"
  • scikit-image>=0.20.0; python_version < "3.12"
  • numpy>=1.22.2; python_version >= "3.10"
  • scikit-image>=0.22.0; python_version >= "3.12"