evolocity


Nameevolocity JSON
Version 1.0.1 PyPI version JSON
download
home_pagehttps://github.com/brianhie/evolocity
SummaryEvolutionary velocity with protein language models
upload_time2022-12-27 18:49:50
maintainer
docs_urlNone
authorBrian Hie
requires_python>=3.6
licenseMIT
keywords evolution velocity evolocity protein language model
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            =========
Evolocity
=========

Evolocity implements evolutionary velocity (evo-velocity), which models a protein sequence landscape as an evolutionary "vector field" by using the local evolutionary predictions enabled by language models to enable global evolutionary insight.

.. image:: ../cyc_stream.PNG
   :width: 450
   :alt: 'Evolocity overview'

Evo-velocity uses the change in languge model likelihoods to estimate directionality between two biological sequences.
Then, over an entire sequence similarity network, this procedure is used to direct network edges.
Finally, network diffusion analysis can identify roots, order sequences in pseudotime, and identify mutations driving the velocity.

Evolocity is a fork of the `scVelo <https://github.com/theislab/scvelo>`_ tool for RNA velocity and relies on many aspects of the `Scanpy <https://scanpy.readthedocs.io/en/stable/>`_ library for high-dimensional biological data analysis.
Like Scanpy and scVelo, evolocity makes use of `anndata <https://anndata.readthedocs.io/en/latest/>`_, an extremely convenient way to store and organize biological data.


Quick Start
===========

Installation
------------

You should be able to install evolocity using ``pip``::

   python -m pip install evolocity

API example
-----------

Below is a quick Python example of using evolocity to load and analyze sequences in a FASTA file.

.. code-block:: python

   import evolocity as evo
   import scanpy as sc

   # Load sequences and compute language model embeddings.
   fasta_fname = 'data.fasta'
   adata = evo.pp.featurize_fasta(fasta_fname)

   # Construct sequence similarity network.
   evo.pp.neighbors(adata)

   # Run evolocity analysis.
   evo.tl.velocity_graph(adata)

   # Embed network and velocities in two-dimensions and plot.
   sc.tl.umap(adata)
   evo.tl.velocity_embedding(adata)
   evo.pl.velocity_embedding_grid(adata)
   evo.pl.velocity_embedding_stream(adata)

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/brianhie/evolocity",
    "name": "evolocity",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": "",
    "keywords": "evolution,velocity,evolocity,protein,language model",
    "author": "Brian Hie",
    "author_email": "brianhie@stanford.edu",
    "download_url": "https://files.pythonhosted.org/packages/d9/c0/813c5d7da9345628706e840c5d320f712c56afa2262220844942dcb59e15/evolocity-1.0.1.tar.gz",
    "platform": null,
    "description": "=========\nEvolocity\n=========\n\nEvolocity implements evolutionary velocity (evo-velocity), which models a protein sequence landscape as an evolutionary \"vector field\" by using the local evolutionary predictions enabled by language models to enable global evolutionary insight.\n\n.. image:: ../cyc_stream.PNG\n   :width: 450\n   :alt: 'Evolocity overview'\n\nEvo-velocity uses the change in languge model likelihoods to estimate directionality between two biological sequences.\nThen, over an entire sequence similarity network, this procedure is used to direct network edges.\nFinally, network diffusion analysis can identify roots, order sequences in pseudotime, and identify mutations driving the velocity.\n\nEvolocity is a fork of the `scVelo <https://github.com/theislab/scvelo>`_ tool for RNA velocity and relies on many aspects of the `Scanpy <https://scanpy.readthedocs.io/en/stable/>`_ library for high-dimensional biological data analysis.\nLike Scanpy and scVelo, evolocity makes use of `anndata <https://anndata.readthedocs.io/en/latest/>`_, an extremely convenient way to store and organize biological data.\n\n\nQuick Start\n===========\n\nInstallation\n------------\n\nYou should be able to install evolocity using ``pip``::\n\n   python -m pip install evolocity\n\nAPI example\n-----------\n\nBelow is a quick Python example of using evolocity to load and analyze sequences in a FASTA file.\n\n.. code-block:: python\n\n   import evolocity as evo\n   import scanpy as sc\n\n   # Load sequences and compute language model embeddings.\n   fasta_fname = 'data.fasta'\n   adata = evo.pp.featurize_fasta(fasta_fname)\n\n   # Construct sequence similarity network.\n   evo.pp.neighbors(adata)\n\n   # Run evolocity analysis.\n   evo.tl.velocity_graph(adata)\n\n   # Embed network and velocities in two-dimensions and plot.\n   sc.tl.umap(adata)\n   evo.tl.velocity_embedding(adata)\n   evo.pl.velocity_embedding_grid(adata)\n   evo.pl.velocity_embedding_stream(adata)\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Evolutionary velocity with protein language models",
    "version": "1.0.1",
    "split_keywords": [
        "evolution",
        "velocity",
        "evolocity",
        "protein",
        "language model"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "1cd06243bc414f159ebe93eac01d534d",
                "sha256": "fd869bfe929833efb51a8e2a2c32150e6fa0efe25d957bdf24ac462b9984beb4"
            },
            "downloads": -1,
            "filename": "evolocity-1.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1cd06243bc414f159ebe93eac01d534d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 87095,
            "upload_time": "2022-12-27T18:49:48",
            "upload_time_iso_8601": "2022-12-27T18:49:48.180911Z",
            "url": "https://files.pythonhosted.org/packages/f0/48/98dd23138e48e52712a4e3f43d4fa0bfba1c7e8db83573397771ec549040/evolocity-1.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "29051fa4ed3ac98fec0e73cf68cc51b8",
                "sha256": "06589e9d5f98a782b24ae687954a6bfeafcd640223daf02c97c24de6ba40c2b2"
            },
            "downloads": -1,
            "filename": "evolocity-1.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "29051fa4ed3ac98fec0e73cf68cc51b8",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 1079366,
            "upload_time": "2022-12-27T18:49:50",
            "upload_time_iso_8601": "2022-12-27T18:49:50.134450Z",
            "url": "https://files.pythonhosted.org/packages/d9/c0/813c5d7da9345628706e840c5d320f712c56afa2262220844942dcb59e15/evolocity-1.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2022-12-27 18:49:50",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": "brianhie",
    "github_project": "evolocity",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [],
    "lcname": "evolocity"
}
        
Elapsed time: 0.07426s