pygsl 2.6.5

Requirements

To build the interface, you will need

• GSL 2.x

• Python 3.9 or newer

• NumPy

• Swig4 <https://www.swig.org>_

• an ANSI C compiler (e.g. gcc).

• A Posix 1 compliant operating system

Since version 2.6 PyGSL is built using meson-python. Swig must be always installed to build PyGSL.Meson-python will be automatically installed by PyPI during the build process.

Installing PyGSL

pip install --upgrade pip wheel

pip install pygsl

pip uninstall pygsl

pip install --upgrade build

Using PyGSL

Do NOT test the interface in the distribution root directory! – please install it first and then change to the tests directory and execute python -m pytest ..

Just write in Python

import pygsl.sf
print("%g+/-%g"%pygsl.sf.erf(1))

or

import pygsl.rng
rng=pygsl.rng.rng()
print rng.gaussian(1.0)

You may set the environment variable LD_LIBRARY_PATH to find the gsl shared object.

Supported Platforms

• Linux with Python 3.x and GSL 2.x

• Mac OS X with Python 3.x and GSL 2.x

but is supposed to compile and run on any posix platform.

Currently it is being tested using GitHub Actions continuous integration on:

• Python 3.9 – 3.12, numpy 1.x and 2.x and GSL 2.7.1 under Ubuntu Linux 22.04.2.

Testing

The directory test will contain several testsuites, based on Python unittest. Change to this directory to run the tests.

What is implemented (versus GSL 2.1):

• Blas

• BSplines

• Chebyshev

• Combination

• Const

• Diff

• Eigen

• Fit

• Ieee

• Integrate

• Interpolation

• Interpolation2D

• Linalg

• Math

• Minimize

• Multifit

• Multifit_nlin

• Multimin

• Multiroots

• Odeiv

• Permutation

• Poly

• Qrng

• Rng

• Roots

• Siman

• Sf

• Spline

• Statistics

What is not implemented yet (versus GSL 2.7)

• GSL Capabilites not yet wrapped by PyGSL

  • Sorting

  • N-tuples

• GSL Capabilites partly implemented

  • Discrete Hankel Transforms

See also the TODO file in the distribution.

For the exact function volume for a module, please type:

from pygsl.testing import sf
dir(sf)

You can do this with the other modules, too. The naming scheme is the same as in GSL.

Documentation

The function reference can be found in the docstrings and at the gsl-reference.

Written documentation can be found in the doc/ref directory.

See also the examples directory.

Support

Support requests and all other questions should be submitted as a GitHub Issue.

Developement

You can browse our git repository.

If you want to contribute to PyGSL, please fork the repository and create a pull request.

The script tools/extract_tool.py generates most of the special function code.

History

A GSL interface for Python was needed for a project at Center for applied informatics Cologne.

pygsl-0.0.3 was released on May 23, 2001.

Thanks

• Charl Linssen for continous integration

• Jochen Küpper for pygsl.statistics

• Fabian Jakobs for pygsl.blas, pygsl.eigen, pygsl.linalg and pygsl.permutation

• Leonardo Milano for rpm build support and test

• Eric Gurrola and Peter Stoltz for testing and supporting the port of pygsl to the MAC

• Sebastien Maret for supporting the Fink http://fink.sourceforge.net port of pygsl.

• Michael Forbes for Series Acceleration

• Sergei Ossokine

• Jerry James

• and all for support by providing feed back on testing or showing by email that the code is useful for them

Maintainers

PyGSL is currently maintained by Achim Gaedke, Pierre Schnizer and Charl Linssen.