No project description provided
Project description
VineCopulas
VineCopulas is a Python package that is able to:
- Fit both bivariate and vine copulas
- Simulate from both bivariate and vine copulas
- Allow for both discrete as well as continuous input data
- Draw conditional samples for any variables of interest with the use of bivariate copulas and different vine structures
Installation
pip install vinecopulas
Getting Started
Get started by testing checking out the package functionality using the Abalone example data.
import pandas as pd
import matplotlib.pyplot as plt
import numpy as np
from vinecopulas.marginals import *
from vinecopulas.bivariate import *
datapath = 'https://raw.githubusercontent.com/VU-IVM/vinecopula/develop/doc/sample_data.csv'
df = pd.read_csv(datapath)
df.head()
Transform the data to pseudo data and fit a survival gumbel copula between two variables. Use the fitted copula to generate random samples.
x = np.array(df)[:,:-1]
u = pseudodata(x) # computes the pseudodata
cop = 4 # copula 4 is the gumbel copula with 180 degree rotation
par = fit(cop, u[:,:2]) # fit the variables in the first 2 columns
n = len(u) # number of samples to generate
ur = random(cop, par, n) # generate random samples
# plot
plt.scatter(u[:,0],u[:,1], label = 'Data')
plt.scatter(ur[:,0], ur[:,1], alpha = 0.5, label = 'Random')
plt.xlabel('$u_1$')
plt.ylabel('$u_2$')
plt.legend()
Fit a vine copula between multiple variables in the data, considering all possible copulas available in the package.
cops = list(range(1,16)) # fit vine copula according to these copulas
M, P, C = fit_vinecop(u, cops, vine = 'R') # fit R-vine
plotvine(M,variables = list(df.columns[:-1]), plottitle = 'R-Vine') # plot structure
For more examples, please have a look at the documentation.
Contribution Guidelines
Please look at our Contributing Guidelines if you are interested in contributing to this package.
Asking Questions and Reporting Issues
If you encounter any bugs or issues while using VineCopulas, please report them by opening an issue in the GitHub repository. Be sure to provide detailed information about the problem, such as steps to reproduce it, including operating system and Python version.
If you have any suggestions for improvements, or questions, please also raise an issue.
Citing the Package
If you use the VineCopulas package in your work, please cite:
Claassen, J. N., Koks, E. E., de Ruiter, M. C., Ward, P. J., & Jäger, W. S. (2024). VineCopulas: an open-source Python package for vine copula modelling. Journal of Open Source Software, 9(101), 6728. https://doi.org/10.21105/joss.06728
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file vinecopulas-2.0.3.tar.gz.
File metadata
- Download URL: vinecopulas-2.0.3.tar.gz
- Upload date:
- Size: 51.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
63214d6279ae4c26809598b22da7ca096a8539856f6865bb14d56eedb23dfa21
|
|
| MD5 |
fd96d4dd27cd80e0829f5105a9cc2517
|
|
| BLAKE2b-256 |
8906e59a2a774e56f1374d151da168f42fb5866315f8bbd72f8844a6b91c7b54
|
Provenance
The following attestation bundles were made for vinecopulas-2.0.3.tar.gz:
Publisher:
release.yml on VU-IVM/VineCopulas
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vinecopulas-2.0.3.tar.gz -
Subject digest:
63214d6279ae4c26809598b22da7ca096a8539856f6865bb14d56eedb23dfa21 - Sigstore transparency entry: 1217126862
- Sigstore integration time:
-
Permalink:
VU-IVM/VineCopulas@60f0207f3779a94f6c871f84e8abd5096206977e -
Branch / Tag:
refs/tags/v2.0.3.1 - Owner: https://github.com/VU-IVM
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@60f0207f3779a94f6c871f84e8abd5096206977e -
Trigger Event:
release
-
Statement type:
File details
Details for the file vinecopulas-2.0.3-py3-none-any.whl.
File metadata
- Download URL: vinecopulas-2.0.3-py3-none-any.whl
- Upload date:
- Size: 45.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
26f6bdf7e5f152d21210941fd34281b015166903191804199d7651dd15e6159d
|
|
| MD5 |
d4539a034284e212dc10017c8a378d9d
|
|
| BLAKE2b-256 |
1a01d12a0cff88582947e8289005ece0697d310aca029e97ff55dbd7f977076a
|
Provenance
The following attestation bundles were made for vinecopulas-2.0.3-py3-none-any.whl:
Publisher:
release.yml on VU-IVM/VineCopulas
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vinecopulas-2.0.3-py3-none-any.whl -
Subject digest:
26f6bdf7e5f152d21210941fd34281b015166903191804199d7651dd15e6159d - Sigstore transparency entry: 1217126872
- Sigstore integration time:
-
Permalink:
VU-IVM/VineCopulas@60f0207f3779a94f6c871f84e8abd5096206977e -
Branch / Tag:
refs/tags/v2.0.3.1 - Owner: https://github.com/VU-IVM
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@60f0207f3779a94f6c871f84e8abd5096206977e -
Trigger Event:
release
-
Statement type:
