---
title: "Elementary Invariants"
canonical: "https://docs.magma-maths.org/v2.30-1/Geometry/IncidenceGeometry/access.html"
source: "https://docs.magma-maths.org/v2.30-1/Geometry/IncidenceGeometry/access.md"
part: "Geometry"
chapter: "Incidence Geometry"
breadcrumbs:
  - {"title": "Magma Handbook", "source": "https://docs.magma-maths.org/v2.30-1/index.md"}
  - {"title": "Geometry", "source": "https://docs.magma-maths.org/v2.30-1/Geometry/index-geometry.md"}
  - {"title": "Incidence Geometry", "source": "https://docs.magma-maths.org/v2.30-1/Geometry/IncidenceGeometry/index-incidence-geometry.md"}
prev: {"title": "Construction of Incidence and Coset Geometries", "source": "https://docs.magma-maths.org/v2.30-1/Geometry/IncidenceGeometry/creation.md"}
next: {"title": "Conversion Functions", "source": "https://docs.magma-maths.org/v2.30-1/Geometry/IncidenceGeometry/conversion-functions.md"}
intrinsics:
  - {"name": "Points", "signature": "Points(D): IncGeom -> SetIndx"}
  - {"name": "Elements", "signature": "Elements(D): IncGeom -> SetIndx"}
  - {"name": "Types", "signature": "Types(D): IncGeom -> SetIndx"}
  - {"name": "Types", "signature": "Types(C): CosetGeom -> SetIndx"}
  - {"name": "Rank", "signature": "Rank(D): IncGeom -> RngIntElt"}
  - {"name": "Rank", "signature": "Rank(C): CosetGeom -> RngIntElt"}
  - {"name": "IncidenceGraph", "signature": "IncidenceGraph(D): IncGeom -> GrphUnd, GrphVertSet, GrphEdgeSet"}
  - {"name": "Group", "signature": "Group(C): CosetGeom -> GrpPerm"}
  - {"name": "MaxParabolics", "signature": "MaxParabolics(C): CosetGeom -> SetIndx"}
  - {"name": "MaximalParabolics", "signature": "MaximalParabolics(C): CosetGeom -> SetIndx"}
  - {"name": "MinParabolics", "signature": "MinParabolics(C): CosetGeom -> SetIndx"}
  - {"name": "MinimalParabolics", "signature": "MinimalParabolics(C): CosetGeom -> SetIndx"}
  - {"name": "Borel", "signature": "Borel(C): CosetGeom -> GrpPerm"}
  - {"name": "BorelSubgroup", "signature": "BorelSubgroup(C): CosetGeom -> GrpPerm"}
  - {"name": "Kernel", "signature": "Kernel(C): CosetGeom -> GrpPerm"}
  - {"name": "Kernels", "signature": "Kernels(C): CosetGeom -> SeqEnum"}
  - {"name": "Quotient", "signature": "Quotient(C, K): CosetGeom, GrpPerm -> CosetGeom"}
---

# Elementary Invariants

<a id="function-points-incgeom"></a>
## `Points(D): IncGeom -> SetIndx`

<a id="function-elements-incgeom"></a>
## `Elements(D): IncGeom -> SetIndx`

Given an incidence geometry $D$, return the set of elements of $D$. These elements are the points of the incidence graph of $D$.

<a id="function-types-incgeom"></a>
## `Types(D): IncGeom -> SetIndx`

Given an incidence geometry $D$, return the set of types of $D$.

<a id="function-types-cosetgeom"></a>
## `Types(C): CosetGeom -> SetIndx`

Given a coset geometry $C$, return the set of types of $C$.

<a id="function-rank-incgeom"></a>
## `Rank(D): IncGeom -> RngIntElt`

Given an incidence geometry $D$, return the rank of $D$, i.e. the cardinality of the set of types.

<a id="function-rank-cosetgeom"></a>
## `Rank(C): CosetGeom -> RngIntElt`

Given a coset geometry $C$, return the rank of $C$.

<a id="function-incidencegraph-incgeom"></a>
## `IncidenceGraph(D): IncGeom -> GrphUnd, GrphVertSet, GrphEdgeSet`

Given an incidence geometry $D$, return the incidence graph of $D$, its vertex set, and its edge set.

We remark that this function is not implemented for coset geometries but we may convert a coset geometry into an incidence geometry using `IncidenceGeometry` and then compute its incidence graph.

<a id="function-group-cosetgeom"></a>
## `Group(C): CosetGeom -> GrpPerm`

Given a coset geometry $C$, return the group from which $C$ is constructed.

<a id="function-maxparabolics-cosetgeom"></a>
## `MaxParabolics(C): CosetGeom -> SetIndx`

<a id="function-maximalparabolics-cosetgeom"></a>
## `MaximalParabolics(C): CosetGeom -> SetIndx`

Given a coset geometry $C$, return an indexed set containing the maximal parabolics of $C$.

<a id="function-minparabolics-cosetgeom"></a>
## `MinParabolics(C): CosetGeom -> SetIndx`

<a id="function-minimalparabolics-cosetgeom"></a>
## `MinimalParabolics(C): CosetGeom -> SetIndx`

Given a coset geometry $C$, return an indexed set containing the minimal parabolics of $C$.

<a id="function-borel-cosetgeom"></a>
## `Borel(C): CosetGeom -> GrpPerm`

<a id="function-borelsubgroup-cosetgeom"></a>
## `BorelSubgroup(C): CosetGeom -> GrpPerm`

Given a coset geometry $C$, return the *Borel subgroup* of $C$, i.e. the intersection of all maximal parabolic subgroups of $C$.

<a id="function-kernel-cosetgeom"></a>
## `Kernel(C): CosetGeom -> GrpPerm`

Given a coset geometry $C$, return a permutation group which is its kernel, i.e. the subgroup of the Borel subgroup of $C$ that fixes all elements of the geometry $C$.

<a id="function-kernels-cosetgeom"></a>
## `Kernels(C): CosetGeom -> SeqEnum`

Given a coset geometry $C$, return a sequence containing the $i$-kernel $K_i$ of each maximal parabolic subgroup $G_i$ of $C$. The $i$-kernel of the subgroup $G_i$ is the subgroup consisting of all the elements of $G_i$ that fix all the elements of the residue of $G_i$.

<a id="function-quotient-cosetgeom-grpperm"></a>
## `Quotient(C, K): CosetGeom, GrpPerm -> CosetGeom`

Given a coset geometry $C = (G; (G_i)_{i\in I})$ and a permutation group $K$, return the coset geometry $(G/K; (G_i/K)_{i\in I})$ provided that $K$ is a normal subgroup of $G$ and of all the maximal parabolic subgroups of $C$.
