---
title: "Operations on Elements"
canonical: "https://docs.magma-maths.org/v2.30-1/LieTheory/ChevalleyGroups/element-operators.html"
source: "https://docs.magma-maths.org/v2.30-1/LieTheory/ChevalleyGroups/element-operators.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": "Constructing Elements", "source": "https://docs.magma-maths.org/v2.30-1/LieTheory/ChevalleyGroups/element-construction.md"}
next: {"title": "Properties of Elements", "source": "https://docs.magma-maths.org/v2.30-1/LieTheory/ChevalleyGroups/more-element-operators.md"}
intrinsics:
  - {"name": "*", "signature": "g * h: GrpLieElt, GrpLieElt -> GrpLieElt"}
  - {"name": "^", "signature": "g ^ -1: GrpLieElt -> GrpLieElt"}
  - {"name": "Inverse", "signature": "Inverse(G): GrpLieElt -> GrpLieElt"}
  - {"name": "^", "signature": "g ^ n: GrpLieElt, RngIntElt -> GrpLieElt"}
  - {"name": "^", "signature": "g ^ h: GrpLieElt, GrpLieElt -> GrpLieElt"}
  - {"name": "(g, h)", "signature": "(g, h): GrpLieElt, GrpLieElt -> GrpLieElt"}
  - {"name": "Commutator", "signature": "Commutator(g, h): GrpLieElt, GrpLieElt -> GrpLieElt"}
  - {"name": "Normalise", "signature": "Normalise(~g): GrpLieElt"}
  - {"name": "Normalize", "signature": "Normalize(~g): GrpLieElt"}
  - {"name": "Normalise", "signature": "Normalise(g): GrpLieElt -> GrpLieElt"}
  - {"name": "Normalize", "signature": "Normalize(g): GrpLieElt -> GrpLieElt"}
  - {"name": "Bruhat", "signature": "Bruhat(g): GrpLieElt -> GrpLieElt, GrpLieElt, GrpLieElt, GrpLieElt"}
  - {"name": "MultiplicativeJordanDecomposition", "signature": "MultiplicativeJordanDecomposition(x): GrpLieElt -> GrpLieElt, GrpLieElt"}
  - {"name": "ConjugateIntoTorus", "signature": "ConjugateIntoTorus(g): GrpLieElt -> GrpLieElt, GrpLieElt"}
  - {"name": "ConjugateIntoBorel", "signature": "ConjugateIntoBorel(g): GrpLieElt -> GrpLieElt, GrpLieElt"}
  - {"name": "Lang", "signature": "Lang(c, q): GrpLieElt, RngIntElt -> GrpLieElt"}
examples:
  - "ex-e7b37f"
  - "ex-6ee091"
  - "ex-95f5c0"
---

<a id="element-operators-2"></a>
<a id="sectgrplieeltops"></a>
# Operations on Elements

<a id="element-operators"></a>
<a id="subsectgrplieeltops"></a>
## Basic Operations

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

