Approximate infinite sums with a guaranteed error.
Project description
InfSumPy is a Python package that evaluates infinite positive sums with guaranteed error. Using ratio and integral tests we evaluate series that pass these tests with controlled error.
Instalation
Make sure you have the mpmath library installed:
pip install mpmath
To install the package, run the following command:
pip install infsumpy
Usage
We have the transformations implemented above, and for use, we have the infsum
function.
Which receives from input:
- A series: In the form of a function f: $\mathbb{N} \to \mathbb{R}$.
- Method: Can be
ratio
,integral
,threshold
orfixed
. - Max terms: The maximum number of terms.
- Start terms: The index of the first term of the series.
- Epsilon (optional): The expected error tolerance (if the method is
ratio
,integral
orthreshold
). - L (optional): Limit of the ratio of terms (if the method is
ratio
). - Integral of series (optional): The function of g(n) = ∫_n^∞ f(x) dx for the integral test (if the method is
integral
). - Precision (optional): The precision for the
mpmath
library (default value is 53).
The function returns the number of terms used in the sum and the approximation.
Ratio test
from infsumpy import infsum
# the infinity sum of n/(2**n) pass in the ratio test with limit L = 1/2,
# then we can evaluate with controled error
print(infsum(lambda n: n/(2**n), 'ratio', max_terms=10**4, initial=1, eps=2**(-52), L=1/2))
> (56, 2.0)
Integral test
from infsumpy import infsum
# the infinity sum of 1/n**2 pass in the integral test with integral
# g(n) = ∫_n^∞ 1/x**2 dx = 1/n, then we can evaluate with controled error
print(infsum(lambda n: 1/(n**2), 'integral', max_terms=10**4, initial=1, eps=10**(-3), g=lambda n: 1/n))
> (499, 1.64493406229104)
Threshold (not guaranteed)
from infsumpy import infsum
# we can also use a stoping criterio such that sum until the n-th are less
# than the epsilon, here for the infinity sum of 2/(2**n)
print(infsum(lambda n: n/(2**n), 'threshold', max_terms=10**4, initial=1, eps=2**(-52)))
> (57, 2.0)
Fixed (not guaranteed)
from infsumpy import infsum
# we can just sum a fixed number of terms of the infinite sum of 2/(2**n)
print(infsum(lambda n: n/(2**n), 'fixed', max_terms=10**4, initial=1))
> (10000, 2.0)
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
infsumpy-1.0.2.tar.gz
(16.7 kB
view details)
Built Distribution
InfSumPy-1.0.2-py3-none-any.whl
(15.8 kB
view details)
File details
Details for the file infsumpy-1.0.2.tar.gz
.
File metadata
- Download URL: infsumpy-1.0.2.tar.gz
- Upload date:
- Size: 16.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | a68f9bbe96603bb2b45d589cd5bc45d0cee4c697f5b92aefadecea978fbed32a |
|
MD5 | bcfe8ad8e33e027715f962e2e846c0e7 |
|
BLAKE2b-256 | 812352e2de4343fc40e118896aa1d06c4b2879fe628a9030d56c8a9bb16ff45c |
File details
Details for the file InfSumPy-1.0.2-py3-none-any.whl
.
File metadata
- Download URL: InfSumPy-1.0.2-py3-none-any.whl
- Upload date:
- Size: 15.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | ae8b2afe2d4993bf60a0bcae3fd5d10a134a9f4a9775d6bcd7f7de3fce1a75d0 |
|
MD5 | 50b037facacd8743abc3d75999e9fb2f |
|
BLAKE2b-256 | fc1ab76613e45e2ef81705be5e165f243e04747c884747eeacd8d1acfb0afdda |