# Cell BLAST
[![license-badge](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![pypi-badge](https://img.shields.io/pypi/v/Cell-BLAST)](https://pypi.org/project/Cell-BLAST)
[![docs-badge](https://readthedocs.org/projects/cblast/badge/?version=latest)](https://cblast.readthedocs.io/en/latest/?badge=latest)
[![build-badge](https://github.com/gao-lab/Cell_BLAST/actions/workflows/build.yml/badge.svg)](https://github.com/gao-lab/Cell_BLAST/actions/workflows/build.yml)
Cell BLAST is a cell querying tool for single-cell transcriptomics data.
For each query cell, it searches for most similar cells in the reference database.
Annotations in reference cells, e.g. cell type, can then be transfered to query
cells based on cell-to-cell similarities. See our
[publication](https://www.nature.com/articles/s41467-020-17281-7) for details.
## Installing the Python package
We only support installation via pip right now.
Installation within virtual environments are recommended, see
[virtualenv](https://virtualenv.pypa.io/en/latest/) or
[conda](https://conda.io/docs/user-guide/tasks/manage-environments.html).
For conda, here's a one-liner to set up an empty environment
for installing Cell BLAST:
`conda create -n cb python=3.9 && conda activate cb`
Then follow the instructions below to install Cell BLAST:
1. Install Cell BLAST from PyPI by running:
`pip install Cell-BLAST`
Or, install an editable dev version by running the following command
under the root directory of this repo:
`flit install -s`
2. Check if the package can be imported in the Python interpreter:
```python
import Cell_BLAST as cb
print(cb.__version__)
```
## Documentation
Online documentation can be found [here](https://cblast.readthedocs.org/).
## Web-based interface
We also provide a [Web-based service](http://cblast.gao-lab.org/) for
off-the-shelf querying of our ACA reference panels.
## Reproduce results in the paper
To reproduce results, please check out the `rep` branch.
## Contact
Feel free to submit an issue or contact us at
[cblast@mail.cbi.pku.edu.cn](mailto:cblast@mail.cbi.pku.edu.cn)
for problems about the Python package, website or database.
Raw data
{
"_id": null,
"home_page": null,
"name": "Cell-BLAST",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "bioinformatics, deep-learning, single-cell",
"author": null,
"author_email": "Zhi-Jie Cao <caozj@mail.cbi.pku.edu.cn>, Runwei Lu <lurw2000@126.com>",
"download_url": "https://files.pythonhosted.org/packages/3a/90/2e48138e59ad506277dff969c16ba2a9375bb60e414fc8a62444c2e67f77/cell_blast-0.5.1.tar.gz",
"platform": null,
"description": "# Cell BLAST\n\n[![license-badge](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![pypi-badge](https://img.shields.io/pypi/v/Cell-BLAST)](https://pypi.org/project/Cell-BLAST)\n[![docs-badge](https://readthedocs.org/projects/cblast/badge/?version=latest)](https://cblast.readthedocs.io/en/latest/?badge=latest)\n[![build-badge](https://github.com/gao-lab/Cell_BLAST/actions/workflows/build.yml/badge.svg)](https://github.com/gao-lab/Cell_BLAST/actions/workflows/build.yml)\n\nCell BLAST is a cell querying tool for single-cell transcriptomics data.\n\nFor each query cell, it searches for most similar cells in the reference database.\nAnnotations in reference cells, e.g. cell type, can then be transfered to query\ncells based on cell-to-cell similarities. See our\n[publication](https://www.nature.com/articles/s41467-020-17281-7) for details.\n\n## Installing the Python package\n\nWe only support installation via pip right now.\n\nInstallation within virtual environments are recommended, see\n[virtualenv](https://virtualenv.pypa.io/en/latest/) or\n[conda](https://conda.io/docs/user-guide/tasks/manage-environments.html).\n\nFor conda, here's a one-liner to set up an empty environment\nfor installing Cell BLAST:\n\n`conda create -n cb python=3.9 && conda activate cb`\n\nThen follow the instructions below to install Cell BLAST:\n\n1. Install Cell BLAST from PyPI by running:\n\n `pip install Cell-BLAST`\n\n Or, install an editable dev version by running the following command\n under the root directory of this repo:\n\n `flit install -s`\n\n2. Check if the package can be imported in the Python interpreter:\n\n ```python\n import Cell_BLAST as cb\n print(cb.__version__)\n ```\n\n## Documentation\n\nOnline documentation can be found [here](https://cblast.readthedocs.org/).\n\n## Web-based interface\n\nWe also provide a [Web-based service](http://cblast.gao-lab.org/) for\noff-the-shelf querying of our ACA reference panels.\n\n## Reproduce results in the paper\n\nTo reproduce results, please check out the `rep` branch.\n\n## Contact\n\nFeel free to submit an issue or contact us at\n[cblast@mail.cbi.pku.edu.cn](mailto:cblast@mail.cbi.pku.edu.cn)\nfor problems about the Python package, website or database.\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Single-cell transcriptome querying tool",
"version": "0.5.1",
"project_urls": {
"Github": "https://github.com/gao-lab/Cell_BLAST"
},
"split_keywords": [
"bioinformatics",
" deep-learning",
" single-cell"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "929873963115317e7fe55ffcb844268759f4b5e0eefc734d40170254b7ecfc3e",
"md5": "46c5343d0d6aacb5839a668720c4de40",
"sha256": "33bf57ff7f7336ae0a163b4f893fcaa57c08da5aea15d19ede2a0546ada94724"
},
"downloads": -1,
"filename": "cell_blast-0.5.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "46c5343d0d6aacb5839a668720c4de40",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 52916,
"upload_time": "2024-07-23T07:29:28",
"upload_time_iso_8601": "2024-07-23T07:29:28.078939Z",
"url": "https://files.pythonhosted.org/packages/92/98/73963115317e7fe55ffcb844268759f4b5e0eefc734d40170254b7ecfc3e/cell_blast-0.5.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3a902e48138e59ad506277dff969c16ba2a9375bb60e414fc8a62444c2e67f77",
"md5": "b64db96ef7abf64837264bcc3a070f51",
"sha256": "40740741303d8c6d34d2b24c54a37c80042bfef185fd7a2bbe375ca19295a245"
},
"downloads": -1,
"filename": "cell_blast-0.5.1.tar.gz",
"has_sig": false,
"md5_digest": "b64db96ef7abf64837264bcc3a070f51",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 47716,
"upload_time": "2024-07-23T07:29:29",
"upload_time_iso_8601": "2024-07-23T07:29:29.651617Z",
"url": "https://files.pythonhosted.org/packages/3a/90/2e48138e59ad506277dff969c16ba2a9375bb60e414fc8a62444c2e67f77/cell_blast-0.5.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-23 07:29:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gao-lab",
"github_project": "Cell_BLAST",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cell-blast"
}