{ "info": { "author": "John Didion", "author_email": "jdidion@dnanexus.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "# IndexTools\n\nCommon index formats, such as BAM Index (BAI) and Tabix (TBI), contain coarse-grained information on the density of NGS reads along the genome that may be leveraged for rapid approximation of read depth-based metrics. IndexTools is a toolkit for extremely fast NGS analysis based on index files.\n\n## Installation\n\n### Pre-requisites\n\n* Python 3.6+\n\n### Pip\n\n```bash\npip install indextools\n```\n\n### From source\n\n* Clone the repository\n ```\n git clone https://github.com/dnanexus/IndexTools.git\n ```\n* You'll need several tools to run the full install and release process\n * [git](https://git-scm.com/)\n * [curl](https://curl.haxx.se/)\n * [make](https://www.gnu.org/software/make/)\n * [Poetry](https://github.com/sdispater/poetry)\n * [Black](https://github.com/python/black)\n * [Flake8](http://flake8.pycqa.org/en/latest/)\n * [Dunamai](https://github.com/mtkennerly/dunamai)\n* Then\n ```bash\n # Install locally\n $ make install\n # Release new version (if you are a maintainer)\n $ make release version= token=\n ```\n\n## Commands\n\n### Partition\n\nThe `partition` command processes a BAM index file and generates a file in BED format that contains intervals that are roughly equal in \"[volume](#volume).\" This partition BAM file can be used for more efficient parallelization of secondary analysis tools (as opposed to parallelizing by chromosome or by uniform windows).\n\n```bash\n# Generate a BED with 10 partitions\nindextools partition -I tests/data/small.bam.bai \\\n -z tests/data/contig_sizes.txt \\\n -n 10 \\\n -o small.partitions.bed\n```\n\n## Limitations\n\nIndexTools is under active development. Please see the [issue tracker](https://github.com/dnanexus/IndexTools/issues) and [road map](https://github.com/dnanexus/IndexTools/projects/1) to view upcoming features.\n\nSome of the most commonly requested features that are not yet available are:\n\n* Support for CRAM files and CRAM indexes (.crai).\n* Support for non-local files, via URIs.\n\n## Development\n\nWe welcome contributions from the community. Please see the [developer README](https://github.com/dnanexus/IndexTools/blob/develop/CONTRIBUTING.md) for details.\n\nContributors are required to abide by our [Code of Conduct](https://github.com/dnanexus/IndexTools/blob/develop/CODE_OF_CONDUCT.md).\n\n## Technical details\n\n### Volume\n\nIn a bioinformatics context, the term \u201csize\u201d is overloaded. It is used to refer to the linear size of a genomic region (number of bp), disk size (number of bytes), or number of features (e.g. read count). IndexTools estimates the approximate number of bytes required to store the uncompressed data of features within a given genomic region. To avoid confusion or conflation with any of the meanings of \u201csize,\u201d we chose instead to use the term \u201cvolume\u201d to refer to the approximate size (in bytes) of a given genomic region. It is almost never important or useful to be able to interpret the meaning of a given volume, nor can volume be meaningfully translated to other units; volume is primarily useful as a relative measure. Thus, we use the made-up unit \u201cV\u201d when referring to any specific volume.\n\n## License\n\nIndexTools is Copyright (c) 2019 DNAnexus, Inc.; and is made available under the [MIT License](https://github.com/dnanexus/IndexTools/blob/develop/LICENSE).\n\nIndexTools is *not* an officially supported DNAnexus product. All bug reports and feature requests should be handled via the [issue tracker](https://github.com/dnanexus/IndexTools/issues). Please *do not* contact DNAnexus support regarding this software.\n\n## Acknowledgements\n\n* The initial inspiration for IndexTools came from @brentp's [indexcov](https://github.com/brentp/goleft/tree/master/indexcov).\n* IndexTools is built on several open-source libraries; see the [pyproject.toml](https://github.com/dnanexus/IndexTools/blob/develop/pyproject.toml) file for a full list.\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/dnanexus/indextools", "keywords": "", "license": "MIT", "maintainer": "John Didion", "maintainer_email": "jdidion@dnanexus.com", "name": "indextools", "package_url": "https://pypi.org/project/indextools/", "platform": "", "project_url": "https://pypi.org/project/indextools/", "project_urls": { "Homepage": "https://github.com/dnanexus/indextools", "Repository": "https://github.com/dnanexus/indextools.git" }, "release_url": "https://pypi.org/project/indextools/0.1.4/", "requires_dist": [ "autoclick (>=0.6.1,<0.7.0)", "loguru (>=0.3.2,<0.4.0)", "ngsindex (>=0.1.7,<0.2.0)", "pysam (>=0.15,<0.16)", "xphyle (>=4.1.3,<5.0.0)" ], "requires_python": ">=3.6,<4.0", "summary": "A toolkit for accelerating genomics using index files.", "version": "0.1.4" }, "last_serial": 5972122, "releases": { "0.1.1": [ { "comment_text": "", "digests": { "md5": "7a3ad556c6e6b0c40f43341ad763abb9", "sha256": "6817903f7f50662dca437d6f549c0704eda324871583ce54ea9361b3e39617bf" }, "downloads": -1, "filename": "indextools-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "7a3ad556c6e6b0c40f43341ad763abb9", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 78233, "upload_time": "2019-05-16T14:46:15", "url": "https://files.pythonhosted.org/packages/48/01/c9686643f0859ef9936ae4efb70d0e9942de518b5b63ee7f80fa41abe73c/indextools-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "9d56f1416438e3d71ef514fc6bd44ae1", "sha256": "f90b7e78c9dfde368c65c95d62f085d18b9afbc675c547d8ad2d511ebf46f942" }, "downloads": -1, "filename": "indextools-0.1.1.tar.gz", "has_sig": false, "md5_digest": "9d56f1416438e3d71ef514fc6bd44ae1", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 20090, "upload_time": "2019-05-16T14:46:17", "url": "https://files.pythonhosted.org/packages/74/8c/657a1e9009bcb427d619117a6fe8bd901509c9f1850f5eccff9052de7ea2/indextools-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "b4de55c74f2920d655f1f3fa169ea37a", "sha256": "e53a583180410eb382ffc1c76d461b20a47f4dde8ca07a09705bef11ea20e4fd" }, "downloads": -1, "filename": "indextools-0.1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "b4de55c74f2920d655f1f3fa169ea37a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 80558, "upload_time": "2019-05-16T14:50:31", "url": "https://files.pythonhosted.org/packages/93/84/3645bdd1079936e6d4b3c452d52172dea89b12da6627ffa2bbf8c4916afd/indextools-0.1.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "5ac00e8dd570d88daf8374a32bac352f", "sha256": "184bca3389edeabeba292c1ac138cfde4a7d6a4c00d09b9a55fceb02d47e322c" }, "downloads": -1, "filename": "indextools-0.1.2.tar.gz", "has_sig": false, "md5_digest": "5ac00e8dd570d88daf8374a32bac352f", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 23259, "upload_time": "2019-05-16T14:50:32", "url": "https://files.pythonhosted.org/packages/3a/c8/5021cbd2535c7b490ff2fbc88442c2237fdd0ec3bbb72933ca553f5804c2/indextools-0.1.2.tar.gz" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "58ab5ce69242608a785670b504f7044e", "sha256": "fbfcc7c04f585a9c551ea6ccc8736a0e820e74aa0e889dc6feae21bda2a137a9" }, "downloads": -1, "filename": "indextools-0.1.3-py3-none-any.whl", "has_sig": false, "md5_digest": "58ab5ce69242608a785670b504f7044e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 380252, "upload_time": "2019-09-28T01:56:26", "url": "https://files.pythonhosted.org/packages/1c/15/56620dec6ae4846f0ca055e0bf9db5082e0b62a953a74e160b05065a54ae/indextools-0.1.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "46cbebf244640b888df44442c82d3827", "sha256": "a4b806655ffa55fe5e1d779ce4c409fd9a66e235cd4cd6c7dcbabaaaa541dc42" }, "downloads": -1, "filename": "indextools-0.1.3.tar.gz", "has_sig": false, "md5_digest": "46cbebf244640b888df44442c82d3827", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 364059, "upload_time": "2019-09-28T01:56:28", "url": "https://files.pythonhosted.org/packages/1c/8b/b9ffcd59f5f0480cdae170cab0cc02839b854c17ede841b175416f66140f/indextools-0.1.3.tar.gz" } ], "0.1.4": [ { "comment_text": "", "digests": { "md5": "1c979caf171598248c90af988e65b923", "sha256": "ef7e48d282050b9baa1d40de6fcd4fbb3ec574ca0ba05141c0d9b865b05e87a8" }, "downloads": -1, "filename": "indextools-0.1.4-cp36-cp36m-macosx_10_13_x86_64.whl", "has_sig": false, "md5_digest": "1c979caf171598248c90af988e65b923", "packagetype": "bdist_wheel", "python_version": "cp36", "requires_python": ">=3.6,<4.0", "size": 234367, "upload_time": "2019-10-14T15:41:10", "url": "https://files.pythonhosted.org/packages/55/15/c51f4b2305917e016dbface61a84a9ada20f8922e5ab1cace8eda1abe8f2/indextools-0.1.4-cp36-cp36m-macosx_10_13_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "39bab878a6d61ffbbbaace7d1824b7bd", "sha256": "bfba993dfb0ea2cf00b6f8abdcc5972e517ff9ae727e3da984db8e880a7240b3" }, "downloads": -1, "filename": "indextools-0.1.4.tar.gz", "has_sig": false, "md5_digest": "39bab878a6d61ffbbbaace7d1824b7bd", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 188812, "upload_time": "2019-10-14T15:41:21", "url": "https://files.pythonhosted.org/packages/9d/c1/2f71471080764b76732bd22e959f7190cb65a7ab5964beb1665bfd497268/indextools-0.1.4.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "1c979caf171598248c90af988e65b923", "sha256": "ef7e48d282050b9baa1d40de6fcd4fbb3ec574ca0ba05141c0d9b865b05e87a8" }, "downloads": -1, "filename": "indextools-0.1.4-cp36-cp36m-macosx_10_13_x86_64.whl", "has_sig": false, "md5_digest": "1c979caf171598248c90af988e65b923", "packagetype": "bdist_wheel", "python_version": "cp36", "requires_python": ">=3.6,<4.0", "size": 234367, "upload_time": "2019-10-14T15:41:10", "url": "https://files.pythonhosted.org/packages/55/15/c51f4b2305917e016dbface61a84a9ada20f8922e5ab1cace8eda1abe8f2/indextools-0.1.4-cp36-cp36m-macosx_10_13_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "39bab878a6d61ffbbbaace7d1824b7bd", "sha256": "bfba993dfb0ea2cf00b6f8abdcc5972e517ff9ae727e3da984db8e880a7240b3" }, "downloads": -1, "filename": "indextools-0.1.4.tar.gz", "has_sig": false, "md5_digest": "39bab878a6d61ffbbbaace7d1824b7bd", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 188812, "upload_time": "2019-10-14T15:41:21", "url": "https://files.pythonhosted.org/packages/9d/c1/2f71471080764b76732bd22e959f7190cb65a7ab5964beb1665bfd497268/indextools-0.1.4.tar.gz" } ] }