---
title: "Binary Quadratic Forms"
canonical: "https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/index-binary-quadratic-forms.html"
source: "https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/index-binary-quadratic-forms.md"
part: "Lattices and Quadratic Forms"
chapter: "Binary Quadratic Forms"
breadcrumbs:
  - {"title": "Magma Handbook", "source": "https://docs.magma-maths.org/v2.30-1/index.md"}
  - {"title": "Lattices and Quadratic Forms", "source": "https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/index-lattices-quadratic-forms.md"}
prev: {"title": "Bibliography", "source": "https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/QuadraticForms/bibliography.md"}
next: {"title": "Introduction", "source": "https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/introduction.md"}
---

<a id="quadratic"></a>
<a id="quadbin"></a>
# Binary Quadratic Forms

- [Introduction](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/introduction.md)
- [Creation Functions](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/creation.md)
  - [Creation of Structures](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/creation.md#creation-of-structures)
    - [`BinaryQuadraticForms(D): RngIntElt → QuadBin`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/creation.md#function-binaryquadraticforms-rngintelt)
    - [`QuadraticForms(D): RngIntElt → QuadBin`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/creation.md#function-quadraticforms-rngintelt)
  - [Creation of Forms](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/creation.md#creation-of-forms)
    - [`Identity(Q): QuadBin → QuadBinElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/creation.md#function-identity-quadbin)
    - [`Q ! 1: QuadBin, RngIntElt → QuadBinElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/creation.md#operation-op-quadbin-rngintelt)
    - [`Q ! [a, b, c]: QuadBin, RngIntElt, RngIntElt, RngIntElt → QuadBinElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/creation.md#operation-op-quadbin-rngintelt-rngintelt-rngintelt)
    - [`elt< Q | a, b, c>: QuadBin, RngIntElt, RngIntElt, RngIntElt → QuadBinElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/creation.md#constructor-constructor-elt-quadbin-rngintelt-rngintelt-rngintelt-quadbinelt)
    - [`elt< Q | a, b>: QuadBin, RngIntElt, RngIntElt → QuadBinElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/creation.md#constructor-constructor-elt-quadbin-rngintelt-rngintelt-quadbinelt)
    - [`PrimeForm(Q, p): QuadBin, RngIntElt → QuadBinElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/creation.md#function-primeform-quadbin-rngintelt)
- [Basic Invariants](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invariants.md)
  - [`Discriminant(f): QuadBinElt → RngIntElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invariants.md#function-discriminant-quadbinelt)
  - [`Discriminant(Q): QuadBin → RngIntElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invariants.md#function-discriminant-quadbin)
  - [`IsDiscriminant(D): RngIntElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invariants.md#function-isdiscriminant-rngintelt)
  - [`IsFundamental(D): RngIntElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invariants.md#function-isfundamental-rngintelt)
  - [`IsFundamentalDiscriminant(D): RngIntElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invariants.md#function-isfundamentaldiscriminant-rngintelt)
  - [`FundamentalDiscriminant(D): RngIntElt → RngIntElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invariants.md#function-fundamentaldiscriminant-rngintelt)
  - [`Conductor(Q): QuadBin → RngIntElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invariants.md#function-conductor-quadbin)
- [Operations on Forms](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md)
  - [Arithmetic](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#arithmetic)
    - [`Conjugate(f): QuadBinElt → QuadBinElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-conjugate-quadbinelt)
    - [`f * g: QuadBinElt, QuadBinElt → QuadBinElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#operation-op-times-quadbinelt-quadbinelt)
    - [`Composition(f, g): QuadBinElt, QuadBinElt → QuadBinElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-composition-quadbinelt-quadbinelt)
    - [`f ^ n: QuadBinElt, RngIntElt → QuadBinElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#operation-op-pow-quadbinelt-rngintelt)
    - [`Power(f, n): QuadBinElt, RngIntElt → QuadBinElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-power-quadbinelt-rngintelt)
  - [Matrix Action](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#matrix-action)
    - [`f * M: QuadBinElt, GrpMatElt → QuadBinElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#operation-op-times-quadbinelt-grpmatelt)
  - [Reduction](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#reduction)
    - [`Reduction(f): QuadBinElt → QuadBinElt, Mtrx`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-reduction-quadbinelt)
    - [`ReducedForm(f): QuadBinElt → QuadBinElt, Mtrx`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-reducedform-quadbinelt)
    - [`ReductionStep(f): QuadBinElt → QuadBinElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-reductionstep-quadbinelt)
    - [`ReductionOrbit(f): QuadBinElt → {@ QuadBinElt @}`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-reductionorbit-quadbinelt)
    - [`Order(f): QuadBinElt → RngIntElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-order-quadbinelt)
  - [Attribute Access](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#attribute-access)
    - [`f[i]: QuadBinElt, RngIntElt → RngIntElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#indexed-indexed-f-quadbinelt-rngintelt-rngintelt)
    - [`Eltseq(f): QuadBinElt → SeqEnum[RngIntElt]`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-eltseq-quadbinelt)
    - [`ElementToSequence(f): QuadBinElt → SeqEnum[RngIntElt]`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-elementtosequence-quadbinelt)
  - [Boolean Operations](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#boolean-operations)
    - [`f in Q: QuadBinElt, QuadBin → BoolElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#operation-op-in-quadbinelt-quadbin)
    - [`f eq g: QuadBinElt, QuadBinElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#operation-op-eq-quadbinelt-quadbinelt)
    - [`IsIdentity(f): QuadBinElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-isidentity-quadbinelt)
    - [`IsReduced(f): QuadBinElt → BoolElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-isreduced-quadbinelt)
    - [`IsEquivalent(f, g): QuadBinElt, QuadBinElt → BoolElt, AlgMatElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-isequivalent-quadbinelt-quadbinelt)
  - [Maps of Forms](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#maps-of-forms)
    - [`FundamentalQuotient(Q): QuadBin → Map`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-fundamentalquotient-quadbin)
    - [`QuotientMap(Q1, Q2): QuadBin, QuadBin → Map`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-quotientmap-quadbin-quadbin)
    - [`Q ! f: QuadBin, QuadBinElt → QuadBinElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#operation-op-quadbin-quadbinelt)
  - [Related Structures](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#related-structures)
    - [`Parent(f): QuadBinElt → QuadBin`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-parent-quadbinelt)
    - [`Category(Q): QuadBin → Cat`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-category-quadbin)
    - [`QuadraticOrder(Q): QuadBin → RngQuad`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-quadraticorder-quadbin)
    - [`Ideal(f): QuadBinElt → RngQuadIdl`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/form-operations.md#function-ideal-quadbinelt)
- [Reduced Forms](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/reduced-forms.md)
  - [`ReducedForms(Q): QuadBin → [ QuadBinElt ]`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/reduced-forms.md#function-reducedforms-quadbin)
  - [`ReducedForms(D): RngIntElt → [ QuadBinElt ]`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/reduced-forms.md#function-reducedforms-rngintelt)
  - [`ReducedOrbits(Q): QuadBin → [ {@ QuadBinElt @} ]`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/reduced-forms.md#function-reducedorbits-quadbin)
- [Class Groups](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/class-group.md)
  - [`ClassNumber(Q: parameters): QuadBin → RngIntElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/class-group.md#function-classnumber-quadbin)
  - [`ClassNumber(D: parameters): RngIntElt → RngIntElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/class-group.md#function-classnumber-rngintelt)
  - [`ClassGroup(Q: parameters): QuadBin → GrpAb, Map`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/class-group.md#function-quadbin-classgroup)
  - [`ClassGroupStructure(Q: parameters): QuadBin → [ RngIntElt ]`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/class-group.md#function-classgroupstructure-quadbin)
  - [`AmbiguousForms(Q): QuadBin → SeqEnum`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/class-group.md#function-ambiguousforms-quadbin)
  - [`TwoTorsionSubgroup(Q): QuadBin → GrpAb, Map`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/class-group.md#function-twotorsionsubgroup-quadbin)
  - [Example: Computing in a Form Class Group](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/class-group.md#example-ex-d1a38f)
- [Discrete Logarithms](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/log.md)
  - [`Log(b, x): QuadBinElt, QuadBinElt → RngIntElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/log.md#function-log-quadbinelt-quadbinelt)
  - [`Log(b, x, t): QuadBinElt, QuadBinElt, RngIntElt → RngIntElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/log.md#function-log-quadbinelt-quadbinelt-rngintelt)
- [Elliptic and Modular Invariants](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invar.md)
  - [`Lattice(f): QuadBinElt → Lat`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invar.md#function-lattice-quadbinelt)
  - [`GramMatrix(f): QuadBinElt → AlgMatElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invar.md#function-grammatrix-quadbinelt)
  - [`ThetaSeries(f, n): QuadBinElt, RngIntElt → RngSerElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invar.md#function-thetaseries-quadbinelt-rngintelt)
  - [`RepresentationNumber(f, n): QuadBinElt, RngIntElt → RngIntElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invar.md#function-representationnumber-quadbinelt-rngintelt)
  - [`jInvariant(f): QuadBinElt → RngSerElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invar.md#function-jinvariant-quadbinelt)
  - [`Eisenstein(k, f): RngIntElt, QuadBinElt → RngSerElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invar.md#function-eisenstein-rngintelt-quadbinelt)
  - [`WeierstrassSeries(z, f): RngSerElt, QuadBinElt → RngSerElt`](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invar.md#function-weierstrassseries-rngserelt-quadbinelt)
  - [Example: Elliptic and Modular Invariants of a Form](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invar.md#example-ex-f93e36)
- [Class Invariants](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invar-2.md)
- [Bibliography](https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/bibliography.md)
