R/RcppExports.R

Defines functions cpp_shared_phylo cpp_mutual_clustering cpp_msi_distance cpp_jaccard_similarity cpp_matching_split_distance cpp_robinson_foulds_info cpp_robinson_foulds_distance cpp_sl_max_tips cpp_mci_impl_score cpp_transfer_dist_cross_pairs cpp_transfer_dist_all_pairs cpp_transfer_dist_scored cpp_transfer_dist cpp_tc_profile cpp_transfer_consensus spr_table_7 keep_and_reduce keep_and_reroot confusion mismatch_size reduce_trees path_vector cpp_splitwise_info_batch cpp_clustering_entropy_batch cpp_jaccard_cross_pairs cpp_shared_phylo_cross_pairs cpp_msi_cross_pairs cpp_msd_cross_pairs cpp_rf_info_cross_pairs cpp_mutual_clustering_cross_pairs cpp_jaccard_all_pairs cpp_shared_phylo_all_pairs cpp_msi_all_pairs cpp_msd_all_pairs cpp_rf_info_all_pairs cpp_mutual_clustering_all_pairs cpp_nni_distance cpp_mast lapjv pair_diff_euclidean vec_diff_euclidean cpp_kc_vector expected_mi entropy_int relabel_hpart clone_hpart hpart_to_edge build_hpart_from_list build_hpart_from_phylo EHMI_xptr HH_xptr HMI_xptr consensus_info robinson_foulds_cross_pairs robinson_foulds_all_pairs COMCLUST binary_entropy_counts

Documented in cpp_mutual_clustering_all_pairs cpp_transfer_consensus cpp_transfer_dist cpp_transfer_dist_all_pairs cpp_transfer_dist_cross_pairs entropy_int

# Generated by using Rcpp::compileAttributes() -> do not edit by hand
# Generator token: 10BE3573-1514-4C36-9D1C-5A225CD40393

binary_entropy_counts <- function(inSplit, nLeaves) {
    .Call(`_TreeDist_binary_entropy_counts`, inSplit, nLeaves)
}

COMCLUST <- function(trees) {
    .Call(`_TreeDist_COMCLUST`, trees)
}

robinson_foulds_all_pairs <- function(tables) {
    .Call(`_TreeDist_robinson_foulds_all_pairs`, tables)
}

robinson_foulds_cross_pairs <- function(tables_a, tables_b) {
    .Call(`_TreeDist_robinson_foulds_cross_pairs`, tables_a, tables_b)
}

consensus_info <- function(trees, phylo, p) {
    .Call(`_TreeDist_consensus_info`, trees, phylo, p)
}

HMI_xptr <- function(ptr1, ptr2) {
    .Call(`_TreeDist_HMI_xptr`, ptr1, ptr2)
}

HH_xptr <- function(ptr) {
    .Call(`_TreeDist_HH_xptr`, ptr)
}

EHMI_xptr <- function(hp1_ptr, hp2_ptr, tolerance = 0.01, minResample = 36L) {
    .Call(`_TreeDist_EHMI_xptr`, hp1_ptr, hp2_ptr, tolerance, minResample)
}

build_hpart_from_phylo <- function(phy) {
    .Call(`_TreeDist_build_hpart_from_phylo`, phy)
}

build_hpart_from_list <- function(tree, n_tip) {
    .Call(`_TreeDist_build_hpart_from_list`, tree, n_tip)
}

hpart_to_edge <- function(hpart_xptr) {
    .Call(`_TreeDist_hpart_to_edge`, hpart_xptr)
}

clone_hpart <- function(hpart_ptr) {
    .Call(`_TreeDist_clone_hpart`, hpart_ptr)
}

relabel_hpart <- function(hpart_ptr, map) {
    invisible(.Call(`_TreeDist_relabel_hpart`, hpart_ptr, map))
}

#' Calculate entropy of integer vector of counts
#' 
#' Wrapper for C++ function; no input checking is performed.
#' [`Ntropy()`] is better suited for use where performance is not critical.
#' @param n a vector of integer counts
#' @return `entropy_int()` returns a numeric corresponding to the entropy of
#' each observation, in bits.
#' @export
#' @keywords internal
entropy_int <- function(n) {
    .Call(`_TreeDist_entropy_int`, n)
}

expected_mi <- function(ni, nj) {
    .Call(`_TreeDist_expected_mi`, ni, nj)
}

cpp_kc_vector <- function(edge, tip_order) {
    .Call(`_TreeDist_cpp_kc_vector`, edge, tip_order)
}

vec_diff_euclidean <- function(vec1, vec2) {
    .Call(`_TreeDist_vec_diff_euclidean`, vec1, vec2)
}

pair_diff_euclidean <- function(vecs) {
    .Call(`_TreeDist_pair_diff_euclidean`, vecs)
}

lapjv <- function(x, maxX) {
    .Call(`_TreeDist_lapjv`, x, maxX)
}

cpp_mast <- function(edge1, edge2, nTip) {
    .Call(`_TreeDist_cpp_mast`, edge1, edge2, nTip)
}

cpp_nni_distance <- function(edge1, edge2, nTip) {
    .Call(`_TreeDist_cpp_nni_distance`, edge1, edge2, nTip)
}

