| Name | copulas JSON |
| Version |
0.11.0
JSON |
| download |
| home_page | None |
| Summary | Create tabular synthetic data using copulas-based modeling. |
| upload_time | 2024-04-10 16:36:49 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | <3.13,>=3.8 |
| license | BSL-1.1 |
| keywords |
copulas
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<p style="text-align:center">
<i>This repository is part of <a href="https://sdv.dev">The Synthetic Data Vault Project</a>, a project from <a href="https://datacebo.com">DataCebo</a>.</i>
</p>
[](https://pypi.org/search/?c=Development+Status+%3A%3A+2+-+Pre-Alpha)
[](https://pypi.python.org/pypi/copulas)
[](https://pepy.tech/project/copulas)
[](https://github.com/sdv-dev/Copulas/actions/workflows/unit.yml)
[](https://codecov.io/gh/sdv-dev/Copulas)
[](https://bit.ly/sdv-slack-invite)
<br/>
<p align="center" style="text-align:center">
<a href="https://github.com/sdv-dev/Copulas">
<img width=40% src="https://github.com/sdv-dev/SDV/blob/stable/docs/images/Copulas-DataCebo.png?raw=true"></img>
</a>
</p>
# 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.
```bash
pip install copulas
```
```bash
conda install -c conda-forge copulas
```
# Usage
Get started using a demo dataset. This dataset contains 3 numerical columns.
```python
from copulas.datasets import sample_trivariate_xyz
real_data = sample_trivariate_xyz()
real_data.head()
```
<img src="docs/images/copulas_sample_dataset.png" width="300">
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.
```python
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.
```python
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.
[](https://bit.ly/copulas-demo)
# Community & Support
Learn more about Copulas library from our [documentation](https://sdv.dev/Copulas/) site.
**Questions or issues?** Join our [Slack channel](https://bit.ly/sdv-slack-invite)
to discuss more about Copulas and synthetic data.
If you find a bug or have a feature request, you can also
[open an issue](https://github.com/sdv-dev/Copulas/issues/new/choose) on our GitHub.
**Interested in contributing to Copulas?** Read our
[Contribution Guide](https://sdv.dev/Copulas/contributing.html) 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!
[View Contributors](https://github.com/sdv-dev/Copulas/graphs/contributors)
---
<div align="center">
<a href="https://datacebo.com"><img align="center" width=40% src="https://github.com/sdv-dev/SDV/blob/stable/docs/images/DataCebo.png"></img></a>
</div>
<br/>
<br/>
[The Synthetic Data Vault Project](https://sdv.dev) was first created at MIT's [Data to AI Lab](
https://dai.lids.mit.edu/) in 2016. After 4 years of research and traction with enterprise, we
created [DataCebo](https://datacebo.com) 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](https://sdv.dev/SDV/getting_started/install.html) -- a fully
integrated solution and your one-stop shop for synthetic data. Or, use the standalone libraries
for specific needs.
Raw data
{
"_id": null,
"home_page": null,
"name": "copulas",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.8",
"maintainer_email": null,
"keywords": "copulas",
"author": null,
"author_email": "\"DataCebo, Inc.\" <info@sdv.dev>",
"download_url": "https://files.pythonhosted.org/packages/c1/7c/a6f788b55891dab5f2ebe5533d153d808d668dc7d0782be70b61e10cc7c9/copulas-0.11.0.tar.gz",
"platform": null,
"description": "<p style=\"text-align:center\">\n <i>This repository is part of <a href=\"https://sdv.dev\">The Synthetic Data Vault Project</a>, a project from <a href=\"https://datacebo.com\">DataCebo</a>.</i>\n</p>\n\n[](https://pypi.org/search/?c=Development+Status+%3A%3A+2+-+Pre-Alpha)\n[](https://pypi.python.org/pypi/copulas)\n[](https://pepy.tech/project/copulas)\n[](https://github.com/sdv-dev/Copulas/actions/workflows/unit.yml)\n[](https://codecov.io/gh/sdv-dev/Copulas)\n[](https://bit.ly/sdv-slack-invite)\n\n<br/>\n<p align=\"center\" style=\"text-align:center\">\n<a href=\"https://github.com/sdv-dev/Copulas\">\n<img width=40% src=\"https://github.com/sdv-dev/SDV/blob/stable/docs/images/Copulas-DataCebo.png?raw=true\"></img>\n</a>\n</p>\n\n# Overview\n\n**Copulas** is a Python library for modeling multivariate distributions and sampling from them\nusing copula functions.\nGiven a table of numerical data, use Copulas to learn the distribution and\ngenerate new synthetic data following the same statistical properties.\n\n**Key Features:**\n\n* **Model multivariate data.** Choose from a variety of univariate\ndistributions and copulas \u2013 including Archimedian Copulas, Gaussian Copulas and Vine Copulas.\n\n* **Compare real and synthetic data visually** after building your model. Visualizations\nare available as 1D histograms, 2D scatterplots and 3D scatterplots.\n\n* **Access & manipulate learned parameters.** With complete access to the internals\nof the model, set or tune parameters to your choosing.\n\n# Install\n\nInstall the Copulas library using pip or conda.\n\n```bash\npip install copulas\n```\n\n```bash\nconda install -c conda-forge copulas\n```\n\n# Usage\n\nGet started using a demo dataset. This dataset contains 3 numerical columns.\n\n```python\nfrom copulas.datasets import sample_trivariate_xyz\n\nreal_data = sample_trivariate_xyz()\nreal_data.head()\n```\n\n<img src=\"docs/images/copulas_sample_dataset.png\" width=\"300\">\n\nModel the data using a copula and use it to create synthetic data.\nThe Copulas library offers many options including Gaussian Copula,\nVine Copulas and Archimedian Copulas.\n\n```python\nfrom copulas.multivariate import GaussianMultivariate\n\ncopula = GaussianMultivariate()\ncopula.fit(real_data)\n\nsynthetic_data = copula.sample(len(real_data))\n```\n\nVisualize the real and synthetic data side-by-side. Let's do this in 3D so see our full dataset.\n\n```python\nfrom copulas.visualization import compare_3d\n\ncompare_3d(real_data, synthetic_data)\n```\n\n\n\n# Tutorials\nClick below to run the code yourself on a Colab Notebook and discover new features.\n\n[](https://bit.ly/copulas-demo)\n\n# Community & Support\n\nLearn more about Copulas library from our [documentation](https://sdv.dev/Copulas/) site.\n\n**Questions or issues?** Join our [Slack channel](https://bit.ly/sdv-slack-invite)\nto discuss more about Copulas and synthetic data.\nIf you find a bug or have a feature request, you can also\n[open an issue](https://github.com/sdv-dev/Copulas/issues/new/choose) on our GitHub.\n\n**Interested in contributing to Copulas?** Read our\n[Contribution Guide](https://sdv.dev/Copulas/contributing.html) to get started.\n\n# Credits\n\nThe Copulas open source project first started at the Data to AI Lab at MIT in 2018.\nThank you to our team of contributors who have built and maintained the library over the years!\n\n[View Contributors](https://github.com/sdv-dev/Copulas/graphs/contributors)\n\n---\n\n\n<div align=\"center\">\n<a href=\"https://datacebo.com\"><img align=\"center\" width=40% src=\"https://github.com/sdv-dev/SDV/blob/stable/docs/images/DataCebo.png\"></img></a>\n</div>\n<br/>\n<br/>\n\n[The Synthetic Data Vault Project](https://sdv.dev) was first created at MIT's [Data to AI Lab](\nhttps://dai.lids.mit.edu/) in 2016. After 4 years of research and traction with enterprise, we\ncreated [DataCebo](https://datacebo.com) in 2020 with the goal of growing the project.\nToday, DataCebo is the proud developer of SDV, the largest ecosystem for\nsynthetic data generation & evaluation. It is home to multiple libraries that support synthetic\ndata, including:\n\n* \ud83d\udd04 Data discovery & transformation. Reverse the transforms to reproduce realistic data.\n* \ud83e\udde0 Multiple machine learning models -- ranging from Copulas to Deep Learning -- to create tabular,\n multi table and time series data.\n* \ud83d\udcca Measuring quality and privacy of synthetic data, and comparing different synthetic data\n generation models.\n\n[Get started using the SDV package](https://sdv.dev/SDV/getting_started/install.html) -- a fully\nintegrated solution and your one-stop shop for synthetic data. Or, use the standalone libraries\nfor specific needs.\n",
"bugtrack_url": null,
"license": "BSL-1.1",
"summary": "Create tabular synthetic data using copulas-based modeling.",
"version": "0.11.0",
"project_urls": {
"Changes": "https://github.com/sdv-dev/Copulas/blob/main/HISTORY.md",
"Chat": "https://bit.ly/sdv-slack-invite",
"Issue Tracker": "https://github.com/sdv-dev/Copulas/issues",
"Source Code": "https://github.com/sdv-dev/Copulas/",
"Twitter": "https://twitter.com/sdv_dev"
},
"split_keywords": [
"copulas"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0dc2366534be86ef6294fd8b75e0762037eb169962fd437afbbbd3b0248c7baa",
"md5": "72650992bf567b45d58d337753a66a27",
"sha256": "d50df30c00d6289e763dd0b516b6474afd0ce2b0239421be01beb1bd01808a5b"
},
"downloads": -1,
"filename": "copulas-0.11.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "72650992bf567b45d58d337753a66a27",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.8",
"size": 51938,
"upload_time": "2024-04-10T16:36:47",
"upload_time_iso_8601": "2024-04-10T16:36:47.635558Z",
"url": "https://files.pythonhosted.org/packages/0d/c2/366534be86ef6294fd8b75e0762037eb169962fd437afbbbd3b0248c7baa/copulas-0.11.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c17ca6f788b55891dab5f2ebe5533d153d808d668dc7d0782be70b61e10cc7c9",
"md5": "c73893138a8b9de2f61889f2c58dc840",
"sha256": "7bfdb16e04ea0af19fed23089bca7521d62bc6fdbb8f9b966833707cb08173e9"
},
"downloads": -1,
"filename": "copulas-0.11.0.tar.gz",
"has_sig": false,
"md5_digest": "c73893138a8b9de2f61889f2c58dc840",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.8",
"size": 44926,
"upload_time": "2024-04-10T16:36:49",
"upload_time_iso_8601": "2024-04-10T16:36:49.292164Z",
"url": "https://files.pythonhosted.org/packages/c1/7c/a6f788b55891dab5f2ebe5533d153d808d668dc7d0782be70b61e10cc7c9/copulas-0.11.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-10 16:36:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sdv-dev",
"github_project": "Copulas",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "copulas"
}
