---
title: "Creation Functions"
canonical: "https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/creation.html"
source: "https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/creation.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"}
  - {"title": "Binary Quadratic Forms", "source": "https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/index-binary-quadratic-forms.md"}
prev: {"title": "Introduction", "source": "https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/introduction.md"}
next: {"title": "Basic Invariants", "source": "https://docs.magma-maths.org/v2.30-1/LatticesQuadraticForms/BinaryQuadraticForms/invariants.md"}
intrinsics:
  - {"name": "BinaryQuadraticForms", "signature": "BinaryQuadraticForms(D): RngIntElt -> QuadBin"}
  - {"name": "QuadraticForms", "signature": "QuadraticForms(D): RngIntElt -> QuadBin"}
  - {"name": "Identity", "signature": "Identity(Q): QuadBin -> QuadBinElt"}
  - {"name": "!", "signature": "Q ! 1: QuadBin, RngIntElt -> QuadBinElt"}
  - {"name": "!", "signature": "Q ! [a, b, c]: QuadBin, RngIntElt, RngIntElt, RngIntElt -> QuadBinElt"}
  - {"name": "elt", "signature": "elt< Q | a, b, c>: QuadBin, RngIntElt, RngIntElt, RngIntElt -> QuadBinElt"}
  - {"name": "elt", "signature": "elt< Q | a, b>: QuadBin, RngIntElt, RngIntElt -> QuadBinElt"}
  - {"name": "PrimeForm", "signature": "PrimeForm(Q, p): QuadBin, RngIntElt -> QuadBinElt"}
---

# Creation Functions

## Creation of Structures

For any nonsquare integer $D$ congruent to $0$ or $1$ modulo $4$, binary quadratic forms of discriminant $D$ may be created. The parent object of forms of discriminant $D$ can be created using the following commands.

<a id="function-binaryquadraticforms-rngintelt"></a>
### `BinaryQuadraticForms(D): RngIntElt -> QuadBin`

<a id="function-quadraticforms-rngintelt"></a>
### `QuadraticForms(D): RngIntElt -> QuadBin`

Create the structure of integral binary quadratic forms of discriminant $D$.

## Creation of Forms

Binary quadratic forms may be created by coercing a triple $[a,b,c]$ of integer coefficients into the parent structure of forms of discriminant $D = b^2-4ac$. Other constructors are provided for constructing the group identity, prime forms, or allowing the omission of third element $c$ of the sequence.

<a id="function-identity-quadbin"></a>
### `Identity(Q): QuadBin -> QuadBinElt`

<a id="operation-op-quadbin-rngintelt"></a>
### `Q ! 1: QuadBin, RngIntElt -> QuadBinElt`

Create the principal form in the structure $Q$ of binary quadratic forms of discriminant $D$. The principal form is a reduced form equivalent to $X^2-D/4Y^2$ when $D \equiv 0 \bmod 4,$ or $X^2+XY-(D-1)/4Y^2$ when $D \equiv 1 \bmod 4$.

<a id="operation-op-quadbin-rngintelt-rngintelt-rngintelt"></a>
### `Q ! [a, b, c]: QuadBin, RngIntElt, RngIntElt, RngIntElt -> QuadBinElt`

<a id="constructor-constructor-elt-quadbin-rngintelt-rngintelt-rngintelt-quadbinelt"></a>
### `elt< Q | a, b, c>: QuadBin, RngIntElt, RngIntElt, RngIntElt -> QuadBinElt`

<a id="constructor-constructor-elt-quadbin-rngintelt-rngintelt-quadbinelt"></a>
### `elt< Q | a, b>: QuadBin, RngIntElt, RngIntElt -> QuadBinElt`

Returns the binary quadratic form $aX^2+bXY+cY^2$ in the magma of forms $Q$ of discriminant $D$. Here $c$ is determined by the solution of the equality $D = b^2-4ac$; if no integer $c$ exists satisfying this, an error will occur.

<a id="function-primeform-quadbin-rngintelt"></a>
### `PrimeForm(Q, p): QuadBin, RngIntElt -> QuadBinElt`

If $p$ is a split prime or a ramified prime not dividing the conductor of the magma of quadratic forms $Q$, returns a quadratic form $pX^2+bXY+cY^2$ in $Q$.
