---
title: "Points on the Kummer Surface"
canonical: "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/HyperellipticCurves/points_kummer.html"
source: "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/HyperellipticCurves/points_kummer.md"
part: "Arithmetic Geometry"
chapter: "Hyperelliptic Curves"
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": "Hyperelliptic Curves", "source": "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/HyperellipticCurves/index-hyperelliptic-curves.md"}
prev: {"title": "Kummer Surfaces", "source": "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/HyperellipticCurves/kummer-surfaces.md"}
next: {"title": "Analytic Jacobians of Hyperelliptic Curves", "source": "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/HyperellipticCurves/analytic.md"}
intrinsics:
  - {"name": "!", "signature": "K ! 0: SrfKum, RngIntElt -> SrfKumPt"}
  - {"name": "!", "signature": "K ! [x1, x2, x3, x4]: SrfKum, [ RngElt ] -> SrfKumPt"}
  - {"name": "!", "signature": "K ! P: SrfKum, SrfKumPt -> SrfKumPt"}
  - {"name": "!", "signature": "K ! P: SrfKum, JacHypPt -> SrfKumPt"}
  - {"name": "IsPoint", "signature": "IsPoint(K, S): SrfKum, [RngElt] -> BoolElt, SrfKumPt"}
  - {"name": "Points", "signature": "Points(K, [x1, x2, x3]): SrfKum, [RngElt] -> SetIndx"}
  - {"name": "P[i]", "signature": "P[i]: SrfKumPt, RngIntElt -> RngElt"}
  - {"name": "Eltseq", "signature": "Eltseq(P): SrfKumPt -> SeqEnum"}
  - {"name": "ElementToSequence", "signature": "ElementToSequence(P): PtHyp -> SeqEnum"}
  - {"name": "eq", "signature": "P eq Q: SrfKumPt, SrfKumPt -> BoolElt"}
  - {"name": "ne", "signature": "P ne Q: SrfKumPt, SrfKumPt -> BoolElt"}
  - {"name": "-", "signature": "- P: SrfKumPt -> SrfKumPt"}
  - {"name": "*", "signature": "n * P: RngIntElt, SrfKumPt -> SrfKumPt"}
  - {"name": "*", "signature": "P * n: SrfKumPt, RngIntElt -> SrfKumPt"}
  - {"name": "Double", "signature": "Double(P): SrfKumPt -> SrfKumPt"}
  - {"name": "PseudoAdd", "signature": "PseudoAdd(P1, P2, P3): SrfKumPt, SrfKumPt, SrfKumPt -> SrfKumPt"}
  - {"name": "PseudoAddMultiple", "signature": "PseudoAddMultiple(P1, P2, P3, n): SrfKumPt, SrfKumPt, SrfKumPt, RngIntElt -> SrfKumPt"}
  - {"name": "RationalPoints", "signature": "RationalPoints(K, Q): SrfKum, [RngElt] -> SetIndx"}
  - {"name": "Points", "signature": "Points(J, P): JacHyp, SrfKumPt -> SetIndx"}
  - {"name": "RationalPoints", "signature": "RationalPoints(J, P): JacHyp, SrfKumPt -> SetIndx"}
examples:
  - "ex-51064e"
---

# Points on the Kummer Surface

Points are given by their projective coordinates, normalized depending on the base field.

## Creation of Points

<a id="operation-op-srfkum-rngintelt"></a>
### `K ! 0: SrfKum, RngIntElt -> SrfKumPt`

Returns the image of the identity element on the Kummer surface $K$, which is normalized to be the origin $(0 : 0 : 0 : 1)$.

<a id="operation-op-srfkum-rngelt"></a>
### `K ! [x1, x2, x3, x4]: SrfKum, [ RngElt ] -> SrfKumPt`

Returns the point on the Kummer surface $K$ defined by the projective coordinates $x_1$, $x_2$, $x_3$, and $x_4$.

<a id="operation-op-srfkum-srfkumpt"></a>
### `K ! P: SrfKum, SrfKumPt -> SrfKumPt`

<a id="operation-op-srfkum-jachyppt"></a>
### `K ! P: SrfKum, JacHypPt -> SrfKumPt`

Given a point $P$ on the Jacobian of $K$, or on a Kummer surface for which $K$ is a base extension, this returns the point on $K$.

<a id="function-ispoint-srfkum-rngelt"></a>
### `IsPoint(K, S): SrfKum, [RngElt] -> BoolElt, SrfKumPt`

Given a sequence $S = [x_1,x_2,x_3,x_4]$ of elements of the base field of $K$, the function returns `true` if the point specified by the sequence defines the homogeneous coordinates of a point on the Kummer surface $K$. If so, the corresponding point on $K$ is returned as the second value.

<a id="function-points-srfkum-rngelt"></a>
### `Points(K, [x1, x2, x3]): SrfKum, [RngElt] -> SetIndx`

