{ "info": { "author": "dlmeduLi", "author_email": "dlmeduLi@163.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "License :: OSI Approved :: BSD License", "Topic :: Scientific/Engineering :: Bio-Informatics" ], "description": "Unique-Sam\n==========\n\n**Unique-Sam** is a simple command line tool to remove the duplicated\nalignments in the `SAM `__ file.\nIf the MAPQ field of the alignment is available, *unique-sam* will keep\none and only one alignment with the highest score. Otherwise,\n*unique-sam* will calculate a score according to the alignment's MD or\nCIGAR field and use the calculated value to remove the duplicated\nalignments.\n\nInstall\n=======\n\n- Install with the source code, in the source folder:\n\n .. code:: bash\n\n python setup.py install\n\n- If you have `**pip** `__\n installed, you can simply run\n\n .. code:: bash\n\n pip install unique-sam\n\n After installation you can access **unique-sam** from your command\n line.\n\nUsage\n=====\n\n**unique-sam** need a SAM format file to run properly. Before using\n``unique-sam`` command, we must sort the sam file by the\n``QNAME``\\ field. You can use ``samtools`` to achieve this purpose,\nrefer to samtools for more helps:\n\n.. code:: bash\n\n samtools sort --help\n\nFor basic usage, in your command line environment:\n\n.. code:: bash\n\n unique-sam input.sam -o output.sam\n\n-s Parameter\n~~~~~~~~~~~~\n\nIf you don't have access to samtools, you can use **-s** option of\n``unique-sam``:\n\n.. code:: shell\n\n unique-sam -s input.sam -o output.sam\n\nThe sort functionality of ``unique-sam`` is implemented as\n\n1. copy a temp file from the original sam file\n2. extract the header of the sam file\n3. sort the alignments with Bash ``sort`` program\n\n-k Parameter\n~~~~~~~~~~~~\n\n``-k`` parameter give you the control on how to extract the alignment\nkey from qname field the parameter of the ``-k`` is a regular\nexpression. You should group the key part with parentheses. \\*\\* e.g.\n1\\*\\* > qname:\n``N|GACGCGGATCTT/500407:4:H03E5AFXX:1:21109:5977:6969_2:N:0:ATACAA`` > >\n``-k '(.*)\\_[1-2](.*)'`` > > key will be:\n``N|GACGCGGATCTT/500407:4:H03E5AFXX:1:21109:5977:6969:N:0:ATACAA`` >\nwhich will remove the ``_1/2`` part of the qname.\n\n\\*\\* e.g. 2\\*\\* > qname: ``HWI-ST667_0147:1:1101:1128:2079#CGATGT/1`` >\n> ``-k '(.*)\\/[1-2]'`` > > key will be:\n``HWI-ST667_0147:1:1101:1128:2079#CGATGT`` > which will remove the\n``/1/2`` part of the qname.\n\nFor more about **unique-sam** run:\n\n.. code:: bash\n\n unique-sam --help\n\nUnique Strategy\n===============\n\nFollowing strategies are applied to find the unique & the best alignment\n\n1. Keep the alignment pair that has the highest score. If more than one\n pairs are found to have the same \"Highest Score\", these pairs will be\n removed.\n2. Read1 and Read2 should be mapped on different strands.\n3. The segment length decided by the read pairs should be longer than\n 0.7 \\* read length\n\nLog File\n========\n\nAll removed alignments will be written into log file ``input.sam.log``\nunder current folder. Each line of the log file start with a symbol and\nfollowed by the deleted alignment (the original alignment record in the\n``input.sam``). The symbol describe the reason of why this/these\nalignments should be removed. The specification of these symbols are\nlisted in the follow table:\n\n\\| Symbol \\| Description \\| \\| ------ \\| ----------- \\| \\| **!** \\|\nError lines \\| \\| **<** \\| Low score alignments \\| \\| **=** \\| Pairs\nwith more than one best score \\| \\| **~** \\| Read pair mapped on the\nsame strand \\| \\| **?** \\| Segment length too short \\| \\| **-** \\|\nInvalid read1/2 information in flag filed or unmapped segment \\|\n\nCopyright\n=========\n\nCopyright (c) 2015 dlmeduLi@163.com", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/dlmeduLi/uniqe-sam", "keywords": "bioinformatic samfile unique", "license": "BSD", "maintainer": null, "maintainer_email": null, "name": "unique-sam", "package_url": "https://pypi.org/project/unique-sam/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/unique-sam/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/dlmeduLi/uniqe-sam" }, "release_url": "https://pypi.org/project/unique-sam/0.2.4/", "requires_dist": null, "requires_python": null, "summary": "Analyse sam file and keep the unique aligment record.", "version": "0.2.4" }, "last_serial": 1476485, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "41521a48dc630b8c9c32c55e7fe84a0a", "sha256": "2b0fa17ba42708527693901039bd9cb9b91a9304e3392aca3c8cbdd08b5772e4" }, "downloads": -1, "filename": "unique-sam-0.1.0.tar.gz", "has_sig": false, "md5_digest": "41521a48dc630b8c9c32c55e7fe84a0a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5872, "upload_time": "2015-02-04T06:36:02", "url": "https://files.pythonhosted.org/packages/f7/26/3877b4c75bf7bec446057507dbf3916c14af9f5dfc3fa5f415b8f709f262/unique-sam-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "b41af96c9af37714a600f85148a552b0", "sha256": "c12e90ade8b5ed1c2916ed501a5d1561f6c86c704a295821b8f28b140626ac01" }, "downloads": -1, "filename": "unique-sam-0.1.1.tar.gz", "has_sig": false, "md5_digest": "b41af96c9af37714a600f85148a552b0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6156, "upload_time": "2015-02-04T07:21:41", "url": "https://files.pythonhosted.org/packages/22/2a/3dd9047578726e590e5dd00faa341faf01e52c1d6c43aabb7b9afdbcc5f0/unique-sam-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "e0abbcd3998bd799116987e1f10a1c69", "sha256": "b59d53f29f52d9fd085bc0140d345c233055dce3c63c23c273931b9a12162ba4" }, "downloads": -1, "filename": "unique-sam-0.1.2.tar.gz", "has_sig": false, "md5_digest": "e0abbcd3998bd799116987e1f10a1c69", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6161, "upload_time": "2015-02-05T01:28:23", "url": "https://files.pythonhosted.org/packages/5f/f0/b4b6a95245fb03641acf1e4206b0cf4bdee9935a3b3665ba951030b6415c/unique-sam-0.1.2.tar.gz" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "7457a56404ab6a04dab76712e777dfc5", "sha256": "61b74d45e9221bc882b4f0d9b95d2f6a2cbf1a5ea210688b3d4c31a97c93d541" }, "downloads": -1, "filename": "unique-sam-0.1.3.tar.gz", "has_sig": false, "md5_digest": "7457a56404ab6a04dab76712e777dfc5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6166, "upload_time": "2015-02-05T02:24:27", "url": "https://files.pythonhosted.org/packages/fe/48/dea4dddecc0f81cd95954ff569492952e3dbf2a1d6368a2a4d7817e85fca/unique-sam-0.1.3.tar.gz" } ], "0.1.4": [ { "comment_text": "", "digests": { "md5": "aadee024f484b51def3c77394620a771", "sha256": "a16b9fee763ce9411c12aeaa0dbecb295ec143efe839bdce2ccd2f6eb1618866" }, "downloads": -1, "filename": "unique-sam-0.1.4.tar.gz", "has_sig": false, "md5_digest": "aadee024f484b51def3c77394620a771", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6192, "upload_time": "2015-02-06T06:02:25", "url": "https://files.pythonhosted.org/packages/cb/3e/fe9d664878b958daf26c8f1c2731df9955e42f2b2f00020a2c69228d62e3/unique-sam-0.1.4.tar.gz" } ], "0.1.5": [ { "comment_text": "", "digests": { "md5": "8b0a93c67b31467ee1ed8b9c3f01b96e", "sha256": "4d7d87bdff05aa91605ff627d8b124dc17b57eb9ba9cb65a0fe4176bc5fc3dd2" }, "downloads": -1, "filename": "unique-sam-0.1.5.tar.gz", "has_sig": false, "md5_digest": "8b0a93c67b31467ee1ed8b9c3f01b96e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6191, "upload_time": "2015-02-06T06:09:23", "url": "https://files.pythonhosted.org/packages/d8/fa/a457de965e02a4af09a4fa1e3f40daa6ea77f37585e066e1194946dbfd25/unique-sam-0.1.5.tar.gz" } ], "0.1.6": [ { "comment_text": "", "digests": { "md5": "3ac37c380ff7141008b608d35950c078", "sha256": "4e258e88f2859674f199fce87b8daab52cc42aa0e9fa44095b34dcc4da57acd5" }, "downloads": -1, "filename": "unique-sam-0.1.6.tar.gz", "has_sig": false, "md5_digest": "3ac37c380ff7141008b608d35950c078", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6194, "upload_time": "2015-02-06T06:38:12", "url": "https://files.pythonhosted.org/packages/00/a6/da520b601ea6815955d78103510c5c9bab1d715785d837248bfe1a1128a8/unique-sam-0.1.6.tar.gz" } ], "0.1.7": [ { "comment_text": "", "digests": { "md5": "95b8c21bec3669012b5020f3bd930349", "sha256": "6ed73f2f624f36383fa7cfbe22d4f30f9029dd7fa225d73139e26460304798b0" }, "downloads": -1, "filename": "unique-sam-0.1.7.tar.gz", "has_sig": false, "md5_digest": "95b8c21bec3669012b5020f3bd930349", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6201, "upload_time": "2015-03-19T08:54:26", "url": "https://files.pythonhosted.org/packages/a7/42/271af116410d176a6c3d424e17d9c5fbdc423fe6b88bb8994a44b6e868bf/unique-sam-0.1.7.tar.gz" } ], "0.1.8": [ { "comment_text": "", "digests": { "md5": "1ffa30cfa63863bf5736415e0d82f769", "sha256": "3d443304e0d1f148701fa2a57f0a5c0c03c7e33f331ffa916a3e2034da578acf" }, "downloads": -1, "filename": "unique-sam-0.1.8.tar.gz", "has_sig": false, "md5_digest": "1ffa30cfa63863bf5736415e0d82f769", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6192, "upload_time": "2015-03-20T02:07:42", "url": "https://files.pythonhosted.org/packages/5d/63/1bf0e6cc4f15f3219cb7428630060521d5fa007d2c6a16bedc58b03e2919/unique-sam-0.1.8.tar.gz" } ], "0.1.9": [ { "comment_text": "", "digests": { "md5": "7c0aacd9abe9e096573575df1fa2f30e", "sha256": "c48d1fefc4f412adf5584f7275523bbca92dd88c0f8b1ad04eec2a4509b16cd8" }, "downloads": -1, "filename": "unique-sam-0.1.9.tar.gz", "has_sig": false, "md5_digest": "7c0aacd9abe9e096573575df1fa2f30e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6194, "upload_time": "2015-03-20T02:09:20", "url": "https://files.pythonhosted.org/packages/52/38/251bdafcbf55f3870040ceb2b9bab31786c0a6b8a073f8805d573cd6e940/unique-sam-0.1.9.tar.gz" } ], "0.2.3": [ { "comment_text": "", "digests": { "md5": "598e1fd72f7e734517aa9a2a879174c3", "sha256": "a5027166606a0999022924d0897d4419b5bc15c3562ddadc50aef8a5d8478024" }, "downloads": -1, "filename": "unique-sam-0.2.3.tar.gz", "has_sig": false, "md5_digest": "598e1fd72f7e734517aa9a2a879174c3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6684, "upload_time": "2015-03-24T08:58:39", "url": "https://files.pythonhosted.org/packages/2e/68/2bf244a238d75fd1a4ed44b6ee3aeaaf692354d8f5b3501125a4497cdf63/unique-sam-0.2.3.tar.gz" } ], "0.2.4": [ { "comment_text": "", "digests": { "md5": "812c50967c6843cba463760c73dd1140", "sha256": "bb19b699e22c5a85c97009dd9926746704a416a684e0bbabdaf9bb9513cbb550" }, "downloads": -1, "filename": "unique-sam-0.2.4.tar.gz", "has_sig": false, "md5_digest": "812c50967c6843cba463760c73dd1140", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6690, "upload_time": "2015-03-25T07:24:40", "url": "https://files.pythonhosted.org/packages/03/16/51c6c02140d2ce6ab9d71615341bdb0383d0a137e790868445161f93cb9b/unique-sam-0.2.4.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "812c50967c6843cba463760c73dd1140", "sha256": "bb19b699e22c5a85c97009dd9926746704a416a684e0bbabdaf9bb9513cbb550" }, "downloads": -1, "filename": "unique-sam-0.2.4.tar.gz", "has_sig": false, "md5_digest": "812c50967c6843cba463760c73dd1140", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6690, "upload_time": "2015-03-25T07:24:40", "url": "https://files.pythonhosted.org/packages/03/16/51c6c02140d2ce6ab9d71615341bdb0383d0a137e790868445161f93cb9b/unique-sam-0.2.4.tar.gz" } ] }