aboutsummaryrefslogtreecommitdiff
path: root/python/python-bigfloat/README
diff options
context:
space:
mode:
Diffstat (limited to 'python/python-bigfloat/README')
-rw-r--r--python/python-bigfloat/README16
1 files changed, 16 insertions, 0 deletions
diff --git a/python/python-bigfloat/README b/python/python-bigfloat/README
new file mode 100644
index 0000000000000..a66784f717f9b
--- /dev/null
+++ b/python/python-bigfloat/README
@@ -0,0 +1,16 @@
+The bigfloat module is a Python wrapper for the MPFR library for arbitrary
+precision floating-point reliable arithmetic.
+
+The MPFR library is a well-known portable C library for arbitrary-precision
+arithmetic on floating-point numbers. It provides precise control over
+precisions and rounding modes and gives correctly-rounded reproducible
+platform-independent results.
+
+The bigfloat module aims to provide a convenient and friendly Python
+interface to the operations and functions provided by the MPFR library. The
+main class, BigFloat, gives an immutable multiple-precision floating-point
+type that can be freely mixed with Python integers and floats. The Context
+class, when used in conjunction with Pythons with statement, gives a simple
+way of controlling precisions and rounding modes. Additional module-level
+functions provide various standard mathematical operations. There is full
+support for IEEE 754 signed zeros, nans, infinities and subnormals.