scvi-tools


Namescvi-tools JSON
Version 1.2.1 PyPI version JSON
download
home_pageNone
SummaryDeep probabilistic analysis of single-cell omics data.
upload_time2024-12-04 11:24:04
maintainerNone
docs_urlNone
authorThe scvi-tools development team
requires_python>=3.10
licenseBSD 3-Clause License Copyright (c) 2024, Adam Gayoso, Romain Lopez, Martin Kim, Pierre Boyeau, Nir Yosef Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <a href="https://scvi-tools.org/">
  <img
    src="https://github.com/scverse/scvi-tools/blob/main/docs/_static/scvi-tools-horizontal.svg?raw=true"
    width="400"
    alt="scvi-tools"
  >
</a>

[![Stars][gh-stars-badge]][gh-stars-link]
[![PyPI][pypi-badge]][pypi-link]
[![PyPIDownloads][pepy-badge]][pepy-link]
[![CondaDownloads][conda-badge]][conda-link]
[![Docs][docs-badge]][docs-link]
[![Build][build-badge]][build-link]
[![Coverage][coverage-badge]][coverage-link]

[scvi-tools] (single-cell variational inference tools) is a package for probabilistic modeling and
analysis of single-cell omics data, built on top of [PyTorch] and [AnnData].

# Analysis of single-cell omics data

scvi-tools is composed of models that perform many analysis tasks across single-cell, multi, and
spatial omics data:

- Dimensionality reduction
- Data integration
- Automated annotation
- Factor analysis
- Doublet detection
- Spatial deconvolution
- and more!

In the [user guide], we provide an overview of each model. All model implementations have a
high-level API that interacts with [Scanpy] and includes standard save/load functions, GPU
acceleration, etc.

# Rapid development of novel probabilistic models

scvi-tools contains the building blocks to develop and deploy novel probablistic models. These
building blocks are powered by popular probabilistic and machine learning frameworks such as
[PyTorch Lightning] and [Pyro]. For an overview of how the scvi-tools package is structured, you
may refer to the [codebase overview] page.

We recommend checking out the [skeleton repository] as a starting point for developing and
deploying new models with scvi-tools.

# Basic installation

For conda,

```bash
conda install scvi-tools -c conda-forge
```

and for pip,

```bash
pip install scvi-tools
```

Please be sure to install a version of [PyTorch] that is compatible with your GPU (if applicable).

# Resources

- Tutorials, API reference, and installation guides are available in the [documentation].
- For discussion of usage, check out our [forum].
- Please use the [issues] to submit bug reports.
- If you'd like to contribute, check out our [contributing guide].
- If you find a model useful for your research, please consider citing the corresponding
    publication.

# Reference

If you use `scvi-tools` in your work, please cite

