TopKListsGUI: TopKListsGUI for inference and visualization

In TopKLists: Inference, Aggregation and Visualization for Top-K Ranked Lists

Description

This function opens a RGUI window and allows the user to select the parameters for the distance δ, for the pilot sample size ν, and the threshold for the aggmap presentation. Based on the selected parameters, a pairwise estimation of the top-k lists overlap is performed with switching reference lists (e.g. L1 with L2 and L2 with L1). Based on these estimates, all involved lists are truncated and the maximum of the \hat{k}_i estimates is selected by default. The individual results of each combination of ranked lists are displayed automatically in the RGUI window and saved to a prespecified folder. After the maximal truncation point is estimated, CEMC algorithm is applied to generate the final list of top-k objects.

The consolidated top-k list results can be displayed in three different formats controlled by tabs:

(1)'Aggregation map': It is a special type of heatmap, where the truncated lists are ordered from left to right, from the one with the largest overlap with all the others to the one with the lowest overlap. For details see the description of the aggmap. (2) 'Summary table': An interactive table that displays the set of overlapping objects in dependence of the selected parameters. (3) 'Venn-diagram & Venn-table': A Venn-diagram and a Venn-table of the overlapping objects based on all truncated input lists.

Usage

TopKListsGUI(lists, autorange.delta = FALSE, override.errors = TRUE,
venndiag.pdf.size = c(7, 7), venndiag.size = c(380, 420),
gui.size = c(900, 810), directory = NULL, venndiag.res = 70, aggmap.res = 100)

Arguments

lists	A data frame of ordered lists of objects - rows represent the objects, columns represent the individual input lists
autorange.delta	If TRUE, results for all δ values leading to the \hat{k}_i estimates (as function of the parameters specified by the user) will be displayed (note, for a large list length N this can take quite some time, because the δ range examined is from 0 to nrow(lists) by steps of 1). If FALSE, then the user defines the δ range (min and max) in the RGUI window
override.errors	If TRUE, errors due to an inappropriate value selection are overridden and the calculation continues for all other δ values, but there is no output for viewing in the GUI corresponding to that combination of values which has caused the error; defaults to TRUE
venndiag.pdf.size	A numeric vector defining the width and height of the Venn-diagram plot - it is passed to the pdf() function that saves the plot; defaults to c(7, 7)
venndiag.size	A numeric vector defining the width and height of the Venn-diagram plot - it is passed to the png() function that saves the plot; defaults to c(380, 420)
gui.size	A numeric vector defining the width and height of the RGUI to be displayed; defaults to c(900, 810)
directory	Specification of the name of the directory where the results and plots should be saved (including some temporary files required for the calculations). If kept NULL a directory called "TopKLists-temp" will be created in getwd(). In that case a write permission is needed for getwd().
venndiag.res	A number defining the resolution of the Venn-diagram plot - this argument is passed to the res = argument of the png() function saving the diagram, but affects also the RGUI display; defaults to 70
aggmap.res	A number defining the resolution of the aggmap plot - this argument is passed to the res = argument of the png() function saving the plot, but affects also the RGUI display; defaults to 100

Value

RGUI window with three tabs:

'Aggregation map': For an index p=1,2,…$, $L-1 aggregation levels (groupings of top lists) are combined in one display. For each group of L-p truncated lists down to the smallest group consisting of just one pair of lists, (1) an arbitrary reference list ("ground truth") is selected under the condition that it comprises \max_i(\hat{k}_i) items among all pairwise comparisons in the group of rankings, (2) symbols of its \max_i(\hat{k}_i) items are printed vertically from the highest to the lowest rank position, and (3) the aggregation information for all remaining L-p rankings in the group is added, ordered according to descending list length.

'Summary table': An interactive table that displays all overlapping (grey) objects based on the truncated list comparison. Rank sum per object and frequency of each object in the input lists or truncated lists are calculated over all compared lists. The first column denotes if an object was selected by the CEMC algorithm for the final set of common objects. The table can be ordered according to any of the displayed columns.

'Venn-diagram & Venn-table': The Venn-diagram and the Venn-table display the rank intersection of the identified top-k objects in two different formats.

These tabs automatically save all plots and tables into the specified directory.

The following additional exploratory features are implemented:

'Deltaplot' (see deltaplot): For a preselected range of δ's and all list pairs, an exploratory plot of rank discordance is created and saved (function not part of the RGUI window).

'Mdelta' (see deltaplot): For a preselected range of δ's and all list pairs, Delta-matrices are created and saved (function not part of the RGUI window) in one rdata object (Mdelta.rdata). Each delta-matrix is saved individually in a tab delimited .txt-file.

Author(s)

Eva Budinska <[e-mail]>, Karl G. Kugler <[e-mail]>, Michael G. Schimek <[e-mail]>

See Also

CEMC

Examples

## Not run: 
data(breast)
TopKListsGUI(breast)

## End(Not run)

TopKLists documentation built on May 2, 2019, 4:41 p.m.