# TopKListsGUI for inference and visualization

### 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

1 2 3 |

### 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 |

`override.errors` |
If TRUE, errors due to an inappropriate value selection are overridden and the calculation continues for all other |

`venndiag.pdf.size` |
A numeric vector defining the width and height of the Venn-diagram plot - it is passed to the |

`venndiag.size` |
A numeric vector defining the width and height of the Venn-diagram plot - it is passed to the |

`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 |

`venndiag.res` |
A number defining the resolution of the Venn-diagram plot - this argument is passed to the |

`aggmap.res` |
A number defining the resolution of the |

### 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 <budinska@iba.muni.cz>, Karl G. Kugler <kg.kugler@gmail.com>, Michael G. Schimek <michael.schimek@medunigraz.at>

### See Also

`CEMC`

### Examples

1 2 3 4 5 | ```
## Not run:
data(breast)
TopKListsGUI(breast)
## End(Not run)
``` |