---
title: "Basic Properties"
canonical: "https://docs.magma-maths.org/v2.30-1/ModularArithmeticGeometry/AlgebraicModularForms/basic-properties.html"
source: "https://docs.magma-maths.org/v2.30-1/ModularArithmeticGeometry/AlgebraicModularForms/basic-properties.md"
part: "Modular Arithmetic Geometry"
chapter: "Algebraic Modular Forms"
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": "Algebraic Modular Forms", "source": "https://docs.magma-maths.org/v2.30-1/ModularArithmeticGeometry/AlgebraicModularForms/index-algebraic-modular-forms.md"}
prev: {"title": "Creation of Spaces of Algebraic Modular Forms", "source": "https://docs.magma-maths.org/v2.30-1/ModularArithmeticGeometry/AlgebraicModularForms/creation.md"}
next: {"title": "Elements", "source": "https://docs.magma-maths.org/v2.30-1/ModularArithmeticGeometry/AlgebraicModularForms/elements.md"}
intrinsics:
  - {"name": "BaseRing", "signature": "BaseRing(M): ModFrmAlg -> Rng"}
  - {"name": "CoefficientRing", "signature": "CoefficientRing(M): ModFrmAlg -> Rng"}
  - {"name": "FieldOfDefinition", "signature": "FieldOfDefinition(M): ModFrmAlg -> FldOrd"}
  - {"name": "InnerForm", "signature": "InnerForm(M): ModFrmAlg -> AlgMatElt"}
  - {"name": "Weight", "signature": "Weight(M): ModFrmAlg -> GrpRep"}
  - {"name": "Level", "signature": "Level(M): ModFrmAlg -> LatNF"}
  - {"name": "IsOrthogonal", "signature": "IsOrthogonal(M): ModFrmAlg -> BoolElt"}
  - {"name": "IsSpecialOrthogonal", "signature": "IsSpecialOrthogonal(M): ModFrmAlg -> BoolElt"}
  - {"name": "Dimension", "signature": "Dimension(M): ModFrmAlg -> RngIntElt"}
  - {"name": "DimensionsOfDirectSummands", "signature": "DimensionsOfDirectSummands(M): ModFrmAlg -> [RngIntElt]"}
  - {"name": "VectorSpace", "signature": "VectorSpace(M): ModFrmAlg -> ModTupFld"}
  - {"name": "Representation", "signature": "Representation(M): ModFrmAlg -> ModTupFld"}
  - {"name": "Genus", "signature": "Genus(M): ModFrmAlg -> SymGen"}
  - {"name": "GenusReps", "signature": "GenusReps(M): ModFrmAlg -> [ Lat ]"}
  - {"name": "GenusReps", "signature": "GenusReps(M): ModFrmAlg -> [ LatNF ]"}
  - {"name": "SetGenus", "signature": "SetGenus(M, reps): ModFrmAlg, [ Lat ]"}
  - {"name": "AutomorphismGroups", "signature": "AutomorphismGroups(M): ModFrmAlg -> [GrpMat]"}
  - {"name": "SetAutomorphismGroups", "signature": "SetAutomorphismGroups(M, groups): ModFrmAlg, [GrpMat]"}
examples:
  - "ex-b1aea0"
---

# Basic Properties

<a id="function-basering-modfrmalg"></a>
## `BaseRing(M): ModFrmAlg -> Rng`

<a id="function-coefficientring-modfrmalg"></a>
## `CoefficientRing(M): ModFrmAlg -> Rng`

The ring of coefficients of the space $M$.

<a id="function-fieldofdefinition-modfrmalg"></a>
## `FieldOfDefinition(M): ModFrmAlg -> FldOrd`

The field on which the space $M$ was defined.

<a id="function-innerform-modfrmalg"></a>
## `InnerForm(M): ModFrmAlg -> AlgMatElt`

The inner form associated with the space $M$.

<a id="function-weight-modfrmalg"></a>
## `Weight(M): ModFrmAlg -> GrpRep`

The weight of the space $M$.

<a id="function-level-modfrmalg"></a>
## `Level(M): ModFrmAlg -> LatNF`

The level of the space $M$.

<a id="function-isorthogonal-modfrmalg"></a>
## `IsOrthogonal(M): ModFrmAlg -> BoolElt`

Returns `true` if $M$ is the space of algebraic modular forms for a group isogenous to an orthogonal group. (i.e of type B or D).

