The iisignature package

This package provides tools for calculating the signature and log signature of a data stream. These are summary statistics of piecewise linear paths, consisting of iterated integrals, inspired by rough path theory.

Documentation: doc.md (online) 👈

See <https://github.com/bottler/phd-docs> for more information about the calculations.

Python

Install a released version, which may be missing recent bugfixes, with:

pip install iisignature

Don't install this package if you don't have numpy >= 1.17 installed. You will need to be able to compile C++ extensions. On a Mac, you will need to have installed Xcode and the Xcode command line tools before doing the installation. The fastest, on-the-fly compiled versions of the log signature calculations are for Windows, Mac and Linux, on both 32 and 64 bit.

Sometimes there are compile errors on a Mac, if this happens try:

MACOSX_DEPLOYMENT_TARGET=10.9 pip install iisignature

Use without installing a released version (START HERE)

To install the current "main" development version straight from github you can type:

pip install git+https://github.com/bottler/iisignature

From a checkout of this repository, you can build the extension and run the tests using:

python setup.py build_ext --inplace && python -m unittest discover tests/

From a checkout of this repository, you can just build the extension into this directory itself using:

python setup.py build_ext --inplace

after which you can use the package in Python in this directory, use the examples in the examples directory, or add this directory to your PYTHONPATH and then use the package in Python anywhere.

If you plan to contribute changes, run pip install pre-commit and then pre-commit install to set up automatic code formatting and linting.

Paper

A paper in TOMS <https://dl.acm.org/doi/10.1145/3371237> accompanies the library. It can also be found on arxiv at <https://arxiv.org/abs/1802.08252>. If you find iisignature useful in your research then please cite:

@article{iisignature,

title={Algorithm 1004: The iisignature Library:

Efficient Calculation of Iterated-Integral Signatures and Log Signatures},

author={Jeremy Reizenstein and Benjamin Graham}, journal={ACM Transactions on Mathematical Software (TOMS)}, year={2020}

}

Authors

• Benjamin Graham
• Jeremy Reizenstein

Thanks

This package includes BCH coefficients from Fernando Casas and Ander Murua. <http://arxiv.org/abs/0810.2656>