A LightGraphs.jl compatible graph package for graphs with multiple vertex, edge and graph metadata.



version Stable Dev CI codecov

SimpleValueGraphs is as LightGraphs.jl compatible package for graphs with multiple, homogeneous vertex, edge and graph metadata. In particular it provides:

  • an abstract interface for graphs with metadata
  • concrete implementations of mutable graphs with metadata

Compared to SimpleWeightedGraphs.jl it has the following advantages:

  • vertex and graph metadata
  • multiple edge metadata
  • faster structural modifications of graphs

Compared to MetaGraphs.jl it has the following advantages:

  • faster access and modifications of metadata
  • better type stability when accessing metadata


using SimpleValueGraphs

using LightGraphs: smallgraph
using Plots
using GraphRecipes: graphplot
using Colors: RGB, Color

# Load a LightGraphs.SimpleGraph
gs = smallgraph(:house)

# Convert to a ValGraph with vertex and edge values
gv = ValGraph(gs;
    # Two names vertex values:
    # - color: A random color
    # - label: The vertex identifier as a string
    vertexval_types=(color=Color, label=String),
    vertexval_init=v -> (rand(RGB), string(v)),
    # One unnamed edge value:
    # A string s -- d from source to destination of each edge
    edgeval_types=(String, ),
    edgeval_init=(s, d) -> ("$s -- $d",)

# Plot this graph using the vertex and edge values
    nodecolor = [get_vertexval(gv, v, :color) for v in vertices(gv)],
    names = [get_vertexval(gv, v, :label) for v in vertices(gv)],
    edgelabel=weights(gv; zerovalue="")

example output


This is a comparison of running LightGraphs.dijkstra_shortest_paths on the egonets-Facebook graph for multiple graph types.

graph type time (ms)
LightGraphs.SimpleGraph + Matrix weights 6.5
LightGraphs.SimpleGraph + SparseMatrixCSC weights 11.4
SimpleWeightedGraphs.SimpleWeightedGraph 11.7
MetaGraphs.MetaGraph 141.9
SimpleValueGraphs.ValGraph 12.4

Currently a lot of LightGraphs algorithm do not optimally work with graphs that store edge metadata internally. The next benchmark is an optimized version of the same algorithm that can be found in SimpleValueGraphs.Experimental.dijkstra_shortests_pasts. Clearly, this is a huge improvement for ValGraph and SimpleWeightedGraph.

graph type time (ms)
LightGraphs.SimpleGraph + Matrix weights 6.8
LightGraphs.SimpleGraph + SparseMatrixCSC weights 10.8
SimpleWeightedGraphs.SimpleWeightedGraph 2.9
MetaGraphs.MetaGraph 147.3
SimpleValueGraphs.ValGraph 3.1

First Commit


Last Touched

4 days ago


239 commits

Used By: