---
title: "Database of Finite Symplectic Matrix Groups"
canonical: "https://docs.magma-maths.org/v2.30-1/FiniteGroups/DatabasesOfGroups/symplgps.html"
source: "https://docs.magma-maths.org/v2.30-1/FiniteGroups/DatabasesOfGroups/symplgps.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 Finite Quaternionic Matrix Groups", "source": "https://docs.magma-maths.org/v2.30-1/FiniteGroups/DatabasesOfGroups/quatgps.md"}
next: {"title": "Database of Irreducible Matrix Groups", "source": "https://docs.magma-maths.org/v2.30-1/FiniteGroups/DatabasesOfGroups/irrgp-data.md"}
intrinsics:
  - {"name": "SymplecticMatrixGroupDatabase", "signature": "SymplecticMatrixGroupDatabase() -> 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"}
  - {"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"}
examples:
  - "ex-c0dcaf"
---

# Database of Finite Symplectic Matrix Groups

Magma includes a database of the maximal finite irreducible subgroups of ${\operatorname{Sp}}_{2n}({\mathbb{Q}})$ for $1\le i \le 11$ up to conjugacy in ${\operatorname{GL}}_{2n}({\mathbb{Q}})$. This collection is due to Markus Kirschmer [[Kir09](https://docs.magma-maths.org/v2.30-1/references.md#cite-kirschmer-symplectic)]. This section defines the interface to that database.

To avoid non-integral entries, the stored matrix groups do not fix the standard skewsymmetric form but some other nondegenerate skewsymmetric form. The example below illustrates how to construct a conjugate matrix group which fixes the standard skewsymmetric form.

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 with a pair of forms. If accessed as a matrix group, the order and base are set on return.

<a id="function-symplecticmatrixgroupdatabase"></a>
## `SymplecticMatrixGroupDatabase() -> DB`

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

<a id="function-largestdimension-db-4"></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-5"></a>
## `NumberOfGroups(D): DB -> RngIntElt`

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

Returns the number of entries stored in the database.

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

<a id="function-numberoflattices-db-rngintelt-4"></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-5"></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-4"></a>
## `Lattice(D, i): DB, RngIntElt -> Lat, SeqEnum`

Returns a lattice $L$ and a sequence $S$ of two integral forms such that the automorphism group of $L$ with respect to $S$ equals `Group(DB, i)`. The first form in $S$ is the gram matrix of $L$ and the second form is skewsymmetric. The sequence $S$ is normalized as described in the appendix of [[Kir09](https://docs.magma-maths.org/v2.30-1/references.md#cite-kirschmer-symplectic)] to simplify the recognition of the matrix group.

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

Returns a string which describes the construction of the $i$-th entry of the database $D$.

<a id="function-group-db-rngintelt-rngintelt-6"></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-4"></a>
## `Lattice(D, d, i): DB, RngIntElt, RngIntElt -> Lat, SeqEnum`

Returns a lattice $L$ and a sequence $S$ of forms corresponding to the $i$-th entry of dimension $d$ in the database $D$.

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

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

<a id="example-ex-c0dcaf"></a>
## `Example: Symplectic Matrix Groups of Dimension 16 (ex-c0dcaf)`

We illustrate accessing the symplectic matrix group database with a group of dimension 16.

```magma
> DB := SymplecticMatrixGroupDatabase();
> NumberOfGroups(DB, 16);
91
> G := Group(DB, 16, 1);
> G : Minimal;
MatrixGroup(16, Integer Ring) of order 2^21 * 3^4 * 5^2
```

The group G does not fix the standard skewsymmetic form. But it can be conjugated to do so.

```magma
> _, S := Lattice(DB, 16, 1);
> T := TransformForm(Matrix(Rationals(), S[2]), "symplectic");
> H := ChangeRing(G, Rationals())^(GL(16,Rationals()) ! T);
> J := SymplecticForm(16, Rationals());
> forall{h: h in Generators(H) | h * J * Transpose(h) eq J};
true
```
