1# FPLSA -- The Finitely Presented Lie Super-Algebra Package
2## A Link to an External Lie Todd-Coxeter Program
3
4When  K  is  a  finitely-presented  Lie  algebra,  the  GAP  operation
5`IsomorphismSCTableAlgebra` can be used to make  the  structure  of  K
6explicit, in the form of an  isomorphic  algebra  given  by  structure
7constants, which is much more amenable to further computations.
8
9This GAP package installs an alternative method  for  this  operation,
10which calls an external C program (fplsa version 4.0) to do  the  hard
11part of the computation. This speeds up the  calculation  and  permits
12larger problems  to  be  attempted.  The  external  program  has  much
13additional functionality which is not used by the present  version  of
14the package.
15
16Since the package contains an external C program, it works only  under
17UNIX and requires a C compiler to install it.
18
19### Installing FPLSA
20
21You have to perform the following steps to install FPLSA:
22
23 - Get and unpack the sources
24 - Use the `configure` script to adjust everything to your specific
25   system
26 - Compile the C part of FPLSA
27
28#### Getting and unpacking the sources
29
30Typically `fplsa` will already be distributed along with your GAP
31distribution, in which case you can skip this step.
32
33Otherwise, you can download the latest version of this package from
34its homepage, which is
35  <https://gap-packages.github.io/FPLSA/>
36
37You will end up with a file named `fplsa-X.Y.tar.gz`, where `X.Y` is
38a version string like `1.1`.
39
40You now change your current directory to the `pkg`subdirectory of the
41location where you installed GAP. Now you extract the sources for the
42FPLSA package (replace `X.Y` with the actual version):
43
44    tar xf fplsa-X.Y.tar.gz
45
46The `tar` utility  unpacks  the  files  and  stores  them  into  the
47appropriate subdirectories. FPLSA resides in the `fplsa-X.Y`
48subdirectory.
49
50
51#### Configuring and Compiling the C part
52
53You have to change your current working directory to the subdirectory
54FPLSA lives in. Starting from the `pkg` dirctory of your GAP
55installation, you can do this via this command (replace `X.Y` with
56the actual version):
57
58    cd fplsa-X.Y
59
60Now you invoke the `configure` script by:
61
62    ./configure ../..
63
64This script produces some Makefiles which  are  used  to  compile  the
65code. You do this by typing
66
67    make
68
69If there were no error, then all C sources should have been compiled
70and a binary executable been built.  If you now enter GAP, type
71
72    gap> LoadPackage( "fplsa" );
73
74Then the new functionality should be available.
75
76
77### Documentation
78
79Full information and documentation can be found in the manual, available
80as PDF `doc/manual.pdf` or as HTML `doc/chap0_mj.html`, or on the package
81homepage at
82
83  <https://gap-packages.github.io/FPLSA/>
84
85
86### Bug reports and feature requests
87
88Please submit bug reports and feature requests via our GitHub issue tracker:
89
90  <https://github.com/gap-packages/FPLSA/issues>
91
92
93### License
94
95fplsa is free software; you can redistribute it and/or modify
96it under the terms of the GNU General Public License as published by
97the Free Software Foundation; either version 2 of the License, or
98(at your option) any later version.
99
100For details see the file LICENSE.
101
102
103### Authors
104
105The FPLSA program was written by V Gerdt and V Kornyak, both of the:
106
107Laboratory of Computing Techniques and Automation,
108Joint Institute for Nuclear Research, Dubna, Moscow Region 141980,
109Russia. Email: <gerdt@jinr.ru> and <vkornyak@gmail.com>
110
111