---
title: "Structure Operations"
canonical: "https://docs.magma-maths.org/v2.30-1/GlobalFields/RationalFunctionFields/operation.html"
source: "https://docs.magma-maths.org/v2.30-1/GlobalFields/RationalFunctionFields/operation.md"
part: "Global Fields"
chapter: "Rational Function Fields"
breadcrumbs:
  - {"title": "Magma Handbook", "source": "https://docs.magma-maths.org/v2.30-1/index.md"}
  - {"title": "Global Fields", "source": "https://docs.magma-maths.org/v2.30-1/GlobalFields/index-global-fields.md"}
  - {"title": "Rational Function Fields", "source": "https://docs.magma-maths.org/v2.30-1/GlobalFields/RationalFunctionFields/index-rational-function-fields.md"}
prev: {"title": "Creation Functions", "source": "https://docs.magma-maths.org/v2.30-1/GlobalFields/RationalFunctionFields/creation.md"}
next: {"title": "Element Operations", "source": "https://docs.magma-maths.org/v2.30-1/GlobalFields/RationalFunctionFields/element.md"}
intrinsics:
  - {"name": "IntegerRing", "signature": "IntegerRing(F): FldFunRat -> RngPol"}
  - {"name": "RingOfIntegers", "signature": "RingOfIntegers(F): FldFunRat -> RngPol"}
  - {"name": "BaseRing", "signature": "BaseRing(F): FldFunRat -> Rng"}
  - {"name": "CoefficientRing", "signature": "CoefficientRing(F): FldFunRat -> Rng"}
  - {"name": "Rank", "signature": "Rank(F): FldFunRat -> RngIntElt"}
  - {"name": "ValuationRing", "signature": "ValuationRing(F): FldFunRat -> RngVal"}
  - {"name": "ValuationRing", "signature": "ValuationRing(F, f): FldFunRat, RngUPolElt -> RngVal"}
  - {"name": "Category", "signature": "Category(R): FldFunRat -> Cat"}
  - {"name": "Parent", "signature": "Parent(R): FldFunRat -> Pow"}
  - {"name": "PrimeRing", "signature": "PrimeRing(R): FldFunRat -> Rng"}
  - {"name": "Characteristic", "signature": "Characteristic(F): FldFunRat -> FldFunRatElt"}
  - {"name": "IsCommutative", "signature": "IsCommutative(F): FldFunRat -> BoolElt"}
  - {"name": "IsUnitary", "signature": "IsUnitary(F): FldFunRat -> BoolElt"}
  - {"name": "IsFinite", "signature": "IsFinite(F): FldFunRat -> BoolElt"}
  - {"name": "IsOrdered", "signature": "IsOrdered(F): FldFunRat -> BoolElt"}
  - {"name": "IsField", "signature": "IsField(F): FldFunRat -> BoolElt"}
  - {"name": "IsEuclideanDomain", "signature": "IsEuclideanDomain(F): FldFunRat -> BoolElt"}
  - {"name": "IsPID", "signature": "IsPID(F): FldFunRat -> BoolElt"}
  - {"name": "IsUFD", "signature": "IsUFD(F): FldFunRat -> BoolElt"}
  - {"name": "IsDivisionRing", "signature": "IsDivisionRing(F): FldFunRat -> BoolElt"}
  - {"name": "IsEuclideanRing", "signature": "IsEuclideanRing(F): FldFunRat -> BoolElt"}
  - {"name": "IsPrincipalIdealRing", "signature": "IsPrincipalIdealRing(F): FldFunRat -> BoolElt"}
  - {"name": "IsDomain", "signature": "IsDomain(F): FldFunRat -> BoolElt"}
  - {"name": "eq", "signature": "F eq G: FldFunRat, Rng -> BoolElt"}
  - {"name": "ne", "signature": "F ne G: FldFunRat, Rng -> BoolElt"}
  - {"name": "hom", "signature": "hom< P -> S | f, y₁, ..., yₙ >: FldFunRat, Rng -> Map"}
  - {"name": "hom", "signature": "hom< P -> S | y₁, ..., yₙ >: FldFunRat, Rng -> Map"}
examples:
  - "ex-bca4bf"
---

# Structure Operations

## Related Structures

<a id="function-integerring-fldfunrat"></a>
### `IntegerRing(F): FldFunRat -> RngPol`

<a id="function-ringofintegers-fldfunrat"></a>
### `RingOfIntegers(F): FldFunRat -> RngPol`

Given the rational function field $F$ this returns the polynomial ring from which $F$ was constructed as its field of fractions.

<a id="function-basering-fldfunrat"></a>
### `BaseRing(F): FldFunRat -> Rng`

<a id="function-coefficientring-fldfunrat"></a>
### `CoefficientRing(F): FldFunRat -> Rng`

The coefficient ring of the (ring of integers of) the rational function field $F$.

<a id="function-rank-fldfunrat"></a>
### `Rank(F): FldFunRat -> RngIntElt`

The rank (number of indeterminates) of the rational function field $F$.

<a id="function-valuationring-fldfunrat"></a>
### `ValuationRing(F): FldFunRat -> RngVal`

