{ "info": { "author": "Chunlei Wu, Cyrus Afrasiabi, Sebastien Lelong", "author_email": "cwu@scripps.edu", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "Intended Audience :: Science/Research", "License :: OSI Approved :: BSD License", "Operating System :: MacOS :: MacOS X", "Operating System :: Microsoft :: Windows", "Operating System :: OS Independent", "Operating System :: POSIX", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Topic :: Scientific/Engineering :: Bio-Informatics", "Topic :: Utilities" ], "description": ".. image:: https://badge.fury.io/py/mygene.svg\n :target: https://pypi.org/project/mygene/\n\n.. image:: https://img.shields.io/pypi/pyversions/mygene.svg\n :target: https://pypi.org/project/mygene/\n\n.. image:: https://img.shields.io/pypi/format/mygene.svg\n :target: https://pypi.org/project/mygene/\n\n.. image:: https://img.shields.io/pypi/status/mygene.svg\n :target: https://pypi.org/project/mygene/\n\nIntro\n=====\n\nMyGene.Info_ provides simple-to-use REST web services to query/retrieve gene annotation data.\nIt's designed with simplicity and performance emphasized. ``mygene``, is an easy-to-use Python\nwrapper to access MyGene.Info_ services.\n\n.. _MyGene.Info: http://mygene.info\n.. _biothings_client: https://pypi.org/project/biothings-client/\n.. _mygene: https://pypi.org/project/mygene/\n\nAs of v3.1.0, mygene_ Python package is now a thin wrapper of underlying biothings_client_ package,\na universal Python client for all `BioThings APIs `_, including MyGene.info_.\nThe installation of mygene_ will install biothings_client_ automatically. The following code snippets\nare essentially equivalent:\n\n\n* Continue using mygene_ package\n\n .. code-block:: python\n\n In [1]: import mygene\n In [2]: mg = mygene.MyGeneInfo()\n\n* Use biothings_client_ package directly\n\n .. code-block:: python\n\n In [1]: from biothings_client import get_client\n In [2]: mg = get_client('gene')\n\nAfter that, the use of ``mg`` instance is exactly the same, e.g. the usage examples below.\n\nRequirements\n============\n python >=2.7 (including python3)\n\n (Python 2.6 might still work, not it's not supported any more since v3.1.0.)\n\n biothings_client_ (>=0.2.0, install using \"pip install biothings_client\")\n\nOptional dependencies\n======================\n `pandas `_ (install using \"pip install pandas\") is required for\n returning a list of gene objects as `DataFrame `_.\n\nInstallation\n=============\n\n Option 1\n pip install mygene\n\n Option 2\n download/extract the source code and run::\n\n python setup.py install\n\n Option 3\n install the latest code directly from the repository::\n\n pip install -e git+https://github.com/biothings/mygene.py#egg=mygene\n\nVersion history\n===============\n\n `CHANGES.txt `_\n\nTutorial\n=========\n\n* `ID mapping using mygene module in Python `_\n\nDocumentation\n=============\n\n http://mygene-py.readthedocs.org/\n\nUsage\n=====\n\n.. code-block:: python\n\n In [1]: import mygene\n\n In [2]: mg = mygene.MyGeneInfo()\n\n In [3]: mg.getgene(1017)\n Out[3]:\n {'_id': '1017',\n 'entrezgene': 1017,\n 'name': 'cyclin-dependent kinase 2',\n 'symbol': 'CDK2',\n 'taxid': 9606}\n\n In [4]: mg.getgene(1017, 'name,symbol,refseq')\n Out[4]:\n {'_id': '1017',\n 'name': 'cyclin-dependent kinase 2',\n 'refseq': {'genomic': ['AC_000144.1',\n 'NC_000012.11',\n 'NG_028086.1',\n 'NT_029419.12',\n 'NW_001838059.1'],\n 'protein': ['NP_001789.2', 'NP_439892.2'],\n 'rna': ['NM_001798.3', 'NM_052827.2']},\n 'symbol': 'CDK2'}\n\n In [5]: mg.getgene(1017, 'name,symbol,refseq.rna')\n Out[5]:\n {'_id': '1017',\n 'name': 'cyclin-dependent kinase 2',\n 'refseq': {'rna': ['NM_001798', 'NM_052827']},\n 'symbol': 'CDK2'}\n\n\n In [6]: mg.getgenes([1017,1018,'ENSG00000148795'])\n Out[6]:\n [{'_id': '1017',\n 'entrezgene': 1017,\n 'name': 'cyclin-dependent kinase 2',\n 'query': '1017',\n 'symbol': 'CDK2',\n 'taxid': 9606},\n {'_id': '1018',\n 'entrezgene': 1018,\n 'name': 'cyclin-dependent kinase 3',\n 'query': '1018',\n 'symbol': 'CDK3',\n 'taxid': 9606},\n {'_id': '1586',\n 'entrezgene': 1586,\n 'name': 'cytochrome P450, family 17, subfamily A, polypeptide 1',\n 'query': 'ENSG00000148795',\n 'symbol': 'CYP17A1',\n 'taxid': 9606}]\n\n In [7]: mg.getgenes([1017,1018,'ENSG00000148795'], as_dataframe=True)\n Out[7]:\n _id entrezgene \\\n query\n 1017 1017 1017\n 1018 1018 1018\n ENSG00000148795 1586 1586\n\n name symbol \\\n query\n 1017 cyclin-dependent kinase 2 CDK2\n 1018 cyclin-dependent kinase 3 CDK3\n ENSG00000148795 cytochrome P450, family 17, subfamily A, polyp... CYP17A1\n\n taxid\n query\n 1017 9606\n 1018 9606\n ENSG00000148795 9606\n\n [3 rows x 5 columns]\n\n In [8]: mg.query('cdk2', size=5)\n Out[8]:\n {'hits': [{'_id': '1017',\n '_score': 373.24667,\n 'entrezgene': 1017,\n 'name': 'cyclin-dependent kinase 2',\n 'symbol': 'CDK2',\n 'taxid': 9606},\n {'_id': '12566',\n '_score': 353.90176,\n 'entrezgene': 12566,\n 'name': 'cyclin-dependent kinase 2',\n 'symbol': 'Cdk2',\n 'taxid': 10090},\n {'_id': '362817',\n '_score': 264.88477,\n 'entrezgene': 362817,\n 'name': 'cyclin dependent kinase 2',\n 'symbol': 'Cdk2',\n 'taxid': 10116},\n {'_id': '52004',\n '_score': 21.221401,\n 'entrezgene': 52004,\n 'name': 'CDK2-associated protein 2',\n 'symbol': 'Cdk2ap2',\n 'taxid': 10090},\n {'_id': '143384',\n '_score': 18.617256,\n 'entrezgene': 143384,\n 'name': 'CDK2-associated, cullin domain 1',\n 'symbol': 'CACUL1',\n 'taxid': 9606}],\n 'max_score': 373.24667,\n 'took': 10,\n 'total': 28}\n\n In [9]: mg.query('reporter:1000_at')\n Out[9]:\n {'hits': [{'_id': '5595',\n '_score': 11.163337,\n 'entrezgene': 5595,\n 'name': 'mitogen-activated protein kinase 3',\n 'symbol': 'MAPK3',\n 'taxid': 9606}],\n 'max_score': 11.163337,\n 'took': 6,\n 'total': 1}\n\n In [10]: mg.query('symbol:cdk2', species='human')\n Out[10]:\n {'hits': [{'_id': '1017',\n '_score': 84.17707,\n 'entrezgene': 1017,\n 'name': 'cyclin-dependent kinase 2',\n 'symbol': 'CDK2',\n 'taxid': 9606}],\n 'max_score': 84.17707,\n 'took': 27,\n 'total': 1}\n\n In [11]: mg.querymany([1017, '695'], scopes='entrezgene', species='human')\n Finished.\n Out[11]:\n [{'_id': '1017',\n 'entrezgene': 1017,\n 'name': 'cyclin-dependent kinase 2',\n 'query': '1017',\n 'symbol': 'CDK2',\n 'taxid': 9606},\n {'_id': '695',\n 'entrezgene': 695,\n 'name': 'Bruton agammaglobulinemia tyrosine kinase',\n 'query': '695',\n 'symbol': 'BTK',\n 'taxid': 9606}]\n\n In [12]: mg.querymany([1017, '695'], scopes='entrezgene', species=9606)\n Finished.\n Out[12]:\n [{'_id': '1017',\n 'entrezgene': 1017,\n 'name': 'cyclin-dependent kinase 2',\n 'query': '1017',\n 'symbol': 'CDK2',\n 'taxid': 9606},\n {'_id': '695',\n 'entrezgene': 695,\n 'name': 'Bruton agammaglobulinemia tyrosine kinase',\n 'query': '695',\n 'symbol': 'BTK',\n 'taxid': 9606}]\n\n In [13]: mg.querymany([1017, '695'], scopes='entrezgene', species=9606, as_dataframe=True)\n Finished.\n Out[13]:\n _id entrezgene name symbol \\\n query\n 1017 1017 1017 cyclin-dependent kinase 2 CDK2\n 695 695 695 Bruton agammaglobulinemia tyrosine kinase BTK\n\n taxid\n query\n 1017 9606\n 695 9606\n\n [2 rows x 5 columns]\n\n In [14]: mg.querymany([1017, '695', 'NA_TEST'], scopes='entrezgene', species='human')\n Finished.\n Out[14]:\n [{'_id': '1017',\n 'entrezgene': 1017,\n 'name': 'cyclin-dependent kinase 2',\n 'query': '1017',\n 'symbol': 'CDK2',\n 'taxid': 9606},\n {'_id': '695',\n 'entrezgene': 695,\n 'name': 'Bruton agammaglobulinemia tyrosine kinase',\n 'query': '695',\n 'symbol': 'BTK',\n 'taxid': 9606},\n {'notfound': True, 'query': 'NA_TEST'}]\n\n # query all human kinases using fetch_all parameter:\n In [15]: kinases = mg.query('name:kinase', species='human', fetch_all=True)\n In [16]: kinases\n Out [16]\" \n\n # kinases is a Python generator, now you can loop through it to get all 1073 hits:\n In [16]: for gene in kinases:\n ....: print gene['_id'], gene['symbol']\n Out [16]: \n\n\nContact\n========\nDrop us any question or feedback:\n * biothings@googlegroups.com (public discussion)\n * help@mygene.info (reach devs privately)\n * `Github issues `_\n * on twitter `@mygeneinfo `_\n * Post a question on `BioStars.org `_ with tag #mygene.\n\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/biothings/mygene.py", "keywords": "biology gene annotation web service client api", "license": "BSD", "maintainer": "", "maintainer_email": "", "name": "mygene", "package_url": "https://pypi.org/project/mygene/", "platform": "", "project_url": "https://pypi.org/project/mygene/", "project_urls": { "Homepage": "https://github.com/biothings/mygene.py" }, "release_url": "https://pypi.org/project/mygene/3.1.0/", "requires_dist": [ "biothings-client (>=0.2.0)" ], "requires_python": "", "summary": "Python Client for MyGene.Info services.", "version": "3.1.0" }, "last_serial": 4610264, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "8430d7fd5094752b2e4b3c3656562e28", "sha256": "da9d44b738f35b6a1627c068d4655c3c936152ad2f79a3348be04abbdc907c61" }, "downloads": -1, "filename": "mygene-0.1.0.tar.gz", "has_sig": false, "md5_digest": "8430d7fd5094752b2e4b3c3656562e28", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7493, "upload_time": "2012-08-31T00:13:01", "url": "https://files.pythonhosted.org/packages/1f/fc/bc47710d57bb3ae25e04bb3811ba654802b5162c541fa61f4b1694e8e9aa/mygene-0.1.0.tar.gz" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "a95001041c8cf53ada958867236cd837", "sha256": "185e7ce91c8485258769b986d6cfb9e45e5cfa7ff2b817ffefb4b1c61ea4ff2d" }, "downloads": -1, "filename": "mygene-1.0.0.tar.gz", "has_sig": false, "md5_digest": "a95001041c8cf53ada958867236cd837", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6896, "upload_time": "2013-06-19T00:59:55", "url": "https://files.pythonhosted.org/packages/61/aa/dde62272061252ef140c9cf13227aabd94462f69d325dfe70f27a56cfdc4/mygene-1.0.0.tar.gz" } ], "2.0.0": [ { "comment_text": "", "digests": { "md5": "f6d246b851999523f420cb509611ba3a", "sha256": "9524be743c6807d39670cb1237c5d67fc102c53e932652cc058cc8137e48327c" }, "downloads": -1, "filename": "mygene-2.0.0.tar.gz", "has_sig": false, "md5_digest": "f6d246b851999523f420cb509611ba3a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6471, "upload_time": "2013-07-12T00:36:51", "url": "https://files.pythonhosted.org/packages/43/f9/1af0475e3a775bdca5bd845f0b8d05f67ffb62fc403cd74c1c4f208748b0/mygene-2.0.0.tar.gz" } ], "2.0.1": [ { "comment_text": "", "digests": { "md5": "0bb0b3f14a44be03790321c8258536d8", "sha256": "4d23e03e57779767535e5d78b5145da3bd4c86e161b1b7dc1a24b71705f7051c" }, "downloads": -1, "filename": "mygene-2.0.1.tar.gz", "has_sig": false, "md5_digest": "0bb0b3f14a44be03790321c8258536d8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6552, "upload_time": "2013-10-01T17:06:10", "url": "https://files.pythonhosted.org/packages/6e/ce/7688c2c15280d1d0299d22a71595d67cc83fcf7daae1b56c34a354574c75/mygene-2.0.1.tar.gz" } ], "2.1.0": [ { "comment_text": "", "digests": { "md5": "6cfea4deb7eb07adf49b03ae7e386e9f", "sha256": "107f931f18e15a55cd72b0498de83be09103b63629382fbd27831abcd44de5d2" }, "downloads": -1, "filename": "mygene-2.1.0.tar.gz", "has_sig": false, "md5_digest": "6cfea4deb7eb07adf49b03ae7e386e9f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6736, "upload_time": "2014-01-08T19:55:29", "url": "https://files.pythonhosted.org/packages/a1/b2/d121c5ac22abc643f544e5a985b7403a0299ce91bdb4d8c70beb2bd11492/mygene-2.1.0.tar.gz" } ], "2.2.0": [ { "comment_text": "", "digests": { "md5": "3ef36a7ed2b419ca812af2972d471905", "sha256": "dcd1d9de9c9743c4e30471808c51db4b3d621e4a43ec1e8d8116abec7344694e" }, "downloads": -1, "filename": "mygene-2.2.0.tar.gz", "has_sig": false, "md5_digest": "3ef36a7ed2b419ca812af2972d471905", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9125, "upload_time": "2014-07-29T20:44:31", "url": "https://files.pythonhosted.org/packages/69/9e/3f22b1b836084b592b98a78bf34a3c63852f0c927851d798a893dbb2f493/mygene-2.2.0.tar.gz" } ], "2.3.0": [ { "comment_text": "", "digests": { "md5": "2708decf3a482dc9654ff9df7980bbbc", "sha256": "8ee8274c1483970179972d2e893035a1fc4877a86abc5e096c19cae2dc851f28" }, "downloads": -1, "filename": "mygene-2.3.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "2708decf3a482dc9654ff9df7980bbbc", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 11559, "upload_time": "2015-12-11T01:19:14", "url": "https://files.pythonhosted.org/packages/a8/3d/aa55b83f940b59b625c0f4df6f59acd8d6397800ec3d99ac920f9d4a0568/mygene-2.3.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "33d653621b03da522f9f02770f20cab2", "sha256": "fc837423216c106b9c369e45e504c033d46658a8502445cfd89a475b2b9d959f" }, "downloads": -1, "filename": "mygene-2.3.0.tar.gz", "has_sig": false, "md5_digest": "33d653621b03da522f9f02770f20cab2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11092, "upload_time": "2015-12-11T01:19:08", "url": "https://files.pythonhosted.org/packages/ce/ca/31ba068bd4a4752cc69f2503cd8381dd5c71a8a8979e1a8ec86801b78e82/mygene-2.3.0.tar.gz" } ], "3.0.0": [ { "comment_text": "", "digests": { "md5": "13e41aa2851fd0d798c930f0a5b62459", "sha256": "20c74296fd8fea96bbf498fba8190a11f7838fdd9d1009d7089f399310d09edf" }, "downloads": -1, "filename": "mygene-3.0.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "13e41aa2851fd0d798c930f0a5b62459", "packagetype": "bdist_wheel", "python_version": "3.5", "requires_python": null, "size": 12768, "upload_time": "2016-08-10T16:07:26", "url": "https://files.pythonhosted.org/packages/16/ef/67ae813d239505424cc8c77823aa1a9677a9d80b9ab62da94581a49ecae6/mygene-3.0.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "cf1e1182619c7506bf15d0d4f88badf2", "sha256": "36e5e42e05ade82141b7a82e5f9249546fabe5e9f47fe18c1535e6cedc603314" }, "downloads": -1, "filename": "mygene-3.0.0.tar.gz", "has_sig": false, "md5_digest": "cf1e1182619c7506bf15d0d4f88badf2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11259, "upload_time": "2016-08-10T16:07:24", "url": "https://files.pythonhosted.org/packages/53/94/6c9975eef99f64cecef912de80615223abfb6dab804bc600b4fe1104eee8/mygene-3.0.0.tar.gz" } ], "3.1.0": [ { "comment_text": "", "digests": { "md5": "5dcc7fcff7858c8d0dbd62db1bb66bb3", "sha256": "0baa2d84748b54b951c773d9af34a149befb598c57c6cf36d910e82fead17e21" }, "downloads": -1, "filename": "mygene-3.1.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "5dcc7fcff7858c8d0dbd62db1bb66bb3", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 4168, "upload_time": "2018-12-18T00:42:10", "url": "https://files.pythonhosted.org/packages/10/30/596b5e4077c46add8782de6ac54c173d10b8f15db5bf57d6d8538565c468/mygene-3.1.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b976bb97adb2634682bc2eb7e07d988c", "sha256": "307305d83b5f9c0722dd8a78642d59c0d9d7742e60f548040819274a330d53af" }, "downloads": -1, "filename": "mygene-3.1.0.tar.gz", "has_sig": false, "md5_digest": "b976bb97adb2634682bc2eb7e07d988c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4860, "upload_time": "2018-12-18T00:42:12", "url": "https://files.pythonhosted.org/packages/13/7c/2e222bba58e788855e777e431b5528d9e545901f9699dae386fe2478b80a/mygene-3.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "5dcc7fcff7858c8d0dbd62db1bb66bb3", "sha256": "0baa2d84748b54b951c773d9af34a149befb598c57c6cf36d910e82fead17e21" }, "downloads": -1, "filename": "mygene-3.1.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "5dcc7fcff7858c8d0dbd62db1bb66bb3", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 4168, "upload_time": "2018-12-18T00:42:10", "url": "https://files.pythonhosted.org/packages/10/30/596b5e4077c46add8782de6ac54c173d10b8f15db5bf57d6d8538565c468/mygene-3.1.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b976bb97adb2634682bc2eb7e07d988c", "sha256": "307305d83b5f9c0722dd8a78642d59c0d9d7742e60f548040819274a330d53af" }, "downloads": -1, "filename": "mygene-3.1.0.tar.gz", "has_sig": false, "md5_digest": "b976bb97adb2634682bc2eb7e07d988c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4860, "upload_time": "2018-12-18T00:42:12", "url": "https://files.pythonhosted.org/packages/13/7c/2e222bba58e788855e777e431b5528d9e545901f9699dae386fe2478b80a/mygene-3.1.0.tar.gz" } ] }