mstLB: Minimum Spanning Tree Preserving Lower Bound

Description Usage Arguments Details Value References Examples

View source: R/mstLB.R

Description

mstLB Returns an nxn matrix containing the lower bounds for all unknown entries in the partial distance matrix D such that the minimum spanning tree of the partial matrix D is preserved upon completion.

Usage

1

Arguments

D

An nxn partial distance matrix to be completed

Details

The insight in constructing the lower bound is drawn from single-linkage clustering. Every edge in a spanning tree separates the vertices into two different groups, depending on which points remain connected to either one vertex or the other of that edge. Because the tree is a minimum spanning tree, if we select the largest edge, then the distance between any vertex of one group and any vertex of the other group must be at least as large as that of the the largest edge. This gives a lower bound for these distances that will preserve that edge in the minimum spanning tree. The same reasoning is applied recursively to each separate group, thus producing a lower bound on all edges.

The details of the algorithm can be found in Rahman & Oldford (2016).

Value

Returns an nxn matrix containing the lower bound for the unknown entries in D

References

Rahman, D., & Oldford R.W. (2016). Euclidean Distance Matrix Completion and Point Configurations from the Minimal Spanning Tree.

Examples

1
2
3
4
5
6
7
D <- matrix(c(0,3,4,3,4,3,
             3,0,1,NA,5,NA,
             4,1,0,5,NA,5,
             3,NA,5,0,1,NA,
             4,5,NA,1,0,5,
             3,NA,5,NA,5,0),byrow=TRUE, nrow=6)
mstLB(D)

great-northern-diver/edmcr documentation built on Dec. 20, 2021, 12:52 p.m.