---
title: "Totally Real and Positive"
canonical: "https://docs.magma-maths.org/v2.30-1/GlobalFields/EtaleAlgebras/TotRealTotPos.html"
source: "https://docs.magma-maths.org/v2.30-1/GlobalFields/EtaleAlgebras/TotRealTotPos.md"
part: "Global Fields"
chapter: "Étale Algebras"
breadcrumbs:
  - {"title": "Magma Handbook", "source": "https://docs.magma-maths.org/v2.30-1/index.md"}
  - {"title": "Global Fields", "source": "https://docs.magma-maths.org/v2.30-1/GlobalFields/index-global-fields.md"}
  - {"title": "Étale Algebras", "source": "https://docs.magma-maths.org/v2.30-1/GlobalFields/EtaleAlgebras/index-etale-algebras.md"}
prev: {"title": "Complex Multiplication", "source": "https://docs.magma-maths.org/v2.30-1/GlobalFields/EtaleAlgebras/complex-mult.md"}
next: {"title": "Printing and Saving", "source": "https://docs.magma-maths.org/v2.30-1/GlobalFields/EtaleAlgebras/print_save.md"}
intrinsics:
  - {"name": "IsTotallyReal", "signature": "IsTotallyReal(a): AlgEtQElt -> BoolElt"}
  - {"name": "IsTotallyRealPositive", "signature": "IsTotallyRealPositive(a): AlgEtQElt -> BoolElt"}
  - {"name": "TotallyRealSubAlgebra", "signature": "TotallyRealSubAlgebra(K): AlgEtQ -> AlgEtQ, Map"}
  - {"name": "TotallyRealUnitGroup", "signature": "TotallyRealUnitGroup(S): AlgEtQOrd -> Grp"}
  - {"name": "TotallyRealPositiveUnitGroup", "signature": "TotallyRealPositiveUnitGroup(S): AlgEtQOrd -> Grp"}
---

# Totally Real and Positive

<a id="function-istotallyreal-algetqelt"></a>
## `IsTotallyReal(a): AlgEtQElt -> BoolElt`

Returns whether element $a$ is totally real.

<a id="function-istotallyrealpositive-algetqelt"></a>
## `IsTotallyRealPositive(a): AlgEtQElt -> BoolElt`

Returns whether the element $a$ is totally positive, that is, totally real and with positive image in CC.

<a id="function-totallyrealsubalgebra-algetq"></a>
## `TotallyRealSubAlgebra(K): AlgEtQ -> AlgEtQ, Map`

Given a CM algebra $K$, returns the unique totally real subalgebra, with an embedding.

<a id="function-totallyrealunitgroup-algetqord"></a>
## `TotallyRealUnitGroup(S): AlgEtQOrd -> Grp`

Given an order $S$ in a CM étale algebra $A$ returns the groups of totally real units of $S$, as a subgroup of $S^*$.

<a id="function-totallyrealpositiveunitgroup-algetqord"></a>
## `TotallyRealPositiveUnitGroup(S): AlgEtQOrd -> Grp`

Given an order $S$ in a CM étale algebra. Returns the groups of totally positive units of $S$, as a subgroup of $S^*$.
