signatory 1.1.2

< No description when building from source. >

Differentiable computations of the signature and logsignature transforms, on both CPU and GPU.

What are signatures?

If you’re reading this then it’s probably because you already know what the signature transform is, and are looking to use it in your project. But in case you’ve stumbled across this and are curious what this ‘signature’ thing is…

The signature transform is a transformation that takes in a stream of data (often a time series), and returns a collection of statistics about that stream of data, called the signature. This collection of statistics is determines the path essentially uniquely, and are both possible and efficient to compute. Furthermore the signature is rich enough that every continuous function of the input stream may be approximated arbitrarily well by a linear function of its signature; the signature is what we call a universal nonlinearity. If you’re doing machine learning then you probably understand why this is such a desirable property!

Check out this for a primer on the use of the signature transform in machine learning, just as a feature transformation, and this for a more in-depth look at integrating the signature transform into neural networks.

Installation

Available for Python 2.7, Python 3.5, Python 3.6, Python 3.7.

Requires PyTorch. Tested with PyTorch version 1.2.0, but should work with all recent versions.

Install via pip install signatory or pip3 install signatory as appropriate.

Only source distributions are available at the moment, so you will need to be able to compile C++. If you are on Linux then this should automatically happen when you run pip. Other operating systems may vary.

Documentation

The documentation is available here.

FAQ

• What’s the difference between Signatory and iisignature?

The essential difference (and the reason for Signatory’s existence) is that iisignature is limited to the CPU, whilst Signatory is for both CPU and GPU. This allows Signatory to run much faster. (See the next question.) Other than that, iisignature is NumPy-based, whilst Signatory is for PyTorch. There are also a few differences in the provided functionality; each package provides a few operations that the other doesn’t.

• What’s the difference in speed between Signatory and iisignature?

Depends on your CPU and GPU, really. But to throw some numbers out there: on the CPU, Signatory tends to be about twice as fast. With the GPU, it’s roughly 65 times as fast.

• I get an ImportError when I try to install Signatory.

You probably haven’t installed PyTorch. Do that, then run pip or pip3 to install Signatory.

• How do I backpropagate through the signature transform?

Just call .backward() like you normally would in PyTorch!

Citation

If you found this library useful in your research, please consider citing

@misc{signatory,
    title={{Signatory: differentiable computations of the signature and logsignature transforms, on both CPU and GPU}},
    author={Kidger, Patrick},
    note={https://github.com/patrick-kidger/signatory},
    year={2019}
}

Acknowledgements

The Python bindings for the C++ code were written with the aid of pybind11.

For NumPy-based CPU-only signature calculations, you may also be interested in the iisignature package. The notes accompanying the iisignature project greatly helped with the implementation of Signatory.