1- # README #
2- ## digraphs-lib ##
3- ### Library of digraphs for the Digraphs package of GAP ###
4-
1+ # README for digraphs-lib
52
3+ ### Library of digraphs for the Digraphs package of GAP ###
64
75In this directory is a collection of various types of digraphs, which can be
86loaded into the GAP computational algebra system using the [ Digraphs
9- package] ( http ://www-circa.mcs.st-and.ac.uk/~jamesm/digraphs.php ) . It is a
7+ package] ( https ://gap-packages.github.io/Digraphs ) . It is a
108completely optional addition to the package, which can be used to produce
119examples of digraphs for use in the package.
1210
1311
14-
1512Getting digraphs-lib
1613--------------------
17- The latest version of this library is available at the following link:
14+ The latest version of this library is available at
15+ < http://gap-packages.github.io/Digraphs > .
1816
19- https://bitbucket.org/james-d-mitchell/digraphs/downloads
20-
21- Simply download it and extract the archive into the root directory of your
17+ Simply download the archive, and extract it into the root directory of your
2218Digraphs installation. This should result in a ` digraphs-lib ` directory inside
2319your ` digraphs ` directory.
2420
2521
26-
2722Using digraphs-lib
2823------------------
2924Once the library is installed, simply launch GAP, load the Digraphs package, and
@@ -34,41 +29,40 @@ Here is an example GAP session:
3429
3530```
3631gap> LoadPackage("digraphs", false);;
37- gap> filename := "~/gap/pkg/ digraphs/digraphs -lib/latin.g6.gz";;
32+ gap> filename := Concatenation(DIGRAPHS_Dir(), "/ digraphs-lib/latin.g6.gz") ;;
3833gap> latin_graphs := ReadDigraphs(filename);
39- [ <digraph with 100 vertices, 2700 edges>,
40- <digraph with 121 vertices, 3630 edges>,
41- <digraph with 144 vertices, 4752 edges>,
42- <digraph with 169 vertices, 6084 edges>,
43- <digraph with 196 vertices, 7644 edges>,
44- <digraph with 225 vertices, 9450 edges>,
45- <digraph with 256 vertices, 11520 edges>,
46- <digraph with 289 vertices, 13872 edges>,
47- <digraph with 324 vertices, 16524 edges>,
48- <digraph with 361 vertices, 19494 edges>,
49- <digraph with 4 vertices, 12 edges>,
50- <digraph with 400 vertices, 22800 edges>,
51- <digraph with 441 vertices, 26460 edges>,
52- <digraph with 484 vertices, 30492 edges>,
53- <digraph with 529 vertices, 34914 edges>,
54- <digraph with 576 vertices, 39744 edges>,
55- <digraph with 625 vertices, 45000 edges>,
56- <digraph with 676 vertices, 50700 edges>,
57- <digraph with 729 vertices, 56862 edges>,
58- <digraph with 784 vertices, 63504 edges>,
59- <digraph with 841 vertices, 70644 edges>,
60- <digraph with 9 vertices, 54 edges>,
61- <digraph with 900 vertices, 78300 edges>,
62- <digraph with 16 vertices, 144 edges>,
63- <digraph with 25 vertices, 300 edges>,
64- <digraph with 36 vertices, 540 edges>,
65- <digraph with 49 vertices, 882 edges>,
66- <digraph with 64 vertices, 1344 edges>,
67- <digraph with 81 vertices, 1944 edges> ]
34+ [ <immutable digraph with 100 vertices, 2700 edges>,
35+ <immutable digraph with 121 vertices, 3630 edges>,
36+ <immutable digraph with 144 vertices, 4752 edges>,
37+ <immutable digraph with 169 vertices, 6084 edges>,
38+ <immutable digraph with 196 vertices, 7644 edges>,
39+ <immutable digraph with 225 vertices, 9450 edges>,
40+ <immutable digraph with 256 vertices, 11520 edges>,
41+ <immutable digraph with 289 vertices, 13872 edges>,
42+ <immutable digraph with 324 vertices, 16524 edges>,
43+ <immutable digraph with 361 vertices, 19494 edges>,
44+ <immutable digraph with 4 vertices, 12 edges>,
45+ <immutable digraph with 400 vertices, 22800 edges>,
46+ <immutable digraph with 441 vertices, 26460 edges>,
47+ <immutable digraph with 484 vertices, 30492 edges>,
48+ <immutable digraph with 529 vertices, 34914 edges>,
49+ <immutable digraph with 576 vertices, 39744 edges>,
50+ <immutable digraph with 625 vertices, 45000 edges>,
51+ <immutable digraph with 676 vertices, 50700 edges>,
52+ <immutable digraph with 729 vertices, 56862 edges>,
53+ <immutable digraph with 784 vertices, 63504 edges>,
54+ <immutable digraph with 841 vertices, 70644 edges>,
55+ <immutable digraph with 9 vertices, 54 edges>,
56+ <immutable digraph with 900 vertices, 78300 edges>,
57+ <immutable digraph with 16 vertices, 144 edges>,
58+ <immutable digraph with 25 vertices, 300 edges>,
59+ <immutable digraph with 36 vertices, 540 edges>,
60+ <immutable digraph with 49 vertices, 882 edges>,
61+ <immutable digraph with 64 vertices, 1344 edges>,
62+ <immutable digraph with 81 vertices, 1944 edges> ]
6863```
6964
7065
71-
7266Types of digraph available
7367--------------------------
7468The following files were created by the authors of the Digraphs package:
@@ -84,9 +78,9 @@ The following files were created by the authors of the Digraphs package:
8478 * ` sparse.ds6.gz ` - Sparse graphs (few edges per vertex)
8579 * ` tournament.d6.gz ` - Tournaments
8680
87- The following files contain symmetric graphs taken from the [ nauty and Traces
88- website] ( http://pallini.di.uniroma1.it/Graphs.html ) , by Brendan McKay and Adolfo
89- Piperno:
81+ The following files contain symmetric digraphs (i.e. graphs) taken from the
82+ [ nauty and Traces website] ( http://pallini.di.uniroma1.it/Graphs.html ) , by
83+ Brendan McKay and Adolfo Piperno:
9084
9185 * ` ag.s6.gz ` - Affine geometry graphs
9286 * ` cfi.s6.gz ` - Cai, Fuerer and Immerman graphs
@@ -109,47 +103,52 @@ Piperno:
109103 * ` sts-sw.g6.gz ` - Steiner triple system graphs with switched edges
110104 * ` triang.g6.gz ` - Triangular graphs
111105
112- There are also some additional files containing graphs coming from finite geometry:
113-
114- * ` fining.p.gz ` - contains some graphs comining from finite geometries:
115- (1): vertices are the generators of the hermitian polar space H(5,4), two vertices are adjacent iff they are skew
116- (2): vertices are the generators of the hermitian quadrangle H(4,4), two vertices are adjacent iff they are skew
117- (3): vertices areh the points and lines of the classical generalized quadrangle Q(4,8), two vertics are adjacent iff
118- they are incident (and no loops!). This is a bipartite graph with diameter 4 and undirected girth 8
119- (4): the bipartite graph (see (3)) of an elation generalized quadrangle. This one was constructed as a coset geometry.
120- (5): the bipartite graph of the split Cayley hexagon of order 4, diameter is 6 and girth is 12.
121- (6): the bipartite graph of the Ree-Tits generalized octagon! This one has diameter 8 and girth 16!
106+ There are also some additional files, added by Jan De Beule, which containing
107+ graphs that come from finite geometry, which were
108+
109+ * ` fining.p.gz ` contains some graphs coming from finite geometries:
110+ 1 . The vertices are the generators of the hermitian polar space ` H(5,4) ` ,
111+ two vertices are adjacent iff they are skew.
112+ 2 . The vertices are the generators of the hermitian quadrangle ` H(4,4) ` , two
113+ vertices are adjacent iff they are skew.
114+ 3 . The vertices are the points and lines of the classical generalised
115+ quadrangle ` Q(4,8) ` , two vertices are adjacent iff they are distinct and
116+ incident (no loops!). This is a bipartite graph with diameter 4 and
117+ undirected girth 8.
118+ 4 . The bipartite graph (see (3)) of an elation generalised quadrangle. This
119+ one was constructed as a coset geometry.
120+ 5 . The bipartite graph of the split Cayley hexagon of order 4, the diameter
121+ is 6 and the girth is 12.
122+ 6 . The bipartite graph of the Ree-Tits generalised octagon. This has
123+ diameter 8 and girth 16!
122124
123125 * ` polar_graphs.p.gz ` A polar graph is by definition the point graph of a
124- finite classical polar space. Note that such a geometry is a partial linear
125- space, so not every pair of points is a pair of collinear points. Two
126- points are adjacent iff they differe and they are collinear. The diamter of
127- these graphs is 2, their undirected girth 3, the latter since these spaces
128- contain lines. Reading in this file requires around 4 Gb.
129-
130- * ` dual_polar_graphs.p.gz ` We consider again finite classical polar
131- spaces. Such geometries contain points, lines, etc., up to maximal
132- subspaces, which all have the same projective dimension. The vertices of a
133- dual polar graph are these maximal subspaces, of dimension d say, and they
134- are adjacent iff they differ and meet in a d-1 dimensional projective
135- subspace. Reading in this file requres around 5Gb .
126+ finite classical polar space. Note that such a geometry is a partial linear
127+ space, so not every pair of points is a pair of collinear points. Two points
128+ are adjacent iff they are distinct and collinear. The diameter of these
129+ graphs is 2, their undirected girth 3, the latter since these spaces contain
130+ lines. Reading in this file requires around 4 Gb of memory .
131+
132+ * ` dual_polar_graphs.p.gz ` We consider again finite classical polar spaces.
133+ Such geometries contain points, lines, etc., up to maximal subspaces, which
134+ all have the same projective dimension. The vertices of a dual polar graph
135+ are these maximal subspaces, of dimension, say, ` d ` , and they are adjacent
136+ iff they are distinct and meet in a ` d-1 ` dimensional projective subspace.
137+ Reading in this file requires around 5 Gb of memory .
136138
137- * ` generators_graphs.p.gz ` (parts 1, 2 and 3). We consider again finite
138- classical polar spaces. The vertices are the maximal subspaces and they
139- are adjacent iff they differ and are skew. Reading part 2 requires almost
140- 6Gb, reading part 3 requires again 6Gb . Reading part 1 requires much less
141- ( around 1.5Gb) .
139+ * ` generators_graphs.p.gz ` (Parts 1, 2, and 3). We again consider finite
140+ classical polar spaces. The vertices are the maximal subspaces and they are
141+ adjacent iff they are distinct and skew. Reading part 2 requires almost 6 Gb
142+ of memory, and reading part 3 requires another 6 Gb . Reading part 1 requires
143+ much less memory, around 1.5 Gb .
142144
143- * ` incidence_graphs.p.gz ` a generalized polygon of gonality n is a point line
144- geometry, such that if one considers the incidence graph, i.e. the
145- vertices are the points and the lines, adjacency is incidence (withouth
146- loops), then it has diameter n and girth 2n. All graphs in this repository
147- are incidence graphs of generalized polygons. Note that by a famous
148- theorem, thick GPs (i.e. at least three points on a line and dually, at
149- least three lines on a point), have gonality 3,4,6 or 8. The repository
150- contains the incidence graph of the smallest generalized octogon, some
151- generalized hexagons, and a lot of generalized quadrangles, and some
152- projective planes. To read it completely, around 1.5Gb is requiered.
153-
154-
155- which were added by Jan De Beule.
145+ * ` incidence_graphs.p.gz ` A generalised polygon of gonality n is a point line
146+ geometry, such that if one considers the incidence graph, i.e. the vertices
147+ are the points and adjacency is incidence (without loops), then it has
148+ diameter n and girth 2n. All graphs in this file are incidence graphs of
149+ generalised polygons. Note that by a famous theorem, thick GPs (i.e. at
150+ least three points on a line and dually, at least three lines on a point),
151+ have gonality 3, 4, 6, or 8. This file contains the incidence graph of the
152+ smallest generalised octogon, some generalised hexagons, and a lot of
153+ generalised quadrangles, and some projective planes. To read it completely,
154+ around 1.5 Gb of memory is required.
0 commit comments