README - Semigroups package for GAP

Copyright (C) 2011-18 James D. Mitchell et al.
Licensing information is available in the LICENSE file.

Getting Semigroups

To get the latest version of the package download the archive file semigroups-x.x.x.tar.gz from the Semigroups webpage, and inside the pkg subdirectory of your GAP installation unpack semigroups-x.x.x.tar.gz, by, for example, doing:

gunzip semigroups-x.x.x.tar.gz; tar xvf semigroups-x.x.x.tar

This will create a subdirectory semigroups-x.x.x.

Issues

For questions, remarks, suggestions, and issues please use the issue tracker.

Installation

It is assumed that you have a working copy of GAP with version number 4.9.0 or higher. The most up-to-date version of GAP and instructions on how to install it can be obtained from the main GAP page.

The following is a summary of the steps that should lead to a successful installation of Semigroups:

• get the IO package version 4.5.1 or higher

• get the Orb package version 4.8.0 or higher. Both Orb and Semigroups perform better if Orb is compiled, so compile Orb!

• ensure that the Digraphs package version 0.12.0 or higher is available. Digraphs must be compiled before Semigroups can be loaded.

• get the genss package version 1.6.5 or higher

• download the package archive semigroups-x.x.x.tar.gz from the Semigroups webpage.

• unzip and untar the file semigroups-x.x.x.tar.gz, for example, using

  gunzip semigroups-x.x.x.tar.gz; tar xvf semigroups-x.x.x.tar
  

  this should create a directory called semigroups-x.x.x.

• locate the pkg directory of your GAP directory, which contains the directories lib, doc and so on. Move the directory semigroups-x.x.x into the pkg directory.

• from version 3.0.0, it is necessary to compile the Semigroups package. Semigroups uses the libsemigroups C++ library, which requires a compiler implementing the C++11 standard. To compile, inside the pkg/semigroups-x.x.x directory, type

  • ./configure
  • make

  If you are using GCC to compile Semigroups, then version 5.0 or higher is required. Trying to compile Semigroups with an earlier version of GCC will result in an error at compile time. Semigroups supports GCC version 5.0 or higher, and clang version 5.0 or higher.

  Further information about this step can be found in manual section entitled "Compiling the kernel module"

• start GAP in the usual way.

• type LoadPackage("semigroups");

Enjoy!