initial commit for version 1.0.0

.gitignore

@@ -0,0 +1,13 @@
+doc/chap*.html
+doc/chap*.txt
+doc/chooser.html
+doc/main.*
+!doc/main.xml
+doc/manual.*
+doc/manualbib.xml.bib
+doc/*.css
+doc/*.js
+tst/docxpl2.tst
+tst/docxpl2.tst~
+tst/docxpl.tst
+tst/docxpl.tst~

PackageInfo.g

@@ -0,0 +1,106 @@
+#############################################################################
+##
+##  PackageInfo.g for the GAP 4 package SingerAlg               Thomas Breuer
+##
+SetPackageInfo( rec(
+PackageName :=
+  "SingerAlg",
+Version :=
+  "1.0.0",
+MyWWWHome :=
+  "http://www.math.rwth-aachen.de/~Thomas.Breuer",
+Subtitle :=
+  "Loewy lengths of certain algebras",
+Date :=
+  "11/09/2020",   # Version 1.0.0
+License :=
+  "GPL-3.0-or-later",
+SourceRepository := rec(
+  Type:= "git",
+  URL:= "https://github.com/oscar-system/SingerAlg",
+  ),
+IssueTrackerURL := Concatenation( ~.SourceRepository.URL, "/issues" ),
+PackageWWWHome :=
+  Concatenation( ~.MyWWWHome, "/", LowercaseString( ~.PackageName ) ),
+ArchiveURL :=
+  Concatenation( ~.PackageWWWHome, "/", LowercaseString( ~.PackageName ),
+                 "-", ~.Version ),
+ArchiveFormats :=
+  ".tar.gz",
+Persons := [
+  rec(
+    LastName := "Breuer",
+    FirstNames := "Thomas",
+    IsAuthor := true,
+    IsMaintainer := true,
+    Email := "[email protected]",
+    WWWHome := ~.MyWWWHome,
+    Place := "Aachen",
+    Institution := "Lehrstuhl für Algebra und Zahlentheorie, RWTH Aachen",
+    PostalAddress := Concatenation( [
+      "Thomas Breuer\n",
+      "Lehrstuhl für Algebra und Zahlentheorie\n",
+      "Pontdriesch 14/16\n",
+      "52062 Aachen\n",
+      "Germany"
+      ] ),
+    ),
+  ],
+Status :=
+  "deposited",
+README_URL :=
+  Concatenation( ~.PackageWWWHome, "/README.md" ),
+PackageInfoURL :=
+  Concatenation( ~.PackageWWWHome, "/PackageInfo.g" ),
+AbstractHTML := Concatenation( [
+  "The package provides functionality for studying the Loewy structure ",
+  "of certain algebras, ",
+  "and provides a database."
+  ] ),
+PackageDoc := [
+  rec(
+    BookName :=
+      "SingerAlg",
+    ArchiveURLSubset :=
+      [ "doc" ],
+    HTMLStart :=
+      "doc/chap0.html",
+    PDFFile :=
+      "doc/manual.pdf",
+    SixFile :=
+      "doc/manual.six",
+    LongTitle :=
+      "Loewy structure of certain algebras",
+  ) ],
+Dependencies := rec(
+  GAP :=
+    ">= 4.10.1",                  # because of a few library functions
+  OtherPackagesLoadedInAdvance := [
+    ],
+  NeededOtherPackages := [
+      [ "gapdoc", ">= 1.6.2" ],   # for the documentation
+    ],
+  SuggestedOtherPackages := [
+      [ "JuliaInterface", ">= 0.4.3" ],  # Julia based speedup
+      [ "Browse", ">= 1.8.9" ],   # because of database attributes
+                                  # and overview functions; need the fix of
+                                  # 'NCurses.BrowseDenseList' from 1.8.9
+      [ "GraPe", ">= 4.8" ],      # because of permutation isomorphisms
+      [ "FactInt", ">= 1.6.3" ],  # because 'Factors' is called a lot
+    ],
+  ExternalConditions := [
+    ],
+  ),
+AvailabilityTest :=
+  ReturnTrue,
+TestFile :=
+  "tst/testauto.g",
+Keywords :=
+  [ "Loewy length", "Loewy vector" ],
+) );
+
+
+#############################################################################
+##
+#E
+

README.md

@@ -0,0 +1,70 @@
+
+The GAP 4 Package **SingerAlg**
+===============================
+
+Description
+-----------
+
+The aims of the GAP package **SingerAlg** are
+to document the computations needed in the papers
+[The Loewy Structure of Certain Fixpoint Algebras, Part I](https://doi.org/10.1016/j.jalgebra.2019.05.004)
+and
+[The Loewy Structure of Certain Fixpoint Algebras, Part II](http://arxiv.org/abs/1912.03065v1),
+and to give access to the related GAP/Julia functions and to the database of
+Singer algebras of dimension up to 10000.
+
+For further information see [the homepage of the package](http://www.math.rwth-aachen.de/~Thomas.Breuer/singeralg/),
+where package archives can be found as well as
+the [data files of low dimensional Singer algebras](http://www.math.rwth-aachen.de/~Thomas.Breuer/singeralg/data/).
+
+
+Authors
+-------
+
+The code was written by [Thomas Breuer](http://www.math.rwth-aachen.de/~Thomas.Breuer/).
+The underlying theory was developed in the abovementioned papers,
+by Thomas Breuer, László Héthelyi, Erzsébet Horváth, and Burkhard Külshammer.
+
+For questions or suggestions write to
+
+    [email protected]
+
+or use [the issue tracker of the git repository](https://github.com/oscar-system/SingerAlg/issues).
+
+
+Installation
+------------
+
+In principle it is enough to unpack the archive in question in the `pkg`
+subdirectory of your GAP installation.
+This generates a subdirectory `SingerAlg-x.y.z`.
+
+No kernel module has to be compiled,
+but the package provides also functions that rely on
+the GAP-Julia integration via the GAP package **JuliaInterface**,
+which is part of
+[the Julia package GAP.jl](https://github.com/oscar-system/GAP.jl).
+In particular GAP must be compiled with Julia's garbage collector
+if one wants to load this package.
+
+If you want to use the Julia functionality but you do not have
+a GAP installation with GAP-Julia integration
+then the easiest way to install this is
+to install first Julia (at least version 1.3) and then let Julia install GAP.jl,
+as described in [its README.md file](https://github.com/oscar-system/GAP.jl/blob/master/README.md).
+
+
+License
+-------
+
+This package may be distributed under the terms and conditions of the
+[**GNU Public License**](http://www.gnu.org/licenses) Version 3 or later.
+
+
+Acknowledgement
+---------------
+
+Thomas Breuer gratefully acknowledges support by
+the German Research Foundation (DFG) within the
+[SFB-TRR 195 *Symbolic Tools in Mathematics and their Applications*](https://www.computeralgebra.de/sfb/).
+