> **A Python library for probabilistic analysis of single-cell omics data**
>
> Adam Gayoso, Romain Lopez, Galen Xing, Pierre Boyeau, Valeh Valiollah Pour Amiri, Justin Hong,
> Katherine Wu, Michael Jayasuriya, Edouard Mehlman, Maxime Langevin, Yining Liu, Jules Samaran,
> Gabriel Misrachi, Achille Nazaret, Oscar Clivio, Chenling Xu, Tal Ashuach, Mariano Gabitto,
> Mohammad Lotfollahi, Valentine Svensson, Eduardo da Veiga Beltrame, Vitalii Kleshchevnikov,
> Carlos Talavera-López, Lior Pachter, Fabian J. Theis, Aaron Streets, Michael I. Jordan,
> Jeffrey Regier & Nir Yosef
>
> _Nature Biotechnology_ 2022 Feb 07. doi: [10.1038/s41587-021-01206-w](https://doi.org/10.1038/s41587-021-01206-w).

along with the publicaton describing the model used.

You can cite the scverse publication as follows:

> **The scverse project provides a computational ecosystem for single-cell omics data analysis**
>
> Isaac Virshup, Danila Bredikhin, Lukas Heumos, Giovanni Palla, Gregor Sturm, Adam Gayoso,
> Ilia Kats, Mikaela Koutrouli, Scverse Community, Bonnie Berger, Dana Pe’er, Aviv Regev,
> Sarah A. Teichmann, Francesca Finotello, F. Alexander Wolf, Nir Yosef, Oliver Stegle &
> Fabian J. Theis
>
> _Nature Biotechnology_ 2023 Apr 10. doi: [10.1038/s41587-023-01733-8](https://doi.org/10.1038/s41587-023-01733-8).

scvi-tools is part of the scverse project ([website](https://scverse.org),
[governance](https://scverse.org/about/roles)) and is fiscally sponsored by [NumFOCUS]. Please
consider making a tax-deductible [donation] to help the project pay for developer time,
professional services, travel, workshops, and a variety of other needs.

<a href="https://numfocus.org/project/scverse">
  <img
    src="https://raw.githubusercontent.com/numfocus/templates/master/images/numfocus-logo.png"
    width="200"
  >
</a>

[anndata]: https://anndata.readthedocs.io/en/latest/
[build-badge]: https://github.com/scverse/scvi-tools/actions/workflows/build.yml/badge.svg
[build-link]: https://github.com/scverse/scvi-tools/actions/workflows/build.yml/
[codebase overview]: https://docs.scvi-tools.org/en/stable/user_guide/background/codebase_overview.html
[conda-badge]: https://img.shields.io/conda/dn/conda-forge/scvi-tools?logo=Anaconda
[conda-link]: https://anaconda.org/conda-forge/scvi-tools
[contributing guide]: https://docs.scvi-tools.org/en/stable/contributing/index.html
[coverage-badge]: https://codecov.io/gh/scverse/scvi-tools/branch/main/graph/badge.svg
[coverage-link]: https://codecov.io/gh/scverse/scvi-tools
[docs-badge]: https://readthedocs.org/projects/scvi/badge/?version=latest
[docs-link]: https://scvi.readthedocs.io/en/stable/?badge=stable
[documentation]: https://docs.scvi-tools.org/
[donation]: https://numfocus.org/donate-to-scverse
[forum]: https://discourse.scvi-tools.org
[gh-stars-badge]: https://img.shields.io/github/stars/scverse/scvi-tools?style=flat&logo=GitHub&color=blue
[gh-stars-link]: https://github.com/scverse/scvi-tools/stargazers
[issues]: https://github.com/scverse/scvi-tools/issues
[numfocus]: https://numfocus.org/
[pepy-badge]: https://static.pepy.tech/badge/scvi-tools
[pepy-link]: https://pepy.tech/project/scvi-tools
[pypi-badge]: https://img.shields.io/pypi/v/scvi-tools.svg
[pypi-link]: https://pypi.org/project/scvi-tools
[pyro]: https://pyro.ai/
[pytorch]: https://pytorch.org
[pytorch lightning]: https://lightning.ai/docs/pytorch/stable/
[scanpy]: http://scanpy.readthedocs.io/
[scvi-tools]: https://scvi-tools.org/
[skeleton repository]: https://github.com/scverse/simple-scvi
[user guide]: https://docs.scvi-tools.org/en/stable/user_guide/index.html

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "scvi-tools",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": "The scvi-tools development team <ori.kronfeld@weizmann.ac.il>",
    "keywords": null,
    "author": "The scvi-tools development team",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/69/a4/02bd72bff3c7e404d1ecab576751b9e2af3c8d4586c929a2d6e8da028229/scvi_tools-1.2.1.tar.gz",
    "platform": null,
    "description": "<a href=\"https://scvi-tools.org/\">\n  <img\n    src=\"https://github.com/scverse/scvi-tools/blob/main/docs/_static/scvi-tools-horizontal.svg?raw=true\"\n    width=\"400\"\n    alt=\"scvi-tools\"\n  >\n</a>\n\n[![Stars][gh-stars-badge]][gh-stars-link]\n[![PyPI][pypi-badge]][pypi-link]\n[![PyPIDownloads][pepy-badge]][pepy-link]\n[![CondaDownloads][conda-badge]][conda-link]\n[![Docs][docs-badge]][docs-link]\n[![Build][build-badge]][build-link]\n[![Coverage][coverage-badge]][coverage-link]\n\n[scvi-tools] (single-cell variational inference tools) is a package for probabilistic modeling and\nanalysis of single-cell omics data, built on top of [PyTorch] and [AnnData].\n\n# Analysis of single-cell omics data\n\nscvi-tools is composed of models that perform many analysis tasks across single-cell, multi, and\nspatial omics data:\n\n- Dimensionality reduction\n- Data integration\n- Automated annotation\n- Factor analysis\n- Doublet detection\n- Spatial deconvolution\n- and more!\n\nIn the [user guide], we provide an overview of each model. All model implementations have a\nhigh-level API that interacts with [Scanpy] and includes standard save/load functions, GPU\nacceleration, etc.\n\n# Rapid development of novel probabilistic models\n\nscvi-tools contains the building blocks to develop and deploy novel probablistic models. These\nbuilding blocks are powered by popular probabilistic and machine learning frameworks such as\n[PyTorch Lightning] and [Pyro]. For an overview of how the scvi-tools package is structured, you\nmay refer to the [codebase overview] page.\n\nWe recommend checking out the [skeleton repository] as a starting point for developing and\ndeploying new models with scvi-tools.\n\n# Basic installation\n\nFor conda,\n\n```bash\nconda install scvi-tools -c conda-forge\n```\n\nand for pip,\n\n```bash\npip install scvi-tools\n```\n\nPlease be sure to install a version of [PyTorch] that is compatible with your GPU (if applicable).\n\n# Resources\n\n- Tutorials, API reference, and installation guides are available in the [documentation].\n- For discussion of usage, check out our [forum].\n- Please use the [issues] to submit bug reports.\n- If you'd like to contribute, check out our [contributing guide].\n- If you find a model useful for your research, please consider citing the corresponding\n    publication.\n\n# Reference\n\nIf you use `scvi-tools` in your work, please cite\n\n> **A Python library for probabilistic analysis of single-cell omics data**\n>\n> Adam Gayoso, Romain Lopez, Galen Xing, Pierre Boyeau, Valeh Valiollah Pour Amiri, Justin Hong,\n> Katherine Wu, Michael Jayasuriya, Edouard Mehlman, Maxime Langevin, Yining Liu, Jules Samaran,\n> Gabriel Misrachi, Achille Nazaret, Oscar Clivio, Chenling Xu, Tal Ashuach, Mariano Gabitto,\n> Mohammad Lotfollahi, Valentine Svensson, Eduardo da Veiga Beltrame, Vitalii Kleshchevnikov,\n> Carlos Talavera-L\u00f3pez, Lior Pachter, Fabian J. Theis, Aaron Streets, Michael I. Jordan,\n> Jeffrey Regier & Nir Yosef\n>\n> _Nature Biotechnology_ 2022 Feb 07. doi: [10.1038/s41587-021-01206-w](https://doi.org/10.1038/s41587-021-01206-w).\n\nalong with the publicaton describing the model used.\n\nYou can cite the scverse publication as follows:\n\n> **The scverse project provides a computational ecosystem for single-cell omics data analysis**\n>\n> Isaac Virshup, Danila Bredikhin, Lukas Heumos, Giovanni Palla, Gregor Sturm, Adam Gayoso,\n> Ilia Kats, Mikaela Koutrouli, Scverse Community, Bonnie Berger, Dana Pe\u2019er, Aviv Regev,\n> Sarah A. Teichmann, Francesca Finotello, F. Alexander Wolf, Nir Yosef, Oliver Stegle &\n> Fabian J. Theis\n>\n> _Nature Biotechnology_ 2023 Apr 10. doi: [10.1038/s41587-023-01733-8](https://doi.org/10.1038/s41587-023-01733-8).\n\nscvi-tools is part of the scverse project ([website](https://scverse.org),\n[governance](https://scverse.org/about/roles)) and is fiscally sponsored by [NumFOCUS]. Please\nconsider making a tax-deductible [donation] to help the project pay for developer time,\nprofessional services, travel, workshops, and a variety of other needs.\n\n<a href=\"https://numfocus.org/project/scverse\">\n  <img\n    src=\"https://raw.githubusercontent.com/numfocus/templates/master/images/numfocus-logo.png\"\n    width=\"200\"\n  >\n</a>\n\n[anndata]: https://anndata.readthedocs.io/en/latest/\n[build-badge]: https://github.com/scverse/scvi-tools/actions/workflows/build.yml/badge.svg\n[build-link]: https://github.com/scverse/scvi-tools/actions/workflows/build.yml/\n[codebase overview]: https://docs.scvi-tools.org/en/stable/user_guide/background/codebase_overview.html\n[conda-badge]: https://img.shields.io/conda/dn/conda-forge/scvi-tools?logo=Anaconda\n[conda-link]: https://anaconda.org/conda-forge/scvi-tools\n[contributing guide]: https://docs.scvi-tools.org/en/stable/contributing/index.html\n[coverage-badge]: https://codecov.io/gh/scverse/scvi-tools/branch/main/graph/badge.svg\n[coverage-link]: https://codecov.io/gh/scverse/scvi-tools\n[docs-badge]: https://readthedocs.org/projects/scvi/badge/?version=latest\n[docs-link]: https://scvi.readthedocs.io/en/stable/?badge=stable\n[documentation]: https://docs.scvi-tools.org/\n[donation]: https://numfocus.org/donate-to-scverse\n[forum]: https://discourse.scvi-tools.org\n[gh-stars-badge]: https://img.shields.io/github/stars/scverse/scvi-tools?style=flat&logo=GitHub&color=blue\n[gh-stars-link]: https://github.com/scverse/scvi-tools/stargazers\n[issues]: https://github.com/scverse/scvi-tools/issues\n[numfocus]: https://numfocus.org/\n[pepy-badge]: https://static.pepy.tech/badge/scvi-tools\n[pepy-link]: https://pepy.tech/project/scvi-tools\n[pypi-badge]: https://img.shields.io/pypi/v/scvi-tools.svg\n[pypi-link]: https://pypi.org/project/scvi-tools\n[pyro]: https://pyro.ai/\n[pytorch]: https://pytorch.org\n[pytorch lightning]: https://lightning.ai/docs/pytorch/stable/\n[scanpy]: http://scanpy.readthedocs.io/\n[scvi-tools]: https://scvi-tools.org/\n[skeleton repository]: https://github.com/scverse/simple-scvi\n[user guide]: https://docs.scvi-tools.org/en/stable/user_guide/index.html\n",
    "bugtrack_url": null,
    "license": "BSD 3-Clause License  Copyright (c) 2024, Adam Gayoso, Romain Lopez, Martin Kim, Pierre Boyeau, Nir Yosef  Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.  2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.  3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.",
    "summary": "Deep probabilistic analysis of single-cell omics data.",
    "version": "1.2.1",
    "project_urls": {
        "Documentation": "https://scvi-tools.org",
        "Home-page": "https://scvi-tools.org",
        "Source": "https://github.com/scverse/scvi-tools"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "47186633989b938612372db70c5a61ee9ce523dbfc956b6fa389a8971ed1a07b",
                "md5": "81ae5cdec61794ed8caa74836898cd39",
                "sha256": "22348c8fc9e3febe7889ab2560977e658a65acae72a8f599f6347907ceb57acb"
            },
            "downloads": -1,
            "filename": "scvi_tools-1.2.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "81ae5cdec61794ed8caa74836898cd39",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 438626,
            "upload_time": "2024-12-04T11:24:01",
            "upload_time_iso_8601": "2024-12-04T11:24:01.466348Z",
            "url": "https://files.pythonhosted.org/packages/47/18/6633989b938612372db70c5a61ee9ce523dbfc956b6fa389a8971ed1a07b/scvi_tools-1.2.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "69a402bd72bff3c7e404d1ecab576751b9e2af3c8d4586c929a2d6e8da028229",
                "md5": "4d42d8b7e893472c0696d736f705f2ee",
                "sha256": "78e1678b6b8ca9b9b7b1105d02e7f17b87b0a80ae50e0ea88d95c208af79c94a"
            },
            "downloads": -1,
            "filename": "scvi_tools-1.2.1.tar.gz",
            "has_sig": false,
            "md5_digest": "4d42d8b7e893472c0696d736f705f2ee",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 7782765,
            "upload_time": "2024-12-04T11:24:04",
            "upload_time_iso_8601": "2024-12-04T11:24:04.220849Z",
            "url": "https://files.pythonhosted.org/packages/69/a4/02bd72bff3c7e404d1ecab576751b9e2af3c8d4586c929a2d6e8da028229/scvi_tools-1.2.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-04 11:24:04",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "scverse",
    "github_project": "scvi-tools",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "scvi-tools"
}
        
Elapsed time: 4.42325s