= OCamlgraph
OCamlgraph is a graph library for Ocaml. Its contribution is three-fold:
1. It provides an easy-to-use graph implementation together with several
operations and algorithms over graphs, in Graph.Pack.Digraph.
It is a reasonably efficient imperative data structure for directed graphs
with vertices and edges labeled with integers.
+
Have a look at this module first in order to get an overview of what
this library provides. See also `demo.ml`.
2. Then OCamlgraph provides several other graph implementations for those
not satisfied with the one above. Some are persistent (immutable) and other
imperative (mutable). Some are directed and other are not.
Some have labels for vertices, or labels for edges, or both.
Some have abstract types for vertices. etc.
+
See interface Sig for the graph signatures and modules Persistent and
Imperative for the implementations.
+
These implementations are written as functors: you give the types of
vertices labels, edge labels, etc. and you get the data structure as a
result.
3. Finally, OCamlgraph provides several classic operations and algorithms
over graphs. They are also written as functors i.e. independently of the
data structure for graphs. One consequence is that you can define your own
data structure for graphs and yet re-use all the algorithms from this
library -- you only need to provide a few operations such as iterating over
all vertices, over the successors of a vertex, etc.
== How to link with OCamlgraph
You can use the `ocamlgraph` ocamlfind package:
ocamlfind ocamlopt -package ocamlgraph ...
(To produce an executable, also add the `-linkpkg` option.)
If you want to invoke the compiler directly, OCamlgraph is packaged as
a single module `Graph`. Linking is done as follows:
bytecode::
ocamlc graph.cma
native code::
ocamlopt graph.cmxa
== Examples
You'll find examples of OCamlgraph use in subdirectory examples/
(demo.ml, demo_planar.ml, color.ml, etc.). You can compile these
programs with `make examples`. Corresponding binaries are produced in
subdirectory bin/. You can also build them individually, e.g. `make
bin/demo.opt` compiles examples/demo.ml.
== Bug reports
Bug reports can be sent to
Sylvain Conchon
Jean-Christophe Filliatre
Julien Signoles