Skip to content

Commit 95e8478

Browse files
committed
Update package for v1.1.0 release
1 parent ea52144 commit 95e8478

File tree

5 files changed

+33
-31
lines changed

5 files changed

+33
-31
lines changed

.VERSION

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
1.0.3
1+
1.1.0

CHANGELOG.md

Lines changed: 24 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -4,55 +4,56 @@ Torpey, Wilf A. Wilson et al.
44

55
Licensing information can be found in the `LICENSE` file.
66

7-
## Version 1.1.0 (released ??/01/2020)
7+
## Version 1.1.0 (released 25/01/2020)
88

99
This is a minor release that includes some new features and some performance
10-
improvements.
10+
improvements.
1111

12-
The following issues were resolve, pull requests merged, or new features added:
12+
The following issues were resolved, pull requests merged, or new features added:
1313

1414
* [Issue #40](https://github.com/gap-packages/Digraphs/issues/40): If [bliss][]
1515
is used to compute the automorphism group of a digraph, then the size of the
16-
automorphism group is returned from [bliss][] to GAP and the group object in
17-
GAP does not have to recalculate this size. This was reported and fixed (in
16+
automorphism group is returned from [bliss][] to GAP, and the group object in
17+
GAP immediately knows its size. In particular, it is not necessary to
18+
recalculate this size. This was reported and fixed in
1819
[PR #278](https://github.com/gap-packages/Digraphs/pull/278) by
1920
[Chris Jefferson][].
2021

2122
* [Issue #279](https://github.com/gap-packages/Digraphs/issues/279):
22-
In the function `HomomorphismDigraphsFinder` it is now possible to specify a
23-
subgroup of the automorphism group of the range digraph. This way the
23+
In the function `HomomorphismDigraphsFinder`, it is now possible to specify a
24+
subgroup of the automorphism group of the range digraph. This way, the
2425
automorphism group of the range digraph is not computed by
2526
`HomomorphismDigraphsFinder`. This can result in a performance improvement
26-
in some cases. This was reported and fixed (in
27-
[PR #285](https://github.com/gap-packages/Digraphs/pull/285) by
28-
[Finn Smith][].
27+
in some cases. This was reported and fixed in
28+
[PR #285](https://github.com/gap-packages/Digraphs/pull/285) by
29+
Finn Smith.
2930

30-
* [Issue #284](https://github.com/gap-packages/Digraphs/issues/284):
31+
* [Issue #284](https://github.com/gap-packages/Digraphs/issues/284):
3132
The function `HomomorphismDigraphsFinder` sometimes did not return any
32-
homomorphisms when the source digraph had exactly 1 vertex. This was caused
33+
homomorphisms when the source digraph had exactly one vertex. This was caused
3334
by the data structures used by `HomomorphismDigraphsFinder` not being
34-
correctly initialised in this case. This issue was reported by [Finn Smith][]
35+
correctly initialised in this case. This issue was reported by Finn Smith
3536
and fixed by [James D. Mitchell][] in
3637
[PR #286](https://github.com/gap-packages/Digraphs/pull/286).
3738

38-
* In [PR #283](https://github.com/gap-packages/Digraphs/pull/283), [Finn Smith][]
39-
added the new operation `DigraphsRespectsColouring` which can be used to
40-
check if a transformation or permutation between digraphs respects given
39+
* In [PR #283](https://github.com/gap-packages/Digraphs/pull/283), Finn Smith
40+
added the new operation `DigraphsRespectsColouring`, which can be used to
41+
check whether a transformation or permutation between digraphs respects given
4142
colourings. New versions of `IsDigraphHomomorphism`, and friends, were added
4243
that accept colourings as arguments and which use
4344
`DigraphsRespectsColouring`.
4445

4546
* The version of [bliss][] included in Digraphs was updated to allow all of its
4647
data structures to be modified in-place rather than allocated and deallocated
4748
repeatedly. The function `HomomorphismDigraphsFinder` was modified to make
48-
use of this new functionality in [bliss][] and subsequently the performance
49-
of `HomomorphismDigraphsFinder` has been improved (in particular, in cases
49+
use of this new functionality in [bliss][], and subsequently the performance
50+
of `HomomorphismDigraphsFinder` has been improved (particularly in cases
5051
where many homomorphisms between distinct small digraphs are found). This
5152
was done by [James D. Mitchell][] in
5253
[PR #282](https://github.com/gap-packages/Digraphs/pull/282).
5354

54-
* Some further minor performance improvements were made and a compiler warning
55-
was fixed.
55+
* Some further minor performance improvements were made, and a compiler warning
56+
was fixed.
5657

5758
## Version 1.0.3 (released 29/11/2019)
5859

@@ -578,14 +579,14 @@ Smith as an author.
578579

579580
This release contains a new technique for encoding a vertex-coloured digraph as a vertex-coloured (undirected) graph while preserving the automorphism group, in order to calculate the automorphism group using bliss. These changes were made by Finn Smith. The previous technique involved adding two intermediate vertices for every edge; on a digraph with `n` vertices this could add `2n(n-1)` new vertices. The new technique encodes a digraph with `n` vertices as a graph with `3n` vertices. In certain cases, this can lead to a dramatic improvement in the time taken to calculate the automorphism group.
580581

581-
The new reduction is based on two techniques in:
582+
The new reduction is based on two techniques in:
582583

583584
> David Bremner, Mathieu Dutour Sikiric, Dmitrii V. Pasechnik, Thomas Rehn, Achill Schürmann. Computing symmetry groups of polyhedra. https://arxiv.org/abs/1210.0206v3
584585
585586
Namely, "Dealing with digraphs" followed by "Reduction by superposition". From the graph obtained by these techniques, `n` vertices which are irrelevant to automorphism finding are removed.
586587

587-
The actual reduction used is as follows: Given a digraph `D=(V=[]1 .. n],E,c)`, create three copies `V1`, `V2`, `V3` of the vertex set `V`. Colour `V1` according to the colouring `c` of `D`, and `V2`, `V3` with two distinct colours that do not occur in `D`. Connect each vertex in `V1` to the corresponding vertices in `V2`, `V3`. For every arc `(x,y)` in `E`, put an edge between the copy of `x` in `V2`, and the copy of `y` in `V3`. Automorphisms of this graph, when restricted to `V`, are precisely the automorphisms of `D`.
588-
Because this changes the graph used to calculate automorphisms, the results sometimes nominally differ from the previous version - especially in the case of canonical labelling, where unrecognisably different results may appear. Generators also often appear in different orders.
588+
The actual reduction used is as follows: Given a digraph `D=(V=[]1 .. n],E,c)`, create three copies `V1`, `V2`, `V3` of the vertex set `V`. Colour `V1` according to the colouring `c` of `D`, and `V2`, `V3` with two distinct colours that do not occur in `D`. Connect each vertex in `V1` to the corresponding vertices in `V2`, `V3`. For every arc `(x,y)` in `E`, put an edge between the copy of `x` in `V2`, and the copy of `y` in `V3`. Automorphisms of this graph, when restricted to `V`, are precisely the automorphisms of `D`.
589+
Because this changes the graph used to calculate automorphisms, the results sometimes nominally differ from the previous version - especially in the case of canonical labelling, where unrecognisably different results may appear. Generators also often appear in different orders.
589590

590591
The performance improvements are most noticeable on large, quite dense digraphs. On random digraphs with 5000 vertices and 0.5 edge probability, 200-400x speedups were common. When calculating the automorphism group of the complete digraph on 1000 vertices, with vertex `i` having colour `i mod 2 + 1`, we obtain a 66x speedup. When the vertex `i` is assigned colour `i mod 7 + 1`, this becomes a 400x speedup.
591592

PackageInfo.g

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,13 +9,13 @@
99
##
1010

1111
## <#GAPDoc Label="PKGVERSIONDATA">
12-
## <!ENTITY VERSION "1.0.3">
12+
## <!ENTITY VERSION "1.1.0">
1313
## <!ENTITY GAPVERS "4.9.0">
1414
## <!ENTITY GRAPEVERS "4.8.1">
1515
## <!ENTITY IOVERS "4.5.1">
1616
## <!ENTITY ORBVERS "4.8.2">
17-
## <!ENTITY ARCHIVENAME "digraphs-1.0.3">
18-
## <!ENTITY COPYRIGHTYEARS "2014-19">
17+
## <!ENTITY ARCHIVENAME "digraphs-1.1.0">
18+
## <!ENTITY COPYRIGHTYEARS "2014-20">
1919
## <#/GAPDoc>
2020

2121
_STANDREWSMATHS := Concatenation(["Mathematical Institute, North Haugh, ",
@@ -26,8 +26,8 @@ _STANDREWSCS := Concatenation(["Jack Cole Building, North Haugh, ",
2626
SetPackageInfo(rec(
2727
PackageName := "Digraphs",
2828
Subtitle := "Graphs, digraphs, and multidigraphs in GAP",
29-
Version := "1.0.4dev",
30-
Date := "29/11/2019", # dd/mm/yyyy format
29+
Version := "1.1.0",
30+
Date := "25/01/2020", # dd/mm/yyyy format
3131
License := "GPL-3.0-or-later",
3232
ArchiveFormats := ".tar.gz",
3333

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77

88
### Digraphs package for GAP
99

10-
#### Copyright (C) 2014-19 by Jan De Beule, Julius Jonušas, James D. Mitchell, Michael Torpey, Wilf A. Wilson et al.
10+
#### Copyright (C) 2014-20 by Jan De Beule, Julius Jonušas, James D. Mitchell, Michael Torpey, Wilf A. Wilson et al.
1111
## Getting Digraphs
1212

1313
To get the latest version of the package, download the archive file

VERSIONS

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,14 @@
11
#############################################################################
22
##
33
#W VERSIONS
4-
#Y Copyright (C) 2015-19 James D. Mitchell
4+
#Y Copyright (C) 2015-20 James D. Mitchell
55
##
66
## Licensing information can be found in the README.md file of this package.
77
##
88
#############################################################################
99
##
1010

11+
release 1.1.0 - 25/01/2020
1112
release 1.0.3 - 29/11/2019
1213
release 1.0.2 - 28/11/2019
1314
release 1.0.1 - 05/10/2019

0 commit comments

Comments
 (0)