Edited wiki page PhyloBioRuby through web user interface.

[jalview.git] / wiki / PhyloBioRuby.wiki

diff --git a/wiki/PhyloBioRuby.wiki b/wiki/PhyloBioRuby.wiki
index 5aab707..503fc75 100644 (file)
--- a/wiki/PhyloBioRuby.wiki
+++ b/wiki/PhyloBioRuby.wiki
@@ -13,10 +13,10 @@ Eventually, this is expected to be placed on the official !BioRuby page.
 Author: [http://www.cmzmasek.net/ Christian M Zmasek], Sanford-Burnham Medical Research Institute
 
  
-Copyright (C) 2011 Christian M Zmasek
+Copyright (C) 2011 Christian M Zmasek. All rights reserved.
 
 
-= Multiple Sequence Alignments =
+= Multiple Sequence Alignment =
 
 
 == Multiple Sequence Alignment Input and Output ==
@@ -43,7 +43,11 @@ msa.each do |entry|
 end
 }}}
 
- 
+Relevant API documentation:
+
+ * [http://bioruby.open-bio.org/rdoc/classes/Bio/ClustalW/Report.html Bio::ClustalW::Report]
+ * [http://bioruby.open-bio.org/rdoc/classes/Bio/Alignment.html Bio::Alignment]
+ * [http://bioruby.open-bio.org/rdoc/classes/Bio/Sequence.html Bio::Sequence]
 
 === Writing a Multiple Sequence Alignment to a File ===
 
@@ -63,26 +67,24 @@ end
 
 ==== Setting the Output Format ====
 
-The following constants determine the output format.
+The following symbols determine the output format:
 
-  * ClustalW: `:clustal`
-  * FASTA:    `:fasta`
-  * PHYLIP interleaved (will truncate sequence names to no more than 10 characters): `:phylip`
-  * PHYLIP non-interleaved (will truncate sequence names to no more than 10 characters): `:phylipnon`
-  * MSF: `:msf`
-  * Molphy: `:molphy`
+  * `:clustal` for ClustalW
+  * `:fasta` for FASTA
+  * `:phylip` for PHYLIP interleaved (will truncate sequence names to no more than 10 characters)
+  * `:phylipnon` for PHYLIP non-interleaved (will truncate sequence names to no more than 10 characters)
+  * `:msf` for MSF
+  * `:molphy` for Molphy
 
 
-For example, the following writes PHYLIP's non-interleaved format:
+For example, the following writes in PHYLIP's non-interleaved format:
 
 {{{
 f.write(align.output(:phylipnon))
 }}}
 
 
-== Formats for individual sequences ==
-
-_... to be done_
+=== Formatting of Individual Sequences ===
 
 !BioRuby can format molecular sequences in a variety of formats.
 Individual sequences can be formatted to (e.g.) Genbank format as shown in the following examples.
@@ -92,14 +94,21 @@ For Sequence objects:
 seq.to_seq.output(:genbank)
 }}}
 
-For Bio::FlatFile entries:
+For Bio::!FlatFile entries:
 {{{
 entry.to_biosequence.output(:genbank)
 }}}
 
-Constants for available formats are:
-  * Genbank :genbank
-
+The following symbols determine the output format:
+  * `:genbank` for Genbank
+  * `:embl` for EMBL
+  * `:fasta` for FASTA
+  * `:fasta_ncbi` for NCBI-type FASTA
+  * `:raw` for raw sequence
+  * `:fastq` for FASTQ (includes quality scores)
+  * `:fastq_sanger` for Sanger-type FASTQ 
+  * `:fastq_solexa` for Solexa-type FASTQ 
+  * `:fastq_illumina` for Illumina-type FASTQ 
 
 == Calculating Multiple Sequence Alignments ==
 
@@ -257,6 +266,15 @@ tree = trees[3]
 }}}
 
 
+====Nexus  Format====
+
+_... to be done_
+
+{{{
+#!/usr/bin/env ruby
+require 'bio'
+
+}}}
 
 === Writing of Phylogenetic Trees ===
 
@@ -299,18 +317,28 @@ writer.write(tree2)
 }}}
 
 
+====Nexus  Format====
 
-== Phylogenetic Inference ==
+_... to be done_
 
-_Currently !BioRuby does not contain wrappers for phylogenetic inference programs, thus I am progress of writing a RAxML wrapper followed by a wrapper for FastME..._
+{{{
+#!/usr/bin/env ruby
+require 'bio'
 
-_What about pairwise distance calculation?_
+}}}
 
 
+= Phylogenetic Inference =
 
-== Maximum Likelihood ==
+_Currently !BioRuby does not contain wrappers for phylogenetic inference programs, thus I am progress of writing a RAxML wrapper followed by a wrapper for FastME..._
 
-=== RAxML ===
+== Optimality Criteria Based on Character Data ==
+
+Character data based methods work directly on molecular sequences and thus do not require the calculation of pairwise distances but tend to be time consuming and sensitive to errors in the multiple sequence alignment.
+
+=== Maximum Likelihood ===
+
+==== RAxML ====
 
 _... to be done_
 
@@ -321,7 +349,7 @@ require 'bio'
 }}}
 
 
-=== PhyML ===
+==== PhyML ====
 
 _... to be done_
 
@@ -331,9 +359,33 @@ require 'bio'
 
 }}}
 
+=== Maximum Parsimony ===
+
+Currently no direct support in !BioRuby.
+
+
+=== Bayesian Inference ===
+
+Currently no direct support in !BioRuby.
+
+
 == Pairwise Distance Based Methods ==
 
-=== FastME ===
+=== Pairwise Sequence Distance Estimation ===
+
+_... to be done_
+
+{{{
+#!/usr/bin/env ruby
+require 'bio'
+
+}}}
+
+
+=== Optimality Criteria Based on Pairwise Distances ===
+
+
+==== Minimal Evolution: FastME ====
 
 _... to be done_
 
@@ -343,9 +395,21 @@ require 'bio'
 
 }}}
 
+=== Algorithmic Methods Based on Pairwise Distances ===
+
+==== Neighbor Joining and Related Methods ====
+
+_... to be done_
+
+{{{
+#!/usr/bin/env ruby
+require 'bio'
+
+}}}
+
+
 
 
-=== PHYLIP? ===