Introduction
Introduction to the &HAPprime; package

&HAPprime; is a package for the &GAP; computer algebra system (http://www.gap-system.org/), and which extends the &HAP; `Homological Algebra Progamming' package written by Graham Ellis (http://hamilton.nuigalway.ie/Hap/www/). It provides algorithms and data structures for calculating resolutions of small prime-power groups. The &HAPprime; functions use significantly less memory than the equivalent function in &HAP;, allowing resolutions (and cohomology ring presentations) of larger groups to be calculated (see Section ).

Earlier versions of &HAPprime; also included functions to compute polynomial ring presentations of cohomology rings, and to ensure that these rings are complete and correct. These functions have now been moved into the &HAP; package and are documented as part of that package (see for example and ).
Required software

The &HAPprime; package requires &GAP; version 4.4 or greater and &HAP; version 1.9.3 or greater.
Installing &HAPprime;

To install the &HAPprime; Package, unpack the archive file into your &GAP; packages directory (either usually the pkg directory of your &GAP; 4 installation if you have access to it, or some local pkg directory that &GAP; can find). The &HAPprime; files will all be installed in a subdirectory called happrime.
Loading and testing &HAPprime;

The &HAPprime; package is not loaded by default when &GAP; is started. To load the package, type the following at the &GAP; prompt: gap> LoadPackage( "HAPprime");

If &HAPprime; isn't already in memory, it is loaded and the author information is displayed. If you are a frequent user of &HAPprime;, you might consider putting this line in your .gaprc file, or using the PackagesToLoad option in your gap.ini file.

The correct installation of &HAPprime; can be tested by using the test routine tst/testall.g: gap> ReadPackage("HAPprime", "tst/testall.g"); + HAPprime version <#Include SYSTEM "../../VERSION"> general tests + GAP4stones: 371057 + HAPprime version <#Include SYSTEM "../../VERSION"> userguide examples + GAP4stones: 387662 + HAPprime version <#Include SYSTEM "../../VERSION"> datatypes reference manual examples + GAP4stones: 382653 true The number of GAP4stones will vary depending on your machine, but any additional lines of messages indicate problems with your installation.

The test routine calls a set of test files which can be found in the tst directory of the &HAPprime; installation. All of the routines listed in this user guide are tested, as are many of those in the datatype reference manual.
Documentation

The documentation for &HAPprime; is in two parts. This document is the user guide, which covers the main functions provided by &HAPprime; and examples of their use. There is also a more technical &HAPprime; datatypes reference manual which gives details of the new &GAP; datatypes defined and used internally by &HAPprime;, as well as outlining the algorithms used by the package.

<#Include Label="MakeHAPprimeDoc_manMisc">
Displaying progress and calculation information

By default, the functions in &HAPprime; display no output (except for returning the result). The InfoHAPprime info class can be used to enable the printing of progress and calculation information during processing. Since some computations with &HAPprime; can take several hours, setting this to a higher level can be particularly useful for monitoring the progress of computations.

<#Include Label="InfoHAPprime_manMisc">