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