---
title: "Automorphisms of Fields"
canonical: "https://docs.magma-maths.org/v2.30-1/GlobalFields/GaloisGroupsAndAutomorphisms/fld_auts.html"
source: "https://docs.magma-maths.org/v2.30-1/GlobalFields/GaloisGroupsAndAutomorphisms/fld_auts.md"
part: "Global Fields"
chapter: "Galois Groups and Automorphisms"
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": "Galois Groups and Automorphisms", "source": "https://docs.magma-maths.org/v2.30-1/GlobalFields/GaloisGroupsAndAutomorphisms/index-galois-groups-and-automorphisms.md"}
prev: {"title": "Galois Cohomology", "source": "https://docs.magma-maths.org/v2.30-1/GlobalFields/GaloisGroupsAndAutomorphisms/cohomology.md"}
next: {"title": "Bibliography", "source": "https://docs.magma-maths.org/v2.30-1/GlobalFields/GaloisGroupsAndAutomorphisms/bibliography.md"}
intrinsics:
  - {"name": "FieldAutomorphism", "signature": "FieldAutomorphism(F, g): Fld, GrpPermElt -> FldAut"}
  - {"name": "FieldAutomorphism", "signature": "FieldAutomorphism(F, g): AlgAss[Fld], GrpPermElt -> FldAut"}
  - {"name": "FieldAutomorphism", "signature": "FieldAutomorphism(F, a): Fld, Map[Fld,Fld] -> FldAut"}
  - {"name": "FieldAutomorphism", "signature": "FieldAutomorphism(F, a): Fld, Intrinsic -> FldAut"}
  - {"name": "FieldAutomorphism", "signature": "FieldAutomorphism(F, a): Fld, UserProgram -> FldAut"}
  - {"name": "FieldAutomorphism", "signature": "FieldAutomorphism(F, a): AlgAss[Fld], Map[AlgAss[Fld],AlgAss[Fld]] -> FldAut"}
  - {"name": "IdentityAutomorphism", "signature": "IdentityAutomorphism(F): Fld -> FldAut"}
  - {"name": "FieldAutomorphism", "signature": "FieldAutomorphism(K): AlgAss[Fld] -> FldAut"}
  - {"name": "ChangeRing", "signature": "ChangeRing(a, K): FldAut, Fld -> FldAut"}
  - {"name": "ChangeRing", "signature": "ChangeRing(a, K): FldAut, AlgAss[Fld] -> FldAut"}
  - {"name": "BaseField", "signature": "BaseField(a): FldAut -> Fld"}
  - {"name": "Order", "signature": "Order(a): FldAut -> RngIntElt"}
  - {"name": "FixedField", "signature": "FixedField(a): FldAut -> Fld"}
  - {"name": "Automorphism", "signature": "Automorphism(a): FldAut -> Map[Fld, Fld]"}
  - {"name": "FixedFieldSymbol", "signature": "FixedFieldSymbol(a, P): FldAut, RngOrdIdl -> RngIntElt"}
  - {"name": "FixedFieldSymbol", "signature": "FixedFieldSymbol(a, P): FldAut, RngInt -> RngIntElt"}
  - {"name": "IsIdentity", "signature": "IsIdentity(a): FldAut -> BoolElt"}
  - {"name": "*", "signature": "a * b: FldAut, FldAut -> FldAut"}
  - {"name": "^", "signature": "a ^ n: FldAut, RngIntElt -> FldAut"}
  - {"name": "Inverse", "signature": "Inverse(a): FldAut -> FldAut"}
  - {"name": "eq", "signature": "a eq b: FldAut, FldAut -> BoolElt"}
  - {"name": "@", "signature": "x @ a: FldElt, FldAut -> FldElt"}
  - {"name": "@", "signature": "x @ a: RngOrdElt, FldAut -> RngOrdElt"}
  - {"name": "@", "signature": "x @ a: RngIntElt, FldAut -> RngIntElt"}
  - {"name": "@", "signature": "x @ a: AlgAssElt[Fld], FldAut -> AlgAssElt[Fld]"}
  - {"name": "@", "signature": "v @ a: ModTupFldElt[Fld], FldAut -> ModTupFldElt[Fld]"}
  - {"name": "@", "signature": "M @ a: ModMatFldElt[Fld], FldAut -> ModMatFldElt[Fld]"}
  - {"name": "@", "signature": "M @ a: AlgMatElt[Fld], FldAut -> AlgMatElt[Fld]"}
  - {"name": "@", "signature": "M @ a: GrpMatElt[Fld], FldAut -> GrpMatElt[Fld]"}
  - {"name": "@", "signature": "M @ a: AlgMatElt[AlgAss[Fld]], FldAut -> AlgMatElt[AlgAss[Fld]]"}
  - {"name": "@", "signature": "I @ a: RngOrdFracIdl[FldOrd], FldAut -> RngOrdFracIdl[FldOrd]"}
  - {"name": "@", "signature": "I @ a: RngInt, FldAut -> RngInt"}
  - {"name": "@", "signature": "I @ a: RngIntFracIdl, FldAut -> RngIntFracIdl"}
  - {"name": "Trace", "signature": "Trace(P, a): RngOrdFracIdl, FldAut -> RngOrdFracIdl"}
  - {"name": "Trace", "signature": "Trace(P, a): RngIntFracIdl, FldAut -> RngIntFracIdl"}
  - {"name": "Norm", "signature": "Norm(P, a): RngOrdFracIdl, FldAut -> RngOrdFracIdl"}
  - {"name": "Norm", "signature": "Norm(P, a): RngIntFracIdl, FldAut -> RngIntFracIdl"}
