README.md
1[](https://travis-ci.org/gap-packages/groupoids)
2[](https://codecov.io/gh/gap-packages/groupoids)
3
4# The GAP 4 package 'groupoids'
5
6## Introduction
7
8This package allows for the computation of finite groupoids: both connected, and with several components. Graphs of groups and graphs of groupoids are also constructed, allowing the calculation of normal forms for Free Products with Amalgamation and for HNN extensions when the initial groups have rewriting systems. This package was, until very recently, named Gpd.
9
10## History
11
12 * Version 1.001 was called 'GraphGpd', and formed part of Emma Moore's PhD thesis in December 2000.
13 * Version 1.002 was prepared for the GAP 4.4 release in January 2004, and deposited in the incoming directory on the St Andrews ftp server.
14 * In the spring of 2006 the package was renamed 'Gpd' and extensively rewritten, with documentation in GAPDoc format.
15 * Version 1.01 was deposited in June 2006.
16 * Gpd became an accepted GAP package in May 2015.
17(In the latest temporary versions there have been a number of changes of function name, such as IsDigraph becoming GpdIsDigraph.
18This is in order to avoid conflicts with the new Digraphs package.
19Further changes will be made once the Digraphs package becomes part of the GAP distribution.)
20 * In April 2017 the package was renamed again as 'groupoids', version 1.51.
21A more detailed history is included as Chapter 8 of the manual, and in the file `CHANGES.md`.
22
23## Distribution
24------------
25 * The 'groupoids' package is distributed with the accepted GAP packages: see
26 <http://www.gap-system.org/Packages/groupoids.html>
27 * It may also be obtained from the GitHub repository at:
28 <https://gap-packages.github.io/groupoids/>
29
30## Copyright
31
32The groupoids package is Copyright {\copyright} Chris Wensley and Emma Moore, 2000-2017.
33
34'groupoids' is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
35
36For details, see: <http://www.gnu.org/licenses/gpl.html>
37
38## Installation
39
40 * unpack `groupoids-<version_number>.tar.gz' in the `pkg` subdirectory of the GAP root directory.
41 * From within GAP load the package with:
42
43 gap> LoadPackage("groupoids");
44
45 true
46
47 * The documentation is in the `doc` subdirectory.
48 * To run the test file read `testall.g` from the `groupoids/tst/` directory.
49
50Contact
51-------
52If you have a question relating to groupoids, encounter any problems, or have a suggestion for extending the package in any way, please
53 * email c.d.wensley@bangor.ac.uk
54 * or report an issue at https://github.com/gap-packages/groupoids/issues/new
55
56
){kind=link}
){kind=link}