---
title: "Automorphisms"
canonical: "https://docs.magma-maths.org/v2.30-1/LieTheory/ChevalleyGroups/automorphisms.html"
source: "https://docs.magma-maths.org/v2.30-1/LieTheory/ChevalleyGroups/automorphisms.md"
part: "Lie Theory"
chapter: "Groups of Lie Type"
breadcrumbs:
  - {"title": "Magma Handbook", "source": "https://docs.magma-maths.org/v2.30-1/index.md"}
  - {"title": "Lie Theory", "source": "https://docs.magma-maths.org/v2.30-1/LieTheory/index-lie-theory.md"}
  - {"title": "Groups of Lie Type", "source": "https://docs.magma-maths.org/v2.30-1/LieTheory/ChevalleyGroups/index-chevalley-groups.md"}
prev: {"title": "Building Groups of Lie Type", "source": "https://docs.magma-maths.org/v2.30-1/LieTheory/ChevalleyGroups/create-new-root-datum.md"}
next: {"title": "Algebraic Homomorphisms", "source": "https://docs.magma-maths.org/v2.30-1/LieTheory/ChevalleyGroups/homomorphism.md"}
intrinsics:
  - {"name": "AutomorphismGroup", "signature": "AutomorphismGroup(G): GrpLie -> GrpLieAuto"}
  - {"name": "IdentityAutomorphism", "signature": "IdentityAutomorphism(G): GrpLie -> GrpLieAutoElt"}
  - {"name": "One", "signature": "One(A): GrpLieAuto -> GrpLieAutoElt"}
  - {"name": "Id", "signature": "Id(A): GrpLieAuto -> GrpLieAutoElt"}
  - {"name": "Mapping", "signature": "Mapping(a): GrpLieAutoElt -> Map"}
  - {"name": "Automorphism", "signature": "Automorphism(m): Map -> GrpLieAutoElt"}
  - {"name": "*", "signature": "h * g: GrpLieAutoElt, GrpLieAutoElt -> GrpLieAutoElt"}
  - {"name": "^", "signature": "h ^ n: GrpLieAutoElt, RngIntElt -> GrpLieAutoElt"}
  - {"name": "^", "signature": "g ^ h: GrpLieAutoElt, GrpLieAutoElt -> GrpLieAutoElt"}
  - {"name": "Domain", "signature": "Domain(A): GrpLieAuto -> GrpLie"}
  - {"name": "Codomain", "signature": "Codomain(A): GrpLieAuto -> GrpLie"}
  - {"name": "Domain", "signature": "Domain(h): GrpLieAutoElt -> GrpLie"}
  - {"name": "Codomain", "signature": "Codomain(h): GrpLieAutoElt -> GrpLie"}
  - {"name": "InnerAutomorphism", "signature": "InnerAutomorphism(G, x): GrpLie, GrpLieElt -> Map"}
  - {"name": "DiagonalAutomorphism", "signature": "DiagonalAutomorphism(G, v): GrpLie, ModTupRngElt -> Map"}
  - {"name": "GraphAutomorphism", "signature": "GraphAutomorphism(G, p): GrpLie, GrpPermElt -> Map"}
  - {"name": "DiagramAutomorphism", "signature": "DiagramAutomorphism(G, p): GrpLie, GrpPermElt -> Map"}
  - {"name": "FieldAutomorphism", "signature": "FieldAutomorphism(G, sigma): GrpLie, Map -> Map"}
  - {"name": "RandomAutomorphism", "signature": "RandomAutomorphism(G): GrpLie -> GrpLieAutoElt"}
  - {"name": "Random", "signature": "Random(A): GrpLieAuto -> GrpLieAutoElt"}
  - {"name": "DualityAutomorphism", "signature": "DualityAutomorphism(G): GrpLie -> GrpLieAutoElt"}
  - {"name": "FrobeniusMap", "signature": "FrobeniusMap(G, q): GrpLie, RngIntElt -> GrpLieAutoElt"}
  - {"name": "DecomposeAutomorphism", "signature": "DecomposeAutomorphism(h): GrpLieAutoElt -> GrpLieAutoElt, GrpLieAutoElt, GrpLieAutoElt, Rec"}
  - {"name": "IsAlgebraic", "signature": "IsAlgebraic(h): GrpLieAutoElt -> BoolElt"}