---

# Automorphisms of Fields

Magma now (from V2.29) contains a new structure for field automorphisms. A field automorphism is of type `FldAut`. Also supports the swap automorphism of $F \times F$, when constructed as an associative algebra. `DirectSum(Algebra(F,F), Algebra(F,F));`

## Creation of Field Automorphisms

<a id="function-fieldautomorphism-fld-grppermelt"></a>
### `FieldAutomorphism(F, g): Fld, GrpPermElt -> FldAut`

<a id="function-fieldautomorphism-algass-fld-grppermelt"></a>
### `FieldAutomorphism(F, g): AlgAss[Fld], GrpPermElt -> FldAut`

Given an element $g$ of a permutation group $G$, satisfying $G \simeq {\operatorname{Aut}}(F)$, returns an element $\alpha \in {\operatorname{Aut}}(F)$ corresponding to $g$.

<a id="function-fieldautomorphism-fld-map-fld-fld"></a>
### `FieldAutomorphism(F, a): Fld, Map[Fld,Fld] -> FldAut`

<a id="function-fieldautomorphism-fld-intrinsic"></a>
### `FieldAutomorphism(F, a): Fld, Intrinsic -> FldAut`

<a id="function-fieldautomorphism-fld-userprogram"></a>
### `FieldAutomorphism(F, a): Fld, UserProgram -> FldAut`

<a id="function-fieldautomorphism-algass-fld-map-algass-fld-algass-fld"></a>
### `FieldAutomorphism(F, a): AlgAss[Fld], Map[AlgAss[Fld],AlgAss[Fld]] -> FldAut`

Given a function, an intrinsic, or a map between fields $a$ describing an automorphism $a : F \to F$, returns the corresponding field automorphism.

<a id="function-identityautomorphism-fld"></a>
### `IdentityAutomorphism(F): Fld -> FldAut`

The identity automorphism of the field $F$.

<a id="function-fieldautomorphism-algass-fld"></a>
### `FieldAutomorphism(K): AlgAss[Fld] -> FldAut`

If $K = F \times F$, return the swap involution.

<a id="function-changering-fldaut-fld"></a>
### `ChangeRing(a, K): FldAut, Fld -> FldAut`

<a id="function-changering-fldaut-algass-fld"></a>
### `ChangeRing(a, K): FldAut, AlgAss[Fld] -> FldAut`

If $F \simeq K$, return the element of ${\operatorname{Aut}}(K)$ corresponding to $a \in {\operatorname{Aut}}(F)$.

## Properties of Field Automorphisms

<a id="function-basefield-fldaut"></a>
### `BaseField(a): FldAut -> Fld`

The field $F$ for which $a \in {\operatorname{Aut}}(F)$.

<a id="function-order-fldaut"></a>
### `Order(a): FldAut -> RngIntElt`

The order of $a$.

<a id="function-fixedfield-fldaut"></a>
### `FixedField(a): FldAut -> Fld`

The fixed field of $a$.

<a id="function-automorphism-fldaut"></a>
### `Automorphism(a): FldAut -> Map[Fld, Fld]`

The map defined by $a : F \to F$.

<a id="function-fixedfieldsymbol-fldaut-rngordidl"></a>
### `FixedFieldSymbol(a, P): FldAut, RngOrdIdl -> RngIntElt`

<a id="function-fixedfieldsymbol-fldaut-rngint"></a>
### `FixedFieldSymbol(a, P): FldAut, RngInt -> RngIntElt`

Returns $-1,0$ or $1$ if $P$ is inert, ramified, or split, respectively in the fixed field of $a$.

## Predicates on Field Automorphisms

<a id="function-isidentity-fldaut"></a>
### `IsIdentity(a): FldAut -> BoolElt`

