<html><head><title>[ACE] 2 Installing and Loading the ACE Package</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 Installing and Loading the ACE Package</h1><p>
<P>
<H3>Sections</H3>
<oL>
<li> <A HREF="CHAP002.htm#SECT001">Installing the ACE Package</a>
<li> <A HREF="CHAP002.htm#SECT002">Loading the ACE Package</a>
</ol><p>
<p>
<p>
<h2><a name="SECT001">2.1 Installing the ACE Package</a></h2>
<p><p>
To install, unpack the archive file, which should have a name of form
<code>ace-</code><var>XXX</var><code>.tar.gz</code> for some package version number <var>XXX</var>, as a
sub-directory in the <code>pkg</code> hierarchy of your version of <font face="Gill Sans,Helvetica,Arial">GAP</font> 4. This
might be the <code>pkg</code> directory of the <font face="Gill Sans,Helvetica,Arial">GAP</font> 4 home directory; it is
however also possible to keep an additional <code>pkg</code> directory in your
private directories. The only essential difference with installing
<font face="Gill Sans,Helvetica,Arial">ACE</font> in a <code>pkg</code> directory different to the <font face="Gill Sans,Helvetica,Arial">GAP</font> 4 home directory
is that one must start <font face="Gill Sans,Helvetica,Arial">GAP</font> with the <code>-l</code> switch (see Section <a href="../../../doc/ref/chap3.html#X782751D5858A6EAF">Command Line Options</a>), e.g. if your private <code>pkg</code>
directory is a subdirectory of <code>mygap</code> in your home directory you
might type:
<p>
<code>gap -l ";myhomedir/mygap"</code>
<p>
where <var>myhomedir</var> is the path to your home directory, which may be
replaced by a tilde. The empty path before the semicolon is filled in
by the default path of the <font face="Gill Sans,Helvetica,Arial">GAP</font> 4 home directory.
<p>
After unpacking the archive, go to the newly created <code>ace</code> directory
and call <code>./configure </code><var>path</var><code></code> where <var>path</var> is the path to the <font face="Gill Sans,Helvetica,Arial">GAP</font>
home directory. So for example if you install the package in the main
<code>pkg</code> directory call
<p>
<pre>
./configure ../..
</pre>
<p>
This will fetch the architecture type for which <font face="Gill Sans,Helvetica,Arial">GAP</font> has been
compiled last and create a <code>Makefile</code>. Now simply call
<p>
<pre>
make
</pre>
<p>
to compile the binary and to install it in the appropriate place.
<p>
Note that the current version of the configuration process only sets
up directory paths. If you need a different compiler or different
compiler options, you need to edit <code>src/Makefile.in</code> yourself, prior
to calling <code>make</code>.
<p>
If you use this installation of <font face="Gill Sans,Helvetica,Arial">GAP</font> on different hardware platforms
you will have to compile the binary for each platform separately. This
is done by calling <code>configure</code>, editing <code>src/Makefile.in</code> possibly,
and calling <code>make</code> for the package anew immediately after compiling
<font face="Gill Sans,Helvetica,Arial">GAP</font> itself for the respective architecture. If your version of
<font face="Gill Sans,Helvetica,Arial">GAP</font> is already compiled (and has last been compiled on the same
architecture) you do not need to compile <font face="Gill Sans,Helvetica,Arial">GAP</font> again, it is
sufficient to call the <code>configure</code> script in the <font face="Gill Sans,Helvetica,Arial">GAP</font> home
directory.
<p>
The manual you are currently reading describes how to use the <font face="Gill Sans,Helvetica,Arial">ACE</font>
Package; it can be found in the <code>doc</code> subdirectory of the package.
<p>
The subdirectory <code>standalone-doc</code> contains the file <code>ace3001.ps</code> which
holds a version of the user manual for the <font face="Gill Sans,Helvetica,Arial">ACE</font> standalone; it forms
part of <a href="biblio.htm#Ram99ace"><cite>Ram99ace</cite></a>). You should consult it if you are going to
switch to the <font face="Gill Sans,Helvetica,Arial">ACE</font> standalone, e.g. in order to directly use
interactive facilities.
<p>
The <code>src</code> subdirectory contains a copy of the original source of
<font face="Gill Sans,Helvetica,Arial">ACE</font>. (The only modification is that a file <code>Makefile.in</code> was
obtained from the different <code>make.xyz</code> and will be used to create a
<code>Makefile</code>.) You can replace the source by a newer version before
compiling.
<p>
If you encounter problems in installation please read the file <code>README.md</code>.
<p>
<p>
<h2><a name="SECT002">2.2 Loading the ACE Package</a></h2>
<p><p>
To use the <font face="Gill Sans,Helvetica,Arial">ACE</font> Package you have to request it explicitly.
This is done by calling
<p>
<pre>
gap> LoadPackage("ace");
---------------------------------------------------------------------------
Loading ACE (Advanced Coset Enumerator) 5.4
GAP code by Greg Gamble <Greg.Gamble@uwa.edu.au> (address for correspondence)
Alexander Hulpke (https://www.math.colostate.edu/~hulpke)
[uses ACE binary (C code program) version: 3.001]
C code by George Havas (http://staff.itee.uq.edu.au/havas)
Colin Ramsay <cram@itee.uq.edu.au>
Co-maintainer: Max Horn <mhorn@rptu.de>
For help, type: ?ACE
---------------------------------------------------------------------------
true
</pre>
<p>
<a name = "I0"></a>
The banner may be suppressed by providing <code>false</code> as second argument
to the <code>LoadPackage</code> command. The <code>LoadPackage</code> command is described in Section <a href="../../../doc/ref/chap76.html#X79B373A77B29D1F5">LoadPackage</a> in the <font face="Gill Sans,Helvetica,Arial">GAP</font> Reference Manual.
<p>
If <font face="Gill Sans,Helvetica,Arial">GAP</font> cannot find a working binary, the call to <code>LoadPackage</code> will
fail.
<p>
If you want to load the <font face="Gill Sans,Helvetica,Arial">ACE</font> package by default, you can put
the <code>LoadPackage</code> command into your <code>gaprc</code> (or <code>.gaprc</code> file) (see Section <a href="../../../doc/ref/chap3.html#X7FD66F977A3B02DF">The gap.ini and gaprc files</a> in the <font face="Gill Sans,Helvetica,Arial">GAP</font> Reference Manual).
<p>
<p>
[<a href = "chapters.htm">Up</a>] [<a href ="CHAP001.htm">Previous</a>] [<a href ="CHAP003.htm">Next</a>] [<a href = "theindex.htm">Index</a>]
<P>
<address>ACE manual<br>April 2025
</address></body></html>
¤ Dauer der Verarbeitung: 0.11 Sekunden
(vorverarbeitet)
¤
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung ist noch experimentell.