Skip to main content

A python interface to vinecopulib

Project description


Build Status License: MIT Codacy Badge Documentation DOI

What are vine copulas?

Vine copulas are a flexible class of dependence models consisting of bivariate building blocks (see e.g., Aas et al., 2009). You can find a comprehensive list of publications and other materials on

What is pyvinecopulib?

pyvinecopulib is the python interface to vinecopulib, a header-only C++ library for vine copula models based on Eigen. It provides high-performance implementations of the core features of the popular VineCopula R library, in particular inference algorithms for both vine copula and bivariate copula models. Advantages over VineCopula are

  • a stand-alone C++ library with interfaces to both R and Python,
  • a sleaker and more modern API,
  • shorter runtimes and lower memory consumption, especially in high dimensions,
  • nonparametric and multi-parameter families.


  • numpy (>=1.14)
  • pybind11 (>=2.4)
  • setuptools (>=30.3.0)
  • setuptools_scm (>=2.0.0)
  • To install from source: a compiler with C++11 support (Linux, OS X) or Visual Studio 2015 (required for all Python versions, see notes below)


The easiest way to install the latest release is to use pip:

pip install pyvinecopulib

To install from source, just clone this repository and do pip install. Note the --recursive option which is needed for the eigen, vinecopulib and wdm submodules:

git clone --recursive
pip install -r ./pyvinecopulib/requirements.txt
pip install ./pyvinecopulib


Jupyter notebooks with examples can be found in the examples folder.


For documentation of the pyvinecopulib's functionality and instructions how to use it, check out our website or the docs/ folder in this repository.

Building the documentation

Documentation for the example project is generated using Sphinx and the "Read the Docs" theme. The following command generates HTML-based reference documentation; for other formats please refer to the Sphinx manual:

  • pip install sphinx-rtd-theme
  • cd pyvinecopulib/docs
  • python3


pyvinecopulib is provided under an MIT license that can be found in the LICENSE file. By using, distributing, or contributing to this project, you agree to the terms and conditions of this license.

Special notes for Windows

Compiler requirements

This package requires a C++11 compliant compiler, i.e Visual Studio 2015 on Windows. Unlike regular C extension modules, it's perfectly fine to compile a pyvinecopulib module with a VS version newer than the target Python's VS version.

Runtime requirements

The Visual C++ 2015 redistributable packages are a runtime requirement for this project.


If you have any questions regarding the library, feel free to open an issue or send a mail to

Download files

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

Source Distribution

pyvinecopulib-0.6.2.tar.gz (23.7 MB view hashes)

Uploaded source

Built Distributions

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page