Learn R Programming

pandemonium

pandemonium performs hierarchical cluster analysis within a Shiny GUI. The data space should be split into two parts, for example input variables and latent variables for a statistical model. Clustering is performed using the subset of variables in the clustering space, and cluster assignments are also visualised in the linked space.

Within the dynamic GUI pandemonium performs data preparation, clustering and visualisation with interactive methods. The user can change all settings without having to to leave the GUI.

Installation

You can install the development version of pandemonium from GitHub with:

# install.packages("pak")
pak::pak("GabrielMccoy/pandemonium")

Getting Started

We use the Bikes data example to show how the app can be used. To load the GUI with this data, the following can be used.

library(pandemonium)
pandemonium(df = Bikes$space1, space2 = Bikes$space2, 
                getScore = outsidescore(Bikes$other$res,"Residual"))

By loading the app with the clustering space in df and the linked space in space2 the data is automatically selected in the data page. From here pressing load app will launch the analysis tab.

Within the analysis tab you can explore different visualisations and their options in each of the enclosed tabs.

Copy Link

Version

Install

install.packages('pandemonium')

Monthly Downloads

190

Version

0.2.4

License

MIT + file LICENSE

Maintainer

Gabriel McCoy

Last Published

November 3rd, 2025

Functions in pandemonium (0.2.4)

plotCstat

Plot selected cluster statistics
plotChi2

Plot chi2
getDists

Compute distances between all points
pullCoords

Chi-Squared Loss Function Coordinates
userCoords

User defined coordinate function
umap

Uniform Manifold Approximation and Projection Embedding
tSNE

t-Distributed Stochastic Neighbor Embedding
plotObs

Make coordinate plot
plotHeatmap

Plot heatmap with dendrogram
tourMaker

function to make tours
plotWC

Show clusters in parameter space
writeResults

Write coordinates and cluster assignment to a CSV file
plotSigBin

Plot sigma bins in parameter space
plotPC

Make parallel coordinate plot
computeSigma

Compute sigma
chi2score

Chi-squared scores function
getClusterDists

Compute cluster distance summaries
getBenchmarkInformation

Compute cluster information
pullCoordsNoCov

Generic Loss Function Coordinates
rawCoords

Raw coordinates
colourHelper

function for assigning colouring, palette and labels
plotDimRed

Plot dimension reduction plot
computeChi2

Compute chi2 value for all points
outsidescore

Using externally computed score values
UI

Generating layout for the graphical interface.
%>%

Pipe operator
Bikes

Bike sharing data with model information
chi2bins

Bin points based on chi2
cstat_labeller

function for labeling cluster statistics on statistics page of pandemonium GUI
getClusterStats

Compute cluster statistics
pandemonium

Shiny app for exploring clustering solutions
normCoords

Scaled coordinates
makePlots

Generate a specified plot outside the GUI