---
title: "The Torsion Subgroup"
canonical: "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/torsion.html"
source: "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/torsion.md"
part: "Arithmetic Geometry"
chapter: "Elliptic Curves over Function Fields"
breadcrumbs:
  - {"title": "Magma Handbook", "source": "https://docs.magma-maths.org/v2.30-1/index.md"}
  - {"title": "Arithmetic Geometry", "source": "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/index-arithmetic-geometry.md"}
  - {"title": "Elliptic Curves over Function Fields", "source": "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/index-elliptic-curves-over-function-fields.md"}
prev: {"title": "Heights", "source": "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/heights.md"}
next: {"title": "The Mordell–Weil Group", "source": "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/mordell-weil-group.md"}
intrinsics:
  - {"name": "TorsionSubgroup", "signature": "TorsionSubgroup(E): CrvEll[FldFunG] -> GrpAb, Map"}
  - {"name": "TorsionBound", "signature": "TorsionBound(E, n): CrvEll[FldFunG], RngIntElt -> RngIntElt"}
  - {"name": "TorsionBound", "signature": "TorsionBound(E, n, B): CrvEll[FldFunG], RngIntElt, RngIntElt -> RngIntElt"}
  - {"name": "GeometricTorsionBound", "signature": "GeometricTorsionBound(E): CrvEll[FldFunG] -> RngIntElt"}
---

# The Torsion Subgroup

<a id="function-torsionsubgroup-crvell-fldfung"></a>
## `TorsionSubgroup(E): CrvEll[FldFunG] -> GrpAb, Map`

Given an elliptic curve $E$ defined over a function field $F$, this function returns an abelian group $A$ isomorphic to the torsion subgroup of $E(F)$, together with a map from $A$ to $E(F)$.

<a id="function-torsionbound-crvell-fldfung-rngintelt"></a>
## `TorsionBound(E, n): CrvEll[FldFunG], RngIntElt -> RngIntElt`

<a id="function-torsionbound-crvell-fldfung-rngintelt-rngintelt"></a>
## `TorsionBound(E, n, B): CrvEll[FldFunG], RngIntElt, RngIntElt -> RngIntElt`

Given an elliptic curve over a function field $F$ and an integer $n$, this function computes a bound on the size of the torsion subgroup of $E(F)$ by considering the torsion subgroups of the fibres of $E$ at $n$ different places of $F$.

When an integer $B$ is given as a third argument then the subgroup of elements of order dividing $B$ is bounded, rather than the whole torsion subgroup.

<a id="function-geometrictorsionbound-crvell-fldfung"></a>
## `GeometricTorsionBound(E): CrvEll[FldFunG] -> RngIntElt`

Given an elliptic curve $E$ defined over a function field $F$, this function computes a bound for the geometric torsion subgroup of $E$. That is, the torsion group of $E(K)$ where $K/F$ is the smallest extension with algebraically closed constant field. In cases where a bound cannot be computed then $0$ is returned.
