---
title: "Other Functions for Nilpotent Matrix Groups"
canonical: "https://docs.magma-maths.org/v2.30-1/FiniteGroups/MatrixGroupsOverInfiniteFields/nilpotent_groups.html"
source: "https://docs.magma-maths.org/v2.30-1/FiniteGroups/MatrixGroupsOverInfiniteFields/nilpotent_groups.md"
part: "Finite Groups"
chapter: "Matrix Groups over Infinite Fields"
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": "Matrix Groups over Infinite Fields", "source": "https://docs.magma-maths.org/v2.30-1/FiniteGroups/MatrixGroupsOverInfiniteFields/index-matrix-groups-over-infinite-fields.md"}
prev: {"title": "Other Properties of Linear Groups", "source": "https://docs.magma-maths.org/v2.30-1/FiniteGroups/MatrixGroupsOverInfiniteFields/other-properties.md"}
next: {"title": "Examples", "source": "https://docs.magma-maths.org/v2.30-1/FiniteGroups/MatrixGroupsOverInfiniteFields/examples.md"}
intrinsics:
  - {"name": "RecogniseAbelian", "signature": "RecogniseAbelian(G): GrpMat -> GrpGPC, Map, Map"}
  - {"name": "SylowSystem", "signature": "SylowSystem(G : parameters): GrpMat[FldFin] -> []"}
  - {"name": "IsIrreducibleFiniteNilpotent", "signature": "IsIrreducibleFiniteNilpotent(G : parameters): GrpMat -> BoolElt, Any"}
  - {"name": "IsPrimitiveFiniteNilpotent", "signature": "IsPrimitiveFiniteNilpotent(G : parameters): GrpMat -> BoolElt, Any"}
---

# Other Functions for Nilpotent Matrix Groups

<a id="function-recogniseabelian-grpmat"></a>
## `RecogniseAbelian(G): GrpMat -> GrpGPC, Map, Map`

Given a completely reducible abelian matrix group $G$ defined over $Q$ or a number field, return an isomorphic polycyclic copy $P$, a map from $G$ to $P$, and a map from $P$ to $G$. It uses an algorithm of Biasse and Fieker [[BF12](https://docs.magma-maths.org/v2.30-1/references.md#cite-fieker)] to work with irreducible abelian groups defined over number fields.

<a id="function-sylowsystem-grpmat-fldfin"></a>
## `SylowSystem(G : parameters): GrpMat[FldFin] -> []`

```magma
Verify: BoolElt                    Default: false
```

Given a nilpotent matrix group $G$ over a finite field, this function constructs one Sylow $p$-subgroup for each prime $p$ dividing $|G|$ using the algorithm of [[DF06](https://docs.magma-maths.org/v2.30-1/references.md#cite-large)]. If the optional parameter `Verify` is set to `true`, then we first verify that $G$ is nilpotent.

The next two functions were developed and implemented by Tobias Rossmann.

<a id="function-isirreduciblefinitenilpotent-grpmat"></a>
## `IsIrreducibleFiniteNilpotent(G : parameters): GrpMat -> BoolElt, Any`

```magma
DecideOnly: BoolElt                    Default: false
Verify    : BoolElt                    Default: false
```

Let $G$ be a finite nilpotent matrix group over $K$, where $K$ is a number field or a rational function field over a number field. The function returns `true` if $G$ is irreducible or `false` and a proper submodule of `GModule(G)`. The construction of a submodule can be suppressed by setting `DecideOnly` to `true`. If the optional parameter `Verify` is set to `true`, then the function checks if $G$ is nilpotent and finite. The algorithm used for irreducibility testing is described in [Ros10a].

<a id="function-isprimitivefinitenilpotent-grpmat"></a>
## `IsPrimitiveFiniteNilpotent(G : parameters): GrpMat -> BoolElt, Any`

```magma
DecideOnly: BoolElt                    Default: false
Verify    : BoolElt                    Default: false
```

Let $G$ be an irreducible finite nilpotent matrix group over $K$, where $K$ is a number field or a rational function field over a number field. The function returns `true` if $G$ is primitive, or `false` and a system of imprimitivity for $G$ given as a sequence of subspaces of `RSpace(G)`. The construction of a system of imprimitivity can be suppressed by setting `DecideOnly` to `true`. If the optional parameter `Verify` is set to `true`, then the function checks if $G$ is nilpotent and finite. The algorithm used for primitivity testing is described in [Ros10b].
