---
title: "Database of Integral Maximal Finite Matrix Groups"
canonical: "https://docs.magma-maths.org/v2.30-1/FiniteGroups/DatabasesOfGroups/intgps.html"
source: "https://docs.magma-maths.org/v2.30-1/FiniteGroups/DatabasesOfGroups/intgps.md"
part: "Finite Groups"
chapter: "Databases of Groups"
breadcrumbs:
  - {"title": "Magma Handbook", "source": "https://docs.magma-maths.org/v2.30-1/index.md"}
  - {"title": "Finite Groups", "source": "https://docs.magma-maths.org/v2.30-1/FiniteGroups/index-finite-groups.md"}
  - {"title": "Databases of Groups", "source": "https://docs.magma-maths.org/v2.30-1/FiniteGroups/DatabasesOfGroups/index-databases-of-groups.md"}
prev: {"title": "Database of Rational Maximal Finite Matrix Groups", "source": "https://docs.magma-maths.org/v2.30-1/FiniteGroups/DatabasesOfGroups/ratgps.md"}
next: {"title": "Database of Finite Quaternionic Matrix Groups", "source": "https://docs.magma-maths.org/v2.30-1/FiniteGroups/DatabasesOfGroups/quatgps.md"}
intrinsics:
  - {"name": "IntegralMatrixGroupDatabase", "signature": "IntegralMatrixGroupDatabase() -> DB"}
  - {"name": "LargestDimension", "signature": "LargestDimension(D): DB -> RngIntElt"}
  - {"name": "#", "signature": "# D: DB -> RngIntElt"}
  - {"name": "NumberOfGroups", "signature": "NumberOfGroups(D): DB -> RngIntElt"}
  - {"name": "NumberOfLattices", "signature": "NumberOfLattices(D): DB -> RngIntElt"}
  - {"name": "NumberOfGroups", "signature": "NumberOfGroups(D, d): DB, RngIntElt -> RngIntElt"}
  - {"name": "NumberOfLattices", "signature": "NumberOfLattices(D, d): DB, RngIntElt -> RngIntElt"}
  - {"name": "Group", "signature": "Group(D, i): DB, RngIntElt -> GrpMat"}
  - {"name": "Lattice", "signature": "Lattice(D, i): DB, RngIntElt -> Lat, SeqEnum"}
  - {"name": "Construction", "signature": "Construction(D, i): DB, RngIntElt -> MonStgElt, SeqEnum"}
  - {"name": "Group", "signature": "Group(D, d, i): DB, RngIntElt, RngIntElt -> GrpMat"}
  - {"name": "Lattice", "signature": "Lattice(D, d, i): DB, RngIntElt, RngIntElt -> Lat, SeqEnum"}
  - {"name": "Construction", "signature": "Construction(D, d, i): DB, RngIntElt, RngIntElt -> MonStgElt, SeqEnum"}
examples:
  - "ex-2e0f58"
---

# Database of Integral Maximal Finite Matrix Groups

Magma includes a database of representatives of the ${\operatorname{GL}}(n, {\mathbb{Z}})$-conjugacy classes of irreducible maximal finite subgroups of ${\operatorname{GL}}(n, {\mathbb{Z}})$ for $n<=11$ and $n \in \{13,17,19,23\}$. This section defines the interface to that database.