<a id="function-isspecialorthogonal-modfrmalg"></a>
## `IsSpecialOrthogonal(M): ModFrmAlg -> BoolElt`

Returns `true` if $M$ is the space of algebraic modular forms for a special orthogonal group (${\operatorname{SO}}(V)$ for some quadratic space $V$).

<a id="function-dimension-modfrmalg"></a>
## `Dimension(M): ModFrmAlg -> RngIntElt`

<a id="function-dimensionsofdirectsummands-modfrmalg"></a>
## `DimensionsOfDirectSummands(M): ModFrmAlg -> [RngIntElt]`

```magma
ThetaPrec: RngIntElt                    Default: 25
```

The dimension of the space $M$ of algebraic modular forms, or the dimensions of the direct summands $W^{\Gamma_i}$. The dimension is determined by explicitly constructing the space. `ThetaPrec` determines the precision to which one computes the theta series of lattices for isometry testing in the process.

<a id="function-vectorspace-modfrmalg"></a>
## `VectorSpace(M): ModFrmAlg -> ModTupFld`

<a id="function-representation-modfrmalg"></a>
## `Representation(M): ModFrmAlg -> ModTupFld`

The underlying vector space of $M$.

<a id="example-ex-b1aea0"></a>
## `Example: Level, Weight, and Dimension (ex-b1aea0)`

We continue with the first example above.

```magma
> Q := SymmetricMatrix([6,0,2,-4,-1,12,3,1,6,12]);
> M := OrthogonalModularForms(Q);
> Level(M);
lattice whose discriminant has norm 193
> Norm(Discriminant(Level(M)));
193
> Weight(M);
free module of rank 1 over Rational Field with an action of GL(4,
RationalField())
> IsTrivial(Weight(M));
true
> time Dimension(M);
9
Time: 0.200
> IsOrthogonal(M);
true
> IsSpecialOrthogonal(M);
false
```

This indicates that $M$ is a space of algebraic modular forms for ${\rm O}(Q)$, rather than ${\operatorname{SO}}(Q)$.

```magma
> M_SO := OrthogonalModularForms(Q : Special);
> time Dimension(M_SO);
10
Time: 0.110
> IsOrthogonal(M_SO);
true
> IsSpecialOrthogonal(M_SO);
true
```

<a id="function-genus-modfrmalg"></a>
## `Genus(M): ModFrmAlg -> SymGen`

```magma
UseAuto  : BoolElt                      Default: true
ThetaPrec: RngIntElt                    Default: 25
```

The genus of the level lattice. If `UseAuto` is `true`, uses the action of the automorphism group to check only one lattice of each orbit. `ThetaPrec` determines the precision of the theta series of lattices to keep track of when checking for isometry.

<a id="function-genusreps-modfrmalg"></a>
## `GenusReps(M): ModFrmAlg -> [ Lat ]`

<a id="function-genusreps-modfrmalg-2"></a>
## `GenusReps(M): ModFrmAlg -> [ LatNF ]`

```magma
UseAuto  : BoolElt                      Default: true
ThetaPrec: RngIntElt                    Default: 25
```

The genus representatives of the level lattice. If `UseAuto` is `true`, uses the action of the automorphism group to check only one lattice of each orbit. `ThetaPrec` determines the precision of the theta series of lattices to keep track of when checking for isometry.

<a id="procedure-setgenus-modfrmalg-lat"></a>
## `SetGenus(M, reps): ModFrmAlg, [ Lat ]`

```magma
GramFactor: RngIntElt                    Default: 2
```

Set the genus representatives of $M$ to be the lattices in `reps`. `GramFactor` Determines the scaling between the bilinear form and the quadratic / unitary form.

<a id="function-automorphismgroups-modfrmalg"></a>
## `AutomorphismGroups(M): ModFrmAlg -> [GrpMat]`

```magma
NaturalAction: BoolElt                    Default: false
```

The automorphism groups $\Gamma_i$ stabilizing each of the genus representatives of $M$. If `NaturalAction` is `true`, returns the groups embedded in the automorphism group of the ambient polar space.

<a id="procedure-setautomorphismgroups-modfrmalg-grpmat"></a>
## `SetAutomorphismGroups(M, groups): ModFrmAlg, [GrpMat]`

Set the automorphism groups $\Gamma_i$ stabilizing each of the genus representatives of $M$ to `groups`.
