qsharp-lang 1.1.2-dev → 1.1.4-dev

package/docs/Microsoft.Quantum.Math/AbsSquaredComplexPolar.md

@@ -0,0 +1,30 @@
+---
+uid: Microsoft.Quantum.Math.AbsSquaredComplexPolar
+title: AbsSquaredComplexPolar function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: AbsSquaredComplexPolar
+qsharp.summary: Returns the squared absolute value of a complex number of type
+`ComplexPolar`.
+---
+
+# AbsSquaredComplexPolar function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function AbsSquaredComplexPolar(input : ComplexPolar) : Double
+```
+
+## Summary
+Returns the squared absolute value of a complex number of type
+`ComplexPolar`.
+
+## Input
+### input
+Complex number c = r⋅𝑒^(t𝑖).
+
+## Output
+Squared absolute value |c|² = r².

package/docs/Microsoft.Quantum.Math/ApproximateFactorial.md

@@ -0,0 +1,40 @@
+---
+uid: Microsoft.Quantum.Math.ApproximateFactorial
+title: ApproximateFactorial function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: ApproximateFactorial
+qsharp.summary: Returns an approximate factorial of a given number.
+---
+
+# ApproximateFactorial function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function ApproximateFactorial(n : Int) : Double
+```
+
+## Summary
+Returns an approximate factorial of a given number.
+
+## Description
+Returns the factorial as `Double`, given an input `n`.
+The domain of inputs for this function is `n <= 169`.
+
+## Remarks
+For n > 10, this function uses the Ramanujan approximation with a
+relative error of the order of 1 / n⁵.
+
+## Input
+### n
+The number to take the approximate factorial of. Must not be negative.
+
+## Output
+The approximate factorial of `n`.
+
+## See Also
+- Microsoft.Quantum.Math.FactorialI
+- Microsoft.Quantum.Math.FactorialL

package/docs/Microsoft.Quantum.Math/ArcCos.md

@@ -0,0 +1,21 @@
+---
+uid: Microsoft.Quantum.Math.ArcCos
+title: ArcCos function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: ArcCos
+qsharp.summary: Returns the angle whose cosine is the specified number.
+---
+
+# ArcCos function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function ArcCos(x : Double) : Double
+```
+
+## Summary
+Returns the angle whose cosine is the specified number.

package/docs/Microsoft.Quantum.Math/ArcCosh.md

@@ -0,0 +1,21 @@
+---
+uid: Microsoft.Quantum.Math.ArcCosh
+title: ArcCosh function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: ArcCosh
+qsharp.summary: Computes the inverse hyperbolic cosine of a number.
+---
+
+# ArcCosh function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function ArcCosh(x : Double) : Double
+```
+
+## Summary
+Computes the inverse hyperbolic cosine of a number.

package/docs/Microsoft.Quantum.Math/ArcSin.md

@@ -0,0 +1,21 @@
+---
+uid: Microsoft.Quantum.Math.ArcSin
+title: ArcSin function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: ArcSin
+qsharp.summary: Returns the angle whose sine is the specified number.
+---
+
+# ArcSin function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function ArcSin(y : Double) : Double
+```
+
+## Summary
+Returns the angle whose sine is the specified number.

package/docs/Microsoft.Quantum.Math/ArcSinh.md

@@ -0,0 +1,21 @@
+---
+uid: Microsoft.Quantum.Math.ArcSinh
+title: ArcSinh function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: ArcSinh
+qsharp.summary: Computes the inverse hyperbolic sine of a number.
+---
+
+# ArcSinh function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function ArcSinh(x : Double) : Double
+```
+
+## Summary
+Computes the inverse hyperbolic sine of a number.

package/docs/Microsoft.Quantum.Math/ArcTan.md

