Rfitch: R interface for fitch

Description Usage Arguments Details Value Author(s) References See Also Examples

Description

This function is an R interface for fitch in the PHYLIP package (Felsenstein 2013). fitch can be used for tree inference using the Fitch-Margoliash method (Fitch & Margoliash 1967), the Cavalli-Sforza & Edwards leasts-squares method (Cavalli-Sforza & Edwards 1967), and the minimum evolution criterion (Kidd & Sgaramella-Zonta 1971; Nei & Rzhetsky 1993).

Usage

1
Rfitch(D, path=NULL , ...)

Arguments

D

a distance matrix as an object of class "matrix" or "dist". If a matrix, then D should be symmetrical with a diagonal of zeros.

path

path to the executable containing fitch. If path = NULL, the R will search several commonly used directories for the correct executable file.

...

optional arguments to be passed to fitch. See details for more information.

Details

Optional arguments include the following: quiet suppress some output to R console (defaults to quiet = FALSE); method - can be "FM" or "fm" (for the Fitch-Margoliash criterion; Fitch & Margoliash 1967), "LS" or "ls" for the Cavalli-Sforza & Edwards (1967) least-squares criterion, or "ME" or "me" (for Minimum Evolution); tree object of class "phylo" - if supplied, then branch lengths are optimized & the optimality criterion is computed on the input tree; negative a logical value indicating whether negative branch lengths should be permitted (defaults to negative = TRUE; global perform global search (defaults to global = TRUE); random.order add taxa to tree in random order (defaults to random.order = TRUE); random.addition number of random addition replicates for random.order = TRUE (defaults to random.addition = 10); outgroup outgroup if outgroup rooting of the estimated tree is desired; and cleanup remove PHYLIP input & output files after the analysis is completed (defaults to cleanup = TRUE).

More information about the fitch program in PHYLIP can be found here http://evolution.genetics.washington.edu/phylip/doc/fitch.html.

Obviously, use of any of the functions of this package requires that PHYLIP (Felsenstein 1989, 2013) should first be installed. More information about installing PHYLIP can be found on the PHYLIP webpage: http://evolution.genetics.washington.edu/phylip.html.

Value

This function returns an object of class "phylo" that is the Fitch-Margoliash, LS, or ME tree.

Author(s)

Liam J. Revell, Scott A. Chamberlain

Maintainer: Liam J. Revell <liam.revell@umb.edu>

References

Cavalli-Sforza, L.L., Edwards, A.W.F. (1967) Phylogenetic analysis: models and estimation procedures. Evolution, 32, 550-570.

Fitch, W.M., Margoliash, E. (1967) Construction of phylogenetic trees. Science, 155, 279-284.

Kidd, K.K., Sgaramella-Zonta, L.A. (1971) Phylogenetic analysis: concepts and methods. American Journal of Human Genetics, 23, 235-252.

Felsenstein, J. (1989) PHYLIP–Phylogeny Inference Package (Version 3.2). Cladistics, 5, 164-166.

Felsenstein, J. (2013) PHYLIP (Phylogeny Inference Package) version 3.695. Distributed by the author. Department of Genome Sciences, University of Washington, Seattle.

See Also

Rdnadist

Examples

1
2
3
4
5
6
## Not run: 
data(primates)
D<-dist.dna(data(primates),model="JC")
tree<-Rfitch(D)

## End(Not run)

Rphylip documentation built on May 2, 2019, 11:11 a.m.