R: A shiny app for interactive clustering

interactive_clustering {dtwclust} | R Documentation

## A shiny app for interactive clustering

### Description

Display a shiny user interface to do clustering based on the provided series.

### Usage

    interactive_clustering(series, ...)

### Arguments

`series` | Time series in the formats accepted by `tsclust()`.
`...` | More arguments for `shiny::runApp()`.

### Explore

This part of the app is simply to see some basic characteristics of the provided series and plot some of them. The field for integer IDs expects a valid R expression that specifies which of the `series` should be plotted. Multivariate series are plotted with each variable in a different facet.

### Cluster

This part of the app wraps `tsclust()`, so you should be familiar with it. Some remarks:

- Specifying a custom centroid or hierarchical method expects the name of a function available in the R session (without quotes). Naturally, any required package should be loaded before calling `interactive_clustering`. For example, if you want to use `cluster::agnes()`, you should load cluster beforehand.

- A random seed of 0 means that it will be left as `NULL` when calling `tsclust()`.

- The input fields for Extra parameters (distance, centroid and ellipsis) expect a comma- separated sequence of key-value pairs. For example: `window.size = 10L`, `trace = TRUE`. You should be able to pass any variables available in the R session's global environment.

- Regarding plot parameters:

  - The `Clusters` field is like the integer IDs from the Explore section.

  - The `Labels` field is passed to the plot method (see TSClusters-methods). You can specify several values like with the Extra parameters, e.g.: `nudge_x = 10`, `nudge_y = 1`. You can type an empty space to activate them with the defaults, and delete everything to hide them. Note that the location of the labels is random each time.

The plot area reacts to the plot parameters, but the actual clustering with `tsclust()` won't be executed until you click the `Cluster!` button. The plot can take a couple of seconds to load! Plotting multivariate series might generate warnings about missing values, they can be safely ignored.

Some of the control parameters are disabled when dtwclust detects them automatically.

The cross-distance matrix is cached so that it can be re-used when appropriate. The cached version is invalidated automatically when necessary.

### Evaluate

This part of the app provides results of the current clustering. External CVIs can be calculated if the name of a variable with the ground truth is provided (see `cvi()`).

### Note

Tracing is printed to the console.

### Author(s)

Alexis Sarda-Espinosa

### Examples

    ## Not run:
    interactive_clustering(CharTrajMV)

    ## End(Not run)

[Package dtwclust version 5.5.7 Index]