{ "info": { "author": "Yuichi Shiraishi", "author_email": "friend1ws@gamil.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Science/Research", "License :: OSI Approved :: GNU General Public License v3 (GPLv3)", "Operating System :: Unix", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Topic :: Scientific/Engineering :: Bio-Informatics" ], "description": "# fusionfusion \n\n[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n[![Build Status](https://travis-ci.org/Genomon-Project/fusionfusion.svg?branch=devel)](https://travis-ci.org/Genomon-Project/fusionfusion)\n\n## Introduction\n\nfusionfusion is a software for detecting gene fusion \nusing the putative chimeric transcript generated by several well-known transcriptome alignment tools (STAR, MapSplice2 and TopHat2).\nMany of those predicted chimeric transcripts are \"false positives\".\nHowever, by performing effective filtering, sensitive and accurate gene fusion detection is possible.\nAfter the alignment steps, the software can generate final gene fusion candidates\nand integrating our software into the pipeline will come very easily to you!\n\n## Dependency\n\n### Python\nPython (>= 2.7), `pysam (>= 0.8.1)`and [`annot_utils`](https://github.com/friend1ws/annot_utils) packages.\n\n### Software\n[blat](https://genome.ucsc.edu/FAQ/FAQblat.html)\n\n## Install\n\nFirst, download the latest release from the release section or type the following command\n```\nwget https://github.com/Genomon-Project/fusionfusion/archive/v0.3.0.tar.gz\ntar zxvf v0.3.0.tar.gz\n```\n\nAlternatively, you can download the latest developing version (which may be unstable)\n```\ngit clone https://github.com/Genomon-Project/fusionfusion.git\n```\n\nThen, install the package by standard python package protocol (https://docs.python.org/2/install/)\n```\ncd fusionfusion-0.3.0\npython setup.py build\npython setup.py install\n```\n\nFor the last command, you may need to add --user if you are using a shared computing cluster.\n```\npython setup.py install --user\n```\n\n## Preparation\n\nFirst, you need to perform transcriptome sequencing alignemnt by STAR, MapSplice2, TopHat2. \n\nFor STAR, our software uses the chimeric sam file\n```\n{output_prefix}.Chimeric.out.sam\n```\n\nFor MapSplice2, our software uses the read alignment file\n```\nalignments.sam (bam)\n```\nYou do not need to care about the sorting status.\n\nFor TopHat2, our software uses the read alignment file\n```\naccepted_hits.bam\n```\n\n## Commands\n\n```\nfusionfusion [-h] [--version] [--star star.Chimeric.out.sam]\n [--ms2 ms2.bam] [--th2 th2.bam] --out output_dir\n --reference_genome reference.fa [--grc]\n [--genome_id {hg19,hg38,mm10}]\n [--pooled_control_file POOLED_CONTROL_FILE] [--debug]\n [--debug] [--abnormal_insert_size ABNORMAL_INSERT_SIZE]\n [--min_major_clipping_size MIN_MAJOR_CLIPPING_SIZE]\n [--min_read_pair_num MIN_READ_PAIR_NUM]\n [--min_valid_read_pair_ratio MIN_VALID_READ_PAIR_RATIO]\n [--min_cover_size MIN_COVER_SIZE]\n [--anchor_size_thres ANCHOR_SIZE_THRES]\n [--min_chimeric_size MIN_CHIMERIC_SIZE]\n [--min_allowed_contig_match_diff MIN_ALLOWED_CONTIG_MATCH_DIFF]\n [--check_contig_size_other_breakpoint CHECK_CONTIG_SIZE_OTHER_BREAKPOINT]\n [--filter_same_gene]\n```\nAt least one of --star, --ms2, --th2 arguments should be specified.\nThe arguments of --out and --reference_genome are mandatory. \nSet the genome model by --genome_id (default is hg19).\nCurrently, we support hg19, hg38 and mm10.\nAlso, if you are using GRC-based files (no \"chr\" in chromosome names), set --grc.\nFor other arguments, please type `fusionfusion -h`.\nAlthough we believe default settings are fine for 100bp-length paired read data., \ntuning *min_cover_size* may help improve the accuracy.\nAlso, using pooled control files generated by the merge_control command of [chimera_utils](https://github.com/friend1ws/chimera_utils)\nwill greatly reduce false positives.\n\n## Results\n\nFor the result generated by single tool (star.fusion.result.txt, ms2.fusion.result.txt and th2.fusion.result.txt):\n\n1. chromosome for the 1st breakpoint\n1. coordinate for the 1st breakpoint\n1. direction of the 1st breakpoint\n1. chromosome for the 2nd breakpoint\n1. coordinate for the 2nd breakpoint\n1. direction of the 2nd breakpoint\n1. inserted nucleotides within the breakpoints\n1. #read_pairs supporting the fusion\n1. gene overlapping the 1st breakpoint\n1. exon-intron junction overlapping the 1st breakpoint\n1. gene overlapping the 2nd breakpoint\n1. exon-intron junction overlapping the 2nd breakpoint\n1. contig match score for the 1st breakpoint\n1. contig size for the 1st breakpoint\n1. contig match score for the 2nd breakpoint\n1. conting size for the 2nd breakpoint\n\nFor the merged result (fusionfusion.result.txt):\n\n1. chromosome for the 1st breakpoint\n1. coordinate for the 1st breakpoint\n1. direction of the 1st breakpoint\n1. chromosome for the 2nd breakpoint\n1. coordinate for the 2nd breakpoint\n1. direction of the 2nd breakpoint \n1. inserted nucleotides within the breakpoints \n1. gene overlapping the 1st breakpoint\n1. exon-intron junction overlapping the 1st breakpoint\n1. gene overlapping the 2nd breakpoint\n1. exon-intron junction overlapping the 2nd breakpoint\n1. #read_pairs supporting the variant (by MapSplice2 if --ms2 is specified)\n1. #read_pairs supporting the variant (by STAR if --star is specified)\n1. #read_pairs supporting the variant (by TopHat2 if --th2 is specified)", "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/friend1ws/fusionfusion", "keywords": "", "license": "GPLv3", "maintainer": "", "maintainer_email": "", "name": "fusionfusion", "package_url": "https://pypi.org/project/fusionfusion/", "platform": "", "project_url": "https://pypi.org/project/fusionfusion/", "project_urls": { "Homepage": "https://github.com/friend1ws/fusionfusion" }, "release_url": "https://pypi.org/project/fusionfusion/0.5.0/", "requires_dist": null, "requires_python": "", "summary": "Python tools for extracting highly confident fusion transcripts from the results of several RNA-seq alignment tools.", "version": "0.5.0" }, "last_serial": 5285102, "releases": { "0.4.0": [ { "comment_text": "", "digests": { "md5": "75ac54498fb61d98b338c7302038b721", "sha256": "ec93ffdf46e819e60e6714baf0751fdfe31cf4d75c9bb010d520b04f33ef3873" }, "downloads": -1, "filename": "fusionfusion-0.4.0.tar.gz", "has_sig": false, "md5_digest": "75ac54498fb61d98b338c7302038b721", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17223, "upload_time": "2018-01-28T23:57:36", "url": "https://files.pythonhosted.org/packages/ae/3d/2dbbaafa6c1da3f99e6e9b0739eedf0db8c7cf32c58042c2870c3efcf4c9/fusionfusion-0.4.0.tar.gz" } ], "0.5.0": [ { "comment_text": "", "digests": { "md5": "3212176f9961e299351f0a3c43a685ed", "sha256": "663a3ddc183c770397bb19f0173b59dc7c9c98fd2a6d44ca872d1641ddfe5d8e" }, "downloads": -1, "filename": "fusionfusion-0.5.0.tar.gz", "has_sig": false, "md5_digest": "3212176f9961e299351f0a3c43a685ed", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20356, "upload_time": "2019-05-18T07:13:17", "url": "https://files.pythonhosted.org/packages/00/a4/35cd00d1aa09085bd9b6b5dbe740eed9ca460b2e1fa1eb5b50bfb9f69e31/fusionfusion-0.5.0.tar.gz" } ], "0.5.0b1": [ { "comment_text": "", "digests": { "md5": "1317b3b81857428c991efd9c216914fa", "sha256": "a36ddee829d161b9d3fc2a1125bad99f6d367ff61492392d7f9b170aa377e820" }, "downloads": -1, "filename": "fusionfusion-0.5.0b1.tar.gz", "has_sig": false, "md5_digest": "1317b3b81857428c991efd9c216914fa", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17768, "upload_time": "2019-05-17T05:49:36", "url": "https://files.pythonhosted.org/packages/b7/88/23ce4e6b794a978e29d662aefa539df99218ac4f2fbe2b13532251eba646/fusionfusion-0.5.0b1.tar.gz" } ], "0.5.0rc1": [ { "comment_text": "", "digests": { "md5": "4898388739562e403562768eebcd56d0", "sha256": "1c6df726c5230f8ed1cd261bfb280768d75b05bfb3976b9554a91d8d6a04b69c" }, "downloads": -1, "filename": "fusionfusion-0.5.0rc1.tar.gz", "has_sig": false, "md5_digest": "4898388739562e403562768eebcd56d0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20364, "upload_time": "2019-05-18T07:00:02", "url": "https://files.pythonhosted.org/packages/2e/4d/1bf41435bcd5d295f9ab697a04611ff3c4e427b37f2830da997014bd1a70/fusionfusion-0.5.0rc1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "3212176f9961e299351f0a3c43a685ed", "sha256": "663a3ddc183c770397bb19f0173b59dc7c9c98fd2a6d44ca872d1641ddfe5d8e" }, "downloads": -1, "filename": "fusionfusion-0.5.0.tar.gz", "has_sig": false, "md5_digest": "3212176f9961e299351f0a3c43a685ed", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 20356, "upload_time": "2019-05-18T07:13:17", "url": "https://files.pythonhosted.org/packages/00/a4/35cd00d1aa09085bd9b6b5dbe740eed9ca460b2e1fa1eb5b50bfb9f69e31/fusionfusion-0.5.0.tar.gz" } ] }