@@ -0,0 +1,21 @@
+---
+uid: Microsoft.Quantum.Math.ArcTan
+title: ArcTan function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: ArcTan
+qsharp.summary: Returns the angle whose tangent is the specified number.
+---
+
+# ArcTan function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function ArcTan(d : Double) : Double
+```
+
+## Summary
+Returns the angle whose tangent is the specified number.

package/docs/Microsoft.Quantum.Math/ArcTan2.md

@@ -0,0 +1,21 @@
+---
+uid: Microsoft.Quantum.Math.ArcTan2
+title: ArcTan2 function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: ArcTan2
+qsharp.summary: Returns the angle whose tangent is the quotient of two specified numbers.
+---
+
+# ArcTan2 function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function ArcTan2(y : Double, x : Double) : Double
+```
+
+## Summary
+Returns the angle whose tangent is the quotient of two specified numbers.

package/docs/Microsoft.Quantum.Math/ArcTanh.md

@@ -0,0 +1,21 @@
+---
+uid: Microsoft.Quantum.Math.ArcTanh
+title: ArcTanh function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: ArcTanh
+qsharp.summary: Computes the inverse hyperbolic tangent of a number.
+---
+
+# ArcTanh function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function ArcTanh(x : Double) : Double
+```
+
+## Summary
+Computes the inverse hyperbolic tangent of a number.

package/docs/Microsoft.Quantum.Math/ArgComplex.md

@@ -0,0 +1,30 @@
+---
+uid: Microsoft.Quantum.Math.ArgComplex
+title: ArgComplex function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: ArgComplex
+qsharp.summary: Returns the phase of a complex number of type
+`Complex`.
+---
+
+# ArgComplex function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function ArgComplex(input : Complex) : Double
+```
+
+## Summary
+Returns the phase of a complex number of type
+`Complex`.
+
+## Input
+### input
+Complex number c = x + y𝑖.
+
+## Output
+Phase Arg(c) = ArcTan(y,x) ∈ (-𝜋,𝜋].

package/docs/Microsoft.Quantum.Math/ArgComplexPolar.md

@@ -0,0 +1,28 @@
+---
+uid: Microsoft.Quantum.Math.ArgComplexPolar
+title: ArgComplexPolar function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: ArgComplexPolar
+qsharp.summary: Returns the phase of a complex number of type `ComplexPolar`.
+---
+
+# ArgComplexPolar function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function ArgComplexPolar(input : ComplexPolar) : Double
+```
+
+## Summary
+Returns the phase of a complex number of type `ComplexPolar`.
+
+## Input
+### input
+Complex number c = r⋅𝑒^(t𝑖).
+
+## Output
+Phase Arg(c) = t.

package/docs/Microsoft.Quantum.Math/Binom.md

@@ -0,0 +1,34 @@
+---
+uid: Microsoft.Quantum.Math.Binom
+title: Binom function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: Binom
+qsharp.summary: Returns the approximate binomial coefficient of two integers.
+---
+
+# Binom function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function Binom(n : Int, k : Int) : Int
+```
+
+## Summary
+Returns the approximate binomial coefficient of two integers.
+
+## Description
+Given two integers n and k, returns the binomial coefficient
+binom(n, k), also known as n-choose-k. Computed approximately.
+
+## Input
+### n
+The first of the two integers to compute the binomial coefficient of.
+### k
+The second of the two integers to compute the binomial coefficient of.
+
+## Output
+The binomial coefficient n-choose-k.

package/docs/Microsoft.Quantum.Math/BitSizeI.md

@@ -0,0 +1,23 @@
+---
+uid: Microsoft.Quantum.Math.BitSizeI
+title: BitSizeI function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: BitSizeI
+qsharp.summary: For a non-negative integer `a`, returns the number of bits required to represent `a`.
+NOTE: This function returns the smallest n such that a < 2^n.
+---
+
+# BitSizeI function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function BitSizeI(a : Int) : Int
+```
+
+## Summary
+For a non-negative integer `a`, returns the number of bits required to represent `a`.
+NOTE: This function returns the smallest n such that a < 2^n.

package/docs/Microsoft.Quantum.Math/BitSizeL.md

@@ -0,0 +1,23 @@
+---
+uid: Microsoft.Quantum.Math.BitSizeL
+title: BitSizeL function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: BitSizeL
+qsharp.summary: For a non-negative integer `a`, returns the number of bits required to represent `a`.
+NOTE: This function returns the smallest n such that a < 2^n.
+---
+
+# BitSizeL function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function BitSizeL(a : BigInt) : Int
+```
+
+## Summary
+For a non-negative integer `a`, returns the number of bits required to represent `a`.
+NOTE: This function returns the smallest n such that a < 2^n.

