---
title: "Operations on Group Algebras and their Subalgebras"
canonical: "https://docs.magma-maths.org/v2.30-1/Algebras/GroupAlgebras/grp-alg-ops.html"
source: "https://docs.magma-maths.org/v2.30-1/Algebras/GroupAlgebras/grp-alg-ops.md"
part: "Algebras"
chapter: "Group Algebras"
breadcrumbs:
  - {"title": "Magma Handbook", "source": "https://docs.magma-maths.org/v2.30-1/index.md"}
  - {"title": "Algebras", "source": "https://docs.magma-maths.org/v2.30-1/Algebras/index-algebras.md"}
  - {"title": "Group Algebras", "source": "https://docs.magma-maths.org/v2.30-1/Algebras/GroupAlgebras/index-group-algebras.md"}
prev: {"title": "Construction of Subalgebras, Ideals, and Quotient Algebras", "source": "https://docs.magma-maths.org/v2.30-1/Algebras/GroupAlgebras/subring-ideal-quotient.md"}
next: {"title": "Operations on Elements", "source": "https://docs.magma-maths.org/v2.30-1/Algebras/GroupAlgebras/elt-ops.md"}
intrinsics:
  - {"name": "Algebra", "signature": "Algebra(A): AlgGrp -> AlgAss, Map"}
  - {"name": "AugmentationMap", "signature": "AugmentationMap(A): AlgGrp -> Map"}
  - {"name": "AugmentationIdeal", "signature": "AugmentationIdeal(A): AlgGrp -> AlgGrpSub"}
  - {"name": "RepresentationType", "signature": "RepresentationType(A): AlgGrp -> MonStgElt"}
  - {"name": "ChangeRepresentationType", "signature": "ChangeRepresentationType(A, Rep): AlgGrp, MonStgElt -> AlgGrp, Map"}
  - {"name": "ConstructTable", "signature": "ConstructTable(A): AlgGrp"}
  - {"name": "CoefficientRing", "signature": "CoefficientRing(A): AlgGrp -> Rng"}
  - {"name": "BaseRing", "signature": "BaseRing(A): AlgGrp -> Rng"}
  - {"name": "!", "signature": "S ! 1: AlgGrpSub -> Grp"}
  - {"name": "!", "signature": "S ! 1: AlgGrp -> Grp"}
  - {"name": "Group", "signature": "Group(S): AlgGrpSub -> Grp"}
  - {"name": "Group", "signature": "Group(S): AlgGrp -> Grp"}
  - {"name": "GroupAlgebra", "signature": "GroupAlgebra(S): AlgGrpSub -> AlgGrp"}
  - {"name": "GroupAlgebra", "signature": "GroupAlgebra(S): AlgGrp -> AlgGrp"}
  - {"name": "Module", "signature": "Module(S): AlgGrpSub -> ModTupRng, Map"}
  - {"name": "Module", "signature": "Module(S): AlgGrp -> ModTupRng, Map"}
  - {"name": "CoefficientRing", "signature": "CoefficientRing(A): AlgGrpSub -> Rng"}
  - {"name": "BaseRing", "signature": "BaseRing(A): AlgGrpSub -> Rng"}
  - {"name": "BasisMatrix", "signature": "BasisMatrix(S): AlgGrpSub -> ModMatRngElt"}
  - {"name": "BasisMatrix", "signature": "BasisMatrix(S): AlgGrp -> ModMatRngElt"}
  - {"name": "Coordinates", "signature": "Coordinates(S, a): AlgGrpSub, AlgGrpElt -> [ RingElt ]"}
  - {"name": "Coordinates", "signature": "Coordinates(S, a): AlgGrp, AlgGrpElt -> [ RingElt ]"}
  - {"name": "IsLeftIdeal", "signature": "IsLeftIdeal(S): AlgGrpSub -> BoolElt"}
  - {"name": "IsLeftIdeal", "signature": "IsLeftIdeal(S): AlgGrp -> BoolElt"}
  - {"name": "IsRightIdeal", "signature": "IsRightIdeal(S): AlgGrpSub -> BoolElt"}
  - {"name": "IsRightIdeal", "signature": "IsRightIdeal(S): AlgGrp -> BoolElt"}
  - {"name": "IsIdeal", "signature": "IsIdeal(S): AlgGrpSub -> BoolElt"}
  - {"name": "IsIdeal", "signature": "IsIdeal(S): AlgGrp -> BoolElt"}
  - {"name": "Centraliser", "signature": "Centraliser(S): AlgGrpSub -> AlgGrpSub"}
  - {"name": "Centralizer", "signature": "Centralizer(S): AlgGrpSub -> AlgGrpSub"}
  - {"name": "Centraliser", "signature": "Centraliser(S): AlgGrp -> AlgGrpSub"}
  - {"name": "Centralizer", "signature": "Centralizer(S): AlgGrp -> AlgGrpSub"}
  - {"name": "Idealiser", "signature": "Idealiser(S): AlgGrpSub -> AlgGrpSub"}
  - {"name": "Idealizer", "signature": "Idealizer(S): AlgGrpSub -> AlgGrpSub"}
  - {"name": "Idealiser", "signature": "Idealiser(S): AlgGrp -> AlgGrpSub"}
  - {"name": "Idealizer", "signature": "Idealizer(S): AlgGrp -> AlgGrpSub"}
  - {"name": "LeftAnnihilator", "signature": "LeftAnnihilator(S): AlgGrpSub -> AlgGrpSub"}
  - {"name": "LeftAnnihilator", "signature": "LeftAnnihilator(S): AlgGrp -> AlgGrpSub"}
  - {"name": "RightAnnihilator", "signature": "RightAnnihilator(S): AlgGrpSub -> AlgGrpSub"}
  - {"name": "RightAnnihilator", "signature": "RightAnnihilator(S): AlgGrp -> AlgGrpSub"}
