<html><head><title>[CARAT] 2 Installation</title></head>
<body text="#000000" bgcolor="#ffffff">
[<a href = "chapters.htm">Up</a>] [<a href ="CHAP001.htm">Previous</a>] [<a href ="CHAP003.htm">Next</a>] [<a href = "theindex.htm">Index</a>]
<h1>2 Installation</h1>

This package must be installed in the <code>pkg</code> subdirectory of any of
the GAP 4 root directories. We assume here that this is <code>/gap4/pkg</code>.

<pre>
cd /gap4/pkg
tar zpxf carat-2.1.7.tar.gz
</pre>

This creates a subdirectory <code>carat</code>, the home directory of the present
interface package. CARAT itself can be installed anywhere on your 
system. You only have to make sure GAP finds the CARAT binaries, 
by making a symbolic link from the <code>bin</code> subdirectory in <code>pkg/carat</code> to 
the <code>bin</code> subdirectory of CARAT itself. In our example, we install 
CARAT in <code>/gap4/pkg/carat</code> (the CARAT tar file should already be 
there):

<pre>
cd /gap4/pkg/carat
zcat carat-2.1b1.tgz | tar pxf -
ln -s carat-2.1b1/bin bin
cd carat-2.1b1
</pre>

This creates a subdirectory <code>carat-2.1b1</code>, the CARAT top level directory. 
For the compilation of CARAT, you have to set the variable <code>TOPDIR</code> to the 
full path of this new directory, possibly along with new values for <code>CC</code> and 
<code>CFLAGS</code>. You can do this either in the <code>Makefile</code>, or directly on the command 
line:

<pre>
make TOPDIR=`pwd` CFLAGS='-O -std=gnu89' 
chmod -R a+rX .
</pre>

The flag '-std=gnu89' is necessary if you use gcc of version 5 or higher.
If you build for more than one architecture, make sure to do a 
'make clean' in between.

You now have to check which subdirectory containing the CARAT 
binaries has been created in the bin directory. The name of this
subdirectory must be the same as that in the main GAP bin directory,
'/gap4/bin'. If the names differ, you might have to add a symbolic
link to correct this. For instance, if the CARAT bin directory
contains <code>x86_64-pc-linux-gnu</code>, but in the GAP bin directory, you find 
<code>x86_64-pc-linux-gnu-gcc-default32</code>, you would have to do this:

<pre>
cd bin
ln -s x86_64-pc-linux-gnu x86_64-pc-linux-gnu-gcc-default32
ln -s x86_64-pc-linux-gnu x86_64-pc-linux-gnu-gcc-default64
</pre>

You can use one installation of CARAT for both 32bit and 64bit gap.

Like any other GAP 4 package, CARAT is then loaded in GAP with

<pre>
gap&gt; LoadPackage("carat");
true
</pre>

This package, together with CARAT itself, takes some 208Mb of disk space,
or more, depending on the system. Some 170Mb is taken by the catalog
of Q-classes if integer matrix groups up to dimension 6. If you want
to avoid unpacking this catalog, you can create empty subdirectories

<pre>
cd /gap4/pkg/carat/carat-2.1b1
mkdir tables
mkdir tables/qcatalog
</pre>

before making CARAT. If you want to unpack the catalog later, just
remove the empty directory <code>tables/qcatalog</code>, and do

<pre>
make Qcatalog
</pre>


[<a href = "chapters.htm">Up</a>] [<a href ="CHAP001.htm">Previous</a>] [<a href ="CHAP003.htm">Next</a>] [<a href = "theindex.htm">Index</a>]

<address>CARAT manual December 2017
</address></body></html>

Collaborative Calculation and Data Science

colby

sagemath

github

google

cornellcollege

depaul

GAP 4.8.9 installation with standard packages -- copy to your CoCalc project to get it

Product

Resources

Company