#' Pairwise mutual clustering information — batch computation
#'
#' Internal function. Computes all pairwise MCI scores for a set of trees,
#' using OpenMP threads when available (falling back to single-threaded
#' execution otherwise). No interrupt checking is performed inside the
#' parallel region; the outer R call remains interruptible between batches.
#'
#' @param splits_list A list of split matrices (class `Splits` or `RawMatrix`),
#'   one per tree, all covering the same tip set.  Typically the object
#'   returned by `as.Splits(trees, tipLabels = labs, asSplits = FALSE)`.
#' @param n_tip Integer; number of tips shared by all trees.
#' @return Numeric vector of length `n*(n-1)/2` containing pairwise MCI
#'   scores in `combn(n, 2)` column-major order (i.e. the data payload of
#'   an R `dist` object).
#' @keywords internal
cpp_mutual_clustering_all_pairs <- function(splits_list, n_tip, n_threads = 1L) {
    .Call(`_TreeDist_cpp_mutual_clustering_all_pairs`, splits_list, n_tip, n_threads)
}

#' @keywords internal
cpp_rf_info_all_pairs <- function(splits_list, n_tip, n_threads = 1L) {
    .Call(`_TreeDist_cpp_rf_info_all_pairs`, splits_list, n_tip, n_threads)
}

#' @keywords internal
cpp_msd_all_pairs <- function(splits_list, n_tip, n_threads = 1L) {
    .Call(`_TreeDist_cpp_msd_all_pairs`, splits_list, n_tip, n_threads)
}

#' @keywords internal
cpp_msi_all_pairs <- function(splits_list, n_tip, n_threads = 1L) {
    .Call(`_TreeDist_cpp_msi_all_pairs`, splits_list, n_tip, n_threads)
}

#' @keywords internal
cpp_shared_phylo_all_pairs <- function(splits_list, n_tip, n_threads = 1L) {
    .Call(`_TreeDist_cpp_shared_phylo_all_pairs`, splits_list, n_tip, n_threads)
}

#' @keywords internal
cpp_jaccard_all_pairs <- function(splits_list, n_tip, k = 1.0, allow_conflict = TRUE, n_threads = 1L) {
    .Call(`_TreeDist_cpp_jaccard_all_pairs`, splits_list, n_tip, k, allow_conflict, n_threads)
}

#' @keywords internal
cpp_mutual_clustering_cross_pairs <- function(splits_a, splits_b, n_tip, n_threads = 1L) {
    .Call(`_TreeDist_cpp_mutual_clustering_cross_pairs`, splits_a, splits_b, n_tip, n_threads)
}

#' @keywords internal
cpp_rf_info_cross_pairs <- function(splits_a, splits_b, n_tip, n_threads = 1L) {
    .Call(`_TreeDist_cpp_rf_info_cross_pairs`, splits_a, splits_b, n_tip, n_threads)
}

#' @keywords internal
cpp_msd_cross_pairs <- function(splits_a, splits_b, n_tip, n_threads = 1L) {
    .Call(`_TreeDist_cpp_msd_cross_pairs`, splits_a, splits_b, n_tip, n_threads)
}

#' @keywords internal
cpp_msi_cross_pairs <- function(splits_a, splits_b, n_tip, n_threads = 1L) {
    .Call(`_TreeDist_cpp_msi_cross_pairs`, splits_a, splits_b, n_tip, n_threads)
}

#' @keywords internal
cpp_shared_phylo_cross_pairs <- function(splits_a, splits_b, n_tip, n_threads = 1L) {
    .Call(`_TreeDist_cpp_shared_phylo_cross_pairs`, splits_a, splits_b, n_tip, n_threads)
}

#' @keywords internal
cpp_jaccard_cross_pairs <- function(splits_a, splits_b, n_tip, k = 1.0, allow_conflict = TRUE, n_threads = 1L) {
    .Call(`_TreeDist_cpp_jaccard_cross_pairs`, splits_a, splits_b, n_tip, k, allow_conflict, n_threads)
}

cpp_clustering_entropy_batch <- function(splits_list, n_tip) {
    .Call(`_TreeDist_cpp_clustering_entropy_batch`, splits_list, n_tip)
}

cpp_splitwise_info_batch <- function(splits_list, n_tip) {
    .Call(`_TreeDist_cpp_splitwise_info_batch`, splits_list, n_tip)
}

path_vector <- function(edge) {
    .Call(`_TreeDist_path_vector`, edge)
}

reduce_trees <- function(x, y, original_label) {
    .Call(`_TreeDist_reduce_trees`, x, y, original_label)
}

mismatch_size <- function(x, y) {
    .Call(`_TreeDist_mismatch_size`, x, y)
}

confusion <- function(x, y) {
    .Call(`_TreeDist_confusion`, x, y)
}

keep_and_reroot <- function(tree1, tree2, keep) {
    .Call(`_TreeDist_keep_and_reroot`, tree1, tree2, keep)
}

keep_and_reduce <- function(tree1, tree2, keep) {
    .Call(`_TreeDist_keep_and_reduce`, tree1, tree2, keep)
}

