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

2 Installing Digraphs
 2.1 For those in a hurry
 2.2 Optional package dependencies
 2.3 Compiling the kernel module
 2.4 Rebuilding the documentation
 2.5 Testing your installation

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:

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:

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.10.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