---
title: "Predicates"
canonical: "https://docs.magma-maths.org/v2.30-1/ModularArithmeticGeometry/SupersingularDivisorsOnModularCurves/predicates.html"
source: "https://docs.magma-maths.org/v2.30-1/ModularArithmeticGeometry/SupersingularDivisorsOnModularCurves/predicates.md"
part: "Modular Arithmetic Geometry"
chapter: "Supersingular Divisors on Modular Curves"
breadcrumbs:
  - {"title": "Magma Handbook", "source": "https://docs.magma-maths.org/v2.30-1/index.md"}
  - {"title": "Modular Arithmetic Geometry", "source": "https://docs.magma-maths.org/v2.30-1/ModularArithmeticGeometry/index-modular-arithmetic-geometry.md"}
  - {"title": "Supersingular Divisors on Modular Curves", "source": "https://docs.magma-maths.org/v2.30-1/ModularArithmeticGeometry/SupersingularDivisorsOnModularCurves/index-supersingular-divisors-on-modular-curves.md"}
prev: {"title": "Associated Spaces", "source": "https://docs.magma-maths.org/v2.30-1/ModularArithmeticGeometry/SupersingularDivisorsOnModularCurves/associated-spaces.md"}
next: {"title": "Arithmetic", "source": "https://docs.magma-maths.org/v2.30-1/ModularArithmeticGeometry/SupersingularDivisorsOnModularCurves/arithmetic.md"}
intrinsics:
  - {"name": "IsAmbientSpace", "signature": "IsAmbientSpace(M): ModSS -> BoolElt"}
  - {"name": "eq", "signature": "M1 eq M2: ModSS, ModSS -> BoolElt"}
  - {"name": "eq", "signature": "P eq Q: ModSSElt, ModSSElt -> BoolElt"}
  - {"name": "subset", "signature": "M1 subset M2: ModSS, ModSS -> BoolElt"}
  - {"name": "UsesBrandt", "signature": "UsesBrandt(M): ModSS -> BoolElt"}
  - {"name": "UsesMestre", "signature": "UsesMestre(M): ModSS -> BoolElt"}
examples:
  - "ex-999e2e"
---

# Predicates

<a id="function-isambientspace-modss"></a>
## `IsAmbientSpace(M): ModSS -> BoolElt`

Returns `true` if the supersingular module $M$ is the full module of supersingular points and not a submodule.

<a id="operation-op-eq-modss-modss"></a>
## `M1 eq M2: ModSS, ModSS -> BoolElt`

Returns `true` if the supersingular module $M_1$ equals $M_2$.

<a id="operation-op-eq-modsselt-modsselt"></a>
## `P eq Q: ModSSElt, ModSSElt -> BoolElt`

Returns `true` if the module element $P$ equals $Q$.

<a id="operation-op-subset-modss-modss"></a>
## `M1 subset M2: ModSS, ModSS -> BoolElt`

Returns `true` if the supersingular module $M_1$ is a subset of $M_2$.

<a id="function-usesbrandt-modss"></a>
## `UsesBrandt(M): ModSS -> BoolElt`

Returns `true` if the underlying computations on the supersingular module $M$ are done using Brandt modules.

<a id="function-usesmestre-modss"></a>
## `UsesMestre(M): ModSS -> BoolElt`

Returns `true` if the underlying computations on the supersingular module $M$ are done using the Mestre-Oesterle method of graphs.

<a id="example-ex-999e2e"></a>
## `Example: Predicates for Supersingular Modules (ex-999e2e)`

In this example we illustrate each of the above predicates.

```magma
> M := SupersingularModule(11);
> S := CuspidalSubspace(M);
> IsAmbientSpace(S);
false
> IsAmbientSpace(M);
true
> S eq M;
false
> S eq S;
true
> S.1 eq S.1;
true
> S.1 eq M.1 - M.2;
true
> S.1 eq M.1;
false
> S subset M;
true
> UsesBrandt(S);
false
> UsesMestre(S);
true
> M := SupersingularModule(11 : Brandt := true);
> UsesBrandt(M);
true
> UsesMestre(M);
false
```
