{ "info": { "author": "Konstantin Tretyakov", "author_email": "kt@ut.ee", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Science/Research", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 2", "Programming Language :: Python :: 3", "Topic :: Scientific/Engineering :: Bio-Informatics" ], "description": "============================================================================\nPure-python implementation of UCSC ``liftOver`` genome coordinate conversion\n============================================================================\n\n.. image:: https://travis-ci.org/konstantint/pyliftover.png?branch=master :target: https://travis-ci.org/konstantint/pyliftover\n\nPyLiftover is a library for quick and easy conversion of genomic (point) coordinates between different assemblies.\n\nIt uses the same logic and coordinate conversion mappings as the UCSC `liftOver tool `_.\n\nAs of current version (0.2), PyLiftover only does conversion of point coordinates, that is, \nunlike ``liftOver``, it does not convert ranges, nor does it provide any special facilities to work with BED files.\nFor single-point coordinates it produces exactly the same output as ``liftOver`` (verified with at least the ``hg17ToHg18.over.chain.gz`` file for now).\n\nInstallation\n------------\n\nThe simplest way to install the package is via ``easy_install`` or ``pip``::\n\n $ easy_install pyliftover\n\nUsage\n-----\nThe primary usage example, supported by the library is the following::\n\n from pyliftover import LiftOver\n lo = LiftOver('hg17', 'hg18')\n lo.convert_coordinate('chr1', 1000000)\n\nThe first line will automatically download the hg17-to-hg18 coordinate conversion `chain file `_ from UCSC,\nunless it is already cached or available in the current directory. Alternatively, you may provide your own chain file::\n\n lo = LiftOver('hg17ToHg18.over.chain.gz')\n lo.convert_coordinate('chr1', 1000000, '-')\n\nThe result of ``lo.convert_coordinate`` call is either ``None`` (if the source chromosome name is unrecognized) or a list of target positions in the\nnew assembly. The list may be empty (locus is deleted in the new assembly), have a single element (locus matched uniquely), or, in principle, \nhave multiple elements (although this is probably a rare occasion for most default intra-species genomic conversions).\nNote that coordinates in the tool are 0-based. That is, a position that you would refer to in the genome browser by ``chr1:10`` \ncorresponds to coordinate ``9`` in PyLiftover's terms.\n\nAlthough you may try to apply the tool with arbitrary chain files, like the original ``liftOver`` tool, it makes most sense for conversion of \ncoordinates between different assemblies of the same species.\n\n\nSee also\n--------\n\n* Blog post: http://fouryears.eu/2013/02/25/the-curse-of-genomic-coordinates/\n* Report issues and submit fixes at Github: https://github.com/konstantint/pyliftover", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/konstantint/pyliftover", "keywords": "bioinformatics liftover genome-analysis", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "pyliftover", "package_url": "https://pypi.org/project/pyliftover/", "platform": "Platform Independent", "project_url": "https://pypi.org/project/pyliftover/", "project_urls": { "Homepage": "https://github.com/konstantint/pyliftover" }, "release_url": "https://pypi.org/project/pyliftover/0.4/", "requires_dist": null, "requires_python": "", "summary": "Pure-python implementation of UCSC ``liftOver`` genome coordinate conversion.", "version": "0.4" }, "last_serial": 5317287, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "7f0d7e16f9df6f22f3a5da3f4126bfe3", "sha256": "49413709dc34f93e3f0d1e0ee459d2ade47acc61868ffee0365460c9c0286d37" }, "downloads": -1, "filename": "pyliftover-0.1.zip", "has_sig": false, "md5_digest": "7f0d7e16f9df6f22f3a5da3f4126bfe3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14530, "upload_time": "2013-02-23T03:35:49", "url": "https://files.pythonhosted.org/packages/8c/c8/11185e5af7617c34052aba42fb45ed7145101efc725efc890228f1e5032c/pyliftover-0.1.zip" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "b4e92f14dc9418710005dca4e7a569d8", "sha256": "3b23f8c7d31a57325e3fd5dbded762d748604116d4663e979b984b7991be6f3b" }, "downloads": -1, "filename": "pyliftover-0.2.zip", "has_sig": false, "md5_digest": "b4e92f14dc9418710005dca4e7a569d8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15371, "upload_time": "2013-03-21T15:46:48", "url": "https://files.pythonhosted.org/packages/3f/6d/43419938c716554b734259d02659102df4c218bab6c7f18d624310d603e7/pyliftover-0.2.zip" } ], "0.3": [ { "comment_text": "", "digests": { "md5": "db3a4cf5fbfce534d8978dac66f2f039", "sha256": "8feaa3106e55705291feb70bb82be0861d7ba2306911a3ad42ceed1a2df19299" }, "downloads": -1, "filename": "pyliftover-0.3.zip", "has_sig": false, "md5_digest": "db3a4cf5fbfce534d8978dac66f2f039", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15836, "upload_time": "2014-03-15T22:53:10", "url": "https://files.pythonhosted.org/packages/95/1a/85ca6e7cbfcc6a3d0e480d446791ff56388235ffc9c922a8067994b5f44f/pyliftover-0.3.zip" } ], "0.4": [ { "comment_text": "", "digests": { "md5": "666d3e8ad0fd25ce0aa4eb3e0a796c09", "sha256": "72bcfb7de907569b0eb75e86c817840365297d63ba43a961da394187e399da41" }, "downloads": -1, "filename": "pyliftover-0.4.tar.gz", "has_sig": false, "md5_digest": "666d3e8ad0fd25ce0aa4eb3e0a796c09", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10708, "upload_time": "2019-05-25T20:44:37", "url": "https://files.pythonhosted.org/packages/c0/20/4386926f08410d472ed81c1f14f25069dac3d62d21e2c1c366eff7b8a035/pyliftover-0.4.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "666d3e8ad0fd25ce0aa4eb3e0a796c09", "sha256": "72bcfb7de907569b0eb75e86c817840365297d63ba43a961da394187e399da41" }, "downloads": -1, "filename": "pyliftover-0.4.tar.gz", "has_sig": false, "md5_digest": "666d3e8ad0fd25ce0aa4eb3e0a796c09", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10708, "upload_time": "2019-05-25T20:44:37", "url": "https://files.pythonhosted.org/packages/c0/20/4386926f08410d472ed81c1f14f25069dac3d62d21e2c1c366eff7b8a035/pyliftover-0.4.tar.gz" } ] }