Returns the indexed set of points on the Kummer surface $K$ with first three coordinates given by the sequence $[x_1, x_2, x_3]$.

## Access Operations

<a id="literal-literal-p-i-srfkumpt-rngintelt-rngelt"></a>
### `P[i]: SrfKumPt, RngIntElt -> RngElt`

Returns the $i$-th coordinate of the point $P$, for $1\leq i\leq 4$.

<a id="function-eltseq-srfkumpt"></a>
### `Eltseq(P): SrfKumPt -> SeqEnum`

<a id="function-elementtosequence-pthyp-3"></a>
### `ElementToSequence(P): PtHyp -> SeqEnum`

Given a point $P$ on a Kummer surface, the function returns the coordinates of $P$ as a sequence.

## Predicates on Points

<a id="operation-op-eq-srfkumpt-srfkumpt"></a>
### `P eq Q: SrfKumPt, SrfKumPt -> BoolElt`

Given two points on the same Kummer surface, this returns `true` if and only if the points $P$ and $Q$ are equal.

<a id="operation-op-ne-srfkumpt-srfkumpt"></a>
### `P ne Q: SrfKumPt, SrfKumPt -> BoolElt`

Given two points on the same Kummer surface, this returns `false` if and only if the points $P$ and $Q$ are equal.

## Arithmetic of Points

<a id="operation-operation-srfkumpt-srfkumpt"></a>
### `- P: SrfKumPt -> SrfKumPt`

Returns the negation of the point $P$ on the Kummer surface, equal to $P$ itself.

<a id="operation-op-times-rngintelt-srfkumpt"></a>
### `n * P: RngIntElt, SrfKumPt -> SrfKumPt`

<a id="operation-op-times-srfkumpt-rngintelt"></a>
### `P * n: SrfKumPt, RngIntElt -> SrfKumPt`

Returns the $n$-th multiple of the point $P$ on the Kummer surface $K$.

<a id="function-double-srfkumpt"></a>
### `Double(P): SrfKumPt -> SrfKumPt`

Returns the double $2*P$ of the point $P$.

<a id="function-pseudoadd-srfkumpt-srfkumpt-srfkumpt"></a>
### `PseudoAdd(P1, P2, P3): SrfKumPt, SrfKumPt, SrfKumPt -> SrfKumPt`

Let $P$ and $Q$ be points on the Jacobian $J$ of a genus $2$ curve. Given the images $P_1$, $P_2$, and $P_3$ on the Kummer surface of points $P$, $Q$, and $P-Q$ on $J$, the function returns the image of $P+Q$.

<a id="function-pseudoaddmultiple-srfkumpt-srfkumpt-srfkumpt-rngintelt"></a>
### `PseudoAddMultiple(P1, P2, P3, n): SrfKumPt, SrfKumPt, SrfKumPt, RngIntElt -> SrfKumPt`

Let $P$ and $Q$ be points on the Jacobian $J$ of a genus $2$ curve. Given the images $P_1$, $P_2$, and $P_3$ on the Kummer surface of points $P$, $Q$, $P-Q$ on $J$, the function returns the image of $P + n*Q$.

## Rational Points on the Kummer Surface

<a id="function-rationalpoints-srfkum-rngelt"></a>
### `RationalPoints(K, Q): SrfKum, [RngElt] -> SetIndx`

Given the Kummer surface of the Jacobian of a genus $2$ hyperelliptic curve defined over a ring $R$ and sequence $Q$ of three elements of $R$, the function returns an indexed set containing those points on $K$ whose first three coordinates correspond to the three terms of $Q$.

<a id="example-ex-51064e"></a>
### `Example: Searching Points on a Kummer Surface (ex-51064e)`

We search for some points on the Kummer surface of the hyperelliptic curve $y^2=x^5-7$ defined over the rational field.

```magma
> P<x> := PolynomialRing(Rationals());
> C := HyperellipticCurve(x^5-7);
> Genus(C);
2
> J := Jacobian(C);
> K := KummerSurface(J);
> K;
Kummer surface of Jacobian of Hyperelliptic Curve defined by
    y^2 = x^5 - 7 over Rational Field
> Points(K, [0,1,2]);
{@ (0 : 1 : 2 : 4) @}
> Points(K, [1,3,2]);
{@ @}
> Points(K, [0,1,3]);
{@ (0 : 1 : 3 : 9) @}
```

## Pullback to the Jacobian

<a id="function-points-jachyp-srfkumpt"></a>
### `Points(J, P): JacHyp, SrfKumPt -> SetIndx`

<a id="function-rationalpoints-jachyp-srfkumpt"></a>
### `RationalPoints(J, P): JacHyp, SrfKumPt -> SetIndx`

Given a point $P$ on the Kummer surface associated to the Jacobian $J$ (of a genus $2$ curve), the function returns the indexed set of points on $J$ mapping to $P$.
