
The GAP 4 Share Package `AtlasRep'
==================================

Description
-----------

This is the first release (Version 1.0) of the share package `AtlasRep'
written for GAP 4, whose aim is to provide an interface between
GAP and the Atlas of Group Representations,
a database that comprises representations of many almost simple groups
and information about their maximal subgroups.
This database has been available independent of GAP at

                     http://www.mat.bham.ac.uk/atlas.

The AtlasRep package consists of this database and a GAP interface.
The latter allows the user to get an overview of the database,
and to access the data in GAP format.

There is a manual in the subdirectory `doc' written in plain TeX.
It describes the available functions in detail.

Up to now, the package has been developed and tested only on Linux,
it may or may not work on other platforms.
Two possible problems are the use of a perl script for internet access
and the use of filenames that do not obey the ``8+3'' restriction.


Authors
-------

The data files of the ATLAS of Group Representations have been prepared by
Robert Wilson, Peter Walsh, Jonathan Tripp, Ibrahim Suleiman, Stephen Rogers,
Richard Parker, Simon Norton, Steve Linton, and John Bray
(in reverse alphabetical order).

The GAP interface was written by Thomas Breuer.


Feedback
--------

If you have used the `AtlasRep' package to solve a problem,
please let us know by sending an email to 

          Robert A. Wilson  (R.A.Wilson@bham.ac.uk) or
          Thomas Breuer     (sam@math.rwth-aachen.de)

about it.

Any comments about the package are very welcome.
If you have found important features missing or if there is a bug,
let us know and we will try to address it in the next version of the package.
Messages concerning the data of the package should be sent to Robert Wilson,
messages concerning the GAP interface to Thomas Breuer.


Contents
--------

With this version you should have obtained this README file
and an archive file containing the GAP interface
in the following files and directories:

        datagens        the directory for files with generators
        dataword        the directory for files with straight line programs
        doc             the directory with the package manual
        etc             the directory with scripts called by the GAP programs
        gap             the directory with the GAP code
        banner.g        the file for showing the package banner
        init.g          the file for initializing the package
        read.g          the file for reading in the package        
        tst             the directory with some test files

The archive does *NOT* contain the database part of the package;
the GAP interface accesses the data on demand via the internet.


Unpacking
---------

You may have got the GAP interface of the package as
a zoo archive (filename ends with .zoo)
or a compressed tar archive (filename ends with .tgz).
In each case, use the appropriate command on your system to unpack
the archive.

On UNIX systems the zoo archive may be unpacked by

    zoo x atlasrep.zoo

which will unpack the archive into a directory `atlasrep' in the
current directory. 

On UNIX systems the compressed tar archive may be unpacked by

    tar xzf atlasrep.tgz

or, if tar on your system does not understand the option z, by

    gunzip atlasrep.tgz
    tar xf atlasrep.tar

which will in each case unpack the code into a directory `atlasrep'
in the current directory.

If your system does not have a zoo programme, you can pick up the
C-code for unzoo from the GAP web page and compile it on your system.
For this your system needs to have a C-compiler.
unzoo can be used to unpack the zoo archive, as follows:

    unzoo -x atlasrep.zoo

unpacks the archive into a directory `atlasrep' in the current directory.


Installation
------------

Installation of the AtlasRep package means unpacking the archive file
in an appropriate directory.

For the two ways of installing GAP share packages in general,
see the sections "Installing Share Packages" and
"Installing a Share Package in your home directory"
in the GAP Reference Manual.

Special configuration issues of the AtlasRep package are described
in the section "Local or Remote Installation of the AtlasRep Share Package"
of the package manual; this section might be of interest after the
installation.

Once you have successfully installed the AtlasRep package,
start GAP (possibly using the command line option -l) and type

gap> RequirePackage( "atlasrep" );
true;
gap>

at the GAP prompt.
Then the functions of the package are available in the current session.

