R: Create a gauge component for a dashboard.

gauge {flexdashboard}

R Documentation

Create a gauge component for a dashboard.

Description

A gauge displays a numeric value on a meter that runs between specified minimum and maximum values.

Usage

gauge(value, min, max, sectors = gaugeSectors(), symbol = NULL,
  label = NULL, abbreviate = TRUE, abbreviateDecimals = 1, href = NULL)

gaugeSectors(success = NULL, warning = NULL, danger = NULL,
  colors = c("success", "warning", "danger"))

Arguments

`value`	Numeric value to display
`min`	Minimum numeric value
`max`	Maximum numeric value
`sectors`	Custom colored sectors (e.g. "success", "warning", "danger"). By default all values are colored using the "success" theme color
`symbol`	Optional symbol to show next to value (e.g. 'kg')
`label`	Optional label to display beneath the value
`abbreviate`	Abbreviate large numbers for min, max, and value (e.g. 1234567 -> 1.23M). Defaults to `TRUE`.
`abbreviateDecimals`	Number of decimal places for abbreviated numbers to contain (defaults to 1).
`href`	An optional URL to link to. Note that this can be an anchor of another dashboard page (e.g. "#details").
`success`	Two-element numeric vector defining the range of values to color as "success" (specific color provided by theme or custom `colors`)
`warning`	Two-element numeric vector defining the range of values to color as "warning" (specific color provided by theme or custom `colors`)
`danger`	Two-element numeric vector defining the range of values to color as "danger" (specific color provided by theme or custom `colors`)
`colors`	Vector of colors to use for the `success`, `warning`, and `danger` ranges. Colors can be standard theme colors ("success", "warning", "danger", "primary", and "info") or any other valid CSS color specifier. Note that if no custom sector ranges are defined, this parameter can be a single color value rather than a vector of three values

Details

See the flexdashboard website for additional documentation: http://rmarkdown.rstudio.com/flexdashboard/using.html#gauges

Examples

library(flexdashboard)

gauge(42, min = 0, max = 100, symbol = '%', gaugeSectors(
  success = c(80, 100), warning = c(40, 79), danger = c(0, 39)
))

[Package flexdashboard version 0.5.1.1 Index]