[![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
```
Raw data
{
"_id": null,
"home_page": "https://pypi.org/project/cspot/",
"name": "cspot",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.12,>=3.8",
"maintainer_email": null,
"keywords": "image analysis, multiplex imaging, single cell analysis",
"author": "Ajit Johnson Nirmal",
"author_email": "ajitjohnson.n@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/78/9b/e3afc7cab90929d42aefede84d71a56a9e8f101c35abfe7d11cb7121d053/cspot-1.0.12.tar.gz",
"platform": null,
"description": "\n\n[![Downloads](https://static.pepy.tech/badge/cspot)](https://pepy.tech/project/cspot)\n[![docs](https://github.com/nirmallab/cspot/actions/workflows/docs.yml/badge.svg)](https://github.com/nirmallab/cspot/actions/workflows/docs.yml)\n[![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)\n\n# \ud83d\udc0a Getting Started with CSPOT \nKindly 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.\n\n## System Requirements:\n\n**Hardware :** \n`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).\n\n**Software :** \nThis package is supported for Windows (10, 11), macOS (Sonoma, Ventura) and Linux (Ubuntu 16.04). \n \n**Dependencies :** \nThe `pyproject.toml` file contains a comprehensive list of dependencies.\n\n## Installation Guide:\n\n**There are two ways to set it up based on how you would like to run the program** \n- Using an interactive environment like Jupyter Notebooks \n- Using Command Line Interface \n \nBefore 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. \n \n**Download and Install the right [conda](https://docs.conda.io/en/latest/miniconda.html) based on the opertating system that you are using**\n\n## **Create a new conda environment**\n\n```\n# use the terminal (mac/linux) and anaconda promt (windows) to run the following command\nconda create --name cspot -y python=3.9\nconda activate cspot\n```\n\n**Install `cspot` within the conda environment.**\n\n```\npip install cspot\n```\nThe installation time for `cspot` generally falls under 5 minutes, based on internet speed and connectivity.\n\n## **Interactive Mode**\nUsing IDE or Jupyter notebooks\n\n```python\npip install notebook\n\n# open the notebook and import CSPOT\nimport cspot as cs\n# Go to the tutorial section to follow along\n```\n\n## **Command Line Interface**\n```\nwget https://github.com/nirmalLab/cspot/archive/main.zip\nunzip main.zip \ncd cspot-main/cspot \n# Go to the tutorial section to follow along\n\n```\n\n## **Docker Container**\n```\ndocker pull nirmallab/cspot:cspot\n# Go to the tutorial section to follow along\n```",
"bugtrack_url": null,
"license": null,
"summary": "CELL SPOTTER (CSPOT): A scalable framework for automated processing of highly multiplexed tissue images",
"version": "1.0.12",
"project_urls": {
"Documentation": "https://nirmallab.github.io/cspot/",
"Homepage": "https://pypi.org/project/cspot/",
"Repository": "https://github.com/nirmallab/cspot"
},
"split_keywords": [
"image analysis",
" multiplex imaging",
" single cell analysis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f38f95b22de18b2ec66dee20ab9c5ea001f8a35e2fdb70d2f6e8bebbe0f0da8e",
"md5": "3348b0adca602bdeff41f8d7be353f54",
"sha256": "5257141d4da9784df48a91b4b23706427f48fce8a9293311fab18d36ebde2868"
},
"downloads": -1,
"filename": "cspot-1.0.12-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3348b0adca602bdeff41f8d7be353f54",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.12,>=3.8",
"size": 95098,
"upload_time": "2024-04-12T19:20:34",
"upload_time_iso_8601": "2024-04-12T19:20:34.597457Z",
"url": "https://files.pythonhosted.org/packages/f3/8f/95b22de18b2ec66dee20ab9c5ea001f8a35e2fdb70d2f6e8bebbe0f0da8e/cspot-1.0.12-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "789be3afc7cab90929d42aefede84d71a56a9e8f101c35abfe7d11cb7121d053",
"md5": "14234dce703e9dcf8d1647d446aa01d9",
"sha256": "7da2205097e1d30074968ade20cbbff127bf5a84f778efa602c7a7a53e850b50"
},
"downloads": -1,
"filename": "cspot-1.0.12.tar.gz",
"has_sig": false,
"md5_digest": "14234dce703e9dcf8d1647d446aa01d9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.12,>=3.8",
"size": 94268,
"upload_time": "2024-04-12T19:20:36",
"upload_time_iso_8601": "2024-04-12T19:20:36.324484Z",
"url": "https://files.pythonhosted.org/packages/78/9b/e3afc7cab90929d42aefede84d71a56a9e8f101c35abfe7d11cb7121d053/cspot-1.0.12.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-12 19:20:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "nirmallab",
"github_project": "cspot",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cspot"
}