Create tabular synthetic data using copulas-based modeling.
Verified details
These details have been verified by PyPIProject links
GitHub Statistics
Maintainers
Project description
This repository is part of The Synthetic Data Vault Project, a project from DataCebo.
Overview
Copulas is a Python library for modeling multivariate distributions and sampling from them using copula functions. Given a table of numerical data, use Copulas to learn the distribution and generate new synthetic data following the same statistical properties.
Key Features:
-
Model multivariate data. Choose from a variety of univariate distributions and copulas – including Archimedian Copulas, Gaussian Copulas and Vine Copulas.
-
Compare real and synthetic data visually after building your model. Visualizations are available as 1D histograms, 2D scatterplots and 3D scatterplots.
-
Access & manipulate learned parameters. With complete access to the internals of the model, set or tune parameters to your choosing.
Install
Install the Copulas library using pip or conda.
pip install copulas
conda install -c conda-forge copulas
Usage
Get started using a demo dataset. This dataset contains 3 numerical columns.
from copulas.datasets import sample_trivariate_xyz
real_data = sample_trivariate_xyz()
real_data.head()
Model the data using a copula and use it to create synthetic data. The Copulas library offers many options including Gaussian Copula, Vine Copulas and Archimedian Copulas.
from copulas.multivariate import GaussianMultivariate
copula = GaussianMultivariate()
copula.fit(real_data)
synthetic_data = copula.sample(len(real_data))
Visualize the real and synthetic data side-by-side. Let's do this in 3D so see our full dataset.
from copulas.visualization import compare_3d
compare_3d(real_data, synthetic_data)
Tutorials
Click below to run the code yourself on a Colab Notebook and discover new features.
Community & Support
Learn more about Copulas library from our documentation site.
Questions or issues? Join our Slack channel to discuss more about Copulas and synthetic data. If you find a bug or have a feature request, you can also open an issue on our GitHub.
Interested in contributing to Copulas? Read our Contribution Guide to get started.
Credits
The Copulas open source project first started at the Data to AI Lab at MIT in 2018. Thank you to our team of contributors who have built and maintained the library over the years!
The Synthetic Data Vault Project was first created at MIT's Data to AI Lab in 2016. After 4 years of research and traction with enterprise, we created DataCebo in 2020 with the goal of growing the project. Today, DataCebo is the proud developer of SDV, the largest ecosystem for synthetic data generation & evaluation. It is home to multiple libraries that support synthetic data, including:
- 🔄 Data discovery & transformation. Reverse the transforms to reproduce realistic data.
- 🧠 Multiple machine learning models -- ranging from Copulas to Deep Learning -- to create tabular, multi table and time series data.
- 📊 Measuring quality and privacy of synthetic data, and comparing different synthetic data generation models.
Get started using the SDV package -- a fully integrated solution and your one-stop shop for synthetic data. Or, use the standalone libraries for specific needs.
Project details
Verified details
These details have been verified by PyPIProject links
GitHub Statistics
Maintainers
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 copulas-0.14.0.tar.gz.
File metadata
- Download URL: copulas-0.14.0.tar.gz
- Upload date:
- Size: 45.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e1dd90663f3c6a8210e1313159adbf1c2ed48bf69224ffe99a338243a880e678
|
|
| MD5 |
f0bfb901f6f48d914f8b552595fee9a8
|
|
| BLAKE2b-256 |
1bde9e72e6788a65921068444dcebfd2c9a3c94b4aaa84c9acf5dc020117c87d
|
Provenance
The following attestation bundles were made for copulas-0.14.0.tar.gz:
Publisher:
release.yml on sdv-dev/Copulas
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
copulas-0.14.0.tar.gz -
Subject digest:
e1dd90663f3c6a8210e1313159adbf1c2ed48bf69224ffe99a338243a880e678 - Sigstore transparency entry: 832153529
- Sigstore integration time:
-
Permalink:
sdv-dev/Copulas@a5d7231aaecc3b87a16f7aa23d7207509b5bfd07 -
Branch / Tag:
refs/tags/v0.14.0 - Owner: https://github.com/sdv-dev
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@a5d7231aaecc3b87a16f7aa23d7207509b5bfd07 -
Trigger Event:
release
-
Statement type:
File details
Details for the file copulas-0.14.0-py3-none-any.whl.
File metadata
- Download URL: copulas-0.14.0-py3-none-any.whl
- Upload date:
- Size: 52.7 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 |
de0bf2357401340fe784fd85ca0087950fb47267779fc7ba793c483e5d2e402c
|
|
| MD5 |
157eda2ba6ddbc571ed0a441e4b0b176
|
|
| BLAKE2b-256 |
25f4bc379a1af3a8b26e6eb9d94fc176bf95c44dc43f1ea960fd189c46664c32
|
Provenance
The following attestation bundles were made for copulas-0.14.0-py3-none-any.whl:
Publisher:
release.yml on sdv-dev/Copulas
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
copulas-0.14.0-py3-none-any.whl -
Subject digest:
de0bf2357401340fe784fd85ca0087950fb47267779fc7ba793c483e5d2e402c - Sigstore transparency entry: 832153537
- Sigstore integration time:
-
Permalink:
sdv-dev/Copulas@a5d7231aaecc3b87a16f7aa23d7207509b5bfd07 -
Branch / Tag:
refs/tags/v0.14.0 - Owner: https://github.com/sdv-dev
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@a5d7231aaecc3b87a16f7aa23d7207509b5bfd07 -
Trigger Event:
release
-
Statement type:
