---
title: "Chain Complexes"
canonical: "https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/index-chain-complexes.html"
source: "https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/index-chain-complexes.md"
part: "Modules"
chapter: "Chain Complexes"
breadcrumbs:
  - {"title": "Magma Handbook", "source": "https://docs.magma-maths.org/v2.30-1/index.md"}
  - {"title": "Modules", "source": "https://docs.magma-maths.org/v2.30-1/Modules/index-modules.md"}
prev: {"title": "Pseudo Matrices", "source": "https://docs.magma-maths.org/v2.30-1/Modules/ModulesOverDedekindDomains/pmat.md"}
next: {"title": "Complexes of Modules", "source": "https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md"}
---

<a id="complexes"></a>
<a id="chap-chain-complexes"></a>
# Chain Complexes

- [Complexes of Modules](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md)
  - [Creation](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#creation)
    - [`Complex(L, d): List, RngIntElt → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-complex-list-rngintelt)
    - [`Complex(f, d): Map, RngIntElt → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-complex-map-rngintelt)
    - [`ZeroComplex(A, m, n): AlgBas, RngIntElt, RngIntElt → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-zerocomplex-algbas-rngintelt-rngintelt)
    - [`Dual(C): ModCpx → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-dual-modcpx)
    - [`Dual(C, n): ModCpx, RngIntElt → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-dual-modcpx-rngintelt)
  - [Subcomplexes and Quotient Complexes](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#subcomplexes-and-quotient-complexes)
    - [`sub< C | Q >: ModCpx, SeqEnum[ModAlg] → ModCpx, MapChn`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#constructor-constructor-sub-modcpx-seqenum-modalg-modcpx-mapchn)
    - [`sub< C | L >: ModCpx, List → ModCpx, MapChn`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#constructor-constructor-sub-modcpx-list-modcpx-mapchn)
    - [`RandomSubcomplex(C, Q): ModCpx, SeqEnum → ModCpx, MapChn`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-randomsubcomplex-modcpx-seqenum)
    - [`quo< C | D >: ModCpx, ModCpx → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#constructor-constructor-quo-modcpx-modcpx-modcpx)
    - [`quo< C | S >: ModCpx, SeqEnum[ModAlg] → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#constructor-constructor-quo-modcpx-seqenum-modalg-modcpx)
    - [`quo< C | L >: ModCpx, List → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#constructor-constructor-quo-modcpx-list-modcpx)
  - [Access Functions](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#access-functions)
    - [`Degrees(C): ModCpx → RngIntElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-degrees-modcpx)
    - [`Algebra(C): ModCpx → AlgBas`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-algebra-modcpx)
    - [`BoundaryMap(C, n): ModCpx, RngIntElt → ModMatRngElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-boundarymap-modcpx-rngintelt)
    - [`BoundaryMaps(C): ModCpx → List`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-boundarymaps-modcpx)
    - [`DimensionsOfHomology(C): ModCpx → SeqEnum`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-dimensionsofhomology-modcpx)
    - [`DimensionOfHomology(C, n): ModCpx, RngIntElt → RngIntElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-dimensionofhomology-modcpx-rngintelt)
    - [`DimensionsOfTerms(C): ModCpx → SeqEnum`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-dimensionsofterms-modcpx)
    - [`Term(C, n): ModCpx, RngIntElt → ModAlg`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-term-modcpx-rngintelt)
    - [`Terms(C): ModCpx → SeqEnum`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-terms-modcpx)
  - [Elementary Operations](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#elementary-operations)
    - [`DirectSum(C, D): ModCpx, ModCpx → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-directsum-modcpx-modcpx)
    - [`Homology(C): ModCpx → SeqEnum`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-homology-modcpx)
    - [`HomologyOfChainComplex(C): ModCpx → SeqEnum`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-homologyofchaincomplex-modcpx)
    - [`Homology(C, n): ModCpx, RngIntElt → SeqEnum`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-homology-modcpx-rngintelt)
    - [`Prune(C): ModCpx → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-prune-modcpx)
    - [`Prune(C,n): ModCpx, RngIntElt → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-prune-modcpx-rngintelt)
    - [`Preprune(C): ModCpx → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-preprune-modcpx)
    - [`Preprune(C,n): ModCpx, RngIntElt → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-preprune-modcpx-rngintelt)
    - [`Shift(C, n): ModCpx, RngIntElt → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-shift-modcpx-rngintelt)
    - [`ShiftToDegreeZero(C): ModCpx → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-shifttodegreezero-modcpx)
    - [`Splice(C, D): ModCpx, ModCpx → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-splice-modcpx-modcpx)
    - [`Splice(C, D, f): ModCpx, ModCpx, ModMatRngElt → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-splice-modcpx-modcpx-modmatrngelt)
  - [Extensions](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#extensions)
    - [`LeftExactExtension(C): ModCpx → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-leftexactextension-modcpx)
    - [`RightExactExtension(C): ModCpx → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-rightexactextension-modcpx)
    - [`ExactExtension(C): ModCpx → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-exactextension-modcpx)
    - [`LeftZeroExtension(C): ModCpx → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-leftzeroextension-modcpx)
    - [`LeftZeroExtension(C, n): ModCpx, RngIntElt → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-leftzeroextension-modcpx-rngintelt)
    - [`RightZeroExtension(C): ModCpx → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-rightzeroextension-modcpx)
    - [`RightZeroExtension(C, n): ModCpx, RngIntElt → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-rightzeroextension-modcpx-rngintelt)
    - [`ZeroExtension(C): ModCpx → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-zeroextension-modcpx)
    - [`EqualizeDegrees(C, D): ModCpx, ModCpx → ModCpx, ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-equalizedegrees-modcpx-modcpx)
    - [`EqualizeDegrees(Q): SeqEnum → SeqEnum`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-equalizedegrees-seqenum)
    - [`EqualizeDegrees(C, D, n): ModCpx, ModCpx, RngIntElt → ModCpx, ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-equalizedegrees-modcpx-modcpx-rngintelt)
  - [Predicates](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#predicates)
    - [`IsExact(C): ModComplex → BoolElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-isexact-modcomplex)
    - [`IsShortExactSequence(C): ModCpx → BoolElt, RngIntElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-isshortexactsequence-modcpx)
    - [`IsExact(C, n): ModCpx, RngIntElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-isexact-modcpx-rngintelt)
    - [`IsZeroComplex(C): ModCpx → BoolElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-iszerocomplex-modcpx)
    - [`IsZeroMap(C, n): ModCpx, RngIntElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-iszeromap-modcpx-rngintelt)
    - [`IsZeroTerm(C, n): ModCpx, RngIntElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#function-iszeroterm-modcpx-rngintelt)
    - [Example: Complexes over a Quiver Algebra](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/complexes.md#example-ex-bb43ae)
- [Chain Maps](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md)
  - [Creation](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#creation)
    - [`ChainMap(Q, C, D, n): SeqEnum, ModCpx, ModCpx, RngIntElt → MapChn`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-chainmap-seqenum-modcpx-modcpx-rngintelt)
    - [`ZeroChainMap(C, D): ModCpx, ModCpx → MapChn`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-zerochainmap-modcpx-modcpx)
  - [Access Functions](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#access-functions)
    - [`Degree(f): MapChn → RngIntElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-degree-mapchn)
    - [`ModuleMap(f, n): MapChn, RngIntElt → ModMatRngElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-modulemap-mapchn-rngintelt)
    - [`Kernel(f): MapChn → ModCpx, MapChn`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-kernel-mapchn)
    - [`Cokernel(f): MapChn → ModCpx, MapChn`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-cokernel-mapchn)
    - [`Image(f): MapChn → ModCpx, MapChn, MapChn`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-image-mapchn)
  - [Elementary Operations](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#elementary-operations)
    - [`f + g: MapChn, MapChn → MapChn`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#operation-op-plus-mapchn-mapchn)
    - [`a * g: RngElt, MapChn → MapChn`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#operation-op-times-rngelt-mapchn)
    - [`f * g: MapChn, MapChn → MapChn`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#operation-op-times-mapchn-mapchn)
  - [Predicates](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#predicates)
    - [`IsSurjective(f): MapChn → BoolElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-issurjective-mapchn)
    - [`IsInjective(f): MapChn → BoolElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-isinjective-mapchn)
    - [`IsZero(f): MapChn → BoolElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-iszero-mapchn)
    - [`IsIsomorphism(f): MapChn → BoolElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-isisomorphism-mapchn)
    - [`IsShortExactSequence(f, g): MapChn, MapChn → BoolElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-isshortexactsequence-mapchn-mapchn)
    - [`IsChainMap(L, C, D, n): List, ModCpx, ModCpx, RngIntElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-ischainmap-list-modcpx-modcpx-rngintelt)
    - [`IsChainMap(f): MapChn → BoolElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-ischainmap-mapchn)
    - [`IsProperChainMap(f): MapChn → BoolElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-isproperchainmap-mapchn)
    - [`HasDefinedModuleMap(C,n): ModCpx, RngIntElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-hasdefinedmodulemap-modcpx-rngintelt)
    - [Example: Chain Maps over a Basic Algebra](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#example-ex-f4e1ae)
  - [Maps on Homology](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#maps-on-homology)
    - [`InducedMapOnHomology(f, n): MapChn, RngIntElt → ModTupFldElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-inducedmaponhomology-mapchn-rngintelt)
    - [`ConnectingHomomorphism(f, g, n): MapChn, MapChn, RngIntElt → ModMatRngElt`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-connectinghomomorphism-mapchn-mapchn-rngintelt)
    - [`LongExactSequenceOnHomology(f, g): MapChn, MapChn → ModCpx`](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#function-longexactsequenceonhomology-mapchn-mapchn)
    - [Example: Long Exact Sequence in Homology](https://docs.magma-maths.org/v2.30-1/Modules/ChainComplexes/chainmaps.md#example-ex-4cd4be)
