Core Types#

The fundamental types provided by NumPy QuadDType.

Quad Precision Value#

class numpy_quaddtype.QuadPrecision(value, backend='sleef')#

A quad-precision (128-bit) floating-point scalar.

QuadPrecision is a NumPy scalar type that provides IEEE 754 binary128 floating-point arithmetic. It can be used standalone or as elements of NumPy arrays.

Parameters:

  • value (float, int, str, bytes, numpy scalar, or QuadPrecision) –

    The value to convert to quad precision. It can be:

    • float or int: Python numeric types

    • str: String representation for maximum precision

    • bytes: Raw 16-byte representation

    • numpy.floating or numpy.integer: NumPy numeric types

    • QuadPrecision: Another QuadPrecision value

  • backend (str, optional) – Computation backend to use. Either "sleef" (default) or "longdouble".

Examples

Create from different input types:

>>> from numpy_quaddtype import QuadPrecision
>>> QuadPrecision(3.14)
QuadPrecision('3.14000000000000012434...')
>>> QuadPrecision("3.14159265358979323846264338327950288")
QuadPrecision('3.14159265358979323846264338327950288')
>>> QuadPrecision(42)
QuadPrecision('42.0')

Arithmetic operations:

>>> x = QuadPrecision("1.5")
>>> y = QuadPrecision("2.5")
>>> x + y
QuadPrecision('4.0')
>>> x * y
QuadPrecision('3.75')
dtype: QuadPrecDType#

The NumPy dtype for this scalar.

real: QuadPrecision#

The real part (always self for QuadPrecision).

imag: QuadPrecision#

The imaginary part (always zero for QuadPrecision).

Quad Precision DType#

class numpy_quaddtype.QuadPrecDType(backend='sleef')#

NumPy dtype for quad-precision floating-point arrays.

QuadPrecDType is a custom NumPy dtype that enables the creation and manipulation of arrays containing quad-precision values.

Parameters:

backend (str, optional) – Computation backend. Either "sleef" (default) or "longdouble".

Examples

Create arrays with QuadPrecDType:

>>> import numpy as np
>>> from numpy_quaddtype import QuadPrecDType
>>> arr = np.array([1, 2, 3], dtype=QuadPrecDType())
>>> arr.dtype
QuadPrecDType128
>>> np.zeros(5, dtype=QuadPrecDType())
array([0.0, 0.0, 0.0, 0.0, 0.0], dtype=QuadPrecDType128)
backend: QuadBackend#

The computation backend (SLEEF or LONGDOUBLE).

itemsize: int#

The size of each element in bytes (always 16).

alignment: int#

The memory alignment in bytes (always 16).

name: str#

The string name of the dtype ("QuadPrecDType128").

class numpy_quaddtype.QuadBackend#

Enumeration of available computation backends.

SLEEF = 0#

SLEEF library backend (default). Provides true IEEE 754 binary128 quad precision with SIMD optimization.

LONGDOUBLE = 1#

The platform’s native long double backend. The precision varies by platform.

Example

>>> from numpy_quaddtype import QuadPrecDType, QuadBackend
>>> dtype = QuadPrecDType()
>>> dtype.backend == QuadBackend.SLEEF
True

Convenience Functions#

numpy_quaddtype.SleefQuadPrecision(value)#

Create a QuadPrecision scalar using the SLEEF backend.

Equivalent to QuadPrecision(value, backend="sleef").

Parameters:

value – Value to convert to quad precision.

Returns:

Quad precision scalar using SLEEF backend.

Return type:

QuadPrecision

numpy_quaddtype.LongDoubleQuadPrecision(value)#

Create a QuadPrecision scalar using the longdouble backend.

Equivalent to QuadPrecision(value, backend="longdouble").

Parameters:

value – Value to convert to quad precision.

Returns:

Quad precision scalar using longdouble backend.

Return type:

QuadPrecision

numpy_quaddtype.SleefQuadPrecDType()#

Create a QuadPrecDType using the SLEEF backend.

Equivalent to QuadPrecDType(backend="sleef").

Returns:

Dtype for SLEEF-backed quad precision arrays.

Return type:

QuadPrecDType

numpy_quaddtype.LongDoubleQuadPrecDType()#

Create a QuadPrecDType using the longdouble backend.

Equivalent to QuadPrecDType(backend="longdouble").

Returns:

Dtype for longdouble-backed quad precision arrays.

Return type:

QuadPrecDType