# polymaking

Interfacing the geometry software polymake

Version 0.8.2
Released 2019-02-23

This project is maintained by Marc Roeder, The GAP Team

(C)2007-2013 by Marc Roeder,
National University of Ireland, Galway

polymak(e)inG(AP)
==================

A very basic GAP-interface to the program "polymake" by
Ewgenij Gawrilow and Michael Joswig which is available at

Note that this package does not provide the program "polymake", which
has to be installed separately.

This package is distributed under the terms of the GNU general public

Requirements
------------
polymaking requires GAP version 4.4. It also needs polymake to be
installed.  The GAPDoc package is needed to display the documentation.
polymaking was written for the "first generation" polymake which was
called as a command-line tool. Using it with a current ("next generation")
version of polymake will result in longer runtimes and fewer supported
keywords/features.

Installation
------------
0. Install polymake

polymaking.tar.bz2
polymaking.tar.gz
polymaking-win.zip
(where  is some version number) to the directory pkg/ of the
GAP home directory. If you do not have permission to do so, create
a directory called gap/pkg in your home directory.

2. change directory to pkg/ and unpack the archive using the according command:
tar -xjf polymaking.tar.bz2
tar -xzf polymaking.tar.gz
unzip polymaking-win.zip
(replace  with the version number)

3. start GAP. If you have created the directory gap/pkg in your home
directory, use "gap -l '/gap;'" where  is the path of
your home directory (use "pwd" to find out what it is, if you don't know)

5. Run "ReadPackage("polymaking","tst/test.gap");" for a quick test

If polymake is not found automatically (a warning will be printed at
level 1 in this case), try this:

6. Tell GAP where to look for polymake by adding the following lines to
POLYMAKE_COMMAND:=Filename(Directory("/home/mypolymakebindir/"),"polymake");
MakeImmutable(POLYMAKE_COMMAND);
Note that you can also modify the value of the variable in
lib/environment.gi.

IMPORTANT NOTE!
===============

Not all polymake keywords/properties are yet converted into GAP
language by polymaking. If you want to use one of those, please tell