Skip to main content
Build status Build status on CircleCI Build status on Travis-CI PyPI version License coverage

pykinsol provides a Python binding to the Nonlinear system of equation solver algorithms from kinsol in the SUNDIALS suite. pykinsol allows a user to numerically solve (systems of) non-linear equations. Note that not all functionality of KINSOL are currently exposed in the python wrapper. Additional functionality is however easy to add if needed.

You may also want to know that you can use pykinsol from pyneqsys which can e.g. derive the Jacobian analytically for you.

Documentation

Autogenerated API documentation is found here.

Installation

Simplest way to install pykinsol is to use the conda package manager:

$ conda install -c bjodah pykinsol pytest
$ python -m pytest --pyargs pykinsol

tests should pass.

Binary distribution is available here: https://anaconda.org/bjodah/pykinsol

Source distribution is available here: https://pypi.python.org/pypi/pykinsol

To compile from source you may proceed e.g. as follows:

$ LLAPACK=openblas python3.4 setup.py install --user

where we specified specifically what LAPACK implementation we used for building SUNDIALS.

Examples

See examples/, and rendered jupyter notebooks here: http://hera.physchem.kth.se/~pykinsol/branches/master/examples

Here is a simple example:

>>> def f(x, fout):
...     fout[0] = x[0] + (x[0] - x[1])**3/2 - 1
...     fout[1] = x[1] + (x[1] - x[0])**3/2
...
>>> def j(x, Jout, fx):
...     Jout[0, 0] =  1 + 3/2 * (x[0] - x[1])**2
...     Jout[0, 1] =  -3/2 * (x[0] - x[1])**2
...     Jout[1, 0] =  -3/2 * (x[1] - x[0])**2
...     Jout[1, 1] =  1 + 3/2 * (x[1] - x[0])**2
...
>>> from pykinsol import solve
>>> result = solve(f, j, [0, 0])
>>> assert result['success']
>>> print(result['x'])  # doctest: +SKIP
[ 0.84116389  0.15883611]

License

The source code is Open Source and is released under the simplified 2-clause BSD license. See LICENSE for further details.

Contributors are welcome to suggest improvements at https://github.com/bjodah/pykinsol

Author

Björn I. Dahlgren, contact:

  • gmail address: bjodah

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pykinsol-0.1.9.tar.gz (114.6 kB view details)

Uploaded Source

File details

Details for the file pykinsol-0.1.9.tar.gz.

File metadata

  • Download URL: pykinsol-0.1.9.tar.gz
  • Upload date:
  • Size: 114.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for pykinsol-0.1.9.tar.gz
Algorithm Hash digest
SHA256 08c1f0f258675c8faf541892cb0a2d883671cdfba90e217e84042a13e970c55a
MD5 bdc4864e16a4bc75b2db3ac60f606b2d
BLAKE2b-256 a8deb9c9f0f04107a08c1b577a9ddb2fbb6d95522fe20128bbc3902d620d5d8f

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1.9 This release

1 file

0.1.8

1 file

0.1.7

1 file

0.1.6

1 file

0.1.5

1 file

0.1.4

1 file

0.1.3

1 file

0.1.2

1 file

0.1.1

1 file

0.1.0

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page