Difference between revisions of "FCP"

From Bioinformatics Software
Jump to navigationJump to search
 
(42 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
The fragment classification package (FCP) provides the following classifiers for assigning query fragments to their source genome:
+
The fragment classification package (FCP) provides the following classifiers for assigning a taxonomic attribution to metagenomic fragments or assembled scaffolds:
  
 
*''Naive Bayes (NB)'': a composition-based, rank-specific classifier
 
*''Naive Bayes (NB)'': a composition-based, rank-specific classifier
Line 12: Line 12:
 
This software is released under the [http://www.gnu.org/licenses/gpl.html GNU General Public License v3.0].
 
This software is released under the [http://www.gnu.org/licenses/gpl.html GNU General Public License v3.0].
  
== Mailing list ==
+
== Obtaining the Software ==
 +
 
 +
* [https://github.com/dparks1134/FragmentClassificationPackage/releases/download/v1.0.7/FCP_1_0_7.zip Fragment classification package v1.0.7]
 +
* [https://github.com/dparks1134/FragmentClassificationPackage Source code on GitHub]
 +
* [[Older versions of FCP|Older versions]]
 +
 
 +
After downloading, uncompress the file and follow the installation instruction in the README.md file. Under OSX or Linux, the zip file can be uncompressed by typing <tt>unzip FCP_1_0_7.zip</tt> at the command prompt. Under Windows 7, the zip file can be uncompressed by right-clicking on the file and selecting 'Extract all...' from the popup menu. The FCP has been tested under OS X Snow Leopard, Linux, and Windows 7. To install the FCP under OS X, gcc must be installed which is available as part of the [http://developer.apple.com/technologies/tools/ Mac Developer Tools].
  
* Join our [http://ratite.cs.dal.ca/software_email_list/subscribe mailing list] to keep informed about FCP developments.
+
== Citing the FCP ==
  
== Obtaining the Software ==
+
If you find this software helpful in your research, please cite:
  
The FCP is available as a gzipped tarball for Linux users and a zip file for Microsoft Windows users:
+
* '''Parks, D.H., MacDonald, N.J., and Beiko, R.G. (2011). Classifying short genomic fragments from novel lineages using composition and homology. ''BMC Bioinformatics'', 12:328. ([http://www.biomedcentral.com/1471-2105/12/328 Abstract])'''
  
* [[Media:FCP_1_0_0.tar.gz|Fragment classification package v1.0.0 (gzipped tarball)]]
+
== Contact Information ==
* [[Media:FCP_1_0_0.zip|Fragment classification package v1.0.0 (zip file)]]
 
  
After downloading, uncompress the FCP file and follow the installation instruction in the README file. Under Linux, the gzipped tarball can be uncompressed by typing <tt>tar zxvf FCP_1_0_0.tar.gz</tt> at the command prompt. Under Windows 7, the zip file can be uncompressed by right-clicking on the file and selecting 'Extract all...' from the popup menu. FCP has been tested under OS X Snow Leopard, Linux, and Windows 7. To install FCP under OS X gcc, included in the [http://developer.apple.com/technologies/tools/ Mac Developer Tools], must be installed.
+
The FCP is in active development and we are interested in discussing all potential applications of this software. We encourage you to send us suggestions for new features. Suggestions, comments, and bug reports can be sent to Rob Beiko (beiko [at] cs.dal.ca). If reporting a bug, please provide as much information as possible and a simplified version of the data set which causes the bug. This will allow us to quickly resolve the issue.  
  
 
== Version History ==
 
== Version History ==
  
* December 13, 2010: initial software release.
+
''v1.0.7 (July 12, 2015)''
 +
* fixed AddModel.py should it accepts the desired n-mer size of new models
 +
 
 +
''v1.0.6 (August 12, 2014)''
 +
* fixed bug with NB-BL.py which caused it to have an output format incompatible with the rest of the FCP suite
 +
 
 +
''v1.0.5 (May 30, 2014)''
 +
* changed default k-mer size from 10 to 8 in response to the rapidly expanding number of reference genomes
 +
* minor code improvements
  
== Contact Information ==
+
''v1.0.4 (April 13, 2013)''
 +
* removed need for taxonomy file from nb-train
 +
* improved error reporting for nb-train and nb-classify
 +
* added example illustrating use of the naive Bayes classifier independent of the FCP framework
  
The FCP is in active development and we are interested in discussing all potential applications of this software. We encourage you to send us suggestions for new features. Suggestions, comments, and bug reports can be sent to Rob Beiko (beiko [at] cs.dal.ca). If reporting a bug, please provide as much information as possible and a simplified version of the data set which causes the bug. This will allow us to quickly resolve the issue.
+
''v1.0.3 (July 13, 2011)''
 +
* changed NB_install.py to FCP_install.py
 +
* added -protein flag to FCP_install.py to all FCP to be used with [http://kiwi.cs.dal.ca/Software/RITA RITA]
  
== Citing the FCP ==
+
''v1.0.2 (June 3, 2011)''
 +
* improved robustness of NB_install.py script
 +
* TaxonomicSummary.py now reports both raw and normalized percentages
 +
* removed need for temporary directories when running nb-classify
 +
* fixed major bug in LCA+Epsilon-NB.py which was causing the epsilon parameter to be handled incorrectly
 +
* fixed minor bug in LCA.py where unclassified fragments where reported as 'u' instead of 'unclassified'
  
If you find this software helpful in your research, please cite:
+
''v1.0.1 (Apr. 28, 2011)''
 +
* revision to NB_install.py to account for genomes without NCBI taxonomy information
  
'''Parks, D.H., MacDonald, N.J., and Beiko, R.G. (2010). Classify short genomic fragments from unrepresented lineages using composition and homology. (Submitted to ISMB, 2011)
+
''v1.0.0 (Jan. 4, 2011)''
 +
* initial software release.
  
 
== Funding ==
 
== Funding ==

Latest revision as of 00:18, 12 July 2015

The fragment classification package (FCP) provides the following classifiers for assigning a taxonomic attribution to metagenomic fragments or assembled scaffolds:

  • Naive Bayes (NB): a composition-based, rank-specific classifier
  • BLASTN: a homology-based, rank-specific classifier
  • NB-BL: a hybrid, rank-specific classifier combining NB and BLASTN
  • Epsilon-NB: a composition-based, rank-flexible classifier
  • Lowest common ancestor (LCA): a homology-based, rank-flexible classifier
  • LCA + epsilon-NB: a hybrid, rank-flexible classifier combining LCA and epsilon-NB

License

This software is released under the GNU General Public License v3.0.

Obtaining the Software

After downloading, uncompress the file and follow the installation instruction in the README.md file. Under OSX or Linux, the zip file can be uncompressed by typing unzip FCP_1_0_7.zip at the command prompt. Under Windows 7, the zip file can be uncompressed by right-clicking on the file and selecting 'Extract all...' from the popup menu. The FCP has been tested under OS X Snow Leopard, Linux, and Windows 7. To install the FCP under OS X, gcc must be installed which is available as part of the Mac Developer Tools.

Citing the FCP

If you find this software helpful in your research, please cite:

  • Parks, D.H., MacDonald, N.J., and Beiko, R.G. (2011). Classifying short genomic fragments from novel lineages using composition and homology. BMC Bioinformatics, 12:328. (Abstract)

Contact Information

The FCP is in active development and we are interested in discussing all potential applications of this software. We encourage you to send us suggestions for new features. Suggestions, comments, and bug reports can be sent to Rob Beiko (beiko [at] cs.dal.ca). If reporting a bug, please provide as much information as possible and a simplified version of the data set which causes the bug. This will allow us to quickly resolve the issue.

Version History

v1.0.7 (July 12, 2015)

  • fixed AddModel.py should it accepts the desired n-mer size of new models

v1.0.6 (August 12, 2014)

  • fixed bug with NB-BL.py which caused it to have an output format incompatible with the rest of the FCP suite

v1.0.5 (May 30, 2014)

  • changed default k-mer size from 10 to 8 in response to the rapidly expanding number of reference genomes
  • minor code improvements

v1.0.4 (April 13, 2013)

  • removed need for taxonomy file from nb-train
  • improved error reporting for nb-train and nb-classify
  • added example illustrating use of the naive Bayes classifier independent of the FCP framework

v1.0.3 (July 13, 2011)

  • changed NB_install.py to FCP_install.py
  • added -protein flag to FCP_install.py to all FCP to be used with RITA

v1.0.2 (June 3, 2011)

  • improved robustness of NB_install.py script
  • TaxonomicSummary.py now reports both raw and normalized percentages
  • removed need for temporary directories when running nb-classify
  • fixed major bug in LCA+Epsilon-NB.py which was causing the epsilon parameter to be handled incorrectly
  • fixed minor bug in LCA.py where unclassified fragments where reported as 'u' instead of 'unclassified'

v1.0.1 (Apr. 28, 2011)

  • revision to NB_install.py to account for genomes without NCBI taxonomy information

v1.0.0 (Jan. 4, 2011)

  • initial software release.

Funding

The development of this software has been supported by several organizations: