]> git.donarmstrong.com Git - ape.git/blob - ChangeLog
changed rtree and rcoal
[ape.git] / ChangeLog
1                 CHANGES IN APE VERSION 2.4-1
2
3
4 NEW FEATURES
5
6     o rtree() and rcoal() now accept a numeric vector for the 'br'
7       argument.
8
9
10 BUG FIXES
11
12     o bind.tree() failed when 'y' had no root edge.
13
14     o read.nexus() shuffled tip labels when the trees have no branch
15       lengths and there is a TRANSLATE block.
16
17     o plot.multiPhylo() crashed R when plotting a list of trees with
18       "compressed tip labels".
19
20     o write.nexus() did not translate the taxa names when asked for.
21
22
23
24                 CHANGES IN APE VERSION 2.4
25
26
27 NEW FEATURES
28
29     o base.freq() has a new option 'freq' to return the counts; the
30       default is still to return the proportions.
31
32
33 BUG FIXES
34
35     o seg.sites() did not handle ambiguous nucleotides correctly: they
36       are now ignored.
37
38     o plot(phy, root.edge = TRUE) failed if there was no $root.edge in
39       the tree: the argument is now ignored.
40
41     o add.scale.bar() failed when 'x' and 'y' were given (thanks to Janet
42       Young for the fix).
43
44
45 OTHER CHANGES
46
47     o Trying to plot a tree with a single tip now returns NULL with a
48       warning (it returned an error previously).
49
50     o The way lines representing nodes are coloured in phylograms has
51       been modified (as well as their widths and types) following some
52       users' request; this is only for dichotomous nodes.
53
54     o The argument 'adj' in [node][tip][edge]labels() now works when
55       using 'pie' or 'thermo'.
56
57     o A more informative message error is now returned by dist.dna() when
58       'model' is badly specified (partial matching of this argument is
59       done now).
60
61     o Deprecated functions are now listed in a help page: see
62       help("ape-defunct") with the quotes.
63
64
65 DEPRECATED & DEFUNCT
66
67     o The functions heterozygosity, nuc.div, theta.h, theta.k and
68       theta.s have been moved from ape to pegas.
69
70     o The functions mlphylo, DNAmodel and sh.test have been removed.
71
72
73
74                 CHANGES IN APE VERSION 2.3-3
75
76
77 BUG FIXES
78
79     o add.scale.bar() always drew a horizontal bar.
80
81     o zoom() shuffled tips with unrooted trees.
82
83     o write.nexus() failed to write correctly trees with a "TipLabel"
84       attribute.
85
86     o rcoal() failed to compute branch lengths with very large n.
87
88     o A small bug was fixed in compar.cheverud() (thanks to Michael
89       Phelan for the fix).
90
91     o seg.sites() failed when passing a vector.
92
93     o drop.tip() sometimes shuffled tip labels.
94
95     o root() shuffled node labels with 'resolve.root = TRUE'.
96
97
98
99                 CHANGES IN APE VERSION 2.3-2
100
101
102 BUG FIXES
103
104     o all.equal.phylo() did not compare unrooted trees correctly.
105
106     o dist.topo(... method = "PH85") did not treat unrooted trees
107       correctly (thanks to Tim Wallstrom for the fix).
108
109     o root() sometimes failed to test for the monophyly of the
110       outgroup correctly.
111
112     o extract.clade() sometimes included too many edges.
113
114     o vcv.phylo() did not work correctly when the tree is in
115       "pruningwise" order.
116
117     o nj() did not handle correctly distance matrices with many 0's.
118       The code has also been significantly improved: 7, 70, 160 times
119       faster with n = 100, 500, 1000, respectively.
120
121
122
123                 CHANGES IN APE VERSION 2.3-1
124
125
126 NEW FEATURES
127
128     o The new function is.monophyletic tests the monophyly of a group.
129
130     o There is now a c() method for lists of class "DNAbin".
131
132     o yule.cov() now fits the null model, and its help page has been
133       corrected with respect to this change.
134
135     o drop.tip() has a new option 'rooted' to force (or not) a tree
136       to be treated as (un)rooted.
137
138
139 BUG FIXES
140
141     o dist.gene() failed on most occasions with the default
142       pairwise.deletion = FALSE.
143
144     o read.tree() failed to read correctly the tree name(s).
145
146     o boot.phylo() now treats correctly data frames.
147
148     o del.gaps() did not copy the rownames of a matrix.
149
150     o A small bug was fixed in CDAM.global().
151
152     o ace() failed with large data sets. Thanks to Rich FitzJohn for
153       the fix. With other improvements, this function is now about 6
154       times faster.
155
156     o write.tree() failed with objects of class "multiPhylo".
157
158     o drop.tip(, subtree = TRUE) sometimes shuffled tip labels.
159
160
161 OTHER CHANGES
162
163     o [.multiPhylo and [.DNAbin now respect the original class.
164
165     o Instances of the form class(phy) == "phylo" have been replaced
166       by inherits(phy, "phylo").
167
168     o rcoal() is now faster.
169
170
171 DEPRECATED & DEFUNCT
172
173     o klastorin() has been removed.
174
175
176
177                 CHANGES IN APE VERSION 2.3
178
179
180 NEW FEATURES
181
182     o The new functions CADM.global and CADM.post, contributed by
183       Pierre Legendre, test the congruence among several distance
184       matrices.
185
186     o The new function yule.time fits a user-defined time-dependent
187       Yule model by maximum likelihood.
188
189     o The new function makeNodeLabel creates and/or modifies node
190       labels in a flexible way.
191
192     o read.tree() and write.tree() have been modified so that they can
193       handle individual tree names.
194
195     o plot.phylo() has a new argument 'edge.lty' that specifies the
196       types of lines used for the edges (plain, dotted, dashed, ...)
197
198     o phymltest() has been updated to work with PhyML 3.0.1.
199
200
201 BUG FIXES
202
203     o drop.tip() shuffled tip labels in some cases.
204
205     o drop.tip() did not handle node.label correctly.
206
207     o is.ultrametric() now checks the ordering of the edge matrix.
208
209     o ace() sometimes returned negative values of likelihoods of
210       ancestral states (thanks to Dan Rabosky for solving this long
211       lasting bug).
212
213
214 OTHER CHANGES
215
216     o The data set xenarthra has been removed.
217
218
219
220                 CHANGES IN APE VERSION 2.2-4
221
222 BUG FIXES
223
224     o The bug fix in read.nexus() in version 2.2-3 was wrong: this is
225       now fixed. (Thanks to Peter Wragg for the fix!)
226
227     o A warning message occurred for no reason with ace(method="GLS").
228
229
230 OTHER CHANGES
231
232     o There is now a general help page displayed with '?ape'.
233
234
235
236                 CHANGES IN APE VERSION 2.2-3
237
238
239 NEW FEATURES
240
241     o The new function extract.clade extracts a clade from a tree by
242       specifying a node number or label.
243
244     o fastme.bal() has two new options 'spr' and 'tbr' to perform tree
245       operations of the same names.
246
247     o dist.dna() can now return the number of site differences by
248       specifying model="N".
249
250
251 BUG FIXES
252
253     o chronopl() did not work with CV = TRUE.
254
255     o read.nexus() did not work correctly in some situations (trees on
256       multiple lines with different numbers of lines and/or with
257       comments inserted within the trees).
258
259     o ltt.plot(), ltt.lines(), and mltt.plot() did not count correctly
260       the number of lineages with non-binary trees.
261
262
263 OTHER CHANGES
264
265     o ape has now a namespace.
266
267     o drop.tip() has been improved: it should be much faster and work
268       better in some cases (e.g., see the example in ?zoom).
269
270
271
272                 CHANGES IN APE VERSION 2.2-2
273
274
275 NEW FEATURES
276
277     o dist.gene() has been substantially improved and gains an option
278       'pairwise.deletion'.
279
280     o cbind.DNAbin() has a new option 'fill.with.gaps' and is now
281       more flexible.
282
283
284 BUG FIXES
285
286     o prop.part() failed with a single tree with the default option
287      'check.labels = TRUE'.
288
289    o summary.DNAbin() failed to display correctly the summary of
290      sequence lengths with lists of sequences of 10,000 bases or more
291      (because summary.default uses 4 significant digits by default).
292
293    o read.nexus() failed to read a file with a single tree with line
294      breaks in the Newick string.
295
296    o del.gaps() returned a list of empty sequences when there were no
297      gaps.
298
299
300 OTHER CHANGES
301
302     o phymltest() has been updated for PhyML 3.0 and gains an option
303       'append', whereas the option 'path2exec' has been removed.
304
305     o rbind.DNAbin() and cbind.DNAbin() now accept a single matrix
306       which is returned unchanged (instead of an error).
307
308     o The data sets bird.orders and bird.families are now stored as
309       Newick strings; i.e., the command data(bird.orders) calls
310       read.tree().
311
312
313
314                 CHANGES IN APE VERSION 2.2-1
315
316
317 NEW FEATURES
318
319     o The new function makeLabel() helps to modify labels of trees,
320       lists of trees, or DNA sequences, with several utilities to
321       truncate and/or make them unique, substituting some
322       characters, and so on.
323
324     o The new function del.gaps() removes insertion gaps ("-") in a
325       set of DNA sequences.
326
327     o read.dna() can now read Clustal files (*.aln).
328
329
330 BUG FIXES
331
332     o root() failed with 'resolve.root = TRUE' when the root was
333       already the specified root.
334
335     o Several bugs were fixed in mlphylo().
336
337     o collapsed.singles() did not propagate the 'Nnode' and
338       'node.labels' elements (thanks to Elizabeth Purdom for the fix).
339
340     o read.nexus() failed to remove correctly the comments within
341       trees.
342
343     o read.nexus() failed to read a file with a single tree and no
344       translation of tip labels.
345
346     o read.nexus() failed to place correctly tip labels when reading
347       a single tree with no edge lengths.
348
349     o A bug was fixed in sh.test().
350
351
352 OTHER CHANGES
353
354     o unique.multiPhylo() is faster thanks to a suggestion by Vladimir
355       Minin.
356
357     o The option 'check.labels' of consensus() and prop.part() is now
358       TRUE by default.
359
360     o write.dna() now does not truncate names to 10 characters with
361       the Phylip formats.
362
363
364
365                 CHANGES IN APE VERSION 2.2
366
367
368 NEW FEATURES
369
370     o Four new functions have been written by Damien de Vienne for the
371       graphical exploration of large trees (cophyloplot, subtrees,
372       subtreeplot), and to return the graphical coordinates of tree
373       (without plotting).
374
375     o The new functions corPagel and corBlomberg implement the Pagel's
376       "lambda" and Blomberg et al.'s "ACDC" correlation structures.
377
378     o chronopl() has been improved and gains several options: see its
379       help page for details.
380
381     o boot.phylo() has now an option 'trees' to possibly return the
382       bootstraped trees (the default is FALSE).
383
384     o prop.part() has been improved and should now be faster in all
385       situations.
386
387
388 BUG FIXES
389
390     o read.dna() failed if "?" occurred in the first 10 sites of the
391       first sequence.
392
393     o The x/y aspect of the plot is now respected when plotting a
394       circular tree (type = "r" or "f").
395
396     o Drawing the tip labels sometimes failed when plotting circular
397       trees.
398
399     o zoom() failed when tip labels were used instead of their numbers
400       (thanks to Yan Wong for the fix).
401
402     o drop.tip() failed with some trees (fixed by Yan Wong).
403
404     o seg.sites() failed with a list.
405
406     o consensus() failed in some cases. The function has been improved
407       as well and is faster.
408
409
410
411                 CHANGES IN APE VERSION 2.1-3
412
413
414 BUG FIXES
415
416     o A bug in read.nexus() made the Windows R-GUI crash.
417
418     o An error was fixed in the computation of ancestral character
419       states by generalized least squares in ace().
420
421     o di2multi() did not modify node labels correctly.
422
423     o multi2di() failed if the tree had its attribute "order" set to
424       "cladewise".
425
426
427
428                 CHANGES IN APE VERSION 2.1-2
429
430
431 NEW FEATURES
432
433     o There three new methods for the "multiPhylo" class: str, $,
434       and [[.
435
436     o root() gains the options 'node' and 'resolve.root'
437       (FALSE by default) as well as its code being improved.
438
439     o mltt.plot() has now an option 'log' used in the same way
440       than in plot.default().
441
442
443 BUG FIXES
444
445     o mltt.plot() failed to display the legend with an unnamed
446       list of trees.
447
448     o nodelabels() with pies now correcly uses the argument
449       'cex' to draw symbols of different sizes (which has
450       worked already for thermometers).
451
452     o read.nexus() generally failed to read very big files.
453
454
455 OTHER CHANGES
456
457     o The argument 'family' of compar.gee() can now be a function
458       as well as a character string.
459
460     o read.tree() and read.nexus() now return an unnamed list if
461       'tree.names = NULL'.
462
463     o read.nexus() now returns a modified object of class "multiPhylo"
464       when there is a TRANSLATE block in the NEXUS file: the individual
465       trees have no 'tip.label' vector, but the list has a 'TipLabel'
466       attribute. The new methods '$' and '[[' set these elements
467       correctly when extracting trees.
468
469
470
471                 CHANGES IN APE VERSION 2.1-1
472
473
474 NEW FEATURES
475
476     o The new function rmtree generates lists of random trees.
477
478     o rcoal() now generates a genuine coalescent tree by default
479       (thanks to Vladimir Minin for the code).
480
481
482 BUG FIXES
483
484     o nuc.div() returned an incorrect value with the default
485       pairwise.deletion = FALSE.
486
487
488 OTHER CHANGES
489
490     o The internal codes of bionj(), fastme.bal(), and fastme.ols()
491       have been improved so that they are stabler and faster.
492
493     o R packages used by ape are now loaded silently; lattice and gee
494       are loaded only when needed.
495
496
497
498                 CHANGES IN APE VERSION 2.1
499
500
501 NEW FEATURES
502
503     o The new function identify.phylo identifies clades on a plotted
504       tree using the mouse.
505
506     o It is now possible to subset a list of trees (object of class
507       "multiPhylo") with "[" while keeping its class correct.
508
509     o The new function as.DNAbin.alignment converts DNA sequences
510       stored in the "alignment" format of the package seqinr into
511       an object of class "DNAbin".
512
513     o The new function weight.taxo2 helps to build similarity matrices
514       given two taxonomic levels (usually called by other functions).
515
516     o write.tree() can now take a list of trees (class "multiPhylo")
517       as its main argument.
518
519     o plot.correlogram() and plot.correlogramList() have been
520       improved, and gain several options (see the help page for
521       details). A legend is now plotted by default.
522
523
524 BUG FIXES
525
526     o dist.dna() returned some incorrect values with `model = "JC69"'
527       and `pairwise.deletion = TRUE'. This affected only the
528       distances involving sequences with missing values. (Thanks
529       to Bruno Toupance for digging this bug out.)
530
531     o write.tree() failed with some trees: this is fixed by removing
532       the `multi.line' option (trees are now always printed on a
533       single line).
534
535     o read.nexus() did not correctly detect trees with multiple root
536       edges (see OTHER CHANGES).
537
538
539 OTHER CHANGES
540
541     o The code of mlphylo() has been almost entirely rewritten, and
542       should be much stabler. The options have been also greatly
543       simplified (see ?mlphylo and ?DNAmodel for details).
544
545     o The internal function nTips has been renamed klastorin_nTips.
546
547     o The code of is.ultrametric() contained redundancies and has
548       been cleaned-up.
549
550     o The code of Moran.I() and of correlogram.formula() have been
551       improved.
552
553     o read.tree() and read.nexus() now return an error when trying to
554       read a tree with multiple root edges (see BUG FIXES). The
555       correction applied in previous version did not work in all
556       situations.
557
558     o The class c("multi.tree", "phylo") has been renamed
559       "multiPhylo".
560
561
562 DOCUMENTATION
563
564     o There is now a vignette in ape: see vignette("MoranI", "ape").
565
566
567 DEPRECATED & DEFUNCT
568
569     o as.matching() and as.phylo.matching() do not support branch
570       lengths.
571
572     o correlogram.phylo() and discrete.dist() have been removed.
573
574
575
576                 CHANGES IN APE VERSION 2.0-2
577
578
579 NEW FEATURES
580
581     o The new function matexpo computes the exponential of a square
582       matrix.
583
584     o The new function unique.multi.tree removes duplicate trees from
585       a list.
586
587     o yule() has a new option `use.root.edge = FALSE' that specifies
588       to ignore, by default, the root edge of the tree if it exists.
589
590
591 BUG FIXES
592
593     o which.edge() failed when the index of a single terminal edge was
594       looked for.
595
596     o In diversi.time(), the values returned for model C were
597       incorrect.
598
599     o A bug was fixed in yule() that affected the calculation of the
600       likelihood in the presence of ties in the branching times.
601
602     o There was a bug in the C function mat_expo4x4 affecting the
603       calculations of the transition probabilities for models HKY and
604       GTR in mlphylo().
605
606     o A small bug was fixed in as.matrix.DNAbin (thanks to James
607       Bullard).
608
609     o rtree() did not `shuffle' the tip labels by default, so only a
610       limited number of labelled topologies could be generated.
611
612
613
614                 CHANGES IN APE VERSION 2.0-1
615
616
617 NEW FEATURES
618
619     o The three new functions bionj, fastme.ols, and fastme.bal
620       perform phylogeny estimation by the BIONJ and fastME methods in
621       OLS and balanced versions. This is a port to R of previous
622       previous programs done by Vincent Lefort.
623
624     o The new function chronoMPL performs molecular dating with the
625       mean path lengths method of Britton et al. (2002, Mol. Phyl.
626       Evol. 24: 58).
627
628     o The new function rotate, contributed by Christoph Heibl, swaps
629       two clades connected to the same node. It works also with
630       multichotomous nodes.
631
632     o The new `method' as.matrix.DNAbin() may be used to convert
633       easily DNA sequences stored in a list into a matrix while
634       keeping the names and the class.
635
636
637 BUG FIXES
638
639     o chronopl() failed when some branch lengths were equal to zero:
640       an error message is now returned.
641
642     o di2multi() failed when there was a series of consecutive edges
643       to remove.
644
645
646
647                 CHANGES IN APE VERSION 1.10-2
648
649
650 NEW FEATURES
651
652     o plot.phylo() can now plot circular trees: the option is type =
653       "fan" or type = "f" (to avoid the ambiguity with type = "c").
654
655     o prop.part() has a new option `check.labels = FALSE' which allows
656       to considerably speed-up the calculations of bipartitions. As a
657       consequence, calculations of bootstrap values with boot.phylo()
658       should be much faster.
659
660
661 BUG FIXES
662
663     o read.GenBank() did not return correctly the list of species as
664       from ape 1.10: this is fixed in this version
665
666     o Applying as.phylo() on a tree of class "phylo" failed: the
667       object is now returned unchanged.
668
669
670
671                 CHANGES IN APE VERSION 1.10-1
672
673
674 NEW FEATURES
675
676     o The three new functions Ntip, Nnode, and Nedge return, for a
677       given tree, the number of tips, nodes, or edges, respectively.
678
679
680 BUG FIXES
681
682     o read.nexus() did not set correctly the class of the returned
683       object when reading multiple trees.
684
685     o mllt.plot() failed with objects of class c("multi.tree",
686       "phylo").
687
688     o unroot() did not work correctly in most cases.
689
690     o reorder.phylo() made R freeze in some occasions.
691
692     o Plotting a tree in pruningwise order failed.
693
694     o When plotting an unrooted tree, the tip labels where not all
695       correctly positioned if the option `cex' was used.
696
697
698
699                 CHANGES IN APE VERSION 1.10
700
701
702 NEW FEATURES
703
704     o Five new `method' functions have been introduced to manipulate
705       DNA sequences in binary format (see below).
706
707     o Three new functions have been introduced to convert between the
708       new binary and the character formats.
709
710     o The new function as.alignment converts DNA sequences stored as
711       single characters into the class "alignment" used by the package
712       seqinr.
713
714     o read.dna() and read.GenBank() have a new argument `as.character'
715       controlling whether the sequences are returned in binary format
716       or as character.
717
718
719 BUG FIXES
720
721     o root() failed when the tree had node labels: this is fixed.
722
723     o plot.phylo() did not correctly set the limits on the y-axis with
724       the default setting: this is fixed.
725
726     o dist.dna() returned a wrong result for the LogDet, paralinear,
727       and BH87 models with `pairwise.deletion = TRUE'.
728
729
730 OTHER CHANGES
731
732     o DNA sequences are now internally stored in a binary format. See
733       the document "A Bit-Level Coding Scheme for Nucleotides" for the
734       details. Most functions analyzing DNA functions have been
735       modified accordingly and are now much faster (dist.dna is now
736       ca. 60 times faster).
737
738
739
740                 CHANGES IN APE VERSION 1.9-4
741
742
743 BUG FIXES
744
745     o A bug was fixed in edgelabels().
746
747     o as.phylo.hclust() did not work correctly when the object of
748       class "hclust" has its labels set to NULL: the returned tree has
749       now its tip labels set to "1", "2", ...
750
751     o consensus could fail if some tip labels are a subset of others
752       (e.g., "a" and "a_1"): this is now fixed.
753
754     o mlphylo() failed in most cases if some branch lengths of the
755       initial tree were greater than one: an error message is now
756       issued.
757
758     o mlphylo() failed in most cases when estimating the proportion of
759       invariants: this is fixed.
760
761
762
763                 CHANGES IN APE VERSION 1.9-3
764
765
766 NEW FEATURES
767
768     o The new function edgelabels adds labels on the edge of the tree
769       in the same way than nodelabels or tiplabels.
770
771
772 BUG FIXES
773
774     o multi2di() did not handle correctly branch lengths with the
775       default option `random = TRUE': this is now fixed.
776
777     o A bug was fixed in nuc.div() when using pairwise deletions.
778
779     o A bug occurred in the analysis of bipartitions with large
780       numbers of large trees, with consequences on prop.part,
781       prop.clades, and boot.phylo.
782
783     o The calculation of the Billera-Holmes-Vogtmann distance in
784       dist.topo was wrong: this has been fixed.
785
786
787
788                 CHANGES IN APE VERSION 1.9-2
789
790
791 NEW FEATURES
792
793     o The new function ladderize reorganizes the internal structure of
794       a tree to plot them left- or right-ladderized.
795
796     o The new function dist.nodes computes the patristic distances
797       between all nodes, internal and terminal, of a tree. It replaces
798       the option `full = TRUE' of cophenetic.phylo (see below).
799
800
801 BUG FIXES
802
803     o A bug was fixed in old2new.phylo().
804
805     o Some bugs were fixed in chronopl().
806
807     o The edge colours were not correctly displayed by plot.phylo
808       (thank you to Li-San Wang for the fix).
809
810     o cophenetic.phylo() failed with multichotomous trees: this is
811       fixed.
812
813
814 OTHER CHANGES
815
816     o read.dna() now returns the sequences in a matrix if they are
817       aligned (interleaved or sequential format). Sequences in FASTA
818       format are still returned in a list.
819
820     o The option `full' of cophenetic.phylo() has been removed because
821       it could not be used from the generic.
822
823
824 DEPRECATED & DEFUNCT
825
826     o rotate() has been removed; this function did not work correctly
827       since ape 1.9.
828
829
830
831                 CHANGES IN APE VERSION 1.9-1
832
833
834 BUG FIXES
835
836     o Trees with a single tip were not read correctly in R as the
837       element `Nnode' was not set: this is fixed.
838
839     o unroot() did not set correctly the number of nodes of the
840       unrooted tree in most cases.
841
842     o read.GenBank() failed when fetching very long sequences,
843       particularly of the BX-series.
844
845     o A bug was introduced in read.tree() with ape 1.9: it has been
846       fixed
847
848
849
850                 CHANGES IN APE VERSION 1.9
851
852
853 NEW FEATURES
854
855     o There are two new print `methods' for trees of class "phylo" and
856       lists of trees of class "multi.tree", so that they are now
857       displayed in a compact and informative way.
858
859     o There are two new functions, old2new.phylo and new2old.phylo,
860       for converting between the old and new coding of the class
861       "phylo".
862
863     o dist.dna() has three new models: Barry and Hartigan ("BH87"),
864       LogDet ("logdet"), and paralinear ("paralin").
865
866     o compute.brlen() has been extended: several methods are now
867       available to compute branch lengths.
868
869     o write.dna() can now handle matrices as well as lists.
870
871
872 BUG FIXES
873
874     o cophenetic.phylo() sometimes returned a wrong result with
875       multichotomous trees: this is fixed.
876
877     o rotate() failed when a single tip was specified: the tree is now
878       returned unchanged.
879
880     o ace() did not return the correct index matrix with custom
881       models: this is fixed.
882
883     o multi2di() did not work correctly when resolving multichotomies
884       randomly: the topology was always the same, only the arrangement
885       of clades was randomized: this is fixed. This function now
886       accepts trees with no branch lengths.
887
888     o The output of diversi.gof() was blurred by useless prints when a
889       user distribution was specified. This has been corrected, and
890       the help page of this function has been expanded.
891
892
893 OTHER CHANGES
894
895     o The internal structure of the class "phylo" has been changed:
896       see the document "Definition of Formats for Coding Phylogenetic
897       Trees in R" for the details. In addition, the code of most
898       functions has been improved.
899
900     o Several functions have been improved by replacing some R codes
901       by C codes: pic, plot.phylo, and reorder.phylo.
902
903     o There is now a citation information: see citation("ape") in R.
904
905     o write.tree() now does not add extra 0's to branch lengths so
906       that 1.23 is printed "1.23" by default, not "1.2300000000".
907
908     o The syntax of bind.tree() has been simplified. This function now
909       accepts trees with no branch lengths, and handles correctly node
910       labels.
911
912     o The option `as.numeric' of mrca() has been removed.
913
914     o The unused options `format' and `rooted' of read.tree() have
915       been removed.
916
917     o The unused option `format' of write.tree() has been removed.
918
919     o The use of node.depth() has been simplified.
920
921
922
923                 CHANGES IN APE VERSION 1.8-5
924
925
926 NEW FEATURES
927
928     o Two new functions read.nexus.data() and write.nexus.data(),
929       contributed by Johan Nylander, allow to read and write molecular
930       sequences in NEXUS files.
931
932     o The new function reorder.phylo() reorders the internal structure
933       of a tree of class "phylo". It is used as the generic, e.g.,
934       reorder(tr).
935
936     o read.tree() and read.nexus() can now read trees with a single
937       edge.
938
939     o The new data set `cynipids' supplies a set of protein sequences
940       in NEXUS format.
941
942
943 BUG FIXES
944
945     o The code of all.equal.phylo() has been completely rewritten
946       (thanks to Benoît Durand) which fixes several bugs.
947
948     o read.tree() and read.nexus() now checks the labels of the tree
949       to remove or substitute any characters that are illegal in the
950       Newick format (parentheses, etc.)
951
952     o A negative P-value could be returned by mantel.test(): this is
953       now fixed.
954
955
956
957                 CHANGES IN APE VERSION 1.8-4
958
959
960 NEW FEATURES
961
962     o The new function sh.test() computes the Shimodaira-
963       Hasegawa test.
964
965     o The new function collapse.singles() removes the nodes with a
966       single descendant from a tree.
967
968     o plot.phylo() has a new argument `tip.color' to specify the
969       colours of the tips.
970
971     o mlphylo() has now an option `quiet' to control the display of
972       the progress of the analysis (the default is FALSE).
973
974
975 BUG FIXES
976
977     o read.dna() did not read correctly sequences in sequential format
978       with leading alignment gaps "-": this is fixed.
979
980     o ace() returned a list with no class so that the generic
981       functions (anova, logLik, ...) could not be used directly. This
982       is fixed as ace() now returns an object of class "ace".
983
984     o anova.ace() had a small bug when computing the number of degrees
985       of freedom: this is fixed.
986
987     o mlphylo() did not work when the sequences were in a matrix or
988       a data frame: this is fixed.
989
990     o rtree() did not work correctly when trying to simulate an
991       unrooted tree with two tips: an error message is now issued.
992
993
994 OTHER CHANGES
995
996     o The algorithm of rtree() has been changed: it is now about 40,
997       100, and 130 times faster for 10, 100, and 1000 tips,
998       respectively.
999
1000
1001
1002                 CHANGES IN APE VERSION 1.8-3
1003
1004
1005 NEW FEATURES
1006
1007     o There are four new `method' functions to be used with the
1008       results of ace(): logLik(), deviance(), AIC(), and anova().
1009
1010     o The plot method of phymltest has two new arguments: `main' to
1011       change the title, and `col' to control the colour of the
1012       segments showing the AIC values.
1013
1014     o ace() has a new argument `ip' that gives the initial values used
1015       in the ML estimation with discrete characters (see the examples
1016       in ?ace). This function now returns a matrix giving the indices
1017       of the estimated rates when analysing discrete characters.
1018
1019     o nodelabels() and tiplabels() have a new argument `pie' to
1020       represent proportions, with any number of categories, as
1021       piecharts. The use of the option `thermo' has been improved:
1022       there is now no limitation on the number of categories.
1023
1024
1025 BUG FIXES
1026
1027     o mlphylo() did not work with more than two partitions: this is
1028       fixed.
1029
1030     o root() failed if the proposed outgroup was already an outgroup
1031       in the tree: this is fixed.
1032
1033     o The `col' argument in nodelabels() and tiplabels() was not
1034       correctly passed when `text' was used: this is fixed.
1035
1036     o Two bugs were fixed in mlphylo(): parameters were not always
1037       correctly output, and the estimation failed in some cases.
1038
1039     o plot.phylo() was stuck when given a tree with a single tip: this
1040       is fixed and a message error is now returned.
1041
1042     o An error was corrected in the help page of gammaStat regarding
1043       the calculation of P-values.
1044
1045     o Using gls() could crash R when the number of species in the tree
1046       and in the variables were different: this is fixed.
1047
1048
1049
1050                 CHANGES IN APE VERSION 1.8-2
1051
1052
1053 NEW FEATURES
1054
1055     o The new function mlphylo() fits a phylogenetic tree by maximum
1056       likelihood from DNA sequences. Its companion function DNAmodel()
1057       is used to define the substitution model which may include
1058       partitioning. There are methods for logLik(), deviance(), and
1059       AIC(), and the summary() method has been extended to display in
1060       a friendly way the results of this model fitting. Currently, the
1061       functionality is limited to estimating the substitution and
1062       associated parameters and computing the likelihood.
1063
1064     o The new function drop1.compar.gee (used as, e.g., drop1(m))
1065       tests for single effects in GEE-based comparative method. A
1066       warning message is printed if there is not enough degrees of
1067       freedom.
1068
1069
1070 BUG FIXES
1071
1072     o An error message was sometimes issued by plot.multi.tree(),
1073       though with no consequence.
1074
1075
1076
1077                 CHANGES IN APE VERSION 1.8-1
1078
1079
1080 NEW FEATURES
1081
1082     o There is a new plot method for lists of trees (objects of class
1083       "multi.tree"): it calls plot.phylo() internally and is
1084       documented on the same help page.
1085
1086
1087 BUG FIXES
1088
1089     o A bug was fixed in the C code that analyzes bipartitions: this
1090       has impact on several functions like prop.part, prop.clades,
1091       boot.phylo, or consensus.
1092
1093     o root() did not work correctly when the specified outgroup had
1094       more than one element: this is fixed.
1095
1096     o dist.dna() sometimes returned a warning inappropriately: this
1097       has been corrected.
1098
1099     o If the distance object given to nj() had no rownames, nj()
1100       returned a tree with no tip labels: it now returns tips labelled
1101       "1", "2", ..., corresponding to the row numbers.
1102
1103
1104 OTHER CHANGES
1105
1106     o nj() has been slightly changed so that tips with a zero distance
1107       are first aggregated with zero-lengthed branches; the usual NJ
1108       procedure is then performed on a distance matrix without 0's.
1109
1110
1111
1112                 CHANGES IN APE VERSION 1.8
1113
1114
1115 NEW FEATURES
1116
1117     o The new function chronopl() estimates dates using the penalized
1118       likelihood method by Sanderson (2002; Mol. Biol. Evol., 19:101).
1119
1120     o The new function consensus() calculates the consensus tree of a
1121       list of trees.
1122
1123     o The new function evolve.phylo() simulates the evolution of
1124       continuous characters along a phylogeny under a Brownian model.
1125
1126     o The new plot method for objects of class "ancestral" displays a
1127       tree together with ancestral values, as returned by the above
1128       function.
1129
1130     o The new function as.phylo.formula() returns a phylogeny from a
1131       set of nested taxonomic variables given as a formula.
1132
1133     o The new function read.caic() reads trees in CAIC format.
1134
1135     o The new function tiplabels() allows to add labels to the tips
1136       of a tree using text or plotting symbols in a flexible way.
1137
1138     o The new function unroot() unroots a phylogeny.
1139
1140     o multi2di() has a new option, `random', which specifies whether
1141       to resolve the multichotomies randomly (the default) or not.
1142
1143     o prop.part() now returns an object of class "prop.part" for which
1144       there are print (to display a partition in a more friendly way)
1145       and summary (to extract the numbers) methods.
1146
1147     o plot.phylo() has a new option, `show.tip.label', specifying
1148       whether to print the labels of the tips. The default is TRUE.
1149
1150     o The code of nj() has been replaced by a faster C code: it is now
1151       about 10, 25, and 40 times faster for 50, 100, and 200 taxa,
1152       respectively.
1153
1154     o write.nexus() now writes whether a tree is rooted or not.
1155
1156
1157 BUG FIXES
1158
1159     o Two bugs have been fixed in root(): unrooted trees are now
1160       handled corretly, and node labels are now output normally.
1161
1162     o A bug was fixed in phymltest(): the executable couldn't be found
1163       in some cases.
1164
1165     o Three bug have been fixed in ace(): computing the likelihood of
1166       ancestral states of discrete characters failed, custom models
1167       did not work, and the function failed with a null gradient (a
1168       warning message is now returned; this latter bug was also
1169       present in yule.cov() as well and is now fixed).
1170
1171     o pic() hanged out when missing data were present: a message error
1172       is now returned.
1173
1174     o A small bug was fixed in dist.dna() where the gamma correction
1175       was not always correctly dispatched.
1176
1177     o plot.phylo() plotted correctly the root edge only when the tree
1178       was plotted rightwards: this works now for all directions.
1179
1180
1181 OTHER CHANGES
1182
1183     o dist.taxo() has been renamed as weight.taxo().
1184
1185     o Various error and warning messages have been improved.
1186
1187
1188
1189                 CHANGES IN APE VERSION 1.7
1190 NEW FEATURES
1191
1192     o The new function ace() estimates ancestral character states for
1193       continuous characters (with ML, GLS, and contrasts methods), and
1194       discrete characters (with ML only) for any number of states.
1195
1196     o The new function compar.ou() fits the Ornstein-Uhlenbeck model
1197       of directional evolution for continuous characters. The user
1198       specifies the node(s) of the tree where the character optimum
1199       changes.
1200
1201     o The new function is.rooted() tests whether a tree (of class
1202       "phylo") is rooted.
1203
1204     o The new function rcoal() generates random ultrametric trees with
1205       the possibility to specify the function that generates the
1206       inter-nodes distances.
1207
1208     o The new function mrca() gives for all pairs of tips in a tree
1209       (and optionally nodes too) the most recent common ancestor.
1210
1211     o nodelabels() has a new option `thermo' to plot proportions (up
1212       to three classes) on the nodes of a tree.
1213
1214     o rtree() has been improved: it can now generate rooted or
1215       unrooted trees, and the mathematical function that generates the
1216       branch lengths may be specified by the user. The tip labels may
1217       be given directly in the call to rtree. The limit cases (n = 2,
1218       3) are now handled correctly.
1219
1220     o dist.topo() has a new argument `method' with two choices: "PH85"
1221       for Penny and Henny's method (already available before and now
1222       the default), and "BHV01" for the geometric distance by Billera
1223       et al. (2001, Adv. Appl. Math. 27:733).
1224
1225     o write.tree() has a new option, `digits', which specifies the
1226       number of digits to be printed in the Newick tree. By default
1227       digits = 10. The numbers are now always printed in decimal form
1228       (i.e., 1.0e-1 is now avoided).
1229
1230     o dist.dna() can now compute the raw distances between pairs of
1231       DNA sequences by specifying model = "raw".
1232
1233     o dist.phylo() has a new option `full' to possibly compute the
1234       distances among all tips and nodes of the tree. The default if
1235       `full = FALSE'.
1236
1237
1238 BUG FIXES
1239
1240     o Several bugs were fixed in all.equal.phylo().
1241
1242     o dist.dna() did not handle correctly gaps ("-") in alignments:
1243       they are now considered as missing data.
1244
1245     o rotate() did not work if the tips were not ordered: this is
1246       fixed.
1247
1248     o mantel.test() returned NA in some special cases: this is fixed
1249       and the function has been improved and is now faster.
1250
1251     o A bug was fixed in diversi.gof() where the calculation of A² was
1252       incorrect.
1253
1254     o cherry() did not work correctly under some OSs (mainly Linux):
1255       this is fixed.
1256
1257     o is.binary.tree() has been modified so that it works with both
1258       rooted and unrooted trees.
1259
1260     o The documentation of theta.s() was not correct: this has been
1261       fixed.
1262
1263     o plot.mst() did not work correctly: this is fixed.
1264
1265
1266
1267                 CHANGES IN APE VERSION 1.6
1268
1269
1270 NEW FEATURES
1271
1272     o The new function dist.topo() computes the topological distances
1273       between two trees.
1274
1275     o The new function boot.phylo() performs a bootstrap analysis on
1276       phylogeny estimation.
1277
1278     o The new functions prop.part() and prop.clades() analyse
1279       bipartitions from a series of trees.
1280
1281
1282 OTHER CHANGES
1283
1284     o read.GenBank() now uses the EFetch utility of NCBI instead of
1285       the usual Web interface: it is now much faster (e.g., 12 times
1286       faster to retrieve 8 sequences, 37 times for 60 sequences).
1287
1288
1289 BUG FIXES
1290
1291     o Several bugs were fixed in read.dna().
1292
1293     o Several bugs were fixed in diversi.time().
1294
1295     o is.binary.tree() did not work correctly if the tree has no edge
1296       lengths: this is fixed.
1297
1298     o drop.tip() did not correctly propagated the `node.label' of a
1299       tree: this is fixed.
1300
1301
1302
1303                 CHANGES IN APE VERSION 1.5
1304
1305
1306 NEW FEATURES
1307
1308     o Two new functions, as.matching.phylo() and as.phylo.matching(),
1309       convert objects between the classes "phylo" and "matching". The
1310       latter implements the representation of binary trees introduced by
1311       Diaconis and Holmes (1998; PNAS 95:14600). The generic function
1312       as.matching() has been introduced as well.
1313
1314     o Two new functions, multi2di() and di2multi(), allow to resolve
1315       and collapse multichotomies with branches of length zero.
1316
1317     o The new function nuc.div() computes the nucleotide diversity
1318       from a sample a DNA sequences.
1319
1320     o dist.dna() has been completely rewritten with a much faster
1321       (particularly for large data sets) C code. Eight models are
1322       available: JC69, K80, F81, K81, F84, T92, TN93, and GG95 (the
1323       option `method' has been renamed `model'). Computation of variance
1324       is available for all models. A gamma-correction is possible for
1325       JC69, K80, F81, and TN93. There is a new option, pairwise.deletion,
1326       to remove sites with missing data on a pairwise basis. The option
1327       `GCcontent' has been removed.
1328
1329     o read.GenBank() has a new option (species.names) which specifies
1330       whether to return the species names of the organisms in addition
1331       to the accession numbers of the sequences (this is the default
1332       behaviour).
1333
1334     o write.nexus() can now write several trees in the same NEXUS file.
1335
1336     o drop.tip() has a new option `root.edge' that allows to specify the
1337       new root edge if internal branches are trimmed.
1338
1339
1340 BUG FIXES
1341
1342     o as.phylo.hclust() failed if some labels had parentheses: this
1343       is fixed.
1344
1345     o Several bugs were fixed in all.equal.phylo(). This function now
1346       returns the logical TRUE if the trees are identical but with
1347       different representations (a report was printed previously).
1348
1349     o read.GenBank() did not correctly handle ambiguous base codes:
1350       this is fixed.
1351
1352
1353 OTHER CHANGES
1354
1355     o birthdeath() now returns an object of class "birthdeath" for
1356       which there is a print method.
1357
1358
1359
1360                 CHANGES IN APE VERSION 1.4
1361
1362
1363 NEW FEATURES
1364
1365     o The new function nj() performs phylogeny estimation with the
1366       neighbor-joining method of Saitou and Nei (1987; Mol. Biol.
1367       Evol., 4:406).
1368
1369     o The new function which.edge() identifies the edges of a tree
1370       that belong to a group specified as a set of tips.
1371
1372     o The new function as.phylo.phylog() converts an object of class
1373       "phylog" (from the package ade4) into an object of class
1374       "phylo".
1375
1376     o The new function axisPhylo() draws axes on the side of a
1377       phylogeny plot.
1378
1379     o The new function howmanytrees() calculates the number of trees
1380       in different cases and giving a number of tips.
1381
1382     o write.tree() has a new option `multi.line' (TRUE by default) to
1383       write a Newick tree on several lines rather than on a single
1384       line.
1385
1386     o The functionalities of zoom() have been extended. Several
1387       subtrees can be visualized at the same time, and they are marked
1388       on the main tree with colors. The context of the subtrees can be
1389       marked with the option `subtree' (see below).
1390
1391     o drop.tip() has a new option `subtree' (FALSE by default) which
1392       specifies whether to output in the tree how many tips have been
1393       deleted and where.
1394
1395     o The arguments of add.scale.bar() have been redefined and have
1396       now default values (see ?add.scale.bar for details). This
1397       function now works even if the plotted tree has no edge length.
1398
1399     o plot.phylo() can now plot radial trees, but this does not take
1400       edge lengths into account.
1401
1402     o In plot.phylo() with `type = "phylogram"', if the values of
1403       `edge.color' and `edge.width' are identical for sister-branches,
1404       they are propagated to the vertical line that link them.
1405
1406
1407 BUG FIXES
1408
1409     o Repeated calls to as.phylo.hclust() or as.hclust.phylo() made R
1410       crashing. This is fixed.
1411
1412     o In plot.phylo(), the options `edge.color' and `edge.width' are
1413       now properly recycled; their default values are now "black" and
1414       1, respectively.
1415
1416     o A bug has been fixed in write.nexus().
1417
1418
1419 OTHER CHANGES
1420
1421     o The function node.depth.edgelength() has been removed and
1422       replaced by a C code.
1423
1424
1425
1426                 CHANGES IN APE VERSION 1.3-1
1427
1428
1429 NEW FEATURES
1430
1431     o The new function nodelabels() allows to add labels to the nodes
1432       of a tree using text or plotting symbols in a flexible way.
1433
1434     o In plot.phylo() the arguments `x.lim' and `y.lim' can now be two
1435       numeric values specifying the lower and upper limits on the x-
1436       and y-axes. This allows to leave some space on any side of the
1437       tree. If a single value is given, this is taken as the upper
1438       limit (as before).
1439
1440
1441
1442                 CHANGES IN APE VERSION 1.3
1443
1444
1445 NEW FEATURES
1446
1447     o The new function phymltest() calls the software PHYML and fits
1448       28 models of DNA sequence evolution. There are a print method to
1449       display likelihood and AIC values, a summary method to compute
1450       the hierarchical likelihood ratio tests, and a plot method to
1451       display graphically the AIC values of each model.
1452
1453     o The new function yule.cov() fits the Yule model with covariates,
1454       a model where the speciation rate is affected by several species
1455       traits through a generalized linear model. The parameters are
1456       estimated by maximum likelihood.
1457
1458     o Three new functions, corBrownian(), corGrafen(), and
1459       corMartins(), compute the expected correlation structures among
1460       species given a phylogeny under different models of evolution.
1461       These can be used for GLS comparative phylogenetic methods (see
1462       the examples). There are coef() and corMatrix() methods and an
1463       Initialize.corPhyl() function associated.
1464
1465     o The new function compar.cheverud() implements Cheverud et al.'s
1466       (1985; Evolution 39:1335) phylogenetic comparative method.
1467
1468     o The new function varcomp() estimates variance components; it has
1469       a plot method.
1470
1471     o Two new functions, panel.superpose.correlogram() and
1472       plot.correlogramList(), allow to plot several phylogenetic
1473       correlograms.
1474
1475     o The new function node.leafnumber() computes the number of leaves
1476       of a subtree defined by a particular node.
1477
1478     o The new function node.sons() gets all tags of son nodes from a
1479       given parent node.
1480
1481     o The new function compute.brlen() computes the branch lengths of
1482       a tree according to a specified method.
1483
1484     o plot.phylo() has three new options: "cex" controls the size of
1485       the (tip and node) labels (thus it is no more needed to change
1486       the global graphical parameter), "direction" which allows to
1487       plot the tree rightwards, leftwards, upwards, or downwards, and
1488       "y.lim" which sets the upper limit on the y-axis.
1489
1490
1491 BUG FIXES
1492
1493     o Some functions which try to match tip labels and names of
1494       additional data (e.g. vector) are likely to fail if there are
1495       typing or syntax errors. If both series of names do not perfectly
1496       match, they are ignored and a warning message is now issued.
1497       These functions are bd.ext, compar.gee, pic. Their help pages
1498       have been clarified on this point.
1499
1500
1501
1502                 CHANGES IN APE VERSION 1.2-7
1503
1504
1505 NEW FEATURES
1506
1507     o The new function root() reroots a phylogenetic tree with respect
1508       to a specified outgroup.
1509
1510     o The new function rotate() rotates an internal branch of a tree.
1511
1512     o In plot.phylo(), the new argument "lab4ut" (labels for unrooted
1513       trees) controls the display of the tip labels in unrooted trees.
1514       This display has been greatly improved: the tip labels are now not
1515       expected to overlap with the tree (particularly if lab4ut =
1516       "axial"). In all cases, combining appropriate values of "lab4ut"
1517       and the font size (via "par(cex = )") should result in readable
1518       unrooted trees. See ?plot.phylo for some examples.
1519
1520     o In drop.tip(), the argument `tip' can now be numeric or character.
1521
1522
1523 BUG FIXES
1524
1525     o drop.tip() did not work correctly with trees with no branch
1526       lengths: this is fixed.
1527
1528     o A bug in plot.phylo(..., type = "unrooted") made some trees being
1529       plotted with some line crossings: this is now fixed.
1530
1531
1532
1533                 CHANGES IN APE VERSION 1.2-6
1534
1535
1536 NEW FEATURES
1537
1538     o Six new functions (Moran.I, correlogram.formula, discrete.dist,
1539       correlogram.phylo, dist.taxo, plot.correlogram) have been added
1540       to implement comparative methods with an autocorrelation approach.
1541
1542     o A new data set describing some life history traits of Carnivores
1543       has been included.
1544
1545
1546 BUG FIXES
1547
1548     o A fix was made on mcmc.popsize() to conform to R 2.0.0.
1549
1550
1551 OTHER CHANGES
1552
1553     o When plotting a tree with plot.phylo(), the new default of the
1554       option `label.offset' is now 0, so the labels are always visible.
1555
1556
1557
1558                 CHANGES IN APE VERSION 1.2-5
1559
1560
1561 NEW FEATURES
1562
1563     o The new function bd.ext() fits a birth-death model with combined
1564       phylogenetic and taxonomic data, and estimates the corresponding
1565       speciation and extinction rates.
1566
1567
1568 OTHER CHANGES
1569
1570     o The package gee is no more required by ape but only suggested
1571       since only the function compar.gee() calls gee.
1572
1573
1574
1575                 CHANGES IN APE VERSION 1.2-4
1576
1577
1578 NEW FEATURES
1579
1580     o Four new functions (mcmc.popsize, extract.popsize, plot.popsize,
1581       and lines.popsize) implementing a new approach for inferring the
1582       demographic history from genealogies using a reversible jump
1583       MCMC have been introduced.
1584
1585     o The unit of time in the skyline plot and in the new plots can
1586       now be chosen to be actual years, rather than substitutions.
1587
1588
1589
1590                 CHANGES IN APE VERSION 1.2-3
1591
1592
1593 NEW FEATURES
1594
1595     o The new function rtree() generates a random binary tree with or
1596       without branch lengths.
1597
1598     o Two new functions for drawing lineages-through-time (LTT) plots
1599       are provided: ltt.lines() adds a LTT curve to an existing plot,
1600       and mltt.plot() does a multiple LTT plot giving several trees as
1601       arguments (see `?ltt.plot' for details).
1602
1603
1604 BUG FIXES
1605
1606     o Some taxon names made R crashing when calling as.phylo.hclust():
1607       this is fixed.
1608
1609     o dist.dna() returned an error with two identical DNA sequences
1610       (only using the Jukes-Cantor method returned 0): this is fixed.
1611
1612
1613 OTHER CHANGES
1614
1615     o The function dist.phylo() has been re-written using a different
1616       algorithm: it is now about four times faster.
1617
1618     o The code of branching.times() has been improved: it is now about
1619       twice faster.
1620
1621
1622
1623                 CHANGES IN APE VERSION 1.2-2
1624
1625
1626 NEW FEATURES
1627
1628     o The new function seg.sites() finds the segregating sites in a
1629       sample of DNA sequences.
1630
1631
1632 BUG FIXES
1633
1634     o A bug introduced in read.tree() and in read.nexus() with version
1635       1.2-1 was fixed.
1636
1637     o A few errors were corrected and a few examples were added in the
1638       help pages.
1639
1640
1641
1642                 CHANGES IN APE VERSION 1.2-1
1643
1644
1645 NEW FEATURES
1646
1647     o plot.phylo() can now draw the edge of the root of a tree if it
1648       has one (see the new option `root.edge', its default is FALSE).
1649
1650
1651 BUG FIXES
1652
1653     o A bug was fixed in read.nexus(): files with semicolons inside
1654       comment blocks were not read correctly.
1655
1656     o The behaviour of read.tree() and read.nexus() was corrected so
1657       that tree files with badly represented root edges (e.g., with
1658       an extra pair of parentheses, see the help pages for details)
1659       are now correctly represented in the object of class "phylo";
1660       a warning message is now issued.
1661
1662
1663
1664                 CHANGES IN APE VERSION 1.2
1665
1666
1667 NEW FEATURES
1668
1669     o plot.phylo() has been completely re-written and offers several
1670       new functionalities. Three types of trees can now be drawn:
1671       phylogram (as previously), cladogram, and unrooted tree; in
1672       all three types the branch lengths can be drawn using the edge
1673       lengths of the phylogeny or not (e.g., if the latter is absent).
1674       The vertical position of the nodes can be adjusted with two
1675       choices (see option `node.pos'). The code has been re-structured,
1676       and two new functions (potentially useful for developpers) are
1677       documented separately: node.depth.edgelength() and node.depth();
1678       see the respective help pages for details.
1679
1680     o The new function zoom() allows to explore very large trees by
1681       focusing on a small portion of it.
1682
1683     o The new function yule() fits by maximum likelihood the Yule model
1684       (birth-only process) to a phylogenetic tree.
1685
1686     o Support for writing DNA sequences in FASTA format has been
1687       introduced in write.dna() (support for reading sequences in
1688       this format was introduced in read.dna() in version 1.1-2).
1689       The function has been completely re-written, fixing some bugs
1690       (see below); the default behaviour is no more to display the
1691       sequences on the standard output. Several options have been
1692       introduced to control the sequence printing in a flexible
1693       way. The help page has been extended.
1694
1695     o A new data set is included: a supertree of bats in NEXUS format.
1696
1697
1698 BUG FIXES
1699
1700     o In theta.s(), the default of the option `variance' has
1701       been changed to `FALSE' (as was indicated in the help page).
1702
1703     o Several bugs were fixed in the code of all.equal.phylo().
1704
1705     o Several bugs were fixed in write.dna(), particularly this
1706       function did not work with `format = "interleaved"'.
1707
1708     o Various errors were corrected in the help pages.
1709
1710
1711 OTHER CHANGES
1712
1713     o The argument names of as.hclust.phylo() have been changed
1714       from "(phy)" to "(x, ...)" to conform to the definition of
1715       the corresponding generic function.
1716
1717     o gamma.stat() has been renamed gammaStat() to avoid confusion
1718       since gamma() is a generic function.
1719
1720
1721
1722                 CHANGES IN APE VERSION 1.1-3
1723
1724
1725 BUG FIXES
1726
1727     o base.freq() previously did not return a value of 0 for
1728       bases absent in the data (e.g., a vector of length 3 was
1729       returned if one base was absent). This is now fixed (a
1730       vector of length 4 is always returned).
1731
1732     o Several bugs were fixed in read.nexus(), including that this
1733       function did not work in this absence of a "TRANSLATE"
1734       command in the NEXUS file, and that the commands were
1735       case-sensitive.
1736
1737
1738
1739                 CHANGES IN APE VERSION 1.1-2
1740
1741
1742 NEW FEATURES
1743
1744     o The Tamura and Nei (1993) model of DNA distance is now implemented
1745       in dist.dna(): five models are now available in this function.
1746
1747     o A new data set is included: a set of 15 sequences of the
1748       cytochrome b mitochondrial gene of the woodmouse (Apodemus
1749       sylvaticus).
1750
1751
1752 BUG FIXES
1753
1754     o A bug in read.nexus() was fixed.
1755
1756     o read.dna() previously did not work correctly in most cases.
1757       The function has been completely re-written and its help page
1758       has been considerably extended (see ?read.dna for details).
1759       Underscores (_) in taxon names are no more replaced with
1760       spaces (this behaviour was undocumented).
1761
1762     o A bug was fixed in write.dna().
1763
1764
1765
1766                 CHANGES IN APE VERSION 1.1-1
1767
1768
1769 BUG FIXES
1770
1771     o A bug in read.tree() introduced in APE 1.1 was fixed.
1772
1773     o A bug in compar.gee() resulted in an error when trying to fit
1774       a model with `family = "binomial"'. This is now fixed.
1775
1776
1777
1778                 CHANGES IN APE VERSION 1.1
1779
1780
1781 NEW FEATURES
1782
1783     o The Klastorin (1982) method as suggested by Misawa and Tajima
1784       (2000, Mol. Biol. Evol. 17:1879-1884) for classifying genes
1785       on the basis of phylogenetic trees has been implemented (see
1786       the function klastorin()).
1787
1788     o Functions have been added to convert APE's "phylo" objects in
1789       "hclust" cluster objects and vice versa (see the help page of
1790       as.phylo for details).
1791
1792     o Three new functions, ratogram(), chronogram() and NPRS.criterion(),
1793       are introduced for the estimation of absolute evolutionary rates
1794       (ratogram) and dated clock-like trees (chronogram) from
1795       phylogenetic trees using the non-parametric rate smoothing approach
1796       by MJ Sanderson (1997, Mol. Biol. Evol. 14:1218-1231).
1797
1798     o A summary method is now provided printing a summary information on a
1799       phylogenetic tree with, for instance, `summary(tree)'.
1800
1801     o The behaviour of read.tree() was changed so that all spaces and
1802       tabulations in tree files are now ignored. Consequently, spaces in tip
1803       labels are no more allowed. Another side effect is that read.nexus()
1804       now does not replace the underscores (_) in tip labels with spaces
1805       (this behaviour was undocumented).
1806
1807     o The function plot.phylo() has a new option (`underscore') which
1808       specifies whether the underscores in tip labels should be written on
1809       the plot as such or replaced with spaces (the default).
1810
1811     o The function birthdeath() now computes 95% confidence intervals of
1812       the estimated parameters using profile likelihood.
1813
1814     o Three new data sets are included: a gene tree estimated from 36
1815       landplant rbcL sequences, a gene tree estimated from 32 opsin
1816       sequences, and a gene tree for 50 BRCA1 mammalian sequences.
1817
1818
1819 BUG FIXES
1820
1821     o A bug was fixed in dist.gene() where nothing was returned.
1822
1823     o A bug in plot.mst() was fixed.
1824
1825     o A bug in vcv.phylo() resulted in false correlations when the
1826       option `cor = TRUE' was used (now fixed).
1827
1828
1829
1830                 CHANGES IN APE VERSION 1.0
1831
1832
1833 NEW FEATURES
1834
1835     o Two new functions, read.dna() and write.dna(), read/write in a file
1836       DNA sequences in interleaved or in sequential format.
1837
1838     o Two new functions, read.nexus() and write.nexus(), read/write trees
1839       in a NEXUS file.
1840
1841     o The new function bind.tree() allows to bind two trees together,
1842       possibly handling root edges to give internal branches.
1843
1844     o The new function drop.tip() removes the tips in a phylogenetic tree,
1845       and trims (or not) the corresponding internal branches.
1846
1847     o The new function is.ultrametric() tests if a tree is ultrametric.
1848
1849     o The function plot.phylo() has more functionalities such as drawing the
1850       branches with different colours and/or different widths, showing the
1851       node labels, controling the position and font of the labels, rotating
1852       the labels, and controling the space around the plot.
1853
1854     o The function read.tree() can now read trees with no branch length,
1855       such as "(a,b),c);". Consequently, the element `edge.length' in
1856       objects of class "phylo" is now optional.
1857
1858     o The function write.tree() has a new default behaviour: if the default
1859       for the option `file' is used (i.e. file = ""), then a variable of
1860       mode character containing the tree in Newick format is returned which
1861       can thus be assigned (e.g., tree <- write.tree(phy)).
1862
1863     o The function read.tree() has a new argument `text' which allows
1864       to read the tree in a variable of mode character.
1865
1866     o A new data set is included: the phylogenetic relationships among
1867       the orders of birds from Sibley and Ahlquist (1990).
1868
1869
1870
1871                 CHANGES IN APE VERSION 0.2-1
1872
1873
1874 BUG FIXES
1875
1876     o Several bugs were fixed in the help pages.
1877
1878
1879
1880                 CHANGES IN APE VERSION 0.2
1881
1882
1883 NEW FEATURES
1884
1885     o The function write.tree() writes phylogenetic trees (objects of class
1886       "phylo") in an ASCII file using the Newick parenthetic format.
1887
1888     o The function birthdeath() fits a birth-death model to branching times
1889       by maximum likelihood, and estimates the corresponding speciation and
1890       extinction rates.
1891
1892     o The function scale.bar() adds a scale bar to a plot of a phylogenetic
1893       tree.
1894
1895     o The function is.binary.tree() tests whether a phylogeny is binary.
1896
1897     o Two generic functions, coalescent.intervals() and collapsed.intervals(),
1898       as well as some methods are introduced.
1899
1900     o Several functions, including some generics and methods, for computing
1901       skyline plot estimates (classic and generalized) of effective
1902       population size through time are introduced and replace the function
1903       skyline.plot() in version 0.1.
1904
1905     o Two data sets are now included: the phylogenetic relationships among
1906       the families of birds from Sibley and Ahlquist (1990), and an
1907       estimated clock-like phylogeny of HIV sequences sampled in the
1908       Democratic Republic of Congo.
1909
1910
1911 DEPRECATED & DEFUNCT
1912
1913     o The function skyline.plot() in ape 0.1 has been deprecated and
1914       replaced by more elaborate functions (see above).
1915
1916
1917 BUG FIXES
1918
1919     o Two important bugs were fixed in plot.phylo(): phylogenies with
1920       multichotomies not at the root or not with only terminal branches,
1921       and phylogenies with a single node (i.e. only terminal branches)
1922       did not plot. These trees should be plotted correctly now.
1923
1924     o Several bugs were fixed in diversi.time() in the computation of
1925       AICs and LRTs.
1926
1927     o Various errors were corrected in the help pages.