The product of two elements of a group of Lie type. If the [`Normalising`](https://docs.magma-maths.org/v2.30-1/LieTheory/ChevalleyGroups/construction.md#grplie-normalising) flag is set for the group, then the product is normalised using the algorithms of [[CHM08](https://docs.magma-maths.org/v2.30-1/references.md#cite-computunipgrps), [CMT04](https://docs.magma-maths.org/v2.30-1/references.md#cite-cohenmurraytaylor)]. Otherwise, the words are just concatenated.

<a id="example-ex-e7b37f"></a>
### `Example: Normalised and Unnormalised Products (ex-e7b37f)`

If the `Normalising` flag is set, the product is normalised, otherwise multiplication is just concatenation.

```magma
> G := GroupOfLieType("G2", GF(3) : Normalising:=false );
> V := VectorSpace(GF(3),2);
> g := elt< G | 1,2,1,2, V![2,2], <1,2>,<5,1> >;
> h := elt< G | <3,2>, V![1,2], 1 >;
> g*h;
n1 n2 n1 n2 (2 2) x1(2) x5(1) x3(2) (1 2) n1
> H := GroupOfLieType("G2", GF(3) : Normalising:=true  );
> g := elt< H | 1,2,1,2, V![2,2], <1,2>,<5,1> >;
> h := elt< H | <3,2>, V![1,2], 1 >;
> g*h;
x2(1) x3(1) (1 2) n1 n2 n1 n2 n1 x4(1)
```

<a id="operation-op-pow-grplieelt"></a>
### `g ^ -1: GrpLieElt -> GrpLieElt`

<a id="function-inverse-grplieelt"></a>
### `Inverse(G): GrpLieElt -> GrpLieElt`

The inverse of the element $g$ of a group of Lie type.

<a id="operation-op-pow-grplieelt-rngintelt"></a>
### `g ^ n: GrpLieElt, RngIntElt -> GrpLieElt`

The $n$th power of the element $g$ of a group of Lie type.

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

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

<a id="literal-literal-g-h-grplieelt-grplieelt-grplieelt"></a>
### `(g, h): GrpLieElt, GrpLieElt -> GrpLieElt`

<a id="function-commutator-grplieelt-grplieelt"></a>
### `Commutator(g, h): GrpLieElt, GrpLieElt -> GrpLieElt`

The commutator $g^{-1}h^{-1}gh$ of $g$ and $h$, where $g$ and $h$ are elements of a group of Lie type.

<a id="procedure-normalise-grplieelt-ref"></a>
### `Normalise(~g): GrpLieElt`

<a id="procedure-normalize-grplieelt-ref"></a>
### `Normalize(~g): GrpLieElt`

<a id="function-normalise-grplieelt"></a>
### `Normalise(g): GrpLieElt -> GrpLieElt`

<a id="function-normalize-grplieelt"></a>
### `Normalize(g): GrpLieElt -> GrpLieElt`

Normalise the element $g$ of a group of Lie type $G$. The procedural form is slightly more efficient than the functional form. If the `Normalise` flag is set for $G$, this operation has no effect. This uses the algorithms of [[CHM08](https://docs.magma-maths.org/v2.30-1/references.md#cite-computunipgrps), [CMT04](https://docs.magma-maths.org/v2.30-1/references.md#cite-cohenmurraytaylor)].

<a id="example-ex-6ee091"></a>
### `Example: Arithmetic in Groups of Lie Type (ex-6ee091)`

Arithmetic in groups of Lie type.

```magma
> k<z> := GF(4);
> G := GroupOfLieType("C3", k);
> V := VectorSpace(k, 3);
> g := elt< G | 1,2,3, <3,z>,<4,z^2>, V![1,z^2,1] >;
> g;
x7(z^2) x8(z^2) (  z   1   z) n1 n2 n3 x3(z) x6(z^2)
> h := elt< G | [0,1,z,1,0,z^2,1,1,z] >;
> h;
x3(z) x7(1) x6(z^2) x8(1) x9(z) x2(1) x4(1)
> g * h^-1;
x3(z) x7(z^2) x6(z) x8(1) (  z   1   z) n1 n2 n3 x5(z) x6(z)
> g^3;
x3(z) x5(z) x7(z^2) x8(z^2) (z^2 z^2 z^2) n1 n2 n1 n3 n2 n1 n3 n2 n3
x3(z) x5(z^2) x7(z) x6(1) x8(z^2) x2(z) x4(1) x1(z)
```

<a id="subsectgrplieeltdecomp"></a>
<a id="id3"></a>
## Decompositions

<a id="function-bruhat-grplieelt"></a>
### `Bruhat(g): GrpLieElt -> GrpLieElt, GrpLieElt, GrpLieElt, GrpLieElt`

Given an element $g$ of a group of Lie type the Bruhat decomposition of $g$ is returned. The function returns elements $u$, $h$, $\dot{w}$, $u'$ with the properties described in Subsection [Bruhat Normalisation](https://docs.magma-maths.org/v2.30-1/LieTheory/ChevalleyGroups/introduction.md#subsectgrpliebruhat) and so that $g=uh\dot{w}u'$.

<a id="example-ex-95f5c0"></a>
### `Example: Bruhat Decomposition of an Element (ex-95f5c0)`

```magma
> k<z> := GF(4);
> G := GroupOfLieType("C3", k);
> V := VectorSpace(k, 3);
> g := elt< G | 1,2,3, <3,z>,<4,z^2>, V![1,z^2,1] >;
> Normalise(g);
x7(z^2) x8(z^2) (  z   1   z) n1 n2 n3 x3(z) x6(z^2)
> u, h, w, up := Bruhat(g);
> u; h; w; up;
x7(z^2) x8(z^2)
(  z   1   z)
n1 n2 n3
x3(z) x6(z^2)
```

<a id="function-multiplicativejordandecomposition-grplieelt"></a>
### `MultiplicativeJordanDecomposition(x): GrpLieElt -> GrpLieElt, GrpLieElt`

The multiplicative Jordan decomposition of the element $x$ of the group of Lie type.

<a id="conjugacy-cohomology"></a>
<a id="subsectgrplieeltconj"></a>
## Conjugacy and Cohomology

<a id="function-conjugateintotorus-grplieelt"></a>
### `ConjugateIntoTorus(g): GrpLieElt -> GrpLieElt, GrpLieElt`

Given a semisimple element $g$ in a finite group of Lie type, return a torus element $t$ and conjugator $x$ such that $t=xgx^{-1}$. The elements returned may be defined over a larger field than the input element.

<a id="function-conjugateintoborel-grplieelt"></a>
### `ConjugateIntoBorel(g): GrpLieElt -> GrpLieElt, GrpLieElt`

Given a semisimple element $g$ in a finite group of Lie type, return a Borel element $b$ and conjugator $x$ such that $b=xgx^{-1}$. The elements returned may be defined over a larger field that the input element. Although any element of a group of Lie type can be conjugated into the Borel subgroup, this function is currently only implemented for semisimple elements.

<a id="function-lang-grplieelt-rngintelt"></a>
### `Lang(c, q): GrpLieElt, RngIntElt -> GrpLieElt`

Given an element $c$ in a finite group of Lie type and $q$ a power of the characteristic, return a solution $a$ of the Lang equation $c = a^{-F} a$. Here $F$ is the Frobenius automorphism gotten by taking $q$th powers in the field.
