---
title: "Properties of a Module"
canonical: "https://docs.magma-maths.org/v2.30-1/RepresentationTheory/ModulesOverAnAlgebraAndGroupRepresentations/module-props.html"
source: "https://docs.magma-maths.org/v2.30-1/RepresentationTheory/ModulesOverAnAlgebraAndGroupRepresentations/module-props.md"
part: "Representation Theory"
chapter: "Modules over an Algebra and Group Representations"
breadcrumbs:
  - {"title": "Magma Handbook", "source": "https://docs.magma-maths.org/v2.30-1/index.md"}
  - {"title": "Representation Theory", "source": "https://docs.magma-maths.org/v2.30-1/RepresentationTheory/index-representation-theory.md"}
  - {"title": "Modules over an Algebra and Group Representations", "source": "https://docs.magma-maths.org/v2.30-1/RepresentationTheory/ModulesOverAnAlgebraAndGroupRepresentations/index-modules-over-an-algebra-and-group-representations.md"}
prev: {"title": "Submodules and Quotient Modules", "source": "https://docs.magma-maths.org/v2.30-1/RepresentationTheory/ModulesOverAnAlgebraAndGroupRepresentations/submodules.md"}
next: {"title": "Structure of a Module", "source": "https://docs.magma-maths.org/v2.30-1/RepresentationTheory/ModulesOverAnAlgebraAndGroupRepresentations/structure.md"}
intrinsics:
  - {"name": "IsIrreducible", "signature": "IsIrreducible(M): ModRng -> BoolElt, ModRng, ModRng"}
  - {"name": "IsAbsolutelyIrreducible", "signature": "IsAbsolutelyIrreducible(M): ModRng -> BoolElt, AlgMatElt, RngIntElt"}
  - {"name": "IsDecomposable", "signature": "IsDecomposable(M): ModRng -> BoolElt, ModRng, ModRng"}
  - {"name": "IsSemisimple", "signature": "IsSemisimple(M): ModGrp -> BoolElt"}
  - {"name": "IsProjective", "signature": "IsProjective(M): ModGrp -> BoolElt"}
  - {"name": "IsFree", "signature": "IsFree(M): ModGrp -> BoolElt"}
  - {"name": "IsSelfDual", "signature": "IsSelfDual(M): ModGrp -> BoolElt"}
  - {"name": "IsPermutationModule", "signature": "IsPermutationModule(M): ModRng -> BoolElt"}
---

# Properties of a Module

The following intrinsics have differing conditions on their application so the user should check before using a given intrinsic.

<a id="function-isirreducible-modrng"></a>
## `IsIrreducible(M): ModRng -> BoolElt, ModRng, ModRng`

Given an $A$-module $M$, defined over a finite field or a number field, the intrinsic returns `true` if and only if $M$ is irreducible. If $M$ is reducible, a proper submodule $N$ of $M$ together with the corresponding quotient module $Q = M/N$, are also returned.

<a id="function-isabsolutelyirreducible-modrng"></a>
## `IsAbsolutelyIrreducible(M): ModRng -> BoolElt, AlgMatElt, RngIntElt`

Given an $K[G]$-module $M$ where $K$ is a finite field, the intrinsic return `true` if and only if $M$ is absolutely irreducible. If $M$ is reducible, a matrix algebra generator for the endomorphism algebra $E$ of $M$ (a field), as well as the dimension of $E$, are also returned.

<a id="function-isdecomposable-modrng"></a>
## `IsDecomposable(M): ModRng -> BoolElt, ModRng, ModRng`

Given an $A$-module $M$ defined over a finite field or a number field, the intrinsic returns `true` if and only if $M$ is decomposable. If $M$ is decomposable and defined over a finite field, the function also returns proper submodules $S$ and $T$ of $M$ such that $M = S\oplus T$.

<a id="function-issemisimple-modgrp"></a>
## `IsSemisimple(M): ModGrp -> BoolElt`

Given a $K[G]$-module $M$ defined over a finite field or a number field, return `true` if $M$ is semisimple and `false` otherwise. The function returns a second value listing the ranks of the primitive idempotents of the algebra. This is also a list of the multiplicities of composition factors in a composition series for $M$.

<a id="function-isprojective-modgrp"></a>
## `IsProjective(M): ModGrp -> BoolElt`

Given an $K[G]$-module $M$, where $K$ is a field, the intrinsic returns `true` if and only $M$ is a projective $K[G]$-module.

<a id="function-isfree-modgrp"></a>
## `IsFree(M): ModGrp -> BoolElt`

Given an $K[G]$-module $M$, where $K$ is a field, the intrinsic returns `true` if and only $M$ is a free $K[G]$-module.

<a id="function-isselfdual-modgrp"></a>
## `IsSelfDual(M): ModGrp -> BoolElt`

Given an $A$-module $M$, return whether $M$ is self-dual, that is, whether $M$ is isomorphic to the dual of $M$.

<a id="function-ispermutationmodule-modrng"></a>
## `IsPermutationModule(M): ModRng -> BoolElt`

Given an $K[G]$-module $M$, the intrinsic returns `true` if and only if the generators of the matrix algebra giving the action of $G$ are permutation matrices.
