GAP (digraphs) - Chapter 2: Installing Digraphs

Goto Chapter: Top 1 2 3 4 5 6 7 8 9 A Bib Ind
[Top of Book] [Contents] [Previous Chapter] [Next Chapter]

[MathJax off]

2 Installing Digraphs
2.1 For those in a hurry
2.2 Optional package dependencies
2.2-1 The Grape package
2.3 Compiling the kernel module
2.4 Rebuilding the documentation
2.4-1 DigraphsMakeDoc
2.5 Testing your installation
2.5-1 DigraphsTestInstall
2.5-2 DigraphsTestStandard

### 2 Installing Digraphs

#### 2.1 For those in a hurry

In this section we give a brief description of how to start using Digraphs.

It is assumed that you have a working copy of GAP with version number 4.8.2 or higher. The most up-to-date version of GAP and instructions on how to install it can be obtained from the main GAP webpage http://www.gap-system.org.

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

- ensure that the IO package version 4.4.4 or higher is available. IO must be compiled before Digraphs can be loaded.

- ensure that the Orb package version 4.7.5 or higher is available. Orb has better performance when compiled, but although compilation is recommended, it is not required to be compiled for Digraphs to be loaded.

- This step is optional: certain functions in Digraphs require the Grape package to be available; see Section 2.2-1 for full details. To use these functions make sure that the Grape package version 4.5 or higher is available. If Grape is not available, then Digraphs can be used as normal with the exception that the functions listed in Subsection 2.2-1 will not work.

- download the package archive `digraphs-0.7.1.tar.gz` from the Digraph package webpage.

- unzip and untar the file, this should create a directory called `digraphs-0.7.1`.

- locate the `pkg` directory of your GAP directory, which contains the directories `lib`, `doc` and so on. Move the directory `digraphs-0.7.1` into the `pkg` directory.

- it is necessary to compile the Digraphs package. Inside the `pkg/digraphs-0.7.1` directory, type

      ./configure
      make

  Further information about this step can be found in Section 2.3.

- start GAP in the usual way (i.e. type `gap` at the command line).

- type `LoadPackage("digraphs");`

If you want to check that the package is working correctly, you should run some of the tests described in Section 2.5.

#### 2.2 Optional package dependencies

The Digraphs package is written in GAP and C code and requires the IO package. The IO package is used to read and write transformations, partial permutations, and bipartitions to a file.

##### 2.2-1 The Grape package

The Grape package must be available for the following operations to be available:

- `Graph` (3.2-3) with a digraph argument

- `AsGraph` (3.2-4) with a digraph argument

- `Digraph` (3.1-5) with a Grape graph argument

If Grape is not available, then Digraphs can be used as normal with the exception that the functions above will not work.

#### 2.3 Compiling the kernel module

The Digraphs package has a GAP kernel component in C which should be compiled. This component contains certain low-level functions required by Digraphs.

It is not possible to use the Digraphs package without compiling it.

To compile the kernel component inside the `pkg/digraphs-0.7.1` directory, type

    ./configure
    make

If you installed the package in another 'pkg' directory than the standard 'pkg' directory in your GAP installation, then you have to do two things. Firstly during compilation you have to use the option '--with-gaproot=PATH' of the 'configure' script where 'PATH' is a path to the main GAP root directory (if not given the default '../..' is assumed).

If you installed GAP on several architectures, you must execute the configure/make step for each of the architectures. You can either do this immediately after configuring and compiling GAP itself on this architecture, or alternatively (when using version 4.5 of GAP or newer) set the environment variable 'CONFIGNAME' to the name of the configuration you used when compiling GAP before running './configure'. Note however that your compiler choice and flags (environment variables 'CC' and 'CFLAGS') need to be chosen to match the setup of the original GAP compilation. For example you have to specify 32-bit or 64-bit mode correctly!

#### 2.4 Rebuilding the documentation

The Digraphs package comes complete with pdf, html, and text versions of the documentation. However, you might find it necessary, at some point, to rebuild the documentation. To rebuild the documentation use the `DigraphsMakeDoc` (2.4-1).

##### 2.4-1 DigraphsMakeDoc

`‣ DigraphsMakeDoc`( ) | ( function )

Returns: Nothing

This function should be called with no argument to compile the Digraphs documentation.

#### 2.5 Testing your installation

In this section we describe how to test that Digraphs is working as intended. To test that Digraphs is installed correctly use `DigraphsTestInstall` (2.5-1) or for more extensive tests use `DigraphsTestStandard` (2.5-2).

If something goes wrong, then please review the instructions in Section 2.1 and ensure that Digraphs has been properly installed. If you continue having problems, please use the issue tracker to report the issues you are having.

##### 2.5-1 DigraphsTestInstall

`‣ DigraphsTestInstall`( ) | ( function )

Returns: `true` or `false`.

This function should be called with no argument to test your installation of Digraphs is working correctly. These tests should take no more than a fraction of a second to complete. To test more comprehensively that Digraphs is working correctly, use `DigraphsTestStandard` (2.5-2).

##### 2.5-2 DigraphsTestStandard

`‣ DigraphsTestStandard`( ) | ( function )

Returns: `true` or `false`.

This function should be called to test all the methods included in Digraphs. These tests should take only a few seconds to complete.

To quickly test that Digraphs is installed correctly use `DigraphsTestInstall` (2.5-1). For a more thorough test, use `DigraphsTestStandard`.

[Top of Book] [Contents] [Previous Chapter] [Next Chapter]
Goto Chapter: Top 1 2 3 4 5 6 7 8 9 A Bib Ind

generated by GAPDoc2HTML