{ "info": { "author": "Tavi Nathanson", "author_email": "tavi@hammerlab.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Environment :: Console", "Intended Audience :: Science/Research", "License :: OSI Approved :: Apache Software License", "Operating System :: OS Independent", "Programming Language :: Python", "Topic :: Scientific/Engineering :: Bio-Informatics" ], "description": "|PyPI| |Build Status| |Coverage Status|\n\nCohorts\n=======\n\nCohorts is a library for analyzing and plotting clinical data, mutations\nand neoepitopes in patient cohorts.\n\nIt calls out to external libraries like\n`topiary `__ and caches the\nresults for easy manipulation.\n\nCohorts requires Python 3 (3.3+). We are no longer maintaining\ncompatability with Python 2. For context, see this `Python 3\nstatement `__.\n\nInstallation\n------------\n\nYou can install Cohorts using\n`pip `__:\n\n.. code:: bash\n\n pip install cohorts\n\nFeatures\n--------\n\n- Data management: construct a ``Cohort`` consisting of ``Patient``\\ s\n with ``Sample``\\ s.\n- Use ``varcode`` and ``topiary`` to generate and cache variant effects\n and predicted neoantigens.\n- Provenance: track the state of the world (package and data versions)\n for a given analysis.\n- Aggregation functions: built-in functions such as\n ``missense_snv_count``, ``neoantigen_count``,\n ``expressed_neoantigen_count``; or create your own functions.\n- Plotting: survival curves via ``lifelines``, response/no response\n plots (with Mann-Whitney and Fisher\u2019s Exact results), ROC curves.\n Example: ``cohort.plot_survival(on=missense_snv_count, how=\"pfs\")``.\n- Filtering: filter collections of variants/effects/neoantigens by, for\n example, variant statistics.\n- Pre-define data sets to work with. Example:\n ``cohort.as_dataframe(join_with=[\"tcr\", \"pdl1\"])``.\n\nIn addition, several other libraries make use of ``cohorts``: \\*\n`pygdc `__ \\*\n`query_tcga `__\n\nQuick Start\n-----------\n\nOne way to get started using Cohorts is to use it to analyze TCGA data.\n\nAs an example, we can create a cohort using\n`query_tcga `__:\n\n.. code:: python\n\n from query_tcga import cohort, config\n\n # provide authentication token\n config.load_config('config.ini')\n\n # load patient data\n blca_patients = cohort.prep_patients(project_name='TCGA-BLCA',\n project_data_dir='data')\n\n # create cohort\n blca_cohort = cohort.prep_cohort(patients=blca_patients,\n cache_dir='data-cache')\n\nThen, use ``plot_survival()`` to summarize a potential biomarker (e.g.\n``snv_count``) by survival:.\n\n.. code:: python\n\n from cohorts.functions import snv_count\n blca_cohort.plot_survival(snv_count, how='os', threshold='median')\n\nWhich should produce a summary of results including this plot:\n\n.. figure:: /docs/survival_plot_example.png\n :alt: Survival plot example\n\n Survival plot example\n\nWe could alternatively use ``plot_benefit()`` to summarize OS>12mo\ninstead of survival:\n\n.. code:: python\n\n blca_cohort.plot_benefit(snv_count)\n\n.. figure:: /docs/benefit_plot_example.png\n :alt: Benefit plot example\n\n Benefit plot example\n\nSee the full example in the `quick-start\nnotebook `__\n\nBuilding from Scratch\n---------------------\n\n.. code:: python\n\n patient_1 = Patient(\n id=\"patient_1\",\n os=70,\n pfs=24,\n deceased=True,\n progressed=True,\n benefit=False\n )\n \n patient_2 = Patient(\n id=\"patient_2\",\n os=100,\n pfs=50,\n deceased=False,\n progressed=True,\n benefit=False\n )\n\n cohort = Cohort(\n patients=[patient_1, patient_2],\n cache_dir=\"/where/cohorts/results/get/saved\"\n )\n\n cohort.plot_survival(on=\"os\")\n\n.. code:: python\n\n sample_1_tumor = Sample(\n is_tumor=True,\n bam_path_dna=\"/path/to/dna/bam\",\n bam_path_rna=\"/path/to/rna/bam\"\n )\n\n patient_1 = Patient(\n id=\"patient_1\",\n ...\n snv_vcf_paths=[\"/where/my/mutect/vcfs/live\",\n \"/where/my/strelka/vcfs/live\"]\n indel_vcfs_paths=[...],\n tumor_sample=sample_1_tumor,\n ...\n )\n\n cohort = Cohort(\n ...\n patients=[patient_1]\n )\n\n.. |PyPI| image:: https://img.shields.io/pypi/v/cohorts.svg?maxAge=21600\n :target: \n.. |Build Status| image:: https://travis-ci.org/hammerlab/cohorts.svg?branch=master\n :target: https://travis-ci.org/hammerlab/cohorts\n.. |Coverage Status| image:: https://coveralls.io/repos/hammerlab/cohorts/badge.svg?branch=master&service=github\n :target: https://coveralls.io/github/hammerlab/cohorts?branch=master", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/tavinathanson/cohorts", "keywords": "", "license": "http://www.apache.org/licenses/LICENSE-2.0.html", "maintainer": "", "maintainer_email": "", "name": "cohorts", "package_url": "https://pypi.org/project/cohorts/", "platform": "", "project_url": "https://pypi.org/project/cohorts/", "project_urls": { "Homepage": "https://github.com/tavinathanson/cohorts" }, "release_url": "https://pypi.org/project/cohorts/0.7.3/", "requires_dist": null, "requires_python": ">=3.3", "summary": "Utilities for analyzing mutations and neoepitopes in patient cohorts", "version": "0.7.3" }, "last_serial": 4686507, "releases": { "0.0.4": [ { "comment_text": "", "digests": { "md5": "21dc95324433742c44bf31e4be1f84af", "sha256": "b83dba7380717a21d181e98e114dd65ac0f2dc6e5638daa351d4724ac680c67c" }, "downloads": -1, "filename": "cohorts-0.0.4.tar.gz", "has_sig": false, "md5_digest": "21dc95324433742c44bf31e4be1f84af", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9388, "upload_time": "2016-04-19T17:50:02", "url": "https://files.pythonhosted.org/packages/23/22/fc62f4fe12018b785c964d263fd681f6591fd790dc1caedb68e90469e122/cohorts-0.0.4.tar.gz" } ], "0.0.5": [ { "comment_text": "", "digests": { "md5": "bf114706d3b6e31156d514b304ee0c28", "sha256": "a69c9d80521b28b59de5db7e50a9150909426f8c0df2ca534c281e18c4091524" }, "downloads": -1, "filename": "cohorts-0.0.5.tar.gz", "has_sig": false, "md5_digest": "bf114706d3b6e31156d514b304ee0c28", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9391, "upload_time": "2016-04-19T17:53:27", "url": "https://files.pythonhosted.org/packages/93/92/3ab2170eb982833ae99488eef3cbddc426fdc93b0933bd4d6b2e9e7ef65f/cohorts-0.0.5.tar.gz" } ], "0.1.0": [ { "comment_text": "", "digests": { "md5": "f8dc9a21ffacb5b188b9fa687c3cb9bd", "sha256": "17a4e555f0180b74cc1fa8ecec5d6ff3e466583bdddfdd6e30e8c263b5e8f8f8" }, "downloads": -1, "filename": "cohorts-0.1.0.tar.gz", "has_sig": false, "md5_digest": "f8dc9a21ffacb5b188b9fa687c3cb9bd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 29944, "upload_time": "2016-05-03T21:59:27", "url": "https://files.pythonhosted.org/packages/8b/82/05b52e973c7db037e2665972c6f8c06bd34ed7b2223d33a7b5c9e7bcf3e4/cohorts-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "b3e13c04163e11c645148bcd44bea460", "sha256": "70a40b7df3a5d55612c0619ac1e1a0b1e9276dbe501ca423896883be565dcac6" }, "downloads": -1, "filename": "cohorts-0.1.1.tar.gz", "has_sig": false, "md5_digest": "b3e13c04163e11c645148bcd44bea460", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 37230, "upload_time": "2016-06-14T15:48:46", "url": "https://files.pythonhosted.org/packages/65/d5/6ed2ff1b7c809717a02a7453ffc908d665086a925f95fa253511c43ec637/cohorts-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "82cb0fa41bf053735b554512c5f54019", "sha256": "3bf3ba2610f154835ccbe7447b86a7d4daef8732efc12a0a685143d7101abe3a" }, "downloads": -1, "filename": "cohorts-0.1.2.tar.gz", "has_sig": false, "md5_digest": "82cb0fa41bf053735b554512c5f54019", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 50502, "upload_time": "2016-08-17T00:15:12", "url": "https://files.pythonhosted.org/packages/d3/e9/7d1621b2f1c9e38365e8c8125825f4b0d1d31db6596593707b383ed67365/cohorts-0.1.2.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "b5ee17f770bac0dca99da09494e4f3f1", "sha256": "c4b18dd73f913c140f57aa17b5b3685fdb47b5657fe8dcda03bb898c77106c96" }, "downloads": -1, "filename": "cohorts-0.2.0.tar.gz", "has_sig": false, "md5_digest": "b5ee17f770bac0dca99da09494e4f3f1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 53522, "upload_time": "2016-09-22T19:58:55", "url": "https://files.pythonhosted.org/packages/41/7f/284f389ea2464daf88d8b5f320b3624d61e9e145071b61f81dd8bc56b5eb/cohorts-0.2.0.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "3c8a903bd6f00a52b209b2858dc1f703", "sha256": "a2f90dc928c6dc816361e89a3a23344ac257a73dea6572eb0f2248bb3fc66bf7" }, "downloads": -1, "filename": "cohorts-0.3.0.tar.gz", "has_sig": false, "md5_digest": "3c8a903bd6f00a52b209b2858dc1f703", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 54534, "upload_time": "2016-09-27T20:57:09", "url": "https://files.pythonhosted.org/packages/2d/95/17667d9f7573be18ffdc1a028ea00ad34a9a5c9b507254d8fb9ca871b82e/cohorts-0.3.0.tar.gz" } ], "0.4.0": [ { "comment_text": "", "digests": { "md5": "69536a648ba3b79cc5e8ea89d8f7eac5", "sha256": "ddf4afae9aa65f97adcaa7cdf2a596f4ad412b8f83fb2110121439e54567bec4" }, "downloads": -1, "filename": "cohorts-0.4.0.tar.gz", "has_sig": false, "md5_digest": "69536a648ba3b79cc5e8ea89d8f7eac5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 57527, "upload_time": "2016-09-28T16:49:41", "url": "https://files.pythonhosted.org/packages/b0/58/1d5df8f00ba68331b81b4af1c555f70cbd83a27387e7b799fbec7a6bee38/cohorts-0.4.0.tar.gz" } ], "0.4.1": [ { "comment_text": "", "digests": { "md5": "ca26d7b9a36762fb8e4cc9ca7db1e3ec", "sha256": "33143e545a58fbfaed54f25a57da7f6a2e90340cf0f5fb934465e3f5d8fe9958" }, "downloads": -1, "filename": "cohorts-0.4.1.tar.gz", "has_sig": false, "md5_digest": "ca26d7b9a36762fb8e4cc9ca7db1e3ec", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 58114, "upload_time": "2016-11-22T19:00:15", "url": "https://files.pythonhosted.org/packages/b0/78/b764e1ea95557bb902d3c0a3f6a74b07c9c8848a738249932631872a21e4/cohorts-0.4.1.tar.gz" } ], "0.4.2": [ { "comment_text": "", "digests": { "md5": "3b1381c3fbc346d628eef4af16a02784", "sha256": "53699489c8d8c284dfe5756c001132c03fe101773a6cb5418ba1a0c0c2017c3a" }, "downloads": -1, "filename": "cohorts-0.4.2.tar.gz", "has_sig": false, "md5_digest": "3b1381c3fbc346d628eef4af16a02784", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 59141, "upload_time": "2016-11-30T20:29:32", "url": "https://files.pythonhosted.org/packages/14/45/a538fc0306a43ef5bc096cc0a4ee2d5dc2c0dceab97733602834777a26a9/cohorts-0.4.2.tar.gz" } ], "0.5.1": [ { "comment_text": "", "digests": { "md5": "63cf69c91eec26e6545e62eea8a27722", "sha256": "3a4e964ca7a518834d3484224cfbc1727d31a98101fd5d520a564354f6ed9ffa" }, "downloads": -1, "filename": "cohorts-0.5.1.tar.gz", "has_sig": false, "md5_digest": "63cf69c91eec26e6545e62eea8a27722", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 63792, "upload_time": "2017-01-17T18:54:19", "url": "https://files.pythonhosted.org/packages/20/9f/205a01b720d4520cc3f84c9ec52b1be6840f8ead7a3d0b039b1968b8fe81/cohorts-0.5.1.tar.gz" } ], "0.5.2": [ { "comment_text": "", "digests": { "md5": "185776dec58a2e170d425613507a9a57", "sha256": "f787ad615ce830850ba1df59cf4dac282eef342fcec0fdadc5fc3c90fb3b7125" }, "downloads": -1, "filename": "cohorts-0.5.2.tar.gz", "has_sig": false, "md5_digest": "185776dec58a2e170d425613507a9a57", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 64051, "upload_time": "2017-01-18T22:21:42", "url": "https://files.pythonhosted.org/packages/47/ce/4f0c6176a14aa9bcf665a32dfa3c252f2780cdc545bdc83a2413ae2a3a59/cohorts-0.5.2.tar.gz" } ], "0.5.3": [ { "comment_text": "", "digests": { "md5": "0d785f74b091f372f43da2cbd66f31c1", "sha256": "2329144c5956ad334a75161d1f57e1d6c898bdfffa38c91fbea91bcdc5bb78ba" }, "downloads": -1, "filename": "cohorts-0.5.3.tar.gz", "has_sig": false, "md5_digest": "0d785f74b091f372f43da2cbd66f31c1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 67518, "upload_time": "2017-04-27T18:47:40", "url": "https://files.pythonhosted.org/packages/48/39/438fb9f605ce01df5e20e803c91ff32e66c7b8f9608839e49b11aff25c4e/cohorts-0.5.3.tar.gz" } ], "0.5.4": [ { "comment_text": "", "digests": { "md5": "ac55e1b4c451b95b94186fd1136dd856", "sha256": "bcc5d6b727216913a9ddfb979e9d39783b621b1b00b490414e657439a14d071b" }, "downloads": -1, "filename": "cohorts-0.5.4.tar.gz", "has_sig": false, "md5_digest": "ac55e1b4c451b95b94186fd1136dd856", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 67548, "upload_time": "2017-04-29T16:52:35", "url": "https://files.pythonhosted.org/packages/18/00/a30768996494e4a294742548a13b94dd3d80d76b3bd5b43eeb41dc106037/cohorts-0.5.4.tar.gz" } ], "0.5.5": [ { "comment_text": "", "digests": { "md5": "bf37512230f272bbeb5f8feca4b3f832", "sha256": "d3841de63014b93bce0a0c29ce7944ee4da78fb27706b3c8ae15ab86c4fb5344" }, "downloads": -1, "filename": "cohorts-0.5.5.tar.gz", "has_sig": false, "md5_digest": "bf37512230f272bbeb5f8feca4b3f832", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 67998, "upload_time": "2017-05-17T00:18:26", "url": "https://files.pythonhosted.org/packages/5f/ce/f5cbef942d5409915121e41f644ede181b0e463a01b5ef93c3fdb8d2e8fa/cohorts-0.5.5.tar.gz" } ], "0.6.2": [ { "comment_text": "", "digests": { "md5": "568e2c4a4b406519f745b2328a600aa5", "sha256": "837a4cdbc030cb54407f6b1fb79af3785dc391496b1c2135711175d15f025db9" }, "downloads": -1, "filename": "cohorts-0.6.2.tar.gz", "has_sig": false, "md5_digest": "568e2c4a4b406519f745b2328a600aa5", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.3", "size": 68178, "upload_time": "2017-05-19T17:51:53", "url": "https://files.pythonhosted.org/packages/a3/7d/d3b6c8925357e86b7f607f3c65b85290cc77e09aff75419186a627550d1d/cohorts-0.6.2.tar.gz" } ], "0.6.3": [ { "comment_text": "", "digests": { "md5": "9e97b54943b8c520c5c61a7271bbc0f7", "sha256": "bf6c2b038a684afd680598782406e469c445dee7db8a86977fc913ad18bd2b92" }, "downloads": -1, "filename": "cohorts-0.6.3.tar.gz", "has_sig": false, "md5_digest": "9e97b54943b8c520c5c61a7271bbc0f7", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.3", "size": 68174, "upload_time": "2017-05-28T15:26:07", "url": "https://files.pythonhosted.org/packages/66/df/7d8f9779f9a6ea1c9b30df40401637be56249838c68876b6a073b643a44e/cohorts-0.6.3.tar.gz" } ], "0.6.4": [ { "comment_text": "", "digests": { "md5": "3c4943bd5eeba8f3d476468d9fde8d89", "sha256": "12d55d7130917202c408fcf4f76de9aad286f64f2f9ebb99b645f6db68154b4b" }, "downloads": -1, "filename": "cohorts-0.6.4.tar.gz", "has_sig": false, "md5_digest": "3c4943bd5eeba8f3d476468d9fde8d89", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.3", "size": 68523, "upload_time": "2017-06-05T22:52:27", "url": "https://files.pythonhosted.org/packages/23/2b/183bfb6d98d4f9d8765bca45a03bb0a491f24270099e7a9eb1033cc39f60/cohorts-0.6.4.tar.gz" } ], "0.7.0": [ { "comment_text": "", "digests": { "md5": "37e46bc1f8dde57757ec00000f42db3f", "sha256": "4335fbdddb7eb3ea151aff9df65d6cdac762fd691ea5b514cd1c3064d34006c7" }, "downloads": -1, "filename": "cohorts-0.7.0.tar.gz", "has_sig": false, "md5_digest": "37e46bc1f8dde57757ec00000f42db3f", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.3", "size": 74641, "upload_time": "2017-08-30T00:27:42", "url": "https://files.pythonhosted.org/packages/4d/b7/d8697926196052d5d561c3c2d6f063616b478f030b0f53429107397a0038/cohorts-0.7.0.tar.gz" } ], "0.7.1": [ { "comment_text": "", "digests": { "md5": "b2dff8f54d14f7ad9c2c510a1c810637", "sha256": "64ce41d9e945cd944120f4a64b3510c2efe30e47d28d8e391252595feb54b507" }, "downloads": -1, "filename": "cohorts-0.7.1.tar.gz", "has_sig": false, "md5_digest": "b2dff8f54d14f7ad9c2c510a1c810637", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.3", "size": 75061, "upload_time": "2017-09-01T01:32:37", "url": "https://files.pythonhosted.org/packages/08/44/e9cfd406130faf8a961ec037394867e0a9d2c6f11a81d362381644f77a7d/cohorts-0.7.1.tar.gz" } ], "0.7.2": [ { "comment_text": "", "digests": { "md5": "6afa1235355715f15db6654a7ff8a16c", "sha256": "cb175a04a0c68e08baad2672bb1a9bd82b75253e9f6cdafdd70159f1744b5929" }, "downloads": -1, "filename": "cohorts-0.7.2.tar.gz", "has_sig": false, "md5_digest": "6afa1235355715f15db6654a7ff8a16c", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.3", "size": 75210, "upload_time": "2017-12-29T00:20:24", "url": "https://files.pythonhosted.org/packages/77/34/c5e3cdc8de201eae8d4d18553f810b7aef088106ba302a8cdb5d4101f91a/cohorts-0.7.2.tar.gz" } ], "0.7.3": [ { "comment_text": "", "digests": { "md5": "e80a670c45dfa275ae70891ba190de06", "sha256": "1bf0a4fb3fbaf670a2eb880a49e20395b5b33deac1f1f0ca1607f6643262b030" }, "downloads": -1, "filename": "cohorts-0.7.3.tar.gz", "has_sig": false, "md5_digest": "e80a670c45dfa275ae70891ba190de06", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.3", "size": 75229, "upload_time": "2017-12-30T21:14:42", "url": "https://files.pythonhosted.org/packages/27/18/b6abe228b176b8ac0d8b4dd13b2a62eaa4740f3af5e1d7d96edd0a4ab096/cohorts-0.7.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "e80a670c45dfa275ae70891ba190de06", "sha256": "1bf0a4fb3fbaf670a2eb880a49e20395b5b33deac1f1f0ca1607f6643262b030" }, "downloads": -1, "filename": "cohorts-0.7.3.tar.gz", "has_sig": false, "md5_digest": "e80a670c45dfa275ae70891ba190de06", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.3", "size": 75229, "upload_time": "2017-12-30T21:14:42", "url": "https://files.pythonhosted.org/packages/27/18/b6abe228b176b8ac0d8b4dd13b2a62eaa4740f3af5e1d7d96edd0a4ab096/cohorts-0.7.3.tar.gz" } ] }