Returns `true` iff $a$ is the identity automorphism.

## Arithmetic of Field Automorphisms

<a id="operation-op-times-fldaut-fldaut"></a>
### `a * b: FldAut, FldAut -> FldAut`

The automorphism given by $a \circ b$, namely $x \mapsto a(b(x))$.

<a id="operation-op-pow-fldaut-rngintelt"></a>
### `a ^ n: FldAut, RngIntElt -> FldAut`

The automorphism $a^n$.

<a id="function-inverse-fldaut"></a>
### `Inverse(a): FldAut -> FldAut`

The automorphism $a^{-1}$.

<a id="operation-op-eq-fldaut-fldaut"></a>
### `a eq b: FldAut, FldAut -> BoolElt`

Returns `true` iff $a$ and $b$ are automorphisms of the same field $F$, and $a = b$.

<a id="operation-operation-fldelt-fldaut-fldelt"></a>
### `x @ a: FldElt, FldAut -> FldElt`

<a id="operation-operation-rngordelt-fldaut-rngordelt"></a>
### `x @ a: RngOrdElt, FldAut -> RngOrdElt`

<a id="operation-operation-rngintelt-fldaut-rngintelt"></a>
### `x @ a: RngIntElt, FldAut -> RngIntElt`

<a id="operation-operation-algasselt-fld-fldaut-algasselt-fld"></a>
### `x @ a: AlgAssElt[Fld], FldAut -> AlgAssElt[Fld]`

Evaluate $a(x)$.

<a id="operation-operation-modtupfldelt-fld-fldaut-modtupfldelt-fld"></a>
### `v @ a: ModTupFldElt[Fld], FldAut -> ModTupFldElt[Fld]`

Given a vector $v = (x_1, ...., x_n)$ in an $F$-vector space $V$, apply $a$ to each coordinate, to get $a(v) = (a(x_1), \ldots, a(x_n))$.

<a id="operation-operation-modmatfldelt-fld-fldaut-modmatfldelt-fld"></a>
### `M @ a: ModMatFldElt[Fld], FldAut -> ModMatFldElt[Fld]`

<a id="operation-operation-algmatelt-fld-fldaut-algmatelt-fld"></a>
### `M @ a: AlgMatElt[Fld], FldAut -> AlgMatElt[Fld]`

<a id="operation-operation-grpmatelt-fld-fldaut-grpmatelt-fld"></a>
### `M @ a: GrpMatElt[Fld], FldAut -> GrpMatElt[Fld]`

<a id="operation-operation-algmatelt-algass-fld-fldaut-algmatelt-algass-fld"></a>
### `M @ a: AlgMatElt[AlgAss[Fld]], FldAut -> AlgMatElt[AlgAss[Fld]]`

Given a matrix $M = (x_{ij})$ with entries in $F$, apply $a$ to each coordinate, to get $a(M) = (a(x_{ij}))$.

<a id="operation-operation-rngordfracidl-fldord-fldaut-rngordfracidl-fldord"></a>
### `I @ a: RngOrdFracIdl[FldOrd], FldAut -> RngOrdFracIdl[FldOrd]`

<a id="operation-operation-rngint-fldaut-rngint"></a>
### `I @ a: RngInt, FldAut -> RngInt`

<a id="operation-operation-rngintfracidl-fldaut-rngintfracidl"></a>
### `I @ a: RngIntFracIdl, FldAut -> RngIntFracIdl`

Given a fraction ideal $I$ of an order $R$, and an automorphism $a$ of the fraction field of $R$, return the fractional ideal $a(I)$.

<a id="function-trace-rngordfracidl-fldaut"></a>
### `Trace(P, a): RngOrdFracIdl, FldAut -> RngOrdFracIdl`

<a id="function-trace-rngintfracidl-fldaut"></a>
### `Trace(P, a): RngIntFracIdl, FldAut -> RngIntFracIdl`

```magma
Mult: RngIntElt                    Default: Order(a)
```

The image of the map $x \mapsto \sum_{j=0}^{m-1} \sum a^j(x)$ on $P$, where $m$ is determined by `Mult`.

<a id="function-norm-rngordfracidl-fldaut"></a>
### `Norm(P, a): RngOrdFracIdl, FldAut -> RngOrdFracIdl`

<a id="function-norm-rngintfracidl-fldaut"></a>
### `Norm(P, a): RngIntFracIdl, FldAut -> RngIntFracIdl`

```magma
Mult: RngIntElt                    Default: Order(a)
```

The image of the map $x \mapsto \prod_{j=0}^{m-1} \sum a^j(x)$ on $P$, where $m$ is determined by `Mult`.
