1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315
|
dendextend 1.8.0 (2018-04-28)
----------------------------------------
###NEW FUNCTIONS
* branches_attr_by_lists - Change col/lwd/lty of branches from the root down to clusters defined by list of labels of respective members
* colored_dots - Add colored dots beside a dendrogram
dendextend 1.7.0 (2018-02-10)
----------------------------------------
###NEW FUNCTIONS
* get_subdendrograms (and find_dendrogram) - getting subtrees from dendrogram based on cutree labels (fixes #61 and https://stackoverflow.com/questions/48167369/r-getting-subtrees-from-dendrogram-based-on-cutree-labels/)
###BUG FIXES
* seriate_dendrogram = stop seriate_dendrogram from always using OLO #57
###OTHER NOTES
* Remove NMF from suggested (as it is about to be removed from CRAN). And also labeltodendro.
dendextend 1.6.0 (2017-11-13)
----------------------------------------
###NEW FUNCTIONS
* pvrect2 - Draw Rectangles Around a Dendrogram's Clusters with High/Low P-values
* min_depth, max_depth - measures the min/max depth of a tree (from the root to the closest/furtherest leaf).
###BUG FIXES
* rect.dendrogram - it now deals much better with setting the lower part of the rectangle to be below the labels.
* circlize_dendrogram - can now handle dendrograms with non unique labels. A warning is issued, and a running number is padded to the labels. Problem first reported here: https://stackoverflow.com/questions/46238364/labelling-circular-dendextend-dendrogram/46438501#46438501
dendextend 1.5.2 (2017-05-19)
----------------------------------------
###NEW FUNCTIONS
* print.ggdend - a wrapper for ggplot2::ggplot of a ggdend object.
###BUG FIXES
* Adding function reindex_dend to resolve problems with as.hclust (#39)
###OTHER NOTES
* Remove dendextendRcpp :( (from tests and suggests)
dendextend 1.5.0 (2017-03-24)
----------------------------------------
###NEW FUNCTIONS
* dend_expend and find_dend - functions for finding a "good" dendrogram for a dist
###UPDATED FUNCTIONS:
* cor_cophenetic - dend2 can now also be a dist object (allowing to check how close is some clustering to the original distance matrix).
###BUG FIXES
* dend_diff - now restore to the par(mfrow) value before running the function.
###OTHER NOTES
* Simplified the roxygen2 code by using @rdname (and removing many instances of @allias and @usage).
* remove a test in untangle due to different outputs in R 3.3.3 and R 3.4.0. More tests are probably needed for the bytecompiler for extreme cases (i.e.: dendrograms with odd branch heights)
dendextend 1.4.0 (2017-01-21)
----------------------------------------
###NEW FUNCTIONS
* as.dendrogram.varclus (enhances in Hmisc)
* highlight_branches, highlight_branches_col, highlight_branches_lwd - Highlight a dendrogram's branches heights via color and line-width.
* has_edgePar, has_nodePar - Does a dendrogram has an edgePar/nodePar component?
###UPDATED FUNCTIONS:
* find_k - now includes `k` in the output, which is a copy of `nc`. This is to make it easier to extract the value (i.e.: the suggested number of clusters).
* set - added the parameter `order_value` to easily use values which are in the order of the original data.
* tanglegram
* Add possibility to draw several tanglegrams on same page via the `just_one` paramter.
* added highlight_branches_col (FALSE) and highlight_branches_lwd (TRUE) parameters. These will only be turned on if the relevant attribute is not already present in the tree. If the tree already has lty/lwd/col - these will not be updated by this parameter. These parameters can be removed from the tree by using `dend %>% set("clear_branches")`.
dendextend 1.3.0 (2016-07-15)
----------------------------------------
###NEW FUNCTIONS
* Added set_labels and place_labels. These are convenience functions for updating the labels of a dendrogram. They differ in their assumption about the order of the labels. Props to Garrett Grolemund for the idea.
* set_labels assumes the labels are in the same order as that of the labels in the dendrogram.
* place_labels assumes the labels has the same order as that of the items in the original data matrix. This is useful for renaming labels based on some other columns in the data matrix.
###BUG FIXES
* "labels_colors<-" - make it more robust for combinations of using it with assign_values_to_leaves_nodePar (as used in set("labels_colors", ...) for example)
dendextend 1.2.0 (2016-06-21)
----------------------------------------
###NEW FUNCTIONS
* find_k - Find the (estimated) number of clusters for a dendrogram using average silhouette width
* is.dist - checks class to be `dist`
* seriate_dendrogram - rotates a dendrogram to fit the optimal ordering (via OLO or GW) of some distance matrix (very useful for heatmaps)
###BUG FIXES
* ggplot.ggdend - Fix the tiny notch in angle of the branches
###OTHER NOTES
* ggplot2 is now imported (instead of just suggested). This is because the use of dendextend for transforming dendrograms into ggplot2 has become more important (thanks to the new plotly package).
* Fix various small issues (importing functions from other packages, the documents, etc.)
* Improve vignette size for CRAN (moving to html_vignette)
dendextend 1.1.9 (2016-03-17)
----------------------------------------
###OTHER NOTES
* Move is.X style functions to a new file: is.functions.R
dendextend 1.1.8 (2016-02-10)
----------------------------------------
###BUG FIXES
* added tryCatch to tests so it would pass github.
dendextend 1.1.7 (2016-02-10)
----------------------------------------
###BUG FIXES
* Added rmarkdown in Suggests of DESCRIPTION. This fixes the travis-ci error: " The vignette engine knitr::rmarkdown is not available, because the rmarkdown package is not installed. Please install it." as was suggested in: https://github.com/rstudio/rmarkdown/issues/609
* Another minor error in tests due to cutree in R-devel.
dendextend 1.1.6 (2016-02-10)
----------------------------------------
###BUG FIXES
* Moved `inst/tests/` to `tests/testthat/`
* Tests fixed to deal with the new R's ability to run as.hclust on dendrogram with ties.
dendextend 1.1.5 (2016-01-06)
----------------------------------------
###BUG FIXES
* cutree - Fix #18 by updating the sort_cluster_numbers parameter.
###OTHER NOTES
* Adding Gregory Jefferis as an author (thanks to his work on dendroextras, which was later reused in the dendextend package)
dendextend 1.1.4 (2016-01-01)
----------------------------------------
###BUG FIXES
* colored_bars
* Fix the default position of the bars (i.e.: y_shift) when dend is provided. (this is a major corrections to the way the bars are located automatically via y_shift)
* Fix the example in the documentation of `colored_bars`
* NEW parameter horiz - now allows for adding bars to horizontal dendrograms
* sort_by_labels_order is now set to TRUE by default
* Made more checks on the object type of dend
* Added many description elements in .Rd files.
dendextend 1.1.3 (2015-11-07)
----------------------------------------
###NEW FUNCTIONS
* color_unique_labels
dendextend 1.1.2 (2015-10-30)
----------------------------------------
###UPDATED FUNCTIONS:
* intersect_trees - return dendlist() and a warning if there are no shared labels between the two trees.
* Removed functions labels.matrix and labels<-.matrix, in order to avoid conflicts with arules (and since these functions are not really used in other parts of the package) - reported by Maja Alicja.
* rect.dendrogram and identify.dendrogram - gain the stop_if_out parameter. The defaults for this parameter makes the error of "Error in rect.dendrogram(x, k = k, x = X$x, cluster = cluster[, k - 1], :
k must be between 2 and 10" - to become less common (since it replaces it with a warning). Feature request by jedgroev from http://stackoverflow.com/questions/32648935/how-to-use-identify-to-a-horizontal-dendrogram-of-class-dendrogram-in-r
###BUG FIXES
* as.ggdend.dendrogram - fix "Error in FUN(X[[i]], ...) : subscript out of bounds" problem for some (more) trees. Fixes bug #12
* as.ggdend.dendrogram - can now handle different label heights. (for example, the ones produces when using hang.dendrogram)
###OTHER NOTES
* Updated CITATION file.
dendextend 1.1.0 (2015-07-30)
----------------------------------------
###NEW FUNCTIONS
* circlize_dendrogram - a function for creating radial dendrogram plots
* labels_col - Added as an alias of labels_colors
* labels_cex
###UPDATED FUNCTIONS:
* set - added "branches_k_lty" parameter
###BUG FIXES
* as.ggdend.dendrogram - fix "Error in FUN(X[[i]], ...) : subscript out of bounds" problem for some trees.
* Various typo fixes to the vignettes.
###OTHER NOTES
* Added a CITATION file!
dendextend 1.0.3 (2015-07-05)
----------------------------------------
###UPDATED FUNCTIONS:
* assign_values_to_nodes_nodePar - can now handle NA with a character string vector in value. Fixes #10
dendextend 1.0.2 (2015-06-28)
----------------------------------------
###UPDATED FUNCTIONS:
* ggplot.ggdend - added offset_labels (TODO: still needs to fix the figure margins)
###OTHER NOTES
* minor typo fixes
dendextend 1.0.1 (2015-06-28)
----------------------------------------
###OTHER NOTES
* Added import to NAMESPACE: graphics, grDevices
* dendextend 1.0.1 is intended to be shipped to CRAN.
dendextend 1.0.0 (2015-06-27)
----------------------------------------
###NEW FUNCTIONS
* common_subtrees_clusters - a (currently hidden) function to get clusters for labels of common subtrees between two trees.
* labels.dendrogram is now working through dendextend_options("labels.dendrogram"). The defualt is the new dendextend_labels.dendrogram (which is just stats:::labels.dendrogram), but this allows the package dendextendRcpp to change the function used by the package (without masking the function in base R) - thus making both me, and CRAN, happy :)
* rank_values_with_clusters - Rank a vector based on clusters (important for various functions.) Added tests.
* cor_common_nodes - a new correlation measure between dendrograms.
* cor_FM_index - Correlation of FM_index for some k (similar to Bk actually)
* prune_common_subtrees.dendlist - Prune trees to their common subtrees
* nleaves.dendlist
###UPDATED FUNCTIONS:
* color_branches - gained a new "cluster" parameter to allow for easy uneven coloring of branches (using branches_attr_by_clusters). This is not a new feature, as it is an attempt to have the user access more options from one place (i.e.: color_branches).
* tanglegram - turned "highlight_distinct_edges = FALSE". This is due to a bug in R that causes plot.dendrogram to crash when trying to plot a tree with both lty and some character color for the branch.
* tanglegram -
* Added new parameters: common_subtrees_color_lines and common_subtrees_color_branches to color connecting-lines and/or the dendrograms themsleves, to help detect commonly shared subtrees.
* new parameter: faster.
* plot.ggdend - added support to plot nodes
* branches_attr_by_clusters -
* can now accept a vector of values with the length of the labels.
* new parameter "branches_changed_have_which_labels" - allows the user the decide if the change in parameters will be for branches with all/any of the labels (useful for tanglegram - since we would like to color common subtrees with all of the labels, not just any.)
* dendlist - removed warning when creating an empty dendlist (since we also don't get a warning when creating a list() )
* ladderize - added the `which` parameter (for indicating which elements in the dendlist to ladderize)
* untangle.dendlist -
* can now return a dendlist with more than two elements.
* now preserve the names in the dendlist
* now has a new "labels" method, and it is now the default.
* dendlist - added the `which` parameter (for indicating which elements in the dendlist to pick out)
* set
* added "rank_branches"
* untangle_random_search/untangle_step_rotate_2side/untangle_best_k_to_rotate_by_2side_backNforth - no longer returns a dendlist with names (it shouldn't, they didn't have a name to begin with.)
* cor.dendlist - added methods "common_nodes", "FM_index".
* cor_cophenetic - changed method to method_coef (so it could be updated when using cor.dendlist)
* use "dend" as a standard name for all the parameters that accept dendrograms (whenever possible, in some cases I preferred to keep another name due to other conventions.)
* object -> dend for:
set, set.dendrogram, set.dendlist,
get_leaves_attr, get_leaves_nodePar, get_leaves_edgePar,
get_leaves_branches_attr, get_leaves_branches_col, get_nodes_attr,
assign_values_to_leaves_nodePar, assign_values_to_leaves_edgePar,
assign_values_to_nodes_nodePar, assign_values_to_branches_edgePar,
remove_branches_edgePar, remove_nodes_nodePar, remove_leaves_nodePar,
labels_colors, shuffle
* tree -> dend for:
color_branches, color_labels_by_labels, color_labels, get_branches_heights, dendextend_get_branches_heights, dendextend_cut_lower_fun, cutree_1h.dendrogram, cutree_1k.dendrogram, heights_per_k.dendrogram
* x -> dend for: cor.dendlist, dend_diff, dist.dendlist, distinct_edges, highlight_distinct_edges, partition_leaves, get_nodes_xy, prune, unbranch
* tree1/tree2 or x1/x2 -> dend1/dend2 for: cor_FM_index, cor_common_nodes, cor_bakers_gamma, cor_cophenetic, entanglement, untangle_random_search, intersect_trees, tanglegram
###BUG FIXES
* Fix "'::' or ':::' import not declared from: ‘rpart’" by adding rpart to DESCRIPTION.
* as.hclust.pvclust - use "x" instead of "object", to avoid "checking S3 generic/method consistency ... WARNING"
* Fix "Objects in \usage without \alias in documentation object". For ‘prune.rpart’ and ‘sort.dendlist’.
* rect.dendrogram - deals with the case we want to use k for which k+1 is not defined.
* Parameters are now stored as a list for (allows for branches to have colors/linetype/linewidth, some are numeric and some character): assign_values_to_branches_edgePar / assign_values_to_leaves_nodePar / assign_values_to_leaves_edgePar / assign_values_to_nodes_nodePar - the parameters are stored as a list in edgePar/nodePar (instead of a vector). Discovered thanks to Martin Maechler. Fixes: "Error in segments(x0, y0, x1, y1, col = col, lty = lty, lwd = lwd) : invalid line type: must be length 2, 4, 6 or 8"
* made sure that the end of the vector in "dendextend_heights_per_k.dendrogram" will give the tree size (and not 0) as its name.
* as.ggdend - now supports edgePar and nodePar which are lists.
###OTHER NOTES
* Added Code of conduct
* Added CRAN status
* Added codecov
* Moved FAQ from introduction.Rmd to FAQ.Rmd
* New vignette "Cluster_Analysis.Rmd" - demonstrating the use of the package on three famous datasets (Iris, khan, votes.repub, animals)
* Added the khan dataset to the package.
* moved assign_dendextend_options to ".onLoad" - this now allows the use of dendextend::some_func
dendextend 0.18.8 (2015-05-17)
----------------------------------------
###UPDATED FUNCTIONS:
* all.equal.dendlist - can now compare two dendlist objects to one another, and not only the dendrograms inside one dendlist. (also added new tests that all.equal.dendlist works)
* all.equal.dendrogram - suppress warning for a dend with only 1 item, when using dendextendRcpp.
* rect.dendrogram - make the heights of the rects be in the middle of the two clusters so that they would look nicer. Added prop_k_height to state which proportion of the height the rect should be (between k and k+1 heights). Also added upper_rect to allow the user to customize the exact height.
###BUG FIXES
* identify.dendrogram - parameter horiz now works (fixes #4)
dendextend 0.18.7 (2015-05-05)
----------------------------------------
###VIGNETTE
* remove dependancy on DendSer (using require instead of library)
###UPDATED FUNCTIONS:
* untangle - added method="ladderize"
* tanglegram.dendlist - fix it when names is null to have the default be ""
dendextend 0.18.6 (2015-04-25)
----------------------------------------
###NEW FUNCTIONS
* get_leaves_edgePar - Get edgePar of dendrogram's leaves
* get_leaves_branches_attr - Get an attribute of the branches of a dendrogram's leaves
* get_leaves_branches_col - Get the colors of the branches of a dendrogram's leaves. This function is actually the point of the two other functions. It is meant to help match the color of the labels with that of the branches - after running color_branches.
###UPDATED FUNCTIONS:
* tanglegram.dendlist - now gets main_left and main_right (if they are null) from the names in dendlist (if they exist)
###VIGNETTE
* added example for using "get_leaves_branches_col" in "How to color the branches in heatmap.2?"
###OTHER NOTES
* library corrplot added to plot cor.dendlist results. Examples added to vignette and function's example.
dendextend 0.18.5 (2015-04-22)
----------------------------------------
###VIGNETTE
* added: "How to color the branches in heatmap.2?"
dendextend 0.18.4 (2015-02-07)
----------------------------------------
###NEW FUNCTIONS
* prune.rpart added
* sort.dendlist
* as.hclust.pvclust
dendextend 0.18.3 (2015-01-31)
----------------------------------------
###OTHER NOTES (Thanks to Prof Brian Ripley for help.)
* Fix "title case" for the package's Title in the DESCRIPTION
* Fix "No package encoding and non-ASCII characters in the following R files"
* Fix "Please use :: or requireNamespace() instead." by commenting out all "library", since using "::" is enough!
* dendextend 0.18.3 is intended to be shipped to CRAN.
dendextend 0.18.2 (2015-01-31)
----------------------------------------
###OTHER NOTES
* Minor doc fix for `collapse_branch`
* dendextend 0.18.2 is intended to be shipped to CRAN.
dendextend 0.18.1 (2015-01-31)
----------------------------------------
###VIGNETTE - new sections!
* Quick functions for FAQ
* How to colour the labels of a dendrogram by an additional factor variable
* How to color a dendrogram's branches/labels based on cluster (i.e.: cutree result)
* Change dendrogram's labels
* Larger font for leaves in a dendrogram
* How to view attributes of a dendrogram
* ggplot2 integration (!)
* Comparing trees:
* dend_diff
* all.equal
* dist.dendlist
* cor.dendlist
* Others
* rotate - explain about sort
* collapse_branch
###UPDATED FUNCTIONS:
* `sort.dendrogram` - added a new parameter: type = c("labels", "nodes"), to use `ladderize` for sorting
* `ggplot.ggdend` - support theme = NULL
###OTHER NOTES
* dendextend 0.18.1 is intended to be shipped to CRAN.
dendextend 0.18.0 (2015-01-29)
----------------------------------------
###NEW FILES:
* ape.R - moved `as.dendrogram.phylo` and `as.phylo.dendrogram` functions to it.
* cor.dendlist.R - For the cor.dendlist function
* renamed imports_stats.R to stats_imports.R
* ggdendro.R
* ggdend.R
* dist_long.R
###NEW FUNCTIONS
* More connections:
* A new phylo method for `labels` and `labels<-`
* More ways to compare trees:
* cor.dendlist - Correlation matrix between a list of trees.
* partition_leaves - A list with labels for each subtree (edge)
* distinct_edges - Finds the edges present in the first tree but not in the second
* highlight_distinct_edges - Highlight distint edges in a tree (compared to another one). Works for both dendrogram and dendlist.
* dend_diff - Plots two trees side by side, highlighting edges unique to each tree in red. Works for both dendrogram and dendlist.
* dist.dendlist - Topological Distances Between Two dendrograms (currently only the Robinson-Foulds distance)
* all.equal.dendrogram/all.equal.dendlist - Global Comparison of two (or more) dendrograms
* `which_node` - finds Which node is common to a group of labels
* Dendrograms in ggplot2! (enhancing the ggdendro package)
* `dendrogram_data` (internal) function - a copy of the function from the ggdendro package (the basis for the new ggdend class).
* `get_leaves_nodePar` - Get nodePar of dendrogram's leaves (designed to help with as.ggdend)
* `as.ggdend.dendrogram` - turns a dendrogram to the ggdend class, ready to be plotted with ggplot2.
* `prepare.ggdend` - fills a ggdend object with various default values (to be later used when plotted)
* `ggplot.ggdend` - plots a ggdend with the ggplot2 engine (also the function `theme_dendro` was imported from the ggdendro package).
* Others:
* `remove_nodes_nodePar` - as the name implies...
* `collapse_branch` - simplifies a tree with branches lower than some tollerance level
* `ladderize` - Ladderize a Tree (reorganizes the internal structure of the tree to get the ladderized effect when plotted)
###NEW TESTS:
* partition_leaves
* distinct_edges
* dend_diff
* dist.dendlist
###UPDATED FUNCTIONS:
* `nleaves.phylo` - no longer require conversion to a dendrogram in order to compute.
* `labels<-.dendrogram` - no longer forces as.character conversion
* `tanglegram` - a new highlight_distinct_edges parameter (default is TRUE)
* `cutree` - now produces warnings if it returns 0's. i.e.: when it can't cut the tree based on the required parameter. (following isue #5 reported by grafab)
* `cutree_1h.dendrogram` and `cutree_1k.dendrogram` - will now create clusters as the number of items if k==nleaves(tree) or if h<0. This is both consistent with stats::hclust, but it also "makes sense" (since this is well defined for ANY tree). Also updated the tests.
* Rename `get_branches_attr` to be `get_root_branches_attr`
* `get_nodes_attr` - added the "id" parameter (to get attributes of only a subset of id's)
* `as.dendrogram.phylo` is properly exported now.
dendextend 0.17.6 (2014-12-08)
----------------------------------------
###NEW FUNCTIONS
* dist_long - Turns a dist object to a "long" table.
dendextend 0.17.5 (2014-09-22)
----------------------------------------
###UPDATED FUNCTIONS:
* `order.dendrogram<-` - commenting off an examples and tests which (as of R 3.1.1-patched) produces an error (as it should). Thanks to Prof Brian Ripley for the e-mail about it.
###BUG FIXES
* checking S3 generic/method consistency ... WARNING
cor_bakers_gamma:
function(tree1, tree2, use_labels_not_values, to_plot, warn, ...)
cor_bakers_gamma.dendlist:
function(tree1, which, ...)
* Undocumented code objects:
'plot.dendlist'
* `cor_bakers_gamma.Rd`:
\usage lines wider than 90 characters
###VIGNETTE:
* Fixed several typos and grammatical mistakes.
###OTHER NOTES
* dendextend 0.17.5 is intended to be shipped to CRAN (to stay compatible with R 3.1.1-patched).
dendextend 0.17.4 (2014-09-20)
----------------------------------------
###NEW FUNCTIONS
* set.data.table - informs the user of the conflict in "set" between dendextend and data.table.
###VIGNETTE:
* added sessionInfo
dendextend 0.17.3 (2014-08-26)
----------------------------------------
###UPDATED FUNCTIONS:
* color_labels - now can handle the coloring of labels when the function is without k and h, but that it is not possible to cut the tree to nleaves items (due to several leaves with 0 height). This is done by not doing any cutting in such cases, and just directly using labels_colors. Tests are added. Bug report by Marina Varfolomeeva, a.k.a varmara - thanks! (https://github.com/talgalili/dendextend/issues/3 )
dendextend 0.17.2 (2014-08-25)
----------------------------------------
###NEW FUNCTIONS
* cor_bakers_gamma.dendlist
* assign_values_to_leaves_edgePar (noticed the need from this question: http://stackoverflow.com/questions/23328663/color-branches-of-dendrogram-using-an-existing-column?rq=1)
###UPDATED FUNCTIONS:
* assign_values_to_leaves_nodePar - added if(warn), if value is missing.
###VIGNETTE:
* Fix some typos and mistakes.
* Add to introduction.Rmd how to install the package from github.
dendextend 0.17.1 (2014-08-19)
----------------------------------------
###OTHER NOTES
* compacted 'dendextend-tutorial.pdf' from 725Kb to 551Kb (doc fixes to pass CRAN checks)
(Thanks to using the following:
tools::compactPDF("inst\\doc\\dendextend-tutorial.pdf",
qpdf = "C:\\Program Files (x86)\\qpdf-5.1.2\\bin\\qpdf.exe",
gs_cmd = "C:\\Program Files\\gs\\gs9.14\\bin\\gswin64c.exe",
gs_quality="ebook")
And to the help of Prof Brian Ripley and Kurt Hornik
)
dendextend 0.17.0 (2014-08-19)
----------------------------------------
###VIGNETTE:
* Wrote a new vignette "introduction.Rmd", to showcase the new functions since the last vignette, and give a quick-as-possible introduction to the package functions.
###NEW FUNCTIONS
* `get_nodes_xy` - Get the x-y coordiantes of a dendrogram's nodes
* `all_unique` - check if all elements in a vector are unique
* `head.dendlist`
* `rainbow_fun` - uses rainbow_hcl, or rainbow (if colorspace is not available)
###UPDATED FUNCTIONS:
* ALL `warn` paramteres are now set to dendextend_options("warn") (which is FALSE)!
* `get_branches_attr` - change "warning" to "warn", and it now works with is.dendrogram, and no longer changes the class of something which is not a dendrogram.
* `untangle_step_rotate_2side` - print_times is now dendextend_options("warn"),
* `color_branches` - now handles flat trees more gracefully. (returns them as they are)
* `cutree.dendrogram` - now replaces NA values with 0L (fix tests for it), added a parameter (NA_to_0L) to control it.
* `Bk` - Have it work with cutree(NA_to_0L = FALSE)
* `set.dendrogram` - added explenation in the .Rd docs of the different possible options for "what"
* `set.dendrogram` - added nodes_pch, nodes_cex and nodes_col - using `assign_values_to_nodes_nodePar`
* `set.dendrogram` - changed from using `labels_colors<-` to `color_labels` for "labels_colors" (this will now work with using k...)
* `set.dendrogram` - if "what" is missing, return the object as is.
* `set.dendrogram` - added a "labels_to_char" option.
* `labels_colors<-` - added if(dendextend_options("warn"))
* `labels<-.dendrogram` - if value is missing, returning the dendrogram as is (this also affects `set`)
* `get_nodes_attr` - can now return an array or a list for attributes which include a more complex structure (such as nodePar), by working with lists and adding a "simplify" parameter.
* `rect.dendrogram` - a new xpd and lower_rect parameters - to control how low the rect will be (for example, below or above the labels). The default is below the labels.
* `colored_bars` - added defaults to make the bars be plotted bellow the labels. +allow the order of the bars to be based on the labels' order, made that to be the default +have scale default be better for multiple bars.
* `branches_attr_by_labels` now uses `dendextend_options("warn")` to decide if to print that labels were coerced into character.
* `intersect_trees` - now returns a dendlist.
* `untangle` - has a default to method (DendSet)
* `untangle_step_rotate_1side` - added "leaves_matching_method" parameter.
* `entanglement.dendrogram` - changed the default of "leaves_matching_method" to be "labels" (slower, but safer for the user...)
###BUG FIXES
* `branches_attr_by_clusters` and `branches_attr_by_labels` - moved from using NA to Inf.
* `color_branches` - can now work when the labels of the tree are not unique ("feature"" request by Heather Turner - thanks Heather :) )
* `rect.dendrogram` - fix a bug with the location of the rect's (using "tree" and not "dend")
* `rect.dendrogram` - Made sure the heights are working properly!
* `colored_bars` - fix for multiple bars to work.
* `assign_values_to_branches_edgePar`, `assign_values_to_nodes_nodePar`, `assign_values_to_leaves_nodePar` - now ignores "Inf" also when it is a character by adding as.numeric (and not only if it is numeric!) (this might be a problem if someone would try to update a label with the name "Inf").
###NEW FILES:
* dendextend_options.R - moved `dendextend_options` functions to it.
* get_nodes_xy.R
* Rename files: trim.R -> prune.R
* DendSer.R
* Move the function `branches_attr_by_labels` between two files.
###NEW TESTS:
* `assign_values_to_branches_edgePar` - make sure it deals with Inf and "Inf".
###OTHER NOTES
* Moved ggdendro,labeltodendro,dendroextras,ape to "Enhances:" in DESCRIPTION.
* Moved dendextend-tutorial.rnw to vignettes\disabled - so it is still there, but not compiled.
* Moved dendextend-tutorial.pdf to inst\doc - so there is a copy of this older vignette, but without needed to run it with all the benchmarks... (it is also compressed)
* Created a copy of "introduction.html" in inst/ignored (so people could see it on github)
* Have the package build the vignette.
dendextend 0.16.4 (2014-08-06)
----------------------------------------
###NEW FUNCTIONS
* `as.dendrogram.pvclust` - extract the hclust from a pvclust object, and turns it into a dendrogram.
* `hc2axes` - imported from pvclust, needed for text.pvclust
* `text.pvclust` - imported from pvclust, adds text to a dend plot of a pvclust result
* `pvclust_show_signif` - Shows the significant branches in a dendrogram, based on a pvclust object
* `pvclust_show_signif_gradient` - Shows the gradient of significance of branches in a dendrogram, based on a pvclust object
###UPDATED FUNCTIONS:
* `assign_values_to_leaves_nodePar`, `assign_values_to_nodes_nodePar`, `assign_values_to_branches_edgePar` - If the value has `Inf` (instead of NA!) then the value will not be changed.
dendextend 0.16.3 (2014-08-06)
----------------------------------------
###NEW FUNCTIONS
* `assign_values_to_nodes_nodePar` - Assign values to nodePar of dendrogram's nodes
###UPDATED FUNCTIONS:
* `assign_values_to_leaves_nodePar` - If the value has NA then the value in edgePar will not be changed.
###OTHER NOTES
* NEWS - updated to use header 2 and 3 instead of 1 and 2 for the markdown version.
dendextend 0.16.2 (2014-07-29)
----------------------------------------
###OTHER NOTES
* require -> library (Thanks Yihui: http://yihui.name/en/2014/07/library-vs-require/)
dendextend 0.16.1 (2014-07-26)
----------------------------------------
###OTHER NOTES
* Minor doc fixes to pass CRAN checks.
dendextend 0.16.0 (2014-07-26)
----------------------------------------
###NEW FUNCTIONS
* `branches_attr_by_clusters` - This function was designed to enable the manipulation (mainly coloring) of branches, based on the results from the cutreeDynamic function (from the {dynamicTreeCut} package).
* `which_leaf` - Which node is a leaf?
* `na_locf` - Fill Last Observation Carried Forward
###UPDATED FUNCTIONS:
* `assign_values_to_branches_edgePar - now can keep existing value, if gets NA.
* `colored_bars` - change the order of colors and dend, and allowing for dend to be missing. (also some other doc modifications)
* `branches_attr_by_labels` - change the order of some parameters (based on how much I expect users to use each of them.)
* `assign_values_to_branches_edgePar` - allow the option to skip leaves
###NEW FILES:
* branches_attr_by.R - for branches_attr_by_clusters
###OTHER NOTES
* added a pvclust example (using a condition on p-value, and heighlighting branches based on that with lwd/col.)
dendextend 0.15.2 (2014-07-24)
----------------------------------------
###NEW FUNCTIONS
* `noded_with_condition` - Find which nodes satisfies a condition
* `branches_attr_by_labels` - Change col/lwd/lty of branches matching labels condition
###UPDATED FUNCTIONS:
* `rect.dendrogram` - adding paramters for creating text under the clusters,
as well as make it easier to plot lines on the rect (density = 7). props to skullkey for his help.
* `set.dendrogram` - added new options: by_labels_branches_col, by_labels_branches_lwd, by_labels_branches_lty
###NEW FILES:
* noded_with_condition.R
dendextend 0.15.1 (2014-07-16)
----------------------------------------
###NEW FUNCTIONS
* `order.hclust` - Ordering of the Leaves in a hclust Dendrogram
* `rect.dendrogram` - just like `rect.hclust`, plus: works for dendrograms, passes `...` to rect for lwd lty etc, now has an horiz parameter!
* `identify.dendrogram` - like `identify.hclust`: reads the position of the graphics pointer when the (first) mouse button is pressed. It then cuts the tree at the vertical position of the pointer and highlights the cluster containing the horizontal position of the pointer. Optionally a function is applied to the index of data points contained in the cluster.
###NEW FILES:
rect.dendrogram.R
###OTHER NOTES
* Rename the `add` functions to be called `set`. Reason: both are short names (important for chaining), both are not used in base R. "add" is used in magrittr (not good long term), and "set" sounds better English wise (we are setting labels color, more than adding it...).
* Rename 2 file names from add->set (set.dendrogram.R and tests-set.dendrogram.R)
dendextend 0.15.0 (2014-07-14)
----------------------------------------
###NEW FUNCTIONS
* `dendlist` - a function which creates a list of dendrogram of the new "dendlist" class.
* `tanglegram.dendlist`
* `entanglement.dendlist`
* `is.dendlist` - to check that an object is a dendlist
* `as.dendlist` - to turn a list to a dendlist
* `plot.dendlist` - it is basically a wrapper to tanglegram.
* `click_rotate` - interactively rotate a tree (thanks to Andrej-Nikolai Spiess)
* `untangle` - a master function to control all untangle functions (making it much easier to navigate this feature, as well as use it through %>% piping)
* `untangle_DendSer` - a new untangle function (this time, only for dendlist), for leverging the serialization package for some more heuristics (based on the functions rotate_DendSer and DendSer.dendrogram).
* `add.dendrogram` - a new master function to allow various updating of dendrogram objects. It includes options for: labels, labels_colors, labels_cex, branches_color, hang, leaves_pch, leaves_cex, leaves_col, branches_k_color, branches_col, branches_lwd, branches_lty, clear_branches, clear_leaves
* `add.dendlist` - a wrapper to add.dendrogram.
* `colored_bars` - adding colored bars underneath a
dendrogram plot.
###UPDATED FUNCTIONS:
* Made sure that the main `untangle` functions will return a `dendlist` (and also that untangle_step_rotate_2side will be able to work with the new untangle_step_rotate_1side output)
* switched to using match.arg wherever possible (Bk_plot, cor_cophenetic, entanglement, untangle_random_search, untangle_step_rotate_1side, and untangle_step_rotate_2side).
* `labels_colors<-` - now has a default behavior if value is missing. Also made sure it is more robust (for cases with partiel attr in nodePar)
* `color_branches` - now has a default behavior if k is missing.
* `assign_values_to_branches_edgePar` - value can now be different than 1 (it now also has a recycle option for the value)
* Generally - moved to using `is.dendrogram` more.
* `tanglegram` - now preserve and restore previous par options (will no longer have a tiny plot in the left corner, when using a simple plot after tanglegram)
###NEW S3 METHODS:
* `tanglegram.dendlist`
###NEW FILES:
* dendlist.R
* test-dendlist.R
* test-add.dendrogram.R
* add.dendrogram.R
* colored_bars.R
* magrittr.R
###UPDATED TESTS:
* Check dendlist works
###OTHER NOTES
* DESCRIPTION -
* Added the magrittr package as a Depends.
* changed stats from depends to imports. Here is a good reference for why to choose the one over the other - http://stackoverflow.com/questions/8637993/better-explanation-of-when-to-use-imports-depends
And: http://stackoverflow.com/questions/6895852/load-a-package-only-when-needed-in-r-package
* Fix errors and typos in vignettes - thank you Bob Muenchen!
* Fix the docs of the functions in dendextend which relates to the newer dendextendRcpp (version 0.5.1): cut_lower_fun, get_branches_heights, heights_per_k.dendrogram
* tests - Moved from using test_that with equal() to test_equal (due to some conflict with, possibly, devtools)
* roxygen2 - Moved from using @S3method to @export (removed 45 warnings from check() )
* Moved all "@import" to the dendextend-package.R file (just to make it easier to follow up on them). This code makes sure that thees packages will be mentioned in the NAMESPACE file.
* Imported the %>% function from magrittr (using a trick from the dplyr package)
dendextend 0.14.4 (2014-07-04)
----------------------------------------
###OTHER NOTES
* Changed all R script files from .r to .R!
dendextend 0.14.3 (2014-04-26)
----------------------------------------
###UPDATED DESCRIPTION:
* Fix an author name.
* Added dendextendRcpp to suggest
###OTHER NOTES
* Minor changes to docs.
dendextend 0.14.2 (2014-03-15)
----------------------------------------
###UPDATED DESCRIPTION:
* Added dependency for R (>= 3.0.0)
###OTHER NOTES
* dendextend 0.14.2 is intended to be shipped to CRAN.
dendextend 0.14.1 (2014-03-15)
----------------------------------------
###UPDATED DESCRIPTION:
* Added Uwe and Kurt as contributors.
* Removed Suggests: dendextendRcpp, (until it would be on CRAN)
* Removed link to google group
###NEW FUNCTIONS
* dendextend_options (actually an enviornment + a function). Here I've moved the dendextend_options from the global enviornment to the dendextend namespace.
###UPDATED TESTS:
* update test_rotate.r so it would make sure ape is loaded BEFORE dendextend.
###OTHER NOTES
* dendextend 0.14.1 goes with Version 0.5.0 of dendextendRcpp. Previous versions of dendextendRcpp will not be effective for versions of dendextend which are before 0.14.0.
* dendextend 0.14.1 is intended to be shipped to CRAN.
dendextend 0.14.0 (2014-03-15)
----------------------------------------
###UPDATED FUNCTIONS:
* assign_dendextend_options - Moved to passing the functions through "dendextend_options" instead of through "options" (Thanks to suggestions by Kurt Hornik and Uwe Ligges).
* assign_dendextend_options - is now exported.
* remove_dendextend_options - now removes the object dendextend_options
* get_branches_heights, heights_per_k.dendrogram, cut_lower_fun - now all rely on dendextend_options.
###UPDATED TESTS:
* update tests to the new names in dendextendRcpp (dendextendRcpp_cut_lower_fun, dendextend_options)
dendextend 0.13.0 (2014-03-01)
----------------------------------------
###UPDATED FUNCTIONS:
* assign_dendextend_options - Moved to passing the functions through "options" instead of through assignInNamespace (which was not intended for production use).
* get_branches_heights, heights_per_k.dendrogram, cut_lower_fun - now all rely on the function located in the global options. This way, they can be replaced by the dendextebdRcpp version, if available.
###UPDATED TESTS:
* When comparing to dendextendRcpp - added condition to not make the check if the package is not loaded and in the search path (this way I could compare the tests with and without the dendextendRcpp package).
* added a minor test for dendextend_get_branches_heights - checking the function directly through the options.
###UPDATED DOCS:
* dendextend_get_branches_heights, dendextend_heights_per_k.dendrogram, dendextend_cut_lower_fun - gave speed tests
###NEW FUNCTIONS
* assign_dendextend_options - we now pass all functions that have a Rcpp equivalent through "options". While this adds a bit of an overhead (sadly), it still gets a much faster speed gain, and without verious warnings that CRAN checks would not like...
* dendextend_get_branches_heights, dendextend_heights_per_k.dendrogram, dendextend_cut_lower_fun
###OTHER NOTES
* dendextend 0.13.0 goes with Version 0.4.0 of dendextendRcpp. Previous versions of dendextendRcpp will not be effective for versions of dendextend which are before 0.13.0 (however, it would also not conflict with them...)
* dendextend 0.13.0 is intended to be shipped to CRAN.
dendextend 0.12.2 (2014-02-03)
----------------------------------------
###UPDATED DESCRIPTION:
* Removed VignetteBuilder: knitr (until later)
* Removed Suggests: dendextendRcpp, (until later)
* fixed mis-spelled words: extanding (14:40)
###NEW FUNCTIONS
* Hidden "stats" functions have been added to a new file "imports_stats.r"
with a new local copy for
'stats:::.memberDend' 'stats:::.midDend'
'stats:::midcache.dendrogram' 'stats:::plotNode'
'stats:::plotNodeLimit'
with stats::: -> stats_
###UPDATED FUNCTIONS:
* stats:::cutree -> stats::cutree
* dendextend:::cutree -> dendextend::cutree
###OTHER NOTES
* compacted ‘dendextend-tutorial.pdf’ from 961Kb to 737Kb (thanks to tools::compactPDF)
* dendextend 0.12.2 is intended to be shipped to CRAN.
dendextend 0.12.1 (2014-02-02)
----------------------------------------
###UPDATED TESTS:
* Made sure to check dendextendRcpp is available before calling it.
###UPDATED DOCS:
* data(iris) -> data(iris, envir = environment())
* Fix "\examples lines wider than 100 characters:" in several places.
###OTHER NOTES
* Commented out manipulations on the search path and of assignInNamespace (to avoid NOTES/warnings). This was done after moving all of these operations into Rcpp.
* dendextend 0.12.1 is intended to be shipped to CRAN. (but failed)
dendextend 0.12.0 (2014-02-01)
----------------------------------------
###UPDATED FUNCTIONS:
* exported prune_leaf
* as.dendrogram.phylo as.phylo.dendrogram - turned into S3 (no longer exported)
* changed functions names:
* trim -> prune
* unroot -> unbranch
* Moved from ::: to :: (where possible).
* tanglegram.dendrogram - fix warning in layout(matrix(1:3, nrow = 1), width =
columns_width): partial argument match of 'width' to 'widths'
* Return "as.phylo.dendrogram" by adding "ape" to "Imports" in DESCRIPTION and "import" to NAMESPACE. Also fixing consistancy (using x instead of object).
* unbranch.phylo - fix extra parameters.
###UPDATED DOCS:
* leaf_Colors - fix example (added "dend").
* Fix various "Missing link or links in documentation object" for example:
* remove \link{untangle} from various .Rd (I never created this function...)
* tangelgram -> tanglegram
* fix "Unknown package 'dendroextra' in Rd xrefs" in color_branches docs. (into dendroextras)
* Fix Undocumented code objects: 'old_cut_lower_fun' 'old_get_branches_heights'
'old_heights_per_k.dendrogram'. By adding them as "#' @aliases"
* Fix "Codoc mismatches from documentation object"
* 'rotate': - by removing k and h (since I never got to implement them...)
*
* Fix "Mismatches in argument default values"
* tanglegram
* Name: 'margin_inner' Code: 3 Docs: 1.8
* Name: 'lab.cex' Code: NULL Docs: 1
* Name: 'remove_nodePar' Code: FALSE Docs: F
* Fix "Argument names in code not in docs", for: edge.lwd dLeaf_left dLeaf_right main sub rank_branches hang match_order_by_labels cex_main cex_main_left cex_main_right cex_sub
* Fix "'library' or 'require' call not declared from: 'ape'" by commenting-off every "require(ape)" command in the code, since it is already mentioned in imports!
(see: http://stackoverflow.com/questions/15648772/how-do-i-prevent-r-library-or-require-calls-not-declared-warnings-when-dev)
The problem still persists because of .onLoad in zzz.r, but we'll look into this later...
* Fix "Undocumented arguments in documentation object" for:
* 'bakers_gamma_for_2_k_matrix'
* 'cor_bakers_gamma'
* 'cut_lower_fun'
* Fix "Objects in \usage without \alias in documentation object 'shuffle'":
'shuffle.dendrogram' 'shuffle.hclust' 'shuffle.phylo'
* Fix "Argument items with no description in Rd object": 'plot_horiz.dendrogram', 'untangle_step_rotate_1side'.
* rotate - Remove the "flip" command in the example (after I noticed that "rev" does this just fine...)
###UPDATED TESTS:
* S3methods no longer seem to be exported (due to something in roxygen2), I chose to update the tests accordingly.
* cutree.hclust -> dendextend:::cutree.hclust
* cutree.dendrogram -> dendextend:::cutree.dendrogram
* cut_lower_fun acts diffirently on dendextendRcpp vs old dendextend, so I updated the tests to reflect that.
* Fixed the usage of person() in DESCRIPTION. (props goes to Uwe Ligges for his input)
###OTHER NOTES
* Fixing .Rd indentation.
* Fix S3method in NAMESPACE.
* Added "ape::" to as.phylo.
* Added to .Rbuildignore: (large files which are not essential)
* inst/doc/2013-09-05_Boston-useR
* vignettes/figure
* vignettes/ (we'll deal with this later...)
* Removed "Enhances: ape" from DESCRIPTION
* README.md - Using 'talgalili/dendextend', in install_github
dendextend 0.11.2 (2013-08-31)
----------------------------------------
###UPDATED FUNCTIONS:
* tanglegram now has "sub" and "cex_sub" parameters.
* untangle_step_rotate_2side added k_seq parameter.
* "trim" is now called "prune"!
###VIGNETTES:
* Finished tanglegram and untangle.
* Finished statistical measures of similarity between trees.
dendextend 0.11.1 (2013-08-29)
----------------------------------------
###UPDATED FUNCTIONS:
* color_labels - added a "warn" parameter. And also set the default (in case no k/h is supplied) - to just color all of the labels.
* Added "warn" parameter to: assign_values_to_leaves_nodePar, And set it to FALSE when used inside "tanglegram".
* tanglegram now returns an invisible list with the two dendrograms (after they have been modified within the function).
###BUG FIXES
* untangle_random_search - made sure the function will return the original trees if no better tree was found.
###OTHER NOTES
* Seperated 2013-09-05_Boston-useR.Rpres into two files (since RStudio is not able to handle them)
dendextend 0.11.0 (2013-08-24)
----------------------------------------
###VIGNETTES:
* Added a knitr presentation for "Boston-useR" 2013-09-05. Includes an introduction to hclust and dendrogram objects, tree manipulation, and dendextend modules (still needs the dendextend section on tanglegram...)
###UPDATED FUNCTIONS:
* tanglegram - added cex_main parameter.
###OTHER NOTES
* Gave proper credit to contributers in the DESCRIPTION file (and not just the .Rd files)
dendextend 0.10.0 (2013-08-20)
----------------------------------------
###NEW FUNCTIONS ADDED:
* cut_lower_fun - it wraps the "cut" function, and is built to be masked by the function in dendextendRcpp in order to gain 4-14 speed gain.
###NEW TESTS ADDED:
* For Bk methods.
###OTHER NOTES
* The dendextendRcpp package (version 0.3.0) is now on github, and offers functions for making cutree.dendrogram(h) faster (between 4 to 14 times faster).
###VIGNETTES:
* Added cut_lower_fun to the Rcpp section.
* Added FM-index and Bk plot sections.
dendextend 0.9.2 (2013-08-20)
----------------------------------------
###NEW FUNCTIONS ADDED:
* cor_bakers_gamma.hclust
###UPDATED FUNCTIONS:
* cutree.hclust - added the "use_labels_not_values" paremter (ignored)
dendextend 0.9.1 (2013-08-19)
----------------------------------------
###UPDATED FUNCTIONS:
* color_labels - added "labels" parameter for selective coloring of labels by name.
* Bk_plot - now adds dots for the asymptotic lines in case of NA's
* Bk - now calculates cutree once for all relevant k's - and only then goes forth with FM_index.
###BUG FIXES
* FM_index_R - now returns NA when comparing NA vectors (when, for example, there is no possible split for some k), instead of crashing (as it did before).
* Bk_plot - now won't turn one dendrogram into hclust, while leaving the other a dendrogram.
###OTHER NOTES
* The dendextendRcpp package (version 0.2.0) is now on github, and offers functions for making cutree.dendrogram(k) MUCH faster (between 20 to 100 times faster). (this is besided having labels.dendrogram now also accept a leaf as a tree.)
###VIGNETTES:
* Added Rcpp section.
* Started the Bk section (some theory, but no code yet - although it is all written by now...).
dendextend 0.9.0 (2013-08-18)
----------------------------------------
###NEW FUNCTIONS ADDED:
* sort_2_clusters_vectors
* FM_index_profdpm
* FM_index_R
* FM_index
* FM_index_permutation - for checking permutation distribution of the FM Index
* Bk
* Bk_permutations
* Bk_plot (it can be MUCH slower for dendrograms with large trees, but works great for hclust)
###UPDATED FUNCTIONS:
* color_labels - removed unused 'groupLabels' parameter.
###VIGNETTES:
* Added the FM Index section.
FILE CHANGES:
* Bk-method.r file added.
###OTHER NOTES
* The dendextendRcpp package (version 0.1.1) is now on github, and offers a faster labels.dendrogram function (It is 20 to 40 times faster than the 'stats' function!)
* Added a commented-out section which could (in the future) be the basis of an Rcpp cutree (actually cutree_1h.dendrogram) function!
dendextend 0.8.0 (2013-08-14)
----------------------------------------
###NEW FUNCTIONS ADDED:
* cor_bakers_gamma
* sample.dendrogram
* rank_order.dendrogram - for fixing leaves value order.
* duplicate_leaf - for sample.dendrogram
* sample.dendrogram - for bootstraping trees when the original data table is missing.
* sort_dist_mat
* cor_cophenetic
###UPDATED FUNCTIONS:
* tanglegram - added the match_order_by_labels parameter.
###VIGNETTES:
* Added the Baker's Gamma Index section.
* Added a bootstrap and permutation examples for inference on Baker's Gamma.
* Also for Cophenetic correlation.
FILE CHANGES:
* sample.dendrogram.r file added.
###BUG FIXES
* fix_members_attr.dendrogram - fixed a bug introduced by the new "members" method in nleaves. (test added)
dendextend 0.7.3 (2013-08-14)
----------------------------------------
###NEW FUNCTIONS ADDED:
* get_childrens_heights - Get height attributes from a dendrogram's children
* rank_branches - ranks the heights of branches - making comparison of the topologies of two trees easier.
###UPDATED FUNCTIONS:
* sort_levels_values - now returns a vector with NA's as is without changing it. Also, a warning is issued (with a parameter to supress the warning called 'warn')
* cutree - now supresses warnings produced by sort_levels_values, in the case of NA values.
* plotNode_horiz now uses "Recall" (I might implement this in more function).
* tanglegram - added parameters hang and rank_branches.
###BUG FIXES
* tanglegram - fixed the right tree's labels position relative to the leaves tips. (they were too far away because of a combination of text_adj with dLeaf)
###VIGNETTES:
* Fixed the dLeaf in tanglegram plots, and gave an example of using rank_branches.
dendextend 0.7.2 (2013-08-13)
----------------------------------------
###NEW FUNCTIONS ADDED:
* plotNode_horiz - allows the labels, in plot_horiz.dendrogram, to be aligned to the leaves tips when the tree is plotted horizontally, its leaves facing left.
###UPDATED FUNCTIONS:
* plot_horiz.dendrogram - allows the labels to be aligned to the leaves tips when the tree is plotted horizontally, its leaves facing left. (took a lot of digging into internal functions used by plot.dendrogram)
* tanglegram - added the parameters: dLeaf_left dLeaf_right. Also, labels are now alligned to the leaves tips in the right dendrogram.
###BUG FIXES
* Fix untangle_step_rotate_1side to work with non-missing dend_heights_per_k
* Set sort_cluster_numbers = TRUE for cutree, in order to make it compatible with stats::cutree. Added a test for this.
* Fix cutree.hclust to work with a vector of k when !order_clusters_as_data
* Fix cutree.dendrogram to give default results as stats::hclust does, by setting the default to sort_cluster_numbers = TRUE.
###OTHER NOTES
* Variations of the changes to plot_horiz.dendrogram and plotNode_horiz should be added to R core in order to allow forward compatability.
dendextend 0.7.1 (2013-08-12)
----------------------------------------
###NEW FUNCTIONS ADDED:
* untangle_step_rotate_2side
###VIGNETTES NEW SECTIONS ADDED:
* untangle_forward_rotate_2side
dendextend 0.7 (2013-08-11)
---------------------------
###NEW FUNCTIONS ADDED:
* shuffle - Random rotation of trees
* untangle_random_search - random search for two trees with low entanglement.
* flip_leaves
* all_couple_rotations_at_k
* untangle_forward_rotate_1side
###OTHER NOTES
* rotate - minor code improvements.
###VIGNETTES NEW SECTIONS ADDED:
* untangle_random_search
* untangle_forward_rotate_1side
dendextend 0.6 (2013-08-10)
---------------------------
###NEW FUNCTIONS ADDED:
* tanglegram - major addition!
* plot_horiz.dendrogram - Plotting a left-tip-adjusted horizontal dendrogram
* remove_leaves_nodePar
* assign_values_to_branches_edgePar
* remove_branches_edgePar
* match_order_by_labels
* match_order_dendrogram_by_old_order - like match_order_by_labels, but faster
* entanglement
###UPDATED FUNCTIONS:
* assign_values_to_leaves_nodePar - now makes sure pch==NA if we are modifying a nodePar value which is other than pch (and pch did not exist before).
* nleaves - now allow the use of the "members" attr of a dendrogram for telling us the size of the tree.
###OTHER NOTES
* entanglement.r file added
* untangle.r file added
###VIGNETTES NEW SECTIONS ADDED:
* Tanglegram
* Entanglement
dendextend 0.5 (2013-08-05)
---------------------------
###NEW FUNCTIONS ADDED:
* tanglegram
###UPDATED FUNCTIONS:
* rotate - fixes calling the same functions more than once (minor improvements)
* fac2num - keep_names parameter added
* intersect_trees - added the "warn" parameter.
###NEW TESTS:
* order.dendrogram gives warning and can be changed
* fac2num works
dendextend 0.4 (2013-08-02)
---------------------------
###NEW FUNCTIONS ADDED:
(including tests and documentation)
* is.natural.number
* cutree_1h.dendrogram - like cutree, but only for 1 height value.
* fix_members_attr.dendrogram - just to validate that prune works o.k.
* hang.dendrogram - hangs a dendrogram leaves (also allows for a rotated hanged dendrogram), works also for non-binary trees.
* nnodes - count the number of nodes in a tree
* as.dendrogram.phylo - based on as.hclust.
* get_nodes_attr - allows easy access to attributes of branches and leaves
* get_branches_heights
* fix_members_attr.dendrogram
* heights_per_k.dendrogram - get the heights for a tree that will yield each k cluster.
* is.hclust
* is.dendrogram
* is.phylo
* fac2num
* as.phylo.dendrogram - based on as.hclust.
* cutree_1k.dendrogram - like cutree, but only for 1 k (number of clusters) value.
* cutree.dendrogram - like cutree but for dendrograms (and it is also vectorized)
* cutree.hclust - like cutree but for hclust
* cutree.phylo - like cutree but for phylo
* sort_levels_values - make the resulting clusters from cutree to be ordered from left to right
* cutree - with S3 methods for dendrogram/hclust/phylo
* color_branches - color a tree branches based on its clusters. This is a modified version of the color_clusters function from jefferis's dendroextra package. It extends it by using my own version of cutree.dendrogram - allowing the function to work for trees that hclust can not handle (unrooted and non-ultrametric trees). Also, it allows REPEATED cluster color assignments to branches on to the same tree. Something which the original function was not able to handle. It also handles extreme cases, such as when the labels of a tree are integers.
* color_labels - just like color_branches, but for labels.
* assign_values_to_leaves_nodePar - allows for complex manipulation of dendrogram's leaves parameters.
###UPDATED FUNCTIONS:
* nleaves - added nleaves.phylo methods, based on as.hclust so it could be improved in the future.
* "labels_colors<-" - fixed it so that by default it would not add phc=1 to the leaves.
* "order.dendrogram<-" - now returns an integer (instead of numeric)
* cutree (cutree.dendogram / cutree.hclust) - Prevent R from crashing when using
cutree on a subset tree (e.g: dend[[1]])
* Renaming the unroot function -> to -> unbranch
* get_leaves_attr - added a simplify parameter.
###OTHER NOTES
* Updated the exact way the GPL was stated in DESCRIPTION and gave a better reference within each file.
###VIGNETTES NEW SECTIONS ADDED:
* Hanging trees
* Coloring branches.
dendextend 0.3 (2013-07-27)
---------------------------
###NEW FUNCTIONS ADDED:
* removed "flip", added rev.hclust instead (since rev.dendrogram already exists)
###VIGNETTES NEW SECTIONS ADDED:
* Vignettes created (using LaTeX)
* Basic introduction to dendrogram objects
* Labels extraction and assignment, and measuring tree size.
* Tree manipulation: unrooting, pruning, label coloring, rotation
###NEW TESTS ADDED:
* labels extraction, assignment and tree size (especially important for comparing hclust and dendrogram!)
* Tree manipulation: unrooting, pruning, label coloring, rotation
###UPDATED FUNCTIONS:
* "labels.hclust" - added the "order" parameter. (based on some ideas from Gregory Jefferis's dendroextras package)
* "labels.hclust" and "labels.hclust<-" - now both use order=TRUE as default. this makes them consistent with labels.dendrogram. Proper tests have been implemented.
* "labels<-.dendrogram" - make sure the new dendrogram does not have each of its node of class "dendrogram" (which happens when using dendrapply)
* unclass_dend - now uses dendrapply
* get_branches_attr - added "warning" parameter
* unroot.dendrogram - Can now deal with unrooting more than 3 branches. supresses various warnings.
* as_hclust_fixed - now works just as as.hclust when hc is missing.
* rotate - allowed "order" to accept character vector.
###OTHER NOTES
* Extending the documentation for: rotate, labels.hclust,
* Added a welcome massage to when loading the package (zzz.r file added)
* Added a first template for browseVignettes(package ='dendextend')
* Added a tests folder - making the foundation for using testthat.
* Added tests for labels assignment
* Added a clear GPL-2+ copyright notice on each r file.
* Forcing {ape} to load before {dendextend}, thus allowing for both rotate and unroot to work for BOTH packages. It does add extra noise when loading the package, but it is the best solution I can think of at this point.
dendextend 0.2 (2013-04-10)
---------------------------
###NEW FUNCTIONS ADDED:
* count_terminal_nodes
* labels_colors (retrieving and assignment)
* unclass_dend
* head.dendrogram (S3 method for dendrogram)
* nleaves (with S3 methods for dendrogram and hclust)
* rotate (with S3 methods for dendrogram, hclust and phylo)
* sort (with S3 methods for dendrogram and hclust)
* flip (works for both dendrogram and hclust)
* prune - prunes leaves off a dendrogram/hclust/phylo trees. (based on the prune_leaf function)
* as_hclust_fixed
* get_branches_attr
* unroot (dendrogram/hclust/phylo)
* raise.dendrogram
* flatten.dendrogram
* order.dendrogram<-
* intersect_trees
###UPDATED FUNCTIONS:
* "labels<-.dendrogram" - made sure to allow shorter length of labels than the size of the tree (now uses recycling). This version is now sure to deal correctly with labeling trees with duplicate labels.
###OTHER NOTES
* From here on I will be using "." only for S3 method functions. Other functions will use "_"
* Added more .r files, and changed the locations of some functions.
dendextend 0.1 (2013-04-05) - FIRST version!
----------------------------------------
###NEW FUNCTIONS
* S3 methods for label assignment operator for vector, dendrogram, hclust, matrix.
###OTHER NOTES
* Includes skeletons for some functions that will be added in the future.
|