examples:
  - "ex-6e4baf"
---

<a id="sectgrplieauto"></a>
<a id="id1"></a>
# Automorphisms

The following functions construct the standard automorphisms of a group of Lie type, as described in [[Car72b](https://docs.magma-maths.org/v2.30-1/references.md#cite-carter-small)] (except for the graph automorphism of $G_2$). In many cases, including the finite groups, every automorphism is a product of these standard automorphisms.

<a id="automorphisms-basic"></a>
<a id="subsectgrplieautobasic"></a>
## Basic Functionality

<a id="function-automorphismgroup-grplie"></a>
### `AutomorphismGroup(G): GrpLie -> GrpLieAuto`

Automorphism group of a group of Lie type $G$.

<a id="function-identityautomorphism-grplie"></a>
### `IdentityAutomorphism(G): GrpLie -> GrpLieAutoElt`

<a id="function-one-grplieauto"></a>
### `One(A): GrpLieAuto -> GrpLieAutoElt`

<a id="function-id-grplieauto"></a>
### `Id(A): GrpLieAuto -> GrpLieAutoElt`

The identity automorphism of the group of Lie type $G$.

<a id="function-mapping-grplieautoelt"></a>
### `Mapping(a): GrpLieAutoElt -> Map`

The map object associated with the automorphism $a$.

<a id="function-automorphism-map"></a>
### `Automorphism(m): Map -> GrpLieAutoElt`

Given a map object $m$ from $G$ to $G$, which is an isomorphism, returns the associated automorphism as an automorphism of a group of Lie type.

<a id="operation-op-times-grplieautoelt-grplieautoelt"></a>
### `h * g: GrpLieAutoElt, GrpLieAutoElt -> GrpLieAutoElt`

The composition of the group of Lie type automorphisms $h$ and $g$.

<a id="operation-op-pow-grplieautoelt-rngintelt"></a>
### `h ^ n: GrpLieAutoElt, RngIntElt -> GrpLieAutoElt`

The $n$th power of the group of Lie type automorphism $h$.

<a id="operation-op-pow-grplieautoelt-grplieautoelt"></a>
### `g ^ h: GrpLieAutoElt, GrpLieAutoElt -> GrpLieAutoElt`

The conjugate $h^{-1}gh$, where $g$ and $h$ are group of Lie type automorphisms $g$ and $h$

<a id="function-domain-grplieauto"></a>
### `Domain(A): GrpLieAuto -> GrpLie`

<a id="function-codomain-grplieauto"></a>
### `Codomain(A): GrpLieAuto -> GrpLie`

<a id="function-domain-grplieautoelt"></a>
### `Domain(h): GrpLieAutoElt -> GrpLie`

<a id="function-codomain-grplieautoelt"></a>
### `Codomain(h): GrpLieAutoElt -> GrpLie`

Domain or codomain of an automorphism of a group of Lie type or of the group of automorphisms.

<a id="automorphisms-special"></a>
<a id="subsectgrplieautospecial"></a>
## Constructing Special Automorphisms

<a id="function-innerautomorphism-grplie-grplieelt"></a>
### `InnerAutomorphism(G, x): GrpLie, GrpLieElt -> Map`

The inner automorphism taking $g\in G$ to $g^x$, where $x$ is an element of the group of Lie type $G$.

<a id="function-diagonalautomorphism-grplie-modtuprngelt"></a>
### `DiagonalAutomorphism(G, v): GrpLie, ModTupRngElt -> Map`

The diagonal automorphism of the semisimple group of Lie type $G$ given by the vector $v$. Let $n$ be the semisimple rank of $G$ and let $k$ be its base field. Then $v$ must be a vector in $k^n$ with every component nonzero. The function returns the automorphism given by the character $\chi$ defined by $\chi(\alpha_i)=v_i$, where $\alpha_i$ is the $i$th simple root. Since our groups are algebraic, a diagonal automorphism is just a special case of an inner automorphism.

<a id="function-graphautomorphism-grplie-grppermelt"></a>
### `GraphAutomorphism(G, p): GrpLie, GrpPermElt -> Map`

<a id="function-diagramautomorphism-grplie-grppermelt"></a>
### `DiagramAutomorphism(G, p): GrpLie, GrpPermElt -> Map`

```magma
SimpleSigns: Any                    Default: 1
```

The graph automorphism of the group of Lie type $G$ given by the permutation $p$. The permutation must act on the indices of simple roots of $G$ or the indices of all roots of $G$. The graph automorphism of the group of type $G_2$ has not been implemented yet.

The optional parameter `SimpleSigns` can be used to specify the signs corresponding to each simple root. This should either be a sequence of integers $\pm1$, or a single integer $\pm1$.

<a id="function-fieldautomorphism-grplie-map"></a>
### `FieldAutomorphism(G, sigma): GrpLie, Map -> Map`

The field automorphism of the group of Lie type $G$ induced by $\sigma$, an element of the automorphism group of the base field of $G$

<a id="function-randomautomorphism-grplie"></a>
### `RandomAutomorphism(G): GrpLie -> GrpLieAutoElt`

<a id="function-random-grplieauto"></a>
### `Random(A): GrpLieAuto -> GrpLieAutoElt`

A random element in $A$, the automorphism group of the group of Lie type $G$.

<a id="function-dualityautomorphism-grplie"></a>
### `DualityAutomorphism(G): GrpLie -> GrpLieAutoElt`

The duality automorphism of $G$. This is an automorphism that takes every unipotent term $x_r(t)$ to $x_s(\pm t)$, where $s=$ `Negative(RootDatum(G),r))`.

<a id="function-frobeniusmap-grplie-rngintelt"></a>
### `FrobeniusMap(G, q): GrpLie, RngIntElt -> GrpLieAutoElt`

The Frobenius automorphism of the finite group of Lie type $G$ gotten by $q$th powers in the base field. The integer $q$ must be a power of the characteristic of the base field of $G$.

## Operations and Properties of Automorphisms

<a id="function-decomposeautomorphism-grplieautoelt"></a>
### `DecomposeAutomorphism(h): GrpLieAutoElt -> GrpLieAutoElt, GrpLieAutoElt, GrpLieAutoElt, Rec`

Given a group of Lie type automorphism $h$, this returns a field automorphism $f$, a graph automorphism $g$, and an inner automorphism $i$ such that $h=fgi$. This only works for groups defined over finite fields. The algorithm is due to Scott Murray and Sergei Haller.

<a id="function-isalgebraic-grplieautoelt"></a>
### `IsAlgebraic(h): GrpLieAutoElt -> BoolElt`

Returns `true` if and only if the automorphism $h$ is algebraic.

<a id="example-ex-6e4baf"></a>
### `Example: Automorphisms of a Group of Type B2 (ex-6e4baf)`

Some automorphisms of $B_2(4)$

```magma
> G := GroupOfLieType("B2", GF(4));
> A := AutomorphismGroup(G);
> A!1 eq IdentityAutomorphism(G);
true
> g := GraphAutomorphism(G, Sym(2)!(1,2));
> g;
Automorphism of Group of Lie type B2 over Finite field of size 2^2
given by: Mapping from: Group of Lie type  to Group of Lie type
given by a rule
Decomposition:
  Mapping from: GF(2^2) to GF(2^2) given by a rule,
  (1, 2),
  1
```

The automorphism of $B_2(4)$ whose stabiliser is ${}^2\!B_2(4)$ is constructed by the following code.

```magma
> sigma := iso< GF(4) -> GF(4) | x :-> x^2, x :-> x^2 >;
> h := FieldAutomorphism(G, sigma) * g;
> h in A;
true
> f,g,i := DecomposeAutomorphism(h);
> assert f*g*i eq h;
```
