Visualizing Association Rules and Frequent Itemsets

Extends package 'arules' with various visualization techniques for association rules and itemsets. The package also includes several interactive visualizations for rule exploration. Michael Hahsler (2017) .

CRAN version Rdoc CRAN RStudio mirror downloads Travis-CI Build Status AppVeyor Build Status

This R package extends package arules with various visualization techniques for association rules and itemsets. The package also includes several interactive visualizations for rule exploration.


Stable CRAN version: install from within R with


Current development version: Download package from AppVeyor or install from GitHub (needs devtools).


This might also require the development version of arules.


  • Visualizations using base and/or grid.
  • Interactive visualizations using grid.
  • Interactive visualizations with package plotly.
  • Interactive rule inspection with package datatable.

Available Visualizations:

  • Scatterplot, two-key plot
  • Matrix and matrix 3D visualization
  • Grouped matrix-based visualization
  • Several graph-based visualizations
  • Doubledecker and mosaic plots
  • Parallel Coordinate plot


Mine some rules.

rules <- apriori(Groceries, parameter=list(support=0.005, confidence=0.5))

Standard visualization


Scatter plot

Interactive visualization with plotly


Open example output.

Interactive inspect with datatable


Open example output.



arulesViz 1.3-2 (12/04/2018)

Bug Fix

  • ruleExplorer now checks for excessive number of items so shiny does not freeze.
  • plot with method matrix: control option reorder = "similarity" works now again.

arulesViz 1.3-1 (04/23/2018)

New features

  • ruleExplorer: interactive visualization with shiny was added.
  • plot method matrix now supports different reordering methods: 'none', 'measure', 'support/confidence', 'similarity'. The default is measure, the measure used for shading.
  • measure and shading now auto-completes measure names.


  • plotly_arules is deprecated use plot with engine = "plotly" instead

Bug Fix

  • Fixed problem with quality measures (offset of 1) when creating igraph graphs (reported by sostahl).

arulesViz 1.3-0 (09/07/2017)

New features

  • Introduced engine parameter for plot which can be used to create htmlWidgets. Matrices and scatterplots use plotly and graphs are plotted using visNetwork.


  • Some work was done on unifying the interface for plot more resulting in a slightly changed order of parameters.
  • Parameter interactive is now deprecated and will be removed in future releases. Use engine = "interactive" or engine = "htmlWidget" (where available).
  • matrix-based visualization: reordering now tries to order by measure of interestingness. The plot now uses shading instead of measure.
  • method graph does not support type anymore. Only items are now supported as vertices.

Bug Fix

  • Fixed item labels order in reordered parallel coordinates plot (reported by Yvi24).

arulesViz 1.2-1 (03/12/2017)

New features

  • plot method "grouped" now shows the most interesting items instead of the most frequent items to represent antecedents. Also, if more than 10 RHS items are found, then only the 10 most important are shown (see control argument rhs_max).
  • arules_plotly uses now signif instead of round for quality measures.
  • arules_plotly implements now jitter to reduce overplotting (defaults to .1 if overplotting would occur).
  • arules_plotly shows correct rule indices for too large rule sets.
  • scatterplot also defaults jitter to .2 if overplotting would occur.
  • scatterplot now handles Inf with a warning.

arulesViz 1.2-0 (10/02/2016)

  • improved graphical parameters for the grouped matrix plot.
  • default color scheme is now a grey-red ramp.
  • added inspectDT for interactive rules inspection using package DT.
  • added plotly_arules, interactive plots with plotly.

arulesViz 1.1-1 (04/10/2016)

  • plot method ordered now passes control arguments on correctly.

arulesViz 1.1-0 (12/13/2015)

  • abbreviate has been moved to arules.
  • fixed bug in grouped plots when the quality of many rules is identical.
  • plots use now heat colors.
  • scatter plots use now for lift zlim starting at 1.

arulesViz 1.0-4 (09/15/2015)

  • fixed empty LHS problem in grouped plot (reported by Andrew Collier)
  • Updated for arules version 1.2.0

arulesViz 1.0-2 (6/29/2015)

  • fixed imports from non-base standard packages.
  • plot (graph) now honors font family set via par(). (Bug reported by May Yang)
  • igraph: Updated NAMESPACE since igraph introduced functions with names that clash with arules and seriation. Transitioned to igraphs new layout me# Chanism.
  • itemsets: scatterplot is now also defaut for itemsets.

arulesViz 1.0-0 (12/07/2014)

  • Improved LHS annotation for grouped plot

arulesViz 0.1-9 (3/10/2014)

  • Cleaned up dependencies on Rgraphviz

arulesViz 0.1-8 (2/18/2014)

  • Cleaned up dependencies (moved most to imports)

arulesViz 0.1-7 (8/11/2013)

  • plot checks now if 0 rules/itemsets are used
  • scatterplots with a single rule now display correctly
  • transition from igraph0 to igraph

arulesViz 0.1-6 (5/25/2013)

  • plot method matrix does not accept custom colors

arulesViz 0.1-5 (3/02/2012)

  • fixed namespace (imports seriation now)

arulesViz 0.1-4 (11/7/2011)

  • fixed font family for igraph under windows (is now Arial).

arulesViz 0.1-0 (12/17/2010)

  • Initial version.

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


1.5-1 by Michael Hahsler, 2 months ago

Report a bug at

Browse source code at

Authors: Michael Hahsler [aut, cre, cph] , Giallanza Tyler [ctb] , Sudheer Chelluboina [ctb]

Documentation:   PDF Manual  

GPL-3 license

Imports graphics, methods, utils, grDevices, stats, seriation, grid, vcd, igraph, scatterplot3d, ggplot2, ggraph, tibble, tidyr, dplyr, DT, plotly, visNetwork

Depends on arules

Suggests datasets, graph, Rgraphviz, tidygraph, shiny, shinythemes, htmlwidgets

Imported by ASSOCShiny, TELP.

Suggested by arules, rattle.

See at CRAN