For $n < 10$ the groups have been described in [[PP77](https://docs.magma-maths.org/v2.30-1/references.md#cite-pleskenpohst-glnz-i-ii), [PP80](https://docs.magma-maths.org/v2.30-1/references.md#cite-pleskenpohst-glnz-iii-v)]. The groups of dimension $10$ can be found in [[Sou94](https://docs.magma-maths.org/v2.30-1/references.md#cite-souvignier-gl8z-gl10z)]. In the cases $n>10$ prime, the representatives have been constructed using the descriptions given in [[Ple85](https://docs.magma-maths.org/v2.30-1/references.md#cite-plesken-circulants)].

A particular entry of the database can be specified in one of two ways. Firstly, a number in the range 1 to the size of the database can be given. Alternatively, the desired dimension can be provided, together with a number in the range 1 to the number of entries of that dimension.

Each entry can be accessed either as a matrix group or as a lattice. If accessed as a matrix group, the order and base are set on return. If as a lattice, the automorphism group is set.

<a id="function-integralmatrixgroupdatabase"></a>
## `IntegralMatrixGroupDatabase() -> DB`

This function returns a database object which contains information about the database.

<a id="function-largestdimension-db-2"></a>
## `LargestDimension(D): DB -> RngIntElt`

Returns the largest dimension of any entry stored in the database. It is an error to refer to larger dimensions in the database.

<a id="operation-operation-db-rngintelt"></a>
## `# D: DB -> RngIntElt`

<a id="function-numberofgroups-db-3"></a>
## `NumberOfGroups(D): DB -> RngIntElt`

<a id="function-numberoflattices-db-2"></a>
## `NumberOfLattices(D): DB -> RngIntElt`

Returns the number of entries stored in the database.

<a id="function-numberofgroups-db-rngintelt-3"></a>
## `NumberOfGroups(D, d): DB, RngIntElt -> RngIntElt`

<a id="function-numberoflattices-db-rngintelt-2"></a>
## `NumberOfLattices(D, d): DB, RngIntElt -> RngIntElt`

Returns the number of entries stored in the database of dimension $d$.

<a id="function-group-db-rngintelt-3"></a>
## `Group(D, i): DB, RngIntElt -> GrpMat`

Returns the $i$-th entry from the database $D$ as a matrix group.

<a id="function-lattice-db-rngintelt-2"></a>
## `Lattice(D, i): DB, RngIntElt -> Lat, SeqEnum`

Returns a lattice $L$ and sequence of additional forms $F$ fixed by the $i$-th group in the database $D$.

<a id="function-construction-db-rngintelt"></a>
## `Construction(D, i): DB, RngIntElt -> MonStgElt, SeqEnum`

Returns a string $S$ which describes the construction of the $i$-th group $G$ in the database $D$.

If the $G$-invariant lattice is well known, $S$ equals the name of this lattice. If the Degree $d$ of $G$ is a prime, $G$ usually can be chosen to fix the form $a_0 I_d + a_1 (z+z^{-1}) + ... + a_k (z^k+z^{-1})$ with $k = (d-1)/2$ and some $a_i \in {\mathbb{Z}}$ where $z$ denotes the permutation matrix of some $d$-cycle in ${\mathbb{Z}}^{d \times d}$ (see [[Ple85](https://docs.magma-maths.org/v2.30-1/references.md#cite-plesken-circulants)]). In this case, $S$ equals $[a_0, a_1, a_2, ...]$. In all other cases, $S$ describes the isomorphism type of $G$.

The second return value gives the numbers of all groups of degree $d$ in the `Rational Matrix Group Database` which contain a ${\operatorname{GL}}(d, {\mathbb{Q}})$-conjugate copy of $G$.

<a id="function-group-db-rngintelt-rngintelt-4"></a>
## `Group(D, d, i): DB, RngIntElt, RngIntElt -> GrpMat`

Returns the $i$-th entry of dimension $d$ in the database $D$ as a matrix group.

<a id="function-lattice-db-rngintelt-rngintelt-2"></a>
## `Lattice(D, d, i): DB, RngIntElt, RngIntElt -> Lat, SeqEnum`

Returns a lattice $L$ and sequence of additional forms $F$ fixed by the $i$-th group of dimension $d$ in the database $D$.

<a id="function-construction-db-rngintelt-rngintelt"></a>
## `Construction(D, d, i): DB, RngIntElt, RngIntElt -> MonStgElt, SeqEnum`

Returns a string and integer which describe the construction of the $i$-th entry of dimension $d$ in the database $D$.

<a id="example-ex-2e0f58"></a>
## `Example: Accessing Integral Matrix Groups (ex-2e0f58)`

```magma
> D:= IntegralMatrixGroupDatabase();
> #D;
222
> G:= Group(D, 8, 7); Construction(D, 8, 7);
A8* [ 3 ]
```

So $G$ is the automorphism group of the dual of the root lattice $A_8$ and it is conjugate to a subgroup of the third entry of dimension $8$ in the `RationalMatrixgroupDatabase`. We find an explicit embedding $T$ of $G$ into that group.

```magma
> DQ:= RationalMatrixGroupDatabase();
> H:= Group(DQ, 8, 3); L:= Lattice(DQ, 8, 3);
> F:= PositiveDefiniteForm(G);
> for s in Sublattices(G) do
>   B:= BasisMatrix(s);
>   FF:= B * F * Transpose(B);
>   ok, T:= IsIsometric(LatticeWithGram(FF div GCD(Eltseq(FF))), L);
>   if ok then break; end if;
> end for;
> assert ok;
> T:= Matrix(Rationals(), T*B);
> [Matrix(Integers(), T*Matrix(G.i)*T^-1) in H : i in [1..Ngens(G)]];
[ true, true ]
```
