Comparison

Comparison matrix

Fixed-point libraries

Library	APyTypes	en_cl_fix	fixedpoint	fpbinary	fxpmath	numfi	pyfixp	spfpm
Custom fixed-point formats	Yes	Yes	Yes	Yes	Yes	Yes [2]	Yes	Yes
Custom floating-point formats	Yes	No	No	No	No	No	No	No
Maximum wordlength [5]	None	53/None [1]	None	None	None	64 [2]	53 [3]	None
Resizing of fixed-point results	Yes	Yes	Yes	Yes	Yes	Yes [2]	Yes [3]	No
Arrays	Yes	Yes	No	No [4]	Yes	Yes	Yes [3]	No
Matrix multiplication (@)	Yes	No	N/A	N/A	No	No	Yes [3]	N/A
Written in	C++/Python	Python	Python	C/Python	Python	Python	Python [3]	Python

Footnotes

[1]

en_cl_fix has two different fixed-point classes, one handles up to 53 bits, the other has no limitation. However, an operation involving the shorter format cannot produce the longer etc. In the comparison, the longer format was used for all tests.

[2] (1,2,3)

numfi is limited to 64 total bits (including results of e.g. multiplication).

[3] (1,2,3,4,5)

pyfixp is essentially a package to simply quantize NumPy-arrays with doubles.

[4]

fpbinary provides a helper function to convert an array to a list with fixed-point numbers.

[5]

Note that this holds for intermediate results as well. For example, multiplying two 27-bit numbers will create a 54-bit result which will not give bit-accurate results with pyfixp.

Floating-point libraries

Library	APyTypes	gmpy2
Custom fixed-point formats	Yes	No
Custom floating-point formats	Yes	Yes
Binary representation of number [6]	Yes	No
Maximum wordlength	32 bits for exponent, 64 bits for mantissa [7]	None
Stochastic rounding	Yes	No
Arrays	Yes	No
Matrix multiplication (@)	Yes	N/A
Written in	C++/Python	C/Python

Footnotes

[6]

This means that it is possible to get a binary representation for comparison with, e.g., a hardware implementation.

[7]

This is a design choice since apytypes is aimed at simulating shorter custom formats. However, there is unlimited word length support for fixed-point values which can, if deemed suitable at a later time, be used for floating-point as well.

Performance Comparison

This benchmark compares relevant fixed-point libraries from the list above. It is updated every documentation build and may vary over time as the code is further optimized.

Feature Comparison