---
title: "Transformations between Genus One Models"
canonical: "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/ModelsOfGenusOneCurves/transformations.html"
source: "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/ModelsOfGenusOneCurves/transformations.md"
part: "Arithmetic Geometry"
chapter: "Models of Genus One 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": "Models of Genus One Curves", "source": "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/ModelsOfGenusOneCurves/index-models-of-genus-one-curves.md"}
prev: {"title": "Attributes of Genus One Models", "source": "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/ModelsOfGenusOneCurves/attributes.md"}
next: {"title": "Equivalence of Genus One Models", "source": "https://docs.magma-maths.org/v2.30-1/ArithmeticGeometry/ModelsOfGenusOneCurves/equivalence.md"}
intrinsics:
  - {"name": "IsTransformation", "signature": "IsTransformation(n, g): RngIntElt, Tup -> BoolElt, TransG1"}
  - {"name": "Tuple", "signature": "Tuple(g): TransG1 -> Tup"}
  - {"name": "ChangeRing", "signature": "ChangeRing(g, R): TransG1, Rng -> TransG1"}
  - {"name": "IdentityTransformation", "signature": "IdentityTransformation(n, R): RngIntElt, Rng -> TransG1"}
  - {"name": "RandomTransformation", "signature": "RandomTransformation(n : parameters): RngIntElt -> TransG1"}
  - {"name": "*", "signature": "g * model: TransG1, ModelG1 -> ModelG1"}
  - {"name": "ApplyTransformation", "signature": "ApplyTransformation(g, model): TransG1, ModelG1 -> ModelG1"}
  - {"name": "*", "signature": "g1 * g2: TransG1, TransG1 -> TransG1"}
  - {"name": "ComposeTransformations", "signature": "ComposeTransformations(g1, g2): TransG1, TransG1 -> TransG1"}
  - {"name": "MultiplyTransformations", "signature": "MultiplyTransformations(g1, g2): TransG1, TransG1 -> TransG1"}
  - {"name": "Inverse", "signature": "Inverse(g): TransG1 -> TransG1"}
  - {"name": "InverseTransformation", "signature": "InverseTransformation(g): TransG1 -> TransG1"}
  - {"name": "InverseTransformation", "signature": "InverseTransformation(n, g): RngIntElt, TransG1 -> TransG1"}
  - {"name": "ScalingFactor", "signature": "ScalingFactor(g): TransG1 -> RngElt"}
  - {"name": "ScalingFactor", "signature": "ScalingFactor(n, g): RngIntElt, TransG1 -> RngElt"}
  - {"name": "Determinant", "signature": "Determinant(g): TransG1 -> RngElt"}
---

<a id="transformations"></a>
# Transformations between Genus One Models

A transformation between two genus one models of degree $n=2$, 3, 4, or 5 is an isomorphism of the underlying data which preserves some additional structure.

Transformations of genus one models have their own type `TransG1`. A transformation can be applied to a model using `'*'`. The syntax for creating transformations, and for extracting data from them, is described in this section.

For degree 2 models $q(x,z)$ without cross terms, or for degree 3 models, a transformation is a tuple $\left< k, S \right>$, where $k$ is an element of the coefficient ring; the transformed model is obtained by making the substitution of coordinate variables determined by $S$ and multiplying the equation by $k$. For degree 2 models with cross terms a transformation is a tuple $\left< k, [A,B,C], S \right>$, where $k$ and $S$ are as above and in addition $y+Ax^2+Bx z + Cz^2$ is substituted for $y$ in the transformation. For degree 4, the first element is a $2 \times 2$ matrix; a model of degree 4 is given by two quadric equations, and the $2 \times 2$ matrix determines a change of basis of the quadrics (acting on them from the left). A transformation of degree $5$ models is a tuple $\left< T,S \right>$ where $T$ and $S$ are both $5 \times 5$ matrices; a model of degree $5$ is given by a $5 \times 5$ matrix of linear forms $M$, and the transformed model is given by $TM_ST^{tr}$ where $M_S$ is obtained from $M$ by making the substitution of coordinate variables specified by $S$.

Two genus one models are said to be equivalent if they differ by such a transformation. Equivalent models have the same invariants up to scaling by the 4th and 6th powers of some element.

<a id="function-istransformation-rngintelt-tup"></a>
## `IsTransformation(n, g): RngIntElt, Tup -> BoolElt, TransG1`

This returns `true` if and only if the tuple $g$ represents a transformation of genus one models of degree $n$. If so, it also returns the transformation as an object of type `TransG1`.

<a id="function-tuple-transg1"></a>
## `Tuple(g): TransG1 -> Tup`

This returns a tuple containing the data that defines the given transformation of genus one models.

<a id="function-changering-transg1-rng"></a>
## `ChangeRing(g, R): TransG1, Rng -> TransG1`

For a transformation $g$ of genus one models, this constructs the same transformation over the ring $R$.

<a id="function-identitytransformation-rngintelt-rng"></a>
## `IdentityTransformation(n, R): RngIntElt, Rng -> TransG1`

The identity transformation of genus one models of degree $n$.

<a id="function-randomtransformation-rngintelt"></a>
## `RandomTransformation(n : parameters): RngIntElt -> TransG1`

```magma
Size      : RngIntElt                    Default: 5
Unimodular: BoolElt                      Default: false
CrossTerms: BoolElt                      Default: false
```

A random transformation of genus one models of degree $n$. When `Unimodular` is set to `true` then the returned transformation is integrally invertible.

The optional parameter `Size` is passed to `RandomSL` or `RandomGL`.

In degree 2, if `CrossTerms` is false then the returned transformation preserves the set of models with no cross terms.

<a id="operation-op-times-transg1-modelg1"></a>
## `g * model: TransG1, ModelG1 -> ModelG1`

<a id="function-applytransformation-transg1-modelg1"></a>
## `ApplyTransformation(g, model): TransG1, ModelG1 -> ModelG1`

The result of applying the transformation $g$ to the genus one model.

<a id="operation-op-times-transg1-transg1"></a>
## `g1 * g2: TransG1, TransG1 -> TransG1`

<a id="function-composetransformations-transg1-transg1"></a>
## `ComposeTransformations(g1, g2): TransG1, TransG1 -> TransG1`

<a id="function-multiplytransformations-transg1-transg1"></a>
## `MultiplyTransformations(g1, g2): TransG1, TransG1 -> TransG1`

The composition $g1*g2$ of two transformations of genus one models. Transformations of genus one models act on the left: $(g1 * g2) * model = g1 * (g2 * model)$.

<a id="function-inverse-transg1"></a>
## `Inverse(g): TransG1 -> TransG1`

<a id="function-inversetransformation-transg1"></a>
## `InverseTransformation(g): TransG1 -> TransG1`

<a id="function-inversetransformation-rngintelt-transg1"></a>
## `InverseTransformation(n, g): RngIntElt, TransG1 -> TransG1`

The inverse of the transformation $g$ of genus one models.

<a id="function-scalingfactor-transg1"></a>
## `ScalingFactor(g): TransG1 -> RngElt`

<a id="function-scalingfactor-rngintelt-transg1"></a>
## `ScalingFactor(n, g): RngIntElt, TransG1 -> RngElt`

The scaling factor of the transformation $g$ of genus one models. This an element $\lambda$ such that if a genus one model has invariants $c_4$ and $c_6$ then the transformed model has invariants $\lambda^4 c_4$ and $\lambda^6 c_6$.

<a id="function-determinant-transg1"></a>
## `Determinant(g): TransG1 -> RngElt`

The determinant of the matrix associated with the transformation $g$.
