Function Repository Resource:

HypergraphPlot

Source Notebook

Plot a hypergraph defined by a list of hyperedges

Contributed by: Jaebum Jung

ResourceFunction["HypergraphPlot"][{{v_i₁,v_i₂,…},…}]

generates a plot of the hypergraph with hyperedges {{v_i₁,v_i₂,…},…}.

Details and Options

Hyperedges can be any expression.

The following options are supported:

"BaseLayout"

"SpringEmbedding"

how to lay out vertices

"SubsetBoundary"

whether to draw the boundary of subsets

"SubsetBoundaryScale"

2

scale factor of the subset boundary size

"SubsetBoundaryStyle"

styles for subsets

"SubsetEdge"

whether to draw edges connecting vertices in subsets

"SubsetEdgeStyle"

styles for subset edges

“NameLabeled"

overall theme for vertices

VertexCoordinates

center coordinates for vertices

labels and placements for vertices

VertexLabelStyle

style to use for vertex labels

VertexShapeFunction

generate graphic shapes for vertices

0.15

size of vertices

styles for vertices

Examples

Basic Examples (1)

Draw a hypergraph:

In[1]:=

Out[1]=

Scope (2)

Draw a hypergraph without edges connecting subsets:

In[2]:=

ResourceFunction[
"HypergraphPlot"][{{1, 2, 3}, {2, 3, 5, 8}, {5, 7, 8}}, "SubsetBoundaryStyle" -> (Directive[Opacity[.5], EdgeForm[Black], #] & /@ ColorData[35, "ColorList"][[{2, 5, 10}]]), "SubsetBoundaryScale" -> {1.8, 2.5, 3}, "SubsetEdge" -> False]

Out[2]=

Draw a hypergraph with different vertex styles:

In[3]:=

ResourceFunction["HypergraphPlot"][{{1, 2, 3}, {2, 3, 5}, {5, 7, 8}}, "SubsetBoundaryStyle" -> (Directive[Opacity[.5], EdgeForm[Black], #] & /@ ColorData[35, "ColorList"][[{2, 5, 10}]]), "SubsetBoundaryScale" -> {8, 10, 11}, "SubsetEdge" -> False, PlotTheme -> "Detailed", VertexSize -> .05, VertexStyle -> Black]

Out[3]=

Options (18)

BaseLayout (2)

The default base layout is "SpringEmbedding":

In[4]:=

Out[4]=

Use "RadialEmbedding":

In[5]:=

Out[5]=

SubsetBoundary (3)

The default subset boundary is Automatic:

In[6]:=

Out[6]=

Use False to not show subset boundaries:

In[7]:=

Out[7]=

Alternate between True and False:

In[8]:=

Out[8]=

SubsetBoundaryScale (3)

The default subset boundary scale factor is 2:

In[9]:=

Out[9]=

Increase the scale factor to 3:

In[10]:=

Out[10]=

Alternate between 3 and 5:

In[11]:=

Out[11]=

SubsetBoundaryStyle (3)

The default subset boundary style is Automatic:

In[12]:=

Out[12]=

Use black boundary lines:

In[13]:=

Out[13]=

Alternate between red and blue:

In[14]:=

Out[14]=

SubsetEdge (3)

The default subset edge is Automatic:

In[15]:=

Out[15]=

Use False to not show subset edges:

In[16]:=

Out[16]=

Alternate between True and False:

In[17]:=

Out[17]=

SubsetEdgeStyle (3)

The default subset edge style is Automatic:

In[18]:=

Out[18]=

Use black edge lines:

In[19]:=

Out[19]=

Alternate between red and blue:

In[20]:=

Out[20]=

VertexCoordinates (1)

Specify vertex coordinates:

In[21]:=

Out[21]=

Applications (2)

Draw a hypergraph constructed by communities:

In[22]:=

ResourceFunction["HypergraphPlot"][
FindGraphCommunities[
ExampleData[{"NetworkGraph", "DolphinSocialNetwork"}]], VertexShapeFunction -> "Capsule", VertexSize -> 0.2]

Out[22]=

Pick the two most involved members of the terrorist network:

In[23]:=

Out[23]=

In[24]:=

Out[24]=

Generate a hypergraph by members connected to most involved members:

In[25]:=

Out[25]=

Show a hypergraph:

In[26]:=

Out[26]=

Version History

2.1.0 – 12 September 2022
2.0.0 – 09 March 2020
1.0.0 – 15 November 2019

Related Resources

Author Notes

A prior function under this name was moved to the new name SimpleHypergraphPlot.

License Information

This work is licensed under a Creative Commons Attribution 4.0 International License