Metadata-Version: 2.1
Name: cspot
Version: 1.0.16
Summary: CELL SPOTTER (CSPOT): A scalable framework for automated processing of highly multiplexed tissue images
Home-page: https://pypi.org/project/cspot/
Keywords: image analysis,multiplex imaging,single cell analysis
Author: Ajit Johnson Nirmal
Author-email: ajitjohnson.n@gmail.com
Requires-Python: >=3.9,<3.12
Classifier: Development Status :: 5 - Production/Stable
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: Brotli (>=1.0.9,<2.0.0)
Requires-Dist: anndata (>=0.8.0,<0.9.0)
Requires-Dist: argparse (>=1.4.0,<2.0.0)
Requires-Dist: dask (>=2022.8.1,<2023.0.0)
Requires-Dist: matplotlib (>=3.7.1,<4.0.0)
Requires-Dist: numpy (>=1.23.2,<2.0.0)
Requires-Dist: opencv-python (>=4.6.0.66,<5.0.0.0)
Requires-Dist: pandas (>=1.4.4,<2.0.0)
Requires-Dist: pathlib (>=1.0.1,<2.0.0)
Requires-Dist: scikit-image (>=0.19.3,<0.20.0)
Requires-Dist: scikit-learn (>=1.2.1,<2.0.0)
Requires-Dist: tensorflow (==2.13.0rc0)
Requires-Dist: tensorflow-io-gcs-filesystem (<=0.31.0) ; platform_machine != "arm64" or platform_system != "Darwin"
Requires-Dist: tifffile (>=2022.8.12,<2023.0.0)
Requires-Dist: zarr (>=2.12.0,<3.0.0)
Project-URL: Documentation, https://nirmallab.github.io/cspot/
Project-URL: Repository, https://github.com/nirmallab/cspot
Description-Content-Type: text/markdown



[![Downloads](https://static.pepy.tech/badge/cspot)](https://pepy.tech/project/cspot)
[![docs](https://github.com/nirmallab/cspot/actions/workflows/docs.yml/badge.svg)](https://github.com/nirmallab/cspot/actions/workflows/docs.yml)
[![build-unix-mac-win](https://github.com/nirmallab/cspot/actions/workflows/build-unix-mac-win.yml/badge.svg)](https://github.com/nirmallab/cspot/actions/workflows/build-unix-mac-win.yml)

# 🐊 Getting Started with CSPOT 
Kindly note that **CSPOT is not a plug-and-play solution**. It's a framework that requires significant upfront investment of time from potential users for training and validating deep learning models, which can then be utilized in a plug-and-play manner for processing large volumes of similar multiplexed imaging data.

## System Requirements:

**Hardware :**  
`CSPOT` comprises two modules: training and prediction. Training can be efficiently executed on a standard laptop without the need for a GPU. However, for predictions, leveraging a GPU significantly enhances processing speed (particularly for large images).

**Software :**  
This package is supported for Windows (10, 11), macOS (Sonoma, Ventura) and Linux (Ubuntu 16.04). 
 
**Dependencies :** 
The `pyproject.toml` file contains a comprehensive list of dependencies.

## Installation Guide:

**There are two ways to set it up based on how you would like to run the program**  
- Using an interactive environment like Jupyter Notebooks  
- Using Command Line Interface  
  
Before we set up CSPOT, we highly recommend using a environment manager like Conda. Using an environment manager like Conda allows you to create and manage isolated environments with specific package versions and dependencies. 
  
**Download and Install the right [conda](https://docs.conda.io/en/latest/miniconda.html) based on the opertating system that you are using**

## **Create a new conda environment**

```
# use the terminal (mac/linux) and anaconda promt (windows) to run the following command
conda create --name cspot -y python=3.9
conda activate cspot
```

**Install `cspot` within the conda environment.**

```
pip install cspot
```
The installation time for `cspot` generally falls under 5 minutes, based on internet speed and connectivity.

## **Interactive Mode**
Using IDE or Jupyter notebooks

```python
pip install notebook

# open the notebook and import CSPOT
import cspot as cs
# Go to the tutorial section to follow along
```

## **Command Line Interface**
```
wget https://github.com/nirmalLab/cspot/archive/main.zip
unzip main.zip 
cd cspot-main/cspot 
# Go to the tutorial section to follow along

```

## **Docker Container**
```
docker pull nirmallab/cspot:cspot
# Go to the tutorial section to follow along
```
