Creating diagrams via the DiagrammeR package

The ggplot package greatly enhances R's plotting capabilities, but in some situations, this is not sufficient. In situations whenever we want to plot relationships between entities or elements, we need a different tool. Diagrams are well suited for this, but drawing them manually is very hard (since we need to draw each square or circle, plus the text, plus the relationships between the elements).

The DiagrammeR package allows us to create powerful diagrams, supporting the Graphviz syntax. Using it is actually simple. We will essentially define nodes, and we will then tell DiagrammeR how we want to connect those nodes. Of course, we can control the format of those diagrams (color, shapes, arrow types, themes, and so on).

Getting ready

In order to run this example, you need to install the DiagrammeR package using install.packages("DiagrammeR").

How to do it...

In this recipe, we will draw a diagram depicting a company structure. The company is split into three groups, and within each group we will draw the sales in blue and the market share in green.

1. Import the library:

library('DiagrammeR')

2. We define the diagram using Graphviz's dot syntax. Essentially, it needs three parts—the graph part controls the global elements of the diagram, the node part defines the nodes, and the edge part defines the edges:

grViz("
digraph dot {
 
 graph [layout = dot]
 
 node [shape = circle,
 style = filled,
 color = grey,
 label = '']
 
 node [fillcolor = white,fixedsize = true, width = 2]
 a[label = 'Company A']
 
 node [fillcolor = white]
 b[label = 'IT+RD Consulting'] c[label = 'General Consulting'] d[label = 'Other Activities']
 
 node [fillcolor = white]
 
 edge [color = grey]
 a -> {b c d}
 b -> {e[label = '254';color=blue] f[label = '83%';color=green]}
 c -> {k[label = '132';color=blue] l[label = '61%';color=green]}
 d -> {q[label = '192';color=blue] r[label = '47%';color=green]}
 }")

How it works...

Inside our diagram, we define two main objects, nodes and edges. We define two nodes, and we define multiple edges that specify how everything will be connected. For each element, we can define the label that will be shown, and the color. The label and color arguments are used to specify the text and color that will be displayed for each node.

We use the fixedsize and the width parameters to force the elements in the corresponding node to have the same size. Had we not, then the circles for those nodes would be of different sizes.

The grViz() function is used to build the Graphviz diagram, as shown in the following screenshot:

See also

The DiagrammeR package's homepage can be found at http://rich-iannone.github.io/DiagrammeR/.