---
title: "Soluble Matrix Groups"
canonical: "https://docs.magma-maths.org/v2.30-1/FiniteGroups/MatrixGroupsOverGeneralRings/soluble-matrix-group.html"
source: "https://docs.magma-maths.org/v2.30-1/FiniteGroups/MatrixGroupsOverGeneralRings/soluble-matrix-group.md"
part: "Finite Groups"
chapter: "Matrix Groups over General Rings"
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 General Rings", "source": "https://docs.magma-maths.org/v2.30-1/FiniteGroups/MatrixGroupsOverGeneralRings/index-matrix-groups-over-general-rings.md"}
prev: {"title": "Base and Strong Generating Set", "source": "https://docs.magma-maths.org/v2.30-1/FiniteGroups/MatrixGroupsOverGeneralRings/BSGS-base-strong-generator.md"}
next: {"title": "Bibliography", "source": "https://docs.magma-maths.org/v2.30-1/FiniteGroups/MatrixGroupsOverGeneralRings/bibliography.md"}
intrinsics:
  - {"name": "PolycyclicGenerators", "signature": "PolycyclicGenerators(G): GrpMat -> [ GrpPCElt ]"}
  - {"name": "PCGroup", "signature": "PCGroup(G): GrpMat -> GrpPC, Map"}
  - {"name": "pCentralSeries", "signature": "pCentralSeries(G, p): GrpMat, RngIntElt -> [ GrpMat ]"}
  - {"name": "IsSpecial", "signature": "IsSpecial(G): GrpMat -> BoolElt"}
  - {"name": "IsExtraSpecial", "signature": "IsExtraSpecial(G): GrpMat -> BoolElt"}
  - {"name": "FrattiniSubgroup", "signature": "FrattiniSubgroup(G): GrpMat -> GrpMat"}
  - {"name": "JenningsSeries", "signature": "JenningsSeries(G): GrpMat -> [ GrpMat ]"}
  - {"name": "PrimaryAbelianInvariants", "signature": "PrimaryAbelianInvariants(G): GrpMat -> [ RngIntElt ]"}
  - {"name": "AbelianInvariants", "signature": "AbelianInvariants(G): GrpMat -> [ RngIntElt ]"}
  - {"name": "PrimaryAbelianBasis", "signature": "PrimaryAbelianBasis(G): GrpMat -> [ GrpMatElt ], [ RngIntElt ]"}
  - {"name": "AbelianBasis", "signature": "AbelianBasis(G): GrpMat -> [ GrpMatElt ], [ RngIntElt ]"}
---

# Soluble Matrix Groups

The functions described in this section apply only to finite groups for which a base and strong generating set may be constructed.

## Conversion to a PC-Group

<a id="function-polycyclicgenerators-grpmat"></a>
### `PolycyclicGenerators(G): GrpMat -> [ GrpPCElt ]`

Construct a polycyclic generating sequence for the soluble group $G$.

<a id="function-pcgroup-grpmat-2"></a>
### `PCGroup(G): GrpMat -> GrpPC, Map`

Given a soluble group $G$, construct a group $S$ in category [`GrpPC`](https://docs.magma-maths.org/v2.30-1/FiniteGroups/FiniteSolubleGroups/index-finite-soluble-groups.md#chapgrppc), isomorphic to $G$. In addition to returning $S$, the function returns an isomorphism $\phi: G \ar S$.

## Soluble Group Functions

<a id="function-pcentralseries-grpmat-rngintelt"></a>
### `pCentralSeries(G, p): GrpMat, RngIntElt -> [ GrpMat ]`

Given a soluble group $G$, and a prime $p$ dividing $|G|$, return the lower $p$-central series for $G$. The series is returned as a sequence of subgroups.

## $p$-group Functions

<a id="function-isspecial-grpmat"></a>
### `IsSpecial(G): GrpMat -> BoolElt`

Given a $p$-group $G$, return `true` if $G$ is special, `false` otherwise.

<a id="function-isextraspecial-grpmat"></a>
### `IsExtraSpecial(G): GrpMat -> BoolElt`

Given a $p$-group $G$, return `true` if $G$ is extraspecial, `false` otherwise.

<a id="function-frattinisubgroup-grpmat"></a>
### `FrattiniSubgroup(G): GrpMat -> GrpMat`

Given a $p$-group $G$, return the Frattini subgroup.

<a id="function-jenningsseries-grpmat"></a>
### `JenningsSeries(G): GrpMat -> [ GrpMat ]`

Given a $p$-group $G$, return the Jennings series for $G$. The series is returned as a sequence of subgroups.

## Abelian Group Functions

<a id="function-primaryabelianinvariants-grpmat"></a>
### `PrimaryAbelianInvariants(G): GrpMat -> [ RngIntElt ]`

<a id="function-abelianinvariants-grpmat"></a>
### `AbelianInvariants(G): GrpMat -> [ RngIntElt ]`

Given an abelian group $G$, return a sequence $Q$ containing the types of each $p$-primary component of $G$. The non-primary form gives the Smith form invariants, i.e. each element of the sequence divides the next.

<a id="function-primaryabelianbasis-grpmat"></a>
### `PrimaryAbelianBasis(G): GrpMat -> [ GrpMatElt ], [ RngIntElt ]`

<a id="function-abelianbasis-grpmat"></a>
### `AbelianBasis(G): GrpMat -> [ GrpMatElt ], [ RngIntElt ]`

Given an abelian group $G$, return sequences $B$ and $I$, where $I$ are $p$-primary invariants for $G$, and $B$ are generators for $G$ having the orders in $I$. The non-primary form uses the Smith form invariants, i.e. each element of the sequence divides the next.