package/docs/Microsoft.Quantum.Math/Ceiling.md

@@ -0,0 +1,23 @@
+---
+uid: Microsoft.Quantum.Math.Ceiling
+title: Ceiling function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: Ceiling
+qsharp.summary: Returns the smallest integer greater than or equal to the specified number.
+For example: Ceiling(3.1) = 4; Ceiling(-3.7) = -3
+---
+
+# Ceiling function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function Ceiling(value : Double) : Int
+```
+
+## Summary
+Returns the smallest integer greater than or equal to the specified number.
+For example: Ceiling(3.1) = 4; Ceiling(-3.7) = -3

package/docs/Microsoft.Quantum.Math/Complex.md

@@ -0,0 +1,31 @@
+---
+uid: Microsoft.Quantum.Math.Complex
+title: Complex user defined type
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: udt
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: Complex
+qsharp.summary: Represents a complex number by its real and imaginary components.
+The first element of the tuple is the real component,
+the second one - the imaginary component.
+---
+
+# Complex user defined type
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+newtype Complex = (Real: Double, Imag: Double)
+```
+
+## Summary
+Represents a complex number by its real and imaginary components.
+The first element of the tuple is the real component,
+the second one - the imaginary component.
+
+## Example
+The following snippet defines the imaginary unit 𝑖 = 0 + 1𝑖:
+```qsharp
+let imagUnit = Complex(0.0, 1.0);
+```

package/docs/Microsoft.Quantum.Math/ComplexPolar.md

@@ -0,0 +1,29 @@
+---
+uid: Microsoft.Quantum.Math.ComplexPolar
+title: ComplexPolar user defined type
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: udt
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: ComplexPolar
+qsharp.summary: Represents a complex number in polar form.
+The polar representation of a complex number is c = r⋅𝑒^(t𝑖).
+---
+
+# ComplexPolar user defined type
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+newtype ComplexPolar = (Magnitude: Double, Argument: Double)
+```
+
+## Summary
+Represents a complex number in polar form.
+The polar representation of a complex number is c = r⋅𝑒^(t𝑖).
+
+## Named Items
+### Magnitude
+The absolute value r>0 of c.
+### Argument
+The phase t ∈ ℝ of c.

package/docs/Microsoft.Quantum.Math/ContinuedFractionConvergentI.md

@@ -0,0 +1,25 @@
+---
+uid: Microsoft.Quantum.Math.ContinuedFractionConvergentI
+title: ContinuedFractionConvergentI function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: ContinuedFractionConvergentI
+qsharp.summary: Finds the continued fraction convergent closest to `fraction`
+with the denominator less or equal to `denominatorBound`
+Using process similar to this: https://nrich.maths.org/1397
+---
+
+# ContinuedFractionConvergentI function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function ContinuedFractionConvergentI(fraction : (Int, Int), denominatorBound : Int) : (Int, Int)
+```
+
+## Summary
+Finds the continued fraction convergent closest to `fraction`
+with the denominator less or equal to `denominatorBound`
+Using process similar to this: https://nrich.maths.org/1397

package/docs/Microsoft.Quantum.Math/ContinuedFractionConvergentL.md