spr_table_7 <- function(sp1, sp2) {
    .Call(`_TreeDist_spr_table_7`, sp1, sp2)
}

#' Transfer consensus (C++ implementation)
#'
#' @param splits_list List of raw matrices (one per tree), each from as.Splits().
#' @param n_tip Number of tips.
#' @param scale Logical: use scaled transfer distance?
#' @param greedy_best_flag Logical: TRUE for "best", FALSE for "first".
#' @param init_majority Logical: TRUE to start from majority-rule splits.
#'
#' @return A `LogicalVector` of length n_splits indicating which pooled splits
#'   are included in the consensus, plus attributes "raw_splits" (a raw matrix
#'   of all unique splits) and "light_side" (integer vector).
#' @keywords internal
cpp_transfer_consensus <- function(splits_list, n_tip, scale, greedy_best_flag, init_majority, n_threads = 1L) {
    .Call(`_TreeDist_cpp_transfer_consensus`, splits_list, n_tip, scale, greedy_best_flag, init_majority, n_threads)
}

#' @keywords internal
cpp_tc_profile <- function(splits_list, n_tip, scale, greedy_best_flag, init_majority, n_iter, n_threads = 1L) {
    .Call(`_TreeDist_cpp_tc_profile`, splits_list, n_tip, scale, greedy_best_flag, init_majority, n_iter, n_threads)
}

#' Per-pair transfer dissimilarity
#'
#' @param x,y Raw matrices representing splits (from as.Splits()).
#' @param nTip Integer: number of tips.
#'
#' @return A list with components:
#'   - score_scaled: scaled transfer dissimilarity (double)
#'   - score_unscaled: unscaled transfer dissimilarity (double)
#'   - `matching_xy`: integer vector, best match in y for each split in x (1-based, NA if sentinel)
#'   - `matching_yx`: integer vector, best match in x for each split in y (1-based, NA if sentinel)
#' @keywords internal
cpp_transfer_dist <- function(x, y, nTip) {
    .Call(`_TreeDist_cpp_transfer_dist`, x, y, nTip)
}

#' @keywords internal
cpp_transfer_dist_scored <- function(x, y, nTip, scale) {
    .Call(`_TreeDist_cpp_transfer_dist_scored`, x, y, nTip, scale)
}

#' All-pairs transfer dissimilarity (OpenMP)
#'
#' @param splits_list List of raw matrices (one per tree).
#' @param n_tip Number of tips.
#' @param scale Logical: use scaled transfer dissimilarity?
#' @param n_threads Number of OpenMP threads.
#'
#' @return Numeric vector of length choose(N,2) in dist order.
#' @keywords internal
cpp_transfer_dist_all_pairs <- function(splits_list, n_tip, scale, n_threads) {
    .Call(`_TreeDist_cpp_transfer_dist_all_pairs`, splits_list, n_tip, scale, n_threads)
}

#' Cross-pairs transfer dissimilarity (OpenMP)
#'
#' @param splits_a,splits_b Lists of raw matrices.
#' @param n_tip Number of tips.
#' @param scale Logical: use scaled transfer dissimilarity?
#' @param n_threads Number of OpenMP threads.
#'
#' @return Numeric matrix of dimension `nA` x `nB`.
#' @keywords internal
cpp_transfer_dist_cross_pairs <- function(splits_a, splits_b, n_tip, scale, n_threads) {
    .Call(`_TreeDist_cpp_transfer_dist_cross_pairs`, splits_a, splits_b, n_tip, scale, n_threads)
}

cpp_mci_impl_score <- function(x, y, n_tips) {
    .Call(`_TreeDist_cpp_mci_impl_score`, x, y, n_tips)
}

cpp_sl_max_tips <- function() {
    .Call(`_TreeDist_cpp_sl_max_tips`)
}

cpp_robinson_foulds_distance <- function(x, y, nTip) {
    .Call(`_TreeDist_cpp_robinson_foulds_distance`, x, y, nTip)
}

cpp_robinson_foulds_info <- function(x, y, nTip) {
    .Call(`_TreeDist_cpp_robinson_foulds_info`, x, y, nTip)
}

cpp_matching_split_distance <- function(x, y, nTip) {
    .Call(`_TreeDist_cpp_matching_split_distance`, x, y, nTip)
}

cpp_jaccard_similarity <- function(x, y, nTip, k, allowConflict) {
    .Call(`_TreeDist_cpp_jaccard_similarity`, x, y, nTip, k, allowConflict)
}

cpp_msi_distance <- function(x, y, nTip) {
    .Call(`_TreeDist_cpp_msi_distance`, x, y, nTip)
}

cpp_mutual_clustering <- function(x, y, nTip) {
    .Call(`_TreeDist_cpp_mutual_clustering`, x, y, nTip)
}

cpp_shared_phylo <- function(x, y, nTip, force_slow = FALSE) {
    .Call(`_TreeDist_cpp_shared_phylo`, x, y, nTip, force_slow)
}

Try the TreeDist package in your browser

Any scripts or data that you put into this service are public.

TreeDist documentation built on June 10, 2026, 5:06 p.m.