# Use processanimateR and Shiny

#### Felix Mannhardt

#### 2020-03-13

ProcessanimateR animation can be also used interactively as part of a (Shiny) web-application. Here, an example application that expects attributes are of an appropriate data type and automatically chooses appropriate color scales is given. We first define a function `ianimate_process` that defines our Shiny application as follows:

    library(processanimateR)
    library(shiny)
    library(shinycssloaders)
    ianimate_process <- function(eventlog, min.time = 30, max.time = 600, default.time = 60) {

      ui <- function(request) {
        fluidPage(
          tags$head(tags$style("#process{height:90vh !important;}")),
          titlePanel("Hello processanimateR!"),

          sidebarLayout(

            sidebarPanel(
              width = 2,
              sliderInput("duration", "Animation duration", min.time, max.time, default.time),
              selectInput("type", "Animation type", c("relative", "absolute"), "relative"),
              selectInput("sizeAttribute", "Size attribute", c("none", colnames(eventlog)), "none"),
              selectInput("colorAttribute", "Color attribute", c("none", colnames(eventlog)), "none"),
              selectInput("orientation", "Orientation", c("horizontal"="LR", "vertical"="TB"), "horizontal"),
              h4("Selected cases"),
              textOutput("token_selection"),
              h4("Selected activities"),
              textOutput("activity_selection")
            ),

            mainPanel(
              width = 10,
              shinycssloaders::withSpinner(processanimaterOutput("process"))
            )
          )
        )
      }

      server <- function(session, input, output) {

        data <- reactive({

          if (input$colorAttribute != "none") {
            attr <- rlang::sym(input$colorAttribute)
            val <- eventlog %>% pull(!!attr)
            if (!(is.character(val) || is.factor(val))) {
              warning("Trying to use a numeric attribute for the token color!")
            }
          }

          if (input$sizeAttribute != "none") {
            # This only works for numeric attributes
            attr <- rlang::sym(input$sizeAttribute)
            val <- eventlog %>% pull(!!attr)
            if (!is.numeric(val)) {
              warning("Trying to use a non-numeric attribute for the token size!")
            }
          }

          eventlog

        })

        output$token_selection <- renderText({

          paste0(input$process_tokens, ",")

        })

        output$activity_selection <- renderText({

          paste0(input$process_activities, ",")

        })

        output$process <- renderProcessanimater(expr = {
          graph <- processmapR::process_map(data(), render = F)
          model <- DiagrammeR::add_global_graph_attrs(graph, attr = "rankdir", value = input$orientation, attr_type = "graph")
          if (input$sizeAttribute != "none" && input$colorAttribute != "none") {
            animate_process(data(), model,
                            mode = input$type,
                            legend = "color",
                            mapping = token_aes(color = token_scale(input$colorAttribute, scale = "ordinal",
                                                                    range = RColorBrewer::brewer.pal(5, "YlOrBr")),
                                                size = token_scale(input$sizeAttribute, scale = "linear", range = c(6,10))),
                            duration = input$duration)
          } else if (input$sizeAttribute != "none") {
            animate_process(data(), model,
                            mode = input$type,
                            legend = "size",
                            mapping = token_aes(size = token_scale(input$sizeAttribute, scale = "linear", range = c(6,10))),
                            duration = input$duration)

          } else if (input$colorAttribute != "none") {
            animate_process(data(), model,
                            mode = input$type,
                            legend = "color",
                            mapping = token_aes(color = token_scale(input$colorAttribute, scale = "ordinal", range = RColorBrewer::brewer.pal(5, "YlOrBr"))),
                            duration = input$duration)
          } else {
            animate_process(data(), model,
                            mode = input$type,
                            duration = input$duration)
          }

        })

      }

      shinyApp(ui, server, options = list(height = 500))

    }

Then, the application can be, for example, launched by calling:

    library(eventdataR)
    library(edeaR)
    library(dplyr)
    ianimate_process(sepsis %>%
      filter_trace_frequency(percentage = 0.2) %>%
      filter_activity(c("Return ER"), reverse = T) %>%
      # we fix the datatype of some of the attributes to allow proper rendering of the token color
      # the token size option currently only support numeric attributes
      mutate_at(c("lacticacid", "leucocytes", "crp", "age"), as.numeric) %>%
      mutate_at(c("disfuncorg", "sirscriteria2ormore", "infectionsuspected"), as.logical))