Installation of the ANU NQ is done in two steps.
First the configure script is run:
./configure
If you installed the package in a
directory other than the standard pkg
directory in your GAP 4 installation, then you have to do two things. First, you have to use the option pkg--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). That is, run../..
./configure --with-gaproot=PATH
Second, you have to tell GAP where to find your
directory, otherwise GAP does not find the package. With GAP 4.15 or later, start GAP with the command line option pkg--packagedirs DIR, where DIR
is your
directory. With older versions, use pkg-l "ROOT;", where ROOT
is the directory containing your
directory; the trailing semicolon prepends it to the list of GAP root directories. You can add this option to your GAP startup script.pkg
Another issue that can occur when running configure is that it may fail to locate the GNU multiple precision library (GMP [GMP]) which ANU NQ requires to work. This library is also used by GAP and hence normally should be available on your system anyway. But if this is not the case for some reason, it has to be installed first. A copy of GMP can be obtained from https://gmplib.org/.
In order for the configure script to find your copy of GMP, you may have to tell it where to find it via --with-gmp=PATH, where PATH
is the path where GMP was installed:
./configure --with-gmp=PATH
If necessary, you may combine --with-gmp and --with-gaproot.
If configure reports no problems, the next step is to start the compilation:
make
A compiled version of the program named nq is then placed into the directory bin/<complicated name>. The <complicated name> component encodes the operating system and the compiler used. This allows you to compile NQ on several architectures sharing the same file system.
If there are any warnings or even fatal error messages during the compilation process, please submit a bug report about that following the instructions in Section 5.4.
After the compilation is finished you can check if the ANU NQ is running properly on your system. Simply type
make test
This runs some computations and compares their output with the output files in the directory examples. If any errors are reported, please follow the instructions below.
If you encounter problems with any of the above steps, please do not hesitate to contact us about this. You can either use the nq issue tracker or contact the GAP support group via support@gap-system.org. Please make sure to include information about the specific issue you encountered (e.g. steps to reproduce it, the specific error message), your operating system, the compiler you used and also the versions of GAP and this package that were involved.
generated by GAPDoc2HTML