examples:
  - "ex-71b601"
---

# Operations on Group Algebras and their Subalgebras

## Operations on Group Algebras

The operations in this section can only be applied to a full group algebra. Functions accepting also a subalgebra of type `AlgGrpSub` are dealt with in the next section.

<a id="function-algebra-alggrp"></a>
### `Algebra(A): AlgGrp -> AlgAss, Map`

For a group algebra $A$ given in vector representation, construct the associative structure constant algebra $B$ isomorphic to $A$ together with the isomorphism $A \rightarrow B$.

<a id="function-augmentationmap-alggrp"></a>
### `AugmentationMap(A): AlgGrp -> Map`

The augmentation map of $A$. That is, the map $A \rightarrow R : \sum_{g \in G} r_g * g \rightarrow \sum_{g \in G} r_g$.

<a id="function-augmentationideal-alggrp"></a>
### `AugmentationIdeal(A): AlgGrp -> AlgGrpSub`

The augmentation ideal of the group algebra $A$ given in vector representation. This is defined as the kernel of the augmentation map.

<a id="function-representationtype-alggrp"></a>
### `RepresentationType(A): AlgGrp -> MonStgElt`

Given a group algebra $A$, return either `"Vector"` or `"Terms"` depending on which representation is used for the elements of $A$.

<a id="function-changerepresentationtype-alggrp-monstgelt"></a>
### `ChangeRepresentationType(A, Rep): AlgGrp, MonStgElt -> AlgGrp, Map`

Given a group algebra $A$, construct an isomorphic group algebra $B$ in which the elements are represented as specified by `Rep` which may be `"Vector"` or `"Terms"`, together with the homomorphism from $A$ to $B$.

<a id="procedure-constructtable-alggrp"></a>
### `ConstructTable(A): AlgGrp`

Procedure which, given a group algebra $A = R[G]$ in vector representation, constructs the multiplication table for the group $G$ to speed up multiplication in $A$. If the multiplication table already exists, nothing is done.

<a id="function-coefficientring-alggrp"></a>
### `CoefficientRing(A): AlgGrp -> Rng`

<a id="function-basering-alggrp"></a>
### `BaseRing(A): AlgGrp -> Rng`

The coefficient ring (base ring) of A.

## Operations on Subalgebras of Group Algebras

The functions in this section can be applied to group algebras and their subalgebras of type `AlgGrpSub`.

<a id="operation-op-alggrpsub"></a>
### `S ! 1: AlgGrpSub -> Grp`

<a id="operation-op-alggrp"></a>
### `S ! 1: AlgGrp -> Grp`

Create the identity element of the group algebra (subalgebra) $S$. Note that for a proper subalgebra of the full group algebra this may be different from the identity element of the group.

<a id="function-group-alggrpsub"></a>
### `Group(S): AlgGrpSub -> Grp`

<a id="function-group-alggrp"></a>
### `Group(S): AlgGrp -> Grp`

The group $G$ for the group algebra (subalgebra) $S$.

<a id="function-groupalgebra-alggrpsub"></a>
### `GroupAlgebra(S): AlgGrpSub -> AlgGrp`

<a id="function-groupalgebra-alggrp"></a>
### `GroupAlgebra(S): AlgGrp -> AlgGrp`

The group algebra of which $S$ is a subalgebra.

<a id="function-module-alggrpsub"></a>
### `Module(S): AlgGrpSub -> ModTupRng, Map`

<a id="function-module-alggrp"></a>
### `Module(S): AlgGrp -> ModTupRng, Map`

For a subalgebra $S$ of the group algebra $A = R[G]$, return the submodule of the module underlying $A$ which corresponds to $S$. This is an $R$-module of dimension `Dimension(S)` and degree `Dimension(A)`. Also returns (as a second return value) the natural map from the subalgebra to the module.

<a id="function-coefficientring-alggrpsub"></a>
### `CoefficientRing(A): AlgGrpSub -> Rng`

<a id="function-basering-alggrpsub"></a>
### `BaseRing(A): AlgGrpSub -> Rng`

The coefficient ring (base ring) of A.

<a id="function-basismatrix-alggrpsub"></a>
### `BasisMatrix(S): AlgGrpSub -> ModMatRngElt`

