[CARAT] 2 Installation

[Up] [Previous] [Next] [Index]

# 2 Installation

GAP is distributed together with a large number of packages, including this one. Carat is located inside the subdirectory `pkg/carat/` of your GAP installation, and needs to be compiled. If you do not want to build all packages with the script `BuildPackages.sh` from GAP, you can build Carat alone by executing these commands inside the directory `pkg/carat/`:

    ./configure <path-to-GAP-root>
    make

The configure script optionally takes the path to the root directory of your GAP installation as argument. The default `../..` should usually work, but if you have unpacked Carat to a location like `/.gap/pkg/carat/`, you need to explicitly give the path to the GAP root directory as argument. The result of `configure` is written to the file `config.carat`, which can be inspected if something goes wrong.

If GAP was configured to use a specific GMP library, or the GMP library bundled with GAP, then CARAT will try to use that same GMP library. Otherwise, the system GMP library in the default path is chosen. If you want to use another GMP library, you may add an argument `--with-gmp=path-to-gmp` to the above configure command, where the directory `path-to-gmp` must contain subdirectories `lib/` and `include/` with the GMP library and include files, respectively.

If you want or need to add further compile or link flags, you may prepend `CFLAGS="your flags"` to the configure command, or append it to the make command (one of these is enough), so that the complete build commands including all options are these:

     [CFLAGS="<your flags>"] ./configure [<path-to-GAP-root>] [--with-gmp=<path-to-gmp>]
     make [CFLAGS="<your flags>"]

As CARAT's catalog of Q-classes of unimodular groups is rather large, it is unpacked by default only up to dimension 5. If you also want to unpack the data for dimension 6, you can do this with the extra command (again inside directory `pkg/carat/`)

    make qcat6

This adds another 150 Mb of data to the installation.

[Up] [Previous] [Next] [Index]