@@ -0,0 +1,25 @@
+---
+uid: Microsoft.Quantum.Math.ContinuedFractionConvergentL
+title: ContinuedFractionConvergentL function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: ContinuedFractionConvergentL
+qsharp.summary: Finds the continued fraction convergent closest to `fraction`
+with the denominator less or equal to `denominatorBound`
+Using process similar to this: https://nrich.maths.org/1397
+---
+
+# ContinuedFractionConvergentL function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function ContinuedFractionConvergentL(fraction : (BigInt, BigInt), denominatorBound : BigInt) : (BigInt, BigInt)
+```
+
+## Summary
+Finds the continued fraction convergent closest to `fraction`
+with the denominator less or equal to `denominatorBound`
+Using process similar to this: https://nrich.maths.org/1397

package/docs/Microsoft.Quantum.Math/Cos.md

@@ -0,0 +1,21 @@
+---
+uid: Microsoft.Quantum.Math.Cos
+title: Cos function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: Cos
+qsharp.summary: Returns the cosine of the specified angle.
+---
+
+# Cos function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function Cos(theta : Double) : Double
+```
+
+## Summary
+Returns the cosine of the specified angle.

package/docs/Microsoft.Quantum.Math/Cosh.md

@@ -0,0 +1,21 @@
+---
+uid: Microsoft.Quantum.Math.Cosh
+title: Cosh function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: Cosh
+qsharp.summary: Returns the hyperbolic cosine of the specified angle.
+---
+
+# Cosh function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function Cosh(d : Double) : Double
+```
+
+## Summary
+Returns the hyperbolic cosine of the specified angle.

package/docs/Microsoft.Quantum.Math/DivRemI.md

@@ -0,0 +1,21 @@
+---
+uid: Microsoft.Quantum.Math.DivRemI
+title: DivRemI function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: DivRemI
+qsharp.summary: Divides one Integer value by another, returns the result and the remainder as a tuple.
+---
+
+# DivRemI function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function DivRemI(dividend : Int, divisor : Int) : (Int, Int)
+```
+
+## Summary
+Divides one Integer value by another, returns the result and the remainder as a tuple.

package/docs/Microsoft.Quantum.Math/DivRemL.md

@@ -0,0 +1,21 @@
+---
+uid: Microsoft.Quantum.Math.DivRemL
+title: DivRemL function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: DivRemL
+qsharp.summary: Divides one BigInteger value by another, returns the result and the remainder as a tuple.
+---
+
+# DivRemL function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function DivRemL(dividend : BigInt, divisor : BigInt) : (BigInt, BigInt)
+```
+
+## Summary
+Divides one BigInteger value by another, returns the result and the remainder as a tuple.

package/docs/Microsoft.Quantum.Math/DividedByC.md

@@ -0,0 +1,30 @@
+---
+uid: Microsoft.Quantum.Math.DividedByC
+title: DividedByC function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: DividedByC
+qsharp.summary: Returns the quotient of two inputs of type `Complex`.
+---
+
+# DividedByC function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function DividedByC(a : Complex, b : Complex) : Complex
+```
+
+## Summary
+Returns the quotient of two inputs of type `Complex`.
+
+## Input
+### a
+The first input a to be divided.
+### b
+The second input b to be divided.
+
+## Output
+The quotient a / b.

package/docs/Microsoft.Quantum.Math/DividedByCP.md

@@ -0,0 +1,30 @@
+---
+uid: Microsoft.Quantum.Math.DividedByCP
+title: DividedByCP function
+ms.date: 02/16/2024 12:00:00 AM
+ms.topic: managed-reference
+qsharp.kind: function
+qsharp.namespace: Microsoft.Quantum.Math
+qsharp.name: DividedByCP
+qsharp.summary: Returns the quotient of two inputs of type `ComplexPolar`.
+---
+
+# DividedByCP function
+
+Namespace: [Microsoft.Quantum.Math](xref:Microsoft.Quantum.Math)
+
+```qsharp
+function DividedByCP(a : ComplexPolar, b : ComplexPolar) : ComplexPolar
+```
+
+## Summary
+Returns the quotient of two inputs of type `ComplexPolar`.
+
+## Input
+### a
+The first input a to be divided.
+### b
+The second input b to be divided.
+
+## Output
+The quotient a / b.