MDSReferenceMapwithProjection: Construction of a MDS Reference Map with a MDS Projection

Description Usage Arguments Details Value

Description

This function computes a MDS Reference Map with an associated MDS Projection based on a distance matrix.

A MDS Projection consists on a MDS Reference Map on which additional objects have been overlayed. MDS Projections can be computed based on the Euclidean or Manhattan metrics using the 'metric' parameter. The initialization space of object positions can be specified using the 'init' parameter.

Usage

1
2
3
MDSReferenceMapwithProjection(dist, ref_values, k = 2, init = "svd",
  metric = "euclidean", max_it = 6 * 10^6, stress_sd_th = 10^-4,
  stack_length = 500, verbose = TRUE)

Arguments

dist

a numeric matrix with all pairwise distances between objects of the representation

ref_values

a numeric vector indicating how the objects must be considered. Objects assigned with 1 are treated as reference objects, objects assigned with 0 are treated as projection objects and objects assigned with NA are not used

k

a numeric value specifying the desired number of dimensions in the resulting MDS Projection representation

init

a character or a numeric matrix specifying how the objects are positioned in the initial configuration. Possible character values are 'rand', 'center', 'svd' (please refer to the details section for more details). Object positions in the initial configuration can be explicitly specified using a numeric matrix where the rows correspond to the objects and where the columns correspond to the MDS dimensions.

metric

a character indicating the distance metric to use ("euclidean" or "manhattan")

max_it

a numeric indicating the maximal number of steps the algorithm can perform

stress_sd_th

a numeric defining the threshold for the standard deviation of Kruskal Stress

stack_length

a numeric defining the length of the Kruskal Stress stack (used to compute the standard deviation of the Kruskal Stress)

verbose

a boolean enabling the display of debug information at each step of the algorithm

Details

A numeric vector is used to specify the objects to use as reference and the objects to add on the Reference Map.

Value

a list of 3 elements containing the position of the objects ('points' element), the Kruskal Stress ('stress' element), and the Entourage Score ('entourage' element)


tchitchek-lab/MDSRefMaps documentation built on May 31, 2019, 7:28 a.m.