# Single-Cell Image Analysis Package
<br>
[![build: Unix-Mac-Win](https://github.com/ajitjohnson/scimap/actions/workflows/build-unix-mac-win.yml/badge.svg)](https://github.com/ajitjohnson/scimap/actions/workflows/build-unix-mac-win.yml)
[![Docs](https://github.com/ajitjohnson/scimap/actions/workflows/docs.yml/badge.svg)](https://github.com/ajitjohnson/scimap/actions/workflows/docs.yml)
[![Downloads](https://pepy.tech/badge/scimap)](https://pepy.tech/project/scimap)
[![PyPI Version](https://img.shields.io/pypi/v/scimap.svg)](https://pypi.org/project/scimap)
[![PyPI License](https://img.shields.io/pypi/l/scimap.svg)](https://pypi.org/project/scimap)
[![DOI](https://zenodo.org/badge/271099296.svg)](https://zenodo.org/badge/latestdoi/271099296)
<br>
<img src="./docs/assets/scimap_logo.jpg" style="max-width:700px;width:100%" >
<br>
Scimap is a scalable toolkit for analyzing spatial molecular data. The underlying framework is generalizable to spatial datasets mapped to XY coordinates. The package uses the [anndata](https://anndata.readthedocs.io/en/stable/anndata.AnnData.html) framework making it easy to integrate with other popular single-cell analysis toolkits. It includes preprocessing, phenotyping, visualization, clustering, spatial analysis and differential spatial testing. The Python-based implementation efficiently deals with large datasets of millions of cells.
## Installation
We strongly recommend installing `scimap` in a fresh virtual environment.
```
# If you have conda installed
conda create --name scimap python=3.10
conda activate scimap
```
Install `scimap` directly into an activated virtual environment:
**Firstly, we suggest installing `scimap` and `napari` together to enable visualization out of the box. Keep in mind, `napari` needs a GUI toolkit, such as PyQt. If you run into any issues because of your computer's operating system, install `scimap` and `napari` separately by following the guidance in `napari's` documentation.**
Here's how you can install both using pip:
```python
pip install scimap[napari]
```
**If you encounter a problem with PyQt6 during the installation, you can install `scimap` alone first. Later on, if you find you need `napari`, you can go ahead and install it by itself.**
To install just `scimap`:
```python
pip install scimap
```
After installation, the package can be imported as:
```python
$ python
>>> import scimap as sm
```
## Get Started
#### Detailed documentation of `scimap` functions and tutorials are available [here](http://scimap.xyz/).
*SCIMAP* development was led by [Ajit Johnson Nirmal](https://ajitjohnson.com/), Harvard Medical School.
Check out other tools from the [Nirmal Lab](https://nirmallab.com/tools/).
## Contibute
Interested in contributing to the package? Check out our guidelines at [https://scimap.xyz/contribute/](https://scimap.xyz/contribute/) for detailed instructions.
## Funding
This work was supported by the following NIH grant K99-CA256497
Raw data
{
"_id": null,
"home_page": "https://pypi.org/project/scimap/",
"name": "SCIMAP",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.11,>=3.9",
"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/f5/1c/c7daa4c8701ac0954e6e2a8cd317785a0737be598bdd26a994123c954c72/scimap-2.0.5.tar.gz",
"platform": null,
"description": "# Single-Cell Image Analysis Package\n<br>\n\n[![build: Unix-Mac-Win](https://github.com/ajitjohnson/scimap/actions/workflows/build-unix-mac-win.yml/badge.svg)](https://github.com/ajitjohnson/scimap/actions/workflows/build-unix-mac-win.yml)\n[![Docs](https://github.com/ajitjohnson/scimap/actions/workflows/docs.yml/badge.svg)](https://github.com/ajitjohnson/scimap/actions/workflows/docs.yml)\n[![Downloads](https://pepy.tech/badge/scimap)](https://pepy.tech/project/scimap)\n[![PyPI Version](https://img.shields.io/pypi/v/scimap.svg)](https://pypi.org/project/scimap)\n[![PyPI License](https://img.shields.io/pypi/l/scimap.svg)](https://pypi.org/project/scimap)\n[![DOI](https://zenodo.org/badge/271099296.svg)](https://zenodo.org/badge/latestdoi/271099296)\n\n<br>\n\n<img src=\"./docs/assets/scimap_logo.jpg\" style=\"max-width:700px;width:100%\" >\n\n<br> \n\nScimap is a scalable toolkit for analyzing spatial molecular data. The underlying framework is generalizable to spatial datasets mapped to XY coordinates. The package uses the [anndata](https://anndata.readthedocs.io/en/stable/anndata.AnnData.html) framework making it easy to integrate with other popular single-cell analysis toolkits. It includes preprocessing, phenotyping, visualization, clustering, spatial analysis and differential spatial testing. The Python-based implementation efficiently deals with large datasets of millions of cells.\n\n## Installation\n\nWe strongly recommend installing `scimap` in a fresh virtual environment.\n\n```\n# If you have conda installed\nconda create --name scimap python=3.10\nconda activate scimap\n```\n\nInstall `scimap` directly into an activated virtual environment:\n \n**Firstly, we suggest installing `scimap` and `napari` together to enable visualization out of the box. Keep in mind, `napari` needs a GUI toolkit, such as PyQt. If you run into any issues because of your computer's operating system, install `scimap` and `napari` separately by following the guidance in `napari's` documentation.**\n\nHere's how you can install both using pip:\n\n```python\npip install scimap[napari]\n```\n\n**If you encounter a problem with PyQt6 during the installation, you can install `scimap` alone first. Later on, if you find you need `napari`, you can go ahead and install it by itself.**\n\nTo install just `scimap`:\n\n```python\npip install scimap\n```\n\nAfter installation, the package can be imported as:\n\n```python\n$ python\n>>> import scimap as sm\n```\n\n\n## Get Started\n\n#### Detailed documentation of `scimap` functions and tutorials are available [here](http://scimap.xyz/).\n\n*SCIMAP* development was led by [Ajit Johnson Nirmal](https://ajitjohnson.com/), Harvard Medical School. \nCheck out other tools from the [Nirmal Lab](https://nirmallab.com/tools/). \n\n\n## Contibute\nInterested in contributing to the package? Check out our guidelines at [https://scimap.xyz/contribute/](https://scimap.xyz/contribute/) for detailed instructions.\n\n\n## Funding\nThis work was supported by the following NIH grant K99-CA256497\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Spatial Single-Cell Analysis Toolkit",
"version": "2.0.5",
"project_urls": {
"Documentation": "https://scimap.xyz",
"Homepage": "https://pypi.org/project/scimap/",
"Repository": "https://github.com/labsyspharm/scimap"
},
"split_keywords": [
"image analysis",
" multiplex imaging",
" single cell analysis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "dbe1d0ebff3f667723889987ae4d85cd3ddeb1407ac01e7b0c763edf1b903e5d",
"md5": "4df36a4801ef7bdc48add9fa65f22895",
"sha256": "6e59844f6d07f684a137aa41299b9c05b1c3f3df895fe33a57988aa90680b68b"
},
"downloads": -1,
"filename": "scimap-2.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4df36a4801ef7bdc48add9fa65f22895",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.11,>=3.9",
"size": 2361553,
"upload_time": "2024-04-10T21:28:14",
"upload_time_iso_8601": "2024-04-10T21:28:14.284216Z",
"url": "https://files.pythonhosted.org/packages/db/e1/d0ebff3f667723889987ae4d85cd3ddeb1407ac01e7b0c763edf1b903e5d/scimap-2.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f51cc7daa4c8701ac0954e6e2a8cd317785a0737be598bdd26a994123c954c72",
"md5": "9fcbacb53db544766cac9e60066c8a5c",
"sha256": "b852949a77aa8b4ecfef20e823a4ef13439308a2a24f2e9b449c0c6311a8d8f2"
},
"downloads": -1,
"filename": "scimap-2.0.5.tar.gz",
"has_sig": false,
"md5_digest": "9fcbacb53db544766cac9e60066c8a5c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.11,>=3.9",
"size": 2320262,
"upload_time": "2024-04-10T21:28:17",
"upload_time_iso_8601": "2024-04-10T21:28:17.799974Z",
"url": "https://files.pythonhosted.org/packages/f5/1c/c7daa4c8701ac0954e6e2a8cd317785a0737be598bdd26a994123c954c72/scimap-2.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-10 21:28:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "labsyspharm",
"github_project": "scimap",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "scimap"
}