<a id="function-basismatrix-alggrp"></a>
### `BasisMatrix(S): AlgGrp -> ModMatRngElt`

For a subalgebra $S$ of the group algebra $A = R[G]$ return the coefficient matrix of the basis of $S$ with respect to the basis of $A$. If $S$ has dimension $m$ this is an $m \times |G|$-matrix over $R$ where the $i$-th row are the coefficients of the $i$-th basis vector of $S$ with respect to the fixed basis of $A$.

<a id="function-coordinates-alggrpsub-alggrpelt"></a>
### `Coordinates(S, a): AlgGrpSub, AlgGrpElt -> [ RingElt ]`

<a id="function-coordinates-alggrp-alggrpelt"></a>
### `Coordinates(S, a): AlgGrp, AlgGrpElt -> [ RingElt ]`

Given an element $a$ which lies in the subalgebra $S$, return a sequence giving the coordinates of $a$ with respect to the basis of $S$.

<a id="function-isleftideal-alggrpsub"></a>
### `IsLeftIdeal(S): AlgGrpSub -> BoolElt`

<a id="function-isleftideal-alggrp"></a>
### `IsLeftIdeal(S): AlgGrp -> BoolElt`

Returns `true` if $S$ is a left ideal of its group algebra; otherwise `false`.

<a id="function-isrightideal-alggrpsub"></a>
### `IsRightIdeal(S): AlgGrpSub -> BoolElt`

<a id="function-isrightideal-alggrp"></a>
### `IsRightIdeal(S): AlgGrp -> BoolElt`

Returns `true` if $S$ is a right ideal of its group algebra; otherwise `false`.

<a id="function-isideal-alggrpsub"></a>
### `IsIdeal(S): AlgGrpSub -> BoolElt`

<a id="function-isideal-alggrp"></a>
### `IsIdeal(S): AlgGrp -> BoolElt`

Returns `true` if $S$ is a (two-sided) ideal of its group algebra; otherwise `false`.

<a id="function-centraliser-alggrpsub"></a>
### `Centraliser(S): AlgGrpSub -> AlgGrpSub`

<a id="function-centralizer-alggrpsub"></a>
### `Centralizer(S): AlgGrpSub -> AlgGrpSub`

<a id="function-centraliser-alggrp"></a>
### `Centraliser(S): AlgGrp -> AlgGrpSub`

<a id="function-centralizer-alggrp"></a>
### `Centralizer(S): AlgGrp -> AlgGrpSub`

The centralizer of the subalgebra $S$ of a group algebra $A$ (in $A$).

<a id="function-idealiser-alggrpsub"></a>
### `Idealiser(S): AlgGrpSub -> AlgGrpSub`

<a id="function-idealizer-alggrpsub"></a>
### `Idealizer(S): AlgGrpSub -> AlgGrpSub`

<a id="function-idealiser-alggrp"></a>
### `Idealiser(S): AlgGrp -> AlgGrpSub`

<a id="function-idealizer-alggrp"></a>
### `Idealizer(S): AlgGrp -> AlgGrpSub`

The largest subalgebra $T$ of $A$ such that $S$ is an ideal in $T$.

<a id="function-leftannihilator-alggrpsub"></a>
### `LeftAnnihilator(S): AlgGrpSub -> AlgGrpSub`

<a id="function-leftannihilator-alggrp"></a>
### `LeftAnnihilator(S): AlgGrp -> AlgGrpSub`

For a subalgebra $S$ of the group algebra $A$ construct the left annihilator of $S$, that is, the subalgebra of $A$ consisting of all elements $a$ such that $a*s = 0$ for all $s \in S$.

<a id="function-rightannihilator-alggrpsub"></a>
### `RightAnnihilator(S): AlgGrpSub -> AlgGrpSub`

<a id="function-rightannihilator-alggrp"></a>
### `RightAnnihilator(S): AlgGrp -> AlgGrpSub`

For a subalgebra $S$ of the group algebra $A$ construct the right annihilator of $S$, that is, the subalgebra of $A$ consisting of all elements $a$ such that $s*a = 0$ for all $s \in S$.

<a id="example-ex-71b601"></a>
### `Example: Jacobson Radical of a Group Algebra (ex-71b601)`

We construct the group algebra of an elementary abelian group over $GF(2)$ and get its Jacobson ideal.

```magma
> A := AbelianGroup([2,2,2,2,2]);
> FG := GroupAlgebra(GF(2), A);
> J := JacobsonRadical(FG);
> J;
Ideal of dimension 31 of the group algebra FG
```

We now check that the Jacobson radical is nilpotent and get its nilpotency class.

```magma
> JPow := [ J ];
> I := J;
> while Dimension(I) ne 0 do
>     I := I*J;
>     Append(~JPow, I);
> end while;
> [ Dimension(I) : I in JPow ];
[ 31, 26, 16, 6, 1, 0 ]
```

Thus, $J$ is nilpotent of class 6. However, every non-zero element of $J$ is of course nilpotent of class 2.

```magma
> IsNilpotent(Random(J));
true 2
```