Given the rational function field $F$ for which the coefficients come from a field, this returns the valuation ring of $F$ with respect to the valuation given by the degree. This valuation ring consists of those rational functions $g/h$ for which the degree of $h$ is greater than or equal to that of $g$.

<a id="function-valuationring-fldfunrat-rngupolelt"></a>
### `ValuationRing(F, f): FldFunRat, RngUPolElt -> RngVal`

Given the rational function field $F$ for which the coefficients come from a field, and an irreducible polynomial $f$ in the ring of integers of $F$, this returns the valuation ring of $F$ with respect to the valuation associated with $f$. This valuation ring consists of those rational functions $g/h$ for which $f$ divides $g$ but not $h$.

<a id="function-category-fldfunrat"></a>
### `Category(R): FldFunRat -> Cat`

<a id="function-parent-fldfunrat"></a>
### `Parent(R): FldFunRat -> Pow`

<a id="function-primering-fldfunrat"></a>
### `PrimeRing(R): FldFunRat -> Rng`

## Invariants

<a id="function-characteristic-fldfunrat"></a>
### `Characteristic(F): FldFunRat -> FldFunRatElt`

## Ring Predicates and Booleans

<a id="function-iscommutative-fldfunrat"></a>
### `IsCommutative(F): FldFunRat -> BoolElt`

<a id="function-isunitary-fldfunrat"></a>
### `IsUnitary(F): FldFunRat -> BoolElt`

<a id="function-isfinite-fldfunrat"></a>
### `IsFinite(F): FldFunRat -> BoolElt`

<a id="function-isordered-fldfunrat"></a>
### `IsOrdered(F): FldFunRat -> BoolElt`

<a id="function-isfield-fldfunrat"></a>
### `IsField(F): FldFunRat -> BoolElt`

<a id="function-iseuclideandomain-fldfunrat"></a>
### `IsEuclideanDomain(F): FldFunRat -> BoolElt`

<a id="function-ispid-fldfunrat"></a>
### `IsPID(F): FldFunRat -> BoolElt`

<a id="function-isufd-fldfunrat"></a>
### `IsUFD(F): FldFunRat -> BoolElt`

<a id="function-isdivisionring-fldfunrat"></a>
### `IsDivisionRing(F): FldFunRat -> BoolElt`

<a id="function-iseuclideanring-fldfunrat"></a>
### `IsEuclideanRing(F): FldFunRat -> BoolElt`

<a id="function-isprincipalidealring-fldfunrat"></a>
### `IsPrincipalIdealRing(F): FldFunRat -> BoolElt`

<a id="function-isdomain-fldfunrat"></a>
### `IsDomain(F): FldFunRat -> BoolElt`

<a id="operation-op-eq-fldfunrat-rng"></a>
### `F eq G: FldFunRat, Rng -> BoolElt`

<a id="operation-op-ne-fldfunrat-rng"></a>
### `F ne G: FldFunRat, Rng -> BoolElt`

## Homomorphisms

In its general form a ring homomorphism taking a function field $R(x_1, \ldots, x_n)$ as domain requires $n+1$ pieces of information, namely, a map (homomorphism) telling how to map the coefficient ring $R$ together with the images of the $n$ indeterminates.

<a id="constructor-constructor-hom-fldfunrat-rng-map"></a>
### `hom< P -> S | f, y₁, ..., yₙ >: FldFunRat, Rng -> Map`

<a id="constructor-constructor-hom-fldfunrat-rng-map-2"></a>
### `hom< P -> S | y₁, ..., yₙ >: FldFunRat, Rng -> Map`

Given a function field $F=R(x_1,\ldots, x_n)$, a ring $S$, a map $f : F\ar S$, and $n$ elements $y_1, \ldots, y_n\in S$, create the homomorphism $g : F\ar S$ by applying the rules of $g(rx_1^{a_1}\cdots x_n^{a_n})=f(r)y_1^{a_1}\cdots y_n^{a_n}$ for monomials, linearity for polynomials, i.e., $g(M+N)=g(M)+g(N)$, and division for fractions, i.e., $g(n/d)=g(n)/g(d)$. The coefficient ring map may be omitted, in which case the coefficients are mapped into $S$ by the unitary homomorphism sending $1_R$ to $1_S$. Also, the images $y_i$ are allowed to be from a structure that allows automatic coercion into $S$.

<a id="example-ex-bca4bf"></a>
### `Example: Homomorphism to a Number Field (ex-bca4bf)`

In this example we map ${\mathbb{Q}}(x, y)$ into the number field ${\mathbb{Q}}(\root 3 \of 2, \sqrt{5})$ by sending $x$ to $\root 3 \of 2$ and $y$ to $\sqrt{5}$ and the identity map on the coefficients (which we omit).

```magma
> Q := RationalField();
> F<x, y> := FunctionField(Q, 2);
> A<a> := PolynomialRing(IntegerRing());
> N<z, w> := NumberField([a^3-2, a^2+5]);
> h := hom< F -> N | z, w >;
> h(x^11*y^3-x+4/5*y-13/4);
-40*w*z^2 - z + 4/5*w - 13/4
> h(x/3);
1/3*z
> h(1/x);
1/2*z^2
> 1/z;
1/2*z^2
```
