---
title: "Arithmetic with Elements"
canonical: "https://docs.magma-maths.org/v2.30-1/FiniteGroups/BlackBoxGroups/operation.html"
source: "https://docs.magma-maths.org/v2.30-1/FiniteGroups/BlackBoxGroups/operation.md"
part: "Finite Groups"
chapter: "Black-Box Groups"
breadcrumbs:
  - {"title": "Magma Handbook", "source": "https://docs.magma-maths.org/v2.30-1/index.md"}
  - {"title": "Finite Groups", "source": "https://docs.magma-maths.org/v2.30-1/FiniteGroups/index-finite-groups.md"}
  - {"title": "Black-Box Groups", "source": "https://docs.magma-maths.org/v2.30-1/FiniteGroups/BlackBoxGroups/index-black-box-groups.md"}
prev: {"title": "Construction of an SLP-Group and its Elements", "source": "https://docs.magma-maths.org/v2.30-1/FiniteGroups/BlackBoxGroups/creation.md"}
next: {"title": "Operations on Elements", "source": "https://docs.magma-maths.org/v2.30-1/FiniteGroups/BlackBoxGroups/operation-element.md"}
intrinsics:
  - {"name": "*", "signature": "u * v: GrpBBElt, GrpBBElt -> GrpBBElt"}
  - {"name": "^", "signature": "u ^ m: GrpBBElt, RngIntElt -> GrpBBElt"}
  - {"name": "^", "signature": "u ^ v: GrpBBElt, GrpBBElt -> GrpBBElt"}
  - {"name": "(u, v)", "signature": "(u, v): GrpBBElt, GrpBBElt -> GrpBBElt"}
  - {"name": ".", "signature": "G . i: GrpBB, RngIntElt -> GrpBBElt"}
  - {"name": "Generators", "signature": "Generators(G): GrpBB -> { GrpBBElt}"}
  - {"name": "NumberOfGenerators", "signature": "NumberOfGenerators(G): GrpBB -> RngIntElt"}
  - {"name": "Ngens", "signature": "Ngens(G): GrpBB -> RngIntElt"}
---

# Arithmetic with Elements

<a id="operation-op-times-grpbbelt-grpbbelt"></a>
## `u * v: GrpBBElt, GrpBBElt -> GrpBBElt`

Construct the product of elements $u$ and $v$ of the BB-group $G$.

<a id="operation-op-pow-grpbbelt-rngintelt"></a>
## `u ^ m: GrpBBElt, RngIntElt -> GrpBBElt`

Given an integer $m$ and $u$, an element of BB-group $G$, return the element of $G$ corresponding to the $m$-th power of $u$.

<a id="operation-op-pow-grpbbelt-grpbbelt"></a>
## `u ^ v: GrpBBElt, GrpBBElt -> GrpBBElt`

Given $u$ and $v$, elements of BB-group $G$, return the element of $G$ corresponding to the conjugate of $u$ by $v$, i.e. $v^{-1}*u*v$.

<a id="literal-literal-u-v-grpbbelt-grpbbelt-grpbbelt"></a>
## `(u, v): GrpBBElt, GrpBBElt -> GrpBBElt`

Commutator of the elements $u$ and $v$, i.e. the element $u^{-1}*v^{-1}*u*v$. Here $u$ and $v$ must belong to the same BB-group $G$.

## Accessing the Defining Generators

The functions described here provide access to basic information stored for a BB-group $G$.

<a id="operation-operation-grpbb-rngintelt-grpbbelt"></a>
### `G . i: GrpBB, RngIntElt -> GrpBBElt`

The $i$-th generator for $G$.

<a id="function-generators-grpbb"></a>
### `Generators(G): GrpBB -> { GrpBBElt}`

A set containing the generators for $G$.

<a id="function-numberofgenerators-grpbb"></a>
### `NumberOfGenerators(G): GrpBB -> RngIntElt`

<a id="function-ngens-grpbb"></a>
### `Ngens(G): GrpBB -> RngIntElt`

The number of generators for $B$.
