---
title: "Access Functions for Groups"
canonical: "https://docs.magma-maths.org/v2.30-1/FinitelyPresentedGroups/PolycyclicGroups/access.html"
source: "https://docs.magma-maths.org/v2.30-1/FinitelyPresentedGroups/PolycyclicGroups/access.md"
part: "Finitely Presented Groups"
chapter: "Polycyclic Groups"
breadcrumbs:
  - {"title": "Magma Handbook", "source": "https://docs.magma-maths.org/v2.30-1/index.md"}
  - {"title": "Finitely Presented Groups", "source": "https://docs.magma-maths.org/v2.30-1/FinitelyPresentedGroups/index-finitely-presented-groups.md"}
  - {"title": "Polycyclic Groups", "source": "https://docs.magma-maths.org/v2.30-1/FinitelyPresentedGroups/PolycyclicGroups/index-polycyclic-groups.md"}
prev: {"title": "Conversion between Categories", "source": "https://docs.magma-maths.org/v2.30-1/FinitelyPresentedGroups/PolycyclicGroups/conversion.md"}
next: {"title": "Set-Theoretic Operations in a Group", "source": "https://docs.magma-maths.org/v2.30-1/FinitelyPresentedGroups/PolycyclicGroups/set.md"}
intrinsics:
  - {"name": ".", "signature": "G . i: GrpGPC, RngIntElt -> GrpGPCElt"}
  - {"name": "Generators", "signature": "Generators(G): GrpGPC -> {@ GrpGPCElt @}"}
  - {"name": "PCGenerators", "signature": "PCGenerators(G): GrpGPC -> {@ GrpGPCElt @}"}
  - {"name": "Generators", "signature": "Generators(H, G): GrpGPC, GrpGPC -> {@ GrpGPCElt @}"}
  - {"name": "PCGenerators", "signature": "PCGenerators(H, G): GrpGPC, GrpGPC -> {@ GrpGPCElt @}"}
  - {"name": "NumberOfGenerators", "signature": "NumberOfGenerators(G): GrpGPC -> RngIntElt"}
  - {"name": "Ngens", "signature": "Ngens(G): GrpGPC -> RngIntElt"}
  - {"name": "NumberOfPCGenerators", "signature": "NumberOfPCGenerators(G): GrpGPC -> RngIntElt"}
  - {"name": "NPCgens", "signature": "NPCgens(G): GrpGPC -> RngIntElt"}
  - {"name": "NPCGenerators", "signature": "NPCGenerators(G): GrpGPC -> RngIntElt"}
  - {"name": "PCExponents", "signature": "PCExponents(G): GrpGPC -> [RngIntElt]"}
  - {"name": "HirschNumber", "signature": "HirschNumber(G): GrpGPC -> RngIntElt"}
---

# Access Functions for Groups

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

<a id="operation-operation-grpgpc-rngintelt-grpgpcelt"></a>
## `G . i: GrpGPC, RngIntElt -> GrpGPCElt`

The $i$-th polycyclic generator for $G$ if $i>0$, the inverse of the $|i|$-th polycyclic generator for $G$ if $i<0$ and the identity element of $G$ if $i=0$.

<a id="function-generators-grpgpc"></a>
## `Generators(G): GrpGPC -> {@ GrpGPCElt @}`

<a id="function-grpgpc-pcgenerators"></a>
## `PCGenerators(G): GrpGPC -> {@ GrpGPCElt @}`

An indexed set containing the polycyclic generators of $G$.

<a id="function-generators-grpgpc-grpgpc"></a>
## `Generators(H, G): GrpGPC, GrpGPC -> {@ GrpGPCElt @}`

<a id="function-grpgpc-pcgenerators-2"></a>
## `PCGenerators(H, G): GrpGPC, GrpGPC -> {@ GrpGPCElt @}`

An indexed set containing the polycyclic generators of $H$ as elements of $G$.

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

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

<a id="function-numberofpcgenerators-grpgpc"></a>
## `NumberOfPCGenerators(G): GrpGPC -> RngIntElt`

<a id="function-npcgens-grpgpc"></a>
## `NPCgens(G): GrpGPC -> RngIntElt`

<a id="function-npcgenerators-grpgpc"></a>
## `NPCGenerators(G): GrpGPC -> RngIntElt`

The number of polycyclic generators for the polycyclic group $G$.

<a id="function-pcexponents-grpgpc"></a>
## `PCExponents(G): GrpGPC -> [RngIntElt]`

The orders of the cyclic factors in the polycyclic series defined by the polycyclic presentation of $G$. The orders are returned in a sequence $Q$. $|G_i/G_{i+1}| = m_i = Q[i]$ if $Q[i] > 0$ and $G_i/G_{i+1}$ is infinite (i.e. $i\notin I$) if $Q[i] = 0$.

<a id="function-hirschnumber-grpgpc"></a>
## `HirschNumber(G): GrpGPC -> RngIntElt`

The Hirsch number of $G$, i.e. the number of infinite cyclic factors in the polycyclic series defined by the polycyclic presentation of $G$.

The Hirsch number of $G$ is equal to $n - |I|$, i.e. to the number of polycyclic generators of $G$ for which there is no power relation. A polycyclic group $G$ is finite if and only if its Hirsch number is 0.
