---
title: "Elliptic Curves over Function Fields"
canonical: "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/index-elliptic-curves-over-function-fields.html"
source: "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/index-elliptic-curves-over-function-fields.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"}
prev: {"title": "Bibliography", "source": "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverQAndNumberFields/bibliography.md"}
next: {"title": "An Overview of Relevant Theory", "source": "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/theory.md"}
---

<a id="elliptic-curve-fldfun"></a>
<a id="crvellfldfun"></a>
# Elliptic Curves over Function Fields

This section involves elliptic curves with coefficients in a function field $k(C)$ where $C$ is a regular projective curve over some field $k$ (usually a number field or a finite field). The commands are largely parallel to those for elliptic curves over the rationals; one can compute local information (Tate’s algorithm and so forth), a minimal model, the $L$-function, the $2$-Selmer group, and the Mordell–Weil group. This goes in order of decreasing generality: Local information is available for curves over univariate function fields over any exact base field, while at the other extreme Mordell–Weil groups are available only for curves over rational function fields over finite fields for which the associated surface is a rational surface. The generality of many of the commands will be expanded in future releases.

- [An Overview of Relevant Theory](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/theory.md)
- [Local Computations](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/local.md)
  - [`BadPlaces(E): CrvEll → [ PlcFunElt ]`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/local.md#function-badplaces-crvell)
  - [`Conductor(E): CrvEll → DivFunElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/local.md#function-conductor-crvell)
  - [`LocalInformation(E, Pl): CrvEll[FldFun], PlcFunElt → Tup, CrvEll`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/local.md#function-localinformation-crvell-fldfun-plcfunelt)
  - [`LocalInformation(E, f): CrvEll[FldFunRat], FldFunRatUElt → Tup, CrvEll`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/local.md#function-localinformation-crvell-fldfunrat-fldfunratuelt)
  - [`LocalInformation(E): CrvEll → [ < Tup > ]`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/local.md#function-localinformation-crvell)
  - [`KodairaSymbols(E): CrvEll → [ <SymKod, RngIntElt> ]`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/local.md#function-kodairasymbols-crvell)
  - [`NumberOfComponents(K): SymKod → RngIntElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/local.md#function-numberofcomponents-symkod)
  - [`MinimalModel(E): CrvEll[FldFunG] → CrvEll, MapIsoSch`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/local.md#function-minimalmodel-crvell-fldfung)
  - [`MinimalDegreeModel(E): CrvEll[FldFunRat] → CrvEll, Map, Map`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/local.md#function-minimaldegreemodel-crvell-fldfunrat)
  - [`IsConstantCurve(E): CrvEll[FldFunRat] → BoolElt, CrvEll`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/local.md#function-isconstantcurve-crvell-fldfunrat)
  - [`TraceOfFrobenius(E, p): CrvEll[FldFunRat], RngElt → BoolElt, CrvEll`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/local.md#function-traceoffrobenius-crvell-fldfunrat-rngelt)
- [Elliptic Curves of Given Conductor](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/ecsearch.md)
  - [`EllipticCurveSearch(N, Effort): [], RngIntElt → SeqEnum`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/ecsearch.md#function-ellipticcurvesearch-rngintelt)
- [Heights](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/heights.md)
  - [`NaiveHeight(P): PtEll → FldPrElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/heights.md#function-naiveheight-ptell)
  - [`Height(P): PtEll → FldRatElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/heights.md#function-height-ptell)
  - [`LocalHeight(P, Pl): PtEll, PlcFunElt → FldPrElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/heights.md#function-localheight-ptell-plcfunelt)
  - [`HeightPairing(P, Q): PtEll[FldFunG], PtEll[FldFunG] → FldRatElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/heights.md#function-heightpairing-ptell-fldfung-ptell-fldfung)
  - [`HeightPairingMatrix(S): SeqEnum[PtEll[FldFunG]] → AlgMatElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/heights.md#function-heightpairingmatrix-seqenum-ptell-fldfung)
  - [`HeightPairingLattice(S): [PtEll[FldFunG]] → AlgMatElt, Map`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/heights.md#function-heightpairinglattice-ptell-fldfung)
  - [`Basis(S): [ PtEll ] → [ PtEll ], ModMatAlgElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/heights.md#function-basis-ptell)
  - [`Basis(S, r, disc): SeqEnum, RngIntElt, RngIntElt → SeqEnum`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/heights.md#function-basis-seqenum-rngintelt-rngintelt)
  - [`IsLinearlyDependent(points): [PtEll] → BoolElt, ModTupRngElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/heights.md#function-islinearlydependent-ptell)
  - [`IsLinearlyIndependent(points): [PtEll] → BoolElt, ModTupRngElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/heights.md#function-islinearlyindependent-ptell)
  - [`IndependentGenerators(points): [PtEll] → [PtEll]`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/heights.md#function-independentgenerators-ptell)
- [The Torsion Subgroup](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/torsion.md)
  - [`TorsionSubgroup(E): CrvEll[FldFunG] → GrpAb, Map`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/torsion.md#function-torsionsubgroup-crvell-fldfung)
  - [`TorsionBound(E, n): CrvEll[FldFunG], RngIntElt → RngIntElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/torsion.md#function-torsionbound-crvell-fldfung-rngintelt)
  - [`TorsionBound(E, n, B): CrvEll[FldFunG], RngIntElt, RngIntElt → RngIntElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/torsion.md#function-torsionbound-crvell-fldfung-rngintelt-rngintelt)
  - [`GeometricTorsionBound(E): CrvEll[FldFunG] → RngIntElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/torsion.md#function-geometrictorsionbound-crvell-fldfung)
- [The Mordell–Weil Group](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/mordell-weil-group.md)
  - [`RankBounds(E): CrvEll[FldFunG] → RngIntElt, RngIntElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/mordell-weil-group.md#function-rankbounds-crvell-fldfung)
  - [`RankBound(E): CrvEll[FldFunG] → RngIntElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/mordell-weil-group.md#function-rankbound-crvell-fldfung)
  - [`MordellWeilGroup(E : parameters): CrvEll[FldFunRat] → GrpAb, Map`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/mordell-weil-group.md#function-mordellweilgroup-crvell-fldfunrat)
  - [`MordellWeilLattice(E): CrvEll[FldFunRat] → Lat, Map`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/mordell-weil-group.md#function-mordellweillattice-crvell-fldfunrat)
  - [`GeometricMordellWeilLattice(E): CrvEll[FldFunRat] → Lat, Map`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/mordell-weil-group.md#function-geometricmordellweillattice-crvell-fldfunrat)
  - [`Generators(E): CrvEll[FldFunRat] → SeqEnum`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/mordell-weil-group.md#function-generators-crvell-fldfunrat)
  - [Example: Rank 2 Curve over a Function Field](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/mordell-weil-group.md#example-ex-ee4c8d)
- [Two Descent](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/two-descent.md)
  - [`TwoSelmerGroup(E): CrvEll[FldFunG] → GrpAb, MapSch`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/two-descent.md#function-twoselmergroup-crvell-fldfung)
  - [`TwoDescent(E): CrvEll[FldFunG] → SeqEnum[CrvHyp], List[MapSch]`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/two-descent.md#function-twodescent-crvell-fldfung)
  - [`QuarticMinimize(f): RngMPolElt[FldFunRat] → RngMPolElt[FldFunRat]`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/two-descent.md#function-quarticminimize-rngmpolelt-fldfunrat)
  - [`Points(C : parameters): CrvHyp → [Pt]`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/two-descent.md#function-points-crvhyp)
  - [`PointsQI(C, H): Crv, RngIntElt → [Pt]`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/two-descent.md#function-pointsqi-crv-rngintelt)
  - [`TwoIsogenySelmerGroups(E): CrvEll[FldFunG] → GrpAb, GrpAb, MapSch, MapSch`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/two-descent.md#function-twoisogenyselmergroups-crvell-fldfung)
- [The $L$-function and Counting Points](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/Lfunction.md)
  - [`LFunction(E): CrvEll[FldFunRat] → RngUPolElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/Lfunction.md#function-lfunction-crvell-fldfunrat)
  - [`LFunction(E, S): CrvEll[FldFunRat], <SeqEnum> → RngUPolElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/Lfunction.md#function-lfunction-crvell-fldfunrat-seqenum)
  - [`LFunction(E, e): CrvEll[FldFunRat], RngIntElt → RngUPolElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/Lfunction.md#function-lfunction-crvell-fldfunrat-rngintelt)
  - [`AnalyticRank(E): CrvEll[FldFunG] → RngIntElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/Lfunction.md#function-analyticrank-crvell-fldfung)
  - [`AnalyticInformation(E): CrvEll[FldFunG] → Tup`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/Lfunction.md#function-analyticinformation-crvell-fldfung)
  - [`AnalyticInformation(E, L): CrvEll[FldFunG], RngUPolElt → Tup`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/Lfunction.md#function-analyticinformation-crvell-fldfung-rngupolelt)
  - [`AnalyticInformation(E, e): CrvEll[FldFunG], RngIntElt → Tup`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/Lfunction.md#function-analyticinformation-crvell-fldfung-rngintelt)
  - [Example: Tate-Shafarevich Group via the L-Function](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/Lfunction.md#example-ex-b7cb32)
  - [Example: L-Function of a Rank 2 Curve](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/Lfunction.md#example-ex-f412e7)
  - [`NumberOfPointsOnSurface(E, e): CrvEll, RngIntElt → RngIntElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/Lfunction.md#function-numberofpointsonsurface-crvell-rngintelt)
  - [`NumbersOfPointsOnSurface(E, e): CrvEll, RngIntElt → [ RngIntElt ], [ RngIntElt ]`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/Lfunction.md#function-numbersofpointsonsurface-crvell-rngintelt)
  - [`BettiNumber(E, i): CrvEll, RngIntElt → RngIntElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/Lfunction.md#function-bettinumber-crvell-rngintelt)
  - [`CharacteristicPolynomialFromTraces(traces): [ Fld ] → RngUPolElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/Lfunction.md#function-characteristicpolynomialfromtraces-fld)
  - [`CharacteristicPolynomialFromTraces(traces, d, q, i): [ Fld ], RngIntElt, RngIntElt, RngIntElt → RngUPolElt, RngUPolElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/Lfunction.md#function-characteristicpolynomialfromtraces-fld-rngintelt-rngintelt-rngintelt)
- [Action of Frobenius](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/frobenius-action.md)
  - [`Frobenius(P, q): PtEll[FldFunRat], RngIntElt → PtEll`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/frobenius-action.md#function-frobenius-ptell-fldfunrat-rngintelt)
  - [`FrobeniusActionOnPoints(S, q : parameters): [ PtEll ], RngIntElt → AlgMatElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/frobenius-action.md#function-frobeniusactiononpoints-ptell-rngintelt)
  - [`FrobeniusActionOnReducibleFiber(L): < Tup > → AlgMatElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/frobenius-action.md#function-frobeniusactiononreduciblefiber-tup)
  - [`FrobeniusActionOnTrivialLattice(E): CrvEll → AlgMatElt`](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/frobenius-action.md#function-frobeniusactionontriviallattice-crvell)
- [Extended Examples](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/extended-examples.md)
  - [Example: Elliptic Curve from a Pencil of Cubics](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/extended-examples.md#example-ex-4e11bd)
  - [Example: Complex Rank by Reduction Modulo p](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/extended-examples.md#example-ex-198933)
  - [Example: Partial L-Function by Hand](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/extended-examples.md#example-ex-98b1c7)
- [Bibliography](https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/EllipticCurvesOverFunctionFields/bibliography.md)
