gauge_chart: Create a gauge (speedometer) chart.

In ddplot: Create D3 Based SVG Graphics

Create a gauge (speedometer) chart.

Description

A gauge (speedometer) chart displays a single quantitative measure against colored zones (warning and danger) with a needle indicator. By default the needle animates on load, sweeping up from the minimum to the value and settling with a small wobble, like a car dashboard.

Usage

gauge_chart(
  value,
  min = 0,
  max = 100,
  title = "",
  warningZone = NULL,
  warningColor = "orange",
  dangerZone = NULL,
  dangerColor = "red",
  arcBgColor = "#ddd",
  needleColor = "crimson",
  pivotColor = "steelblue",
  titleFontSize = 16,
  valueFontSize = 14,
  font = "Verdana, Geneva, Tahoma, sans-serif",
  bgcol = "white",
  animate = TRUE,
  animationDuration = 1500,
  width = NULL,
  height = NULL
)

Arguments

value	Numeric. The current value to display on the gauge.
min	Numeric. The minimum value of the gauge. Defaults to 0.
max	Numeric. The maximum value of the gauge. Defaults to 100.
title	Character. Label shown inside the gauge. Defaults to "".
warningZone	Numeric. The value at which the warning (first) arc begins. Defaults to 75% of max.
warningColor	The color of the warning zone arc. Defaults to "orange".
dangerZone	Numeric. The value at which the danger (second, critical) arc begins. Defaults to 90% of max.
dangerColor	The color of the danger zone arc. Defaults to "red".
arcBgColor	The background color of the gauge arc track. Defaults to "#ddd".
needleColor	The color of the needle. Defaults to "crimson".
pivotColor	The color of the center pivot circle. Defaults to "steelblue".
titleFontSize	The font size of the gauge title. Defaults to 16.
valueFontSize	The font size of the current value label. Defaults to 14.
font	The font family used for all text. Defaults to "Verdana, Geneva, Tahoma, sans-serif".
bgcol	The background color of the SVG. Defaults to "white".
animate	Logical. When TRUE (default), the needle sweeps from the minimum up to the value on load and settles with a small wobble. Set to FALSE to draw the needle at the value immediately with no animation.
animationDuration	Numeric. Duration of the needle sweep in milliseconds. Defaults to 1500.
width	Optional. The width of the SVG output.
height	Optional. The height of the SVG output.

Value

An SVG gauge chart.

Examples

# Basic usage
gauge_chart(value = 8, title = "Memory")

# Custom warning and danger thresholds
gauge_chart(
  value = 72,
  min = 0,
  max = 100,
  title = "CPU Load",
  warningZone  = 60,
  warningColor = "orange",
  dangerZone   = 80,
  dangerColor  = "red"
)

# Non-percentage range (response time in ms)
gauge_chart(
  value = 530,
  min = 0,
  max = 1000,
  title = "Response (ms)",
  warningZone  = 400,
  dangerZone   = 700
)

ddplot documentation built on Aug. 25, 2026, 5:10 p.m.