copulas 0.10.1.dev0__py3-none-any.whl

copulas/visualization.py

@@ -0,0 +1,350 @@
+"""Visualization utilities for the Copulas library."""
+
+import pandas as pd
+import plotly.express as px
+import plotly.figure_factory as ff
+
+
+class PlotConfig:
+    """Custom plot settings for visualizations."""
+
+    DATACEBO_DARK = '#000036'
+    DATACEBO_GREEN = '#01E0C9'
+    BACKGROUND_COLOR = '#F5F5F8'
+    FONT_SIZE = 18
+
+
+def _generate_1d_plot(data, title, labels, colors):
+    """Generate a density plot of an array-like structure.
+
+    Args:
+        data (array-like structure):
+            The data to plot.
+        title (str):
+            The title of the plot.
+        labels (list[str]):
+            The labels of the data.
+        colors (list[str]):
+            The colors of the data.
+
+    Returns:
+        plotly.graph_objects._figure.Figure
+    """
+    fig = ff.create_distplot(
+        hist_data=data,
+        group_labels=labels,
+        show_hist=False,
+        show_rug=False,
+        colors=colors
+    )
+
+    for i, name in enumerate(labels):
+        fig.update_traces(
+            x=fig.data[i].x,
+            hovertemplate=f'<b>{name}</b><br>Frequency: %{{y}}<extra></extra>',
+            selector={'name': name},
+            fill='tozeroy',
+        )
+
+    fig.update_layout(
+        title=title,
+        plot_bgcolor=PlotConfig.BACKGROUND_COLOR,
+        font={'size': PlotConfig.FONT_SIZE},
+        showlegend=True if labels[0] else False,
+        xaxis_title='value',
+        yaxis_title='frequency'
+    )
+
+    return fig
+
+
+def dist_1d(data, title=None, label=None):
+    """Plot the 1 dimensional data.
+
+    Args:
+        data (array_like structure):
+            The table data.
+        title (str):
+            The title of the plot.
+        label (str):
+            The label of the plot.
+
+    Returns:
+        plotly.graph_objects._figure.Figure
+    """
+    if not title:
+        title = 'Data'
+        if isinstance(data, pd.DataFrame):
+            title += f" for column '{data.columns[0]}'"
+        elif isinstance(data, pd.Series) and data.name:
+            title += f" for column '{data.name}'"
+
+    return _generate_1d_plot(
+        data=[data],
+        title=title,
+        labels=[label],
+        colors=[PlotConfig.DATACEBO_DARK]
+    )
+
+
+def compare_1d(real, synth, title=None):
+    """Plot the comparison between real and synthetic data.
+
+    Args:
+        real (array_like):
+            The real data.
+        synth (array_like):
+            The synthetic data.
+        title (str):
+            The title of the plot.
+
+    Returns:
+        plotly.graph_objects._figure.Figure
+    """
+    if not title:
+        title = 'Real vs. Synthetic Data'
+        if isinstance(real, pd.DataFrame):
+            title += f" for column '{real.columns[0]}'"
+        elif isinstance(real, pd.Series) and real.name:
+            title += f" for column '{real.name}'"
+
+    return _generate_1d_plot(
+        data=[real, synth],
+        title=title,
+        labels=['Real', 'Synthetic'],
+        colors=[PlotConfig.DATACEBO_DARK, PlotConfig.DATACEBO_GREEN]
+    )
+
+
+def _generate_scatter_2d_plot(data, columns, color_discrete_map, title):
+    """Generate a scatter plot for a pair of columns.
+
+    Args:
+        data (pandas.DataFrame):
+            The data for the desired column pair containing a
+            ``Data`` column indicating whether it is real or synthetic.
+        columns (list):
+            A list of the columns being plotted.
+        color_discrete_map (dict):
+            A dictionary mapping the values of the ``Data`` column to the colors
+            used to plot them.
+        title (str):
+            The title of the plot.
+
+    Returns:
+        plotly.graph_objects._figure.Figure
+    """
+    if columns:
+        columns.append('Data')
+    else:
+        columns = data.columns
+
+    if len(columns) != 3:  # includes the 'Data' column
+        raise ValueError('Only 2 columns can be plotted')
+
+    fig = px.scatter(
+        data,
+        x=columns[0],
+        y=columns[1],
+        color='Data',
+        color_discrete_map=color_discrete_map,
+        symbol='Data'
+    )
+
+    fig.update_layout(
+        title=title,
+        plot_bgcolor=PlotConfig.BACKGROUND_COLOR,
+        font={'size': PlotConfig.FONT_SIZE},
+        showlegend=False if len(color_discrete_map) == 1 else True,
+    )
+
+    return fig
+
+
+def scatter_2d(data, columns=None, title=None):
+    """Plot 2 dimensional data in a scatter plot.
+
+    Args:
+        data (pandas.DataFrame):
+            The table data.
+        columns (list[string]):
+            The names of the two columns to plot.
+        title (str):
+            The title of the plot.
+
+    Returns:
+        plotly.graph_objects._figure.Figure
+    """
+    data = data.copy()
+    data['Data'] = 'Real'
+
+    if not title:
+        title = 'Data'
+        if columns:
+            title += f" for columns '{columns[0]}' and '{columns[1]}'"
+        elif isinstance(data, pd.DataFrame):
+            title += f" for columns '{data.columns[0]}' and '{data.columns[1]}'"
+
+    return _generate_scatter_2d_plot(
+        data=data,
+        columns=columns,
+        color_discrete_map={'Real': PlotConfig.DATACEBO_DARK},
+        title=title
+    )
+
+
+def compare_2d(real, synth, columns=None, title=None):
+    """Plot the comparison between real and synthetic data for a given column pair.
+
+    Args:
+        real (pandas.DataFrame):
+            The real table data.
+        synth (pandas.Dataframe):
+            The synthetic table data.
+        columns (list[string]):
+            The names of the two columns to plot.
+        title (str):
+            The title of the plot.
+
+    Returns:
+        plotly.graph_objects._figure.Figure
+    """
+    real, synth = real.copy(), synth.copy()
+    real['Data'] = 'Real'
+    synth['Data'] = 'Synthetic'
+    data = pd.concat([real, synth], axis=0, ignore_index=True)
+
+    if not title:
+        title = 'Real vs. Synthetic Data'
+        if columns:
+            title += f" for columns '{columns[0]}' and '{columns[1]}'"
+        elif isinstance(data, pd.DataFrame):
+            title += f" for columns '{data.columns[0]}' and '{data.columns[1]}'"
+
+    return _generate_scatter_2d_plot(
+        data=data,
+        columns=columns,
+        color_discrete_map={
+            'Real': PlotConfig.DATACEBO_DARK,
+            'Synthetic': PlotConfig.DATACEBO_GREEN
+        },
+        title=title
+    )
+
+
+def _generate_scatter_3d_plot(data, columns, color_discrete_map, title):
+    """Generate a scatter plot for column pair plot.
+
+    Args:
+        data (pandas.DataFrame):
+            The data for the desired three columns containing a
+            ``Data`` column that indicates whether it is real or synthetic.
+        columns (list):
+            A list of the columns being plotted.
+        color_discrete_map (dict):
+            A dictionary mapping the values of the ``Data`` column to the colors
+            used to plot them.
+        title (str):
+            The title of the plot.
+
+    Returns:
+        plotly.graph_objects._figure.Figure
+    """
+    if columns:
+        columns.append('Data')
+    else:
+        columns = data.columns
+
+    if len(columns) != 4:  # includes the 'Data' column
+        raise ValueError('Only 3 columns can be plotted')
+
+    fig = px.scatter_3d(
+        data,
+        x=columns[0],
+        y=columns[1],
+        z=columns[2],
+        color='Data',
+        color_discrete_map=color_discrete_map,
+        symbol='Data',
+    )
+
+    fig.update_traces(marker={'size': 5})
+
+    fig.update_layout(
+        title=title,
+        plot_bgcolor=PlotConfig.BACKGROUND_COLOR,
+        font={'size': PlotConfig.FONT_SIZE},
+        showlegend=False if len(color_discrete_map) == 1 else True,
+    )
+
+    return fig
+
+
+def scatter_3d(data, columns=None, title=None):
+    """Plot 3 dimensional data in a scatter plot.
+
+    Args:
+        data (pandas.DataFrame):
+            The table data. Must have at least 3 columns.
+        columns (list[string]):
+            The names of the three columns to plot.
+        title (str):
+            The title of the plot.
+
+    Returns:
+        plotly.graph_objects._figure.Figure
+    """
+    data = data.copy()
+    data['Data'] = 'Real'
+
+    if not title:
+        title = 'Data'
+        if columns:
+            title += f" for columns '{columns[0]}', '{columns[1]}' and '{columns[2]}'"
+        elif isinstance(data, pd.DataFrame):
+            title += \
+                f" for columns '{data.columns[0]}', '{data.columns[1]}' and '{data.columns[2]}'"
+
+    return _generate_scatter_3d_plot(
+        data=data,
+        columns=columns,
+        color_discrete_map={'Real': PlotConfig.DATACEBO_DARK},
+        title=title
+    )
+
+
+def compare_3d(real, synth, columns=None, title=None):
+    """Plot the comparison between real and synthetic data for a given column triplet.
+
+    Args:
+        real (pd.DataFrame):
+            The real data.
+        synth (pd.DataFrame):
+            The synthetic data.
+        columns (list):
+            The name of the columns to plot.
+        title (str):
+            The title of the plot.
+    """
+    real, synth = real.copy(), synth.copy()
+    real['Data'] = 'Real'
+    synth['Data'] = 'Synthetic'
+    data = pd.concat([real, synth], axis=0, ignore_index=True)
+
+    if not title:
+        title = 'Real vs. Synthetic Data'
+        if columns:
+            title += f" for columns '{columns[0]}', '{columns[1]}' and '{columns[2]}'"
+        elif isinstance(data, pd.DataFrame):
+            title += \
+                f" for columns '{data.columns[0]}', '{data.columns[1]}' and '{data.columns[2]}'"
+
+    return _generate_scatter_3d_plot(
+        data=data,
+        columns=columns,
+        color_discrete_map={
+            'Real': PlotConfig.DATACEBO_DARK,
+            'Synthetic': PlotConfig.DATACEBO_GREEN
+        },
+        title=title
+    )

copulas-0.10.1.dev0.dist-info/LICENSE

@@ -0,0 +1,106 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             DataCebo, Inc.
+
+Licensed Work:        Copulas
+                      The Licensed Work is (c) DataCebo, Inc.
+
+Additional Use Grant: You may make use of the Licensed Work, and derivatives of the Licensed
+                      Work, provided that you do not use the Licensed Work, or derivatives of
+                      the Licensed Work, for a Synthetic Data Creation Service.
+
+                      A "Synthetic Data Creation Service" is a commercial offering
+                      that allows third parties (other than your employees and
+                      contractors) to access the functionality of the Licensed
+                      Work so that such third parties directly benefit from the
+                      data processing, machine learning or synthetic data creation
+                      features of the Licensed Work.
+
+Change Date:          Change date is four years from release date.
+                      Please see https://github.com/sdv-dev/Copulas/releases
+                      for exact dates.
+
+Change License:       MIT License
+
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+-----------------------------------------------------------------------------
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License’s text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License’s text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where "compatible" means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.

copulas-0.10.1.dev0.dist-info/METADATA

@@ -0,0 +1,223 @@
+Metadata-Version: 2.1
+Name: copulas
+Version: 0.10.1.dev0
+Summary: Create tabular synthetic data using copulas-based modeling.
+Author-email: "DataCebo, Inc." <info@sdv.dev>
+License: BSL-1.1
+Project-URL: Source Code, https://github.com/sdv-dev/Copulas/
+Project-URL: Issue Tracker, https://github.com/sdv-dev/Copulas/issues
+Project-URL: Changes, https://github.com/sdv-dev/Copulas/blob/main/HISTORY.md
+Project-URL: Twitter, https://twitter.com/sdv_dev
+Project-URL: Chat, https://bit.ly/sdv-slack-invite
+Keywords: copulas
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Free for non-commercial use
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: <3.12,>=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: plotly <6,>=5.10.0
+Requires-Dist: numpy <2,>=1.20.0 ; python_version < "3.10"
+Requires-Dist: pandas >=1.1.3 ; python_version < "3.10"
+Requires-Dist: scipy <2,>=1.5.4 ; python_version < "3.10"
+Requires-Dist: numpy <2,>=1.23.3 ; python_version >= "3.10"
+Requires-Dist: scipy <2,>=1.9.2 ; python_version >= "3.10"
+Requires-Dist: pandas >=1.3.4 ; python_version >= "3.10" and python_version < "3.11"
+Requires-Dist: pandas >=1.5.0 ; python_version >= "3.11"
+Provides-Extra: dev
+Requires-Dist: copulas[test,tutorials] ; extra == 'dev'
+Requires-Dist: pip >=9.0.1 ; extra == 'dev'
+Requires-Dist: build <2,>=1.0.0 ; extra == 'dev'
+Requires-Dist: bump-my-version <1,>=0.18.3 ; extra == 'dev'
+Requires-Dist: watchdog <0.11,>=0.8.3 ; extra == 'dev'
+Requires-Dist: m2r <0.3,>=0.2.0 ; extra == 'dev'
+Requires-Dist: nbsphinx <0.7,>=0.5.0 ; extra == 'dev'
+Requires-Dist: Sphinx <3,>=1.7.1 ; extra == 'dev'
+Requires-Dist: sphinx-rtd-theme <0.5,>=0.2.4 ; extra == 'dev'
+Requires-Dist: Jinja2 <3,>=2 ; extra == 'dev'
+Requires-Dist: flake8 <4,>=3.7.7 ; extra == 'dev'
+Requires-Dist: isort <5,>=4.3.4 ; extra == 'dev'
+Requires-Dist: flake8-debugger <4.1,>=4.0.0 ; extra == 'dev'
+Requires-Dist: flake8-mock <0.4,>=0.3 ; extra == 'dev'
+Requires-Dist: flake8-mutable <1.3,>=1.2.0 ; extra == 'dev'
+Requires-Dist: flake8-fixme <1.2,>=1.1.1 ; extra == 'dev'
+Requires-Dist: pep8-naming <0.13,>=0.12.1 ; extra == 'dev'
+Requires-Dist: dlint <0.12,>=0.11.0 ; extra == 'dev'
+Requires-Dist: flake8-docstrings <2,>=1.5.0 ; extra == 'dev'
+Requires-Dist: pydocstyle <6.2,>=6.1.1 ; extra == 'dev'
+Requires-Dist: flake8-pytest-style <2,>=1.5.0 ; extra == 'dev'
+Requires-Dist: flake8-comprehensions <3.7,>=3.6.1 ; extra == 'dev'
+Requires-Dist: flake8-print <4.1,>=4.0.0 ; extra == 'dev'
+Requires-Dist: flake8-expression-complexity <0.1,>=0.0.9 ; extra == 'dev'
+Requires-Dist: flake8-multiline-containers <0.1,>=0.0.18 ; extra == 'dev'
+Requires-Dist: pandas-vet <0.3,>=0.2.2 ; extra == 'dev'
+Requires-Dist: flake8-builtins <1.6,>=1.5.3 ; extra == 'dev'
+Requires-Dist: flake8-eradicate <1.2,>=1.1.0 ; extra == 'dev'
+Requires-Dist: flake8-quotes <4,>=3.3.0 ; extra == 'dev'
+Requires-Dist: flake8-variables-names <0.1,>=0.0.4 ; extra == 'dev'
+Requires-Dist: flake8-sfs <0.1,>=0.0.3 ; extra == 'dev'
+Requires-Dist: flake8-absolute-import <2,>=1.0 ; extra == 'dev'
+Requires-Dist: autoflake <2,>=1.1 ; extra == 'dev'
+Requires-Dist: autopep8 <1.6,>=1.4.3 ; extra == 'dev'
+Requires-Dist: twine <4,>=1.10.0 ; extra == 'dev'
+Requires-Dist: wheel >=0.30.0 ; extra == 'dev'
+Requires-Dist: coverage <6,>=4.5.1 ; extra == 'dev'
+Requires-Dist: tox <4,>=2.9.1 ; extra == 'dev'
+Requires-Dist: invoke ; extra == 'dev'
+Requires-Dist: doc8 <0.9,>=0.8.0 ; extra == 'dev'
+Requires-Dist: urllib3 <1.26,>=1.20 ; extra == 'dev'
+Requires-Dist: tabulate <0.9,>=0.8.3 ; extra == 'dev'
+Requires-Dist: boto3 <1.10,>=1.7.47 ; extra == 'dev'
+Requires-Dist: docutils <0.15,>=0.10 ; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: copulas[tutorials] ; extra == 'test'
+Requires-Dist: pytest <7,>=6.2.5 ; extra == 'test'
+Requires-Dist: pytest-cov <3,>=2.6.0 ; extra == 'test'
+Requires-Dist: pytest-rerunfailures <10,>=9.0.0 ; extra == 'test'
+Requires-Dist: rundoc <0.5,>=0.4.3 ; extra == 'test'
+Requires-Dist: tomli <3,>=2.0.0 ; extra == 'test'
+Provides-Extra: tutorials
+Requires-Dist: markupsafe <=2.0.1 ; extra == 'tutorials'
+Requires-Dist: scikit-learn <1.2,>=0.24 ; extra == 'tutorials'
+Requires-Dist: jupyter <2,>=1.0.0 ; extra == 'tutorials'
+
+<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>
+
+[![Development Status](https://img.shields.io/badge/Development%20Status-2%20--%20Pre--Alpha-yellow)](https://pypi.org/search/?c=Development+Status+%3A%3A+2+-+Pre-Alpha)
+[![PyPi Shield](https://img.shields.io/pypi/v/copulas.svg)](https://pypi.python.org/pypi/copulas)
+[![Downloads](https://pepy.tech/badge/copulas)](https://pepy.tech/project/copulas)
+[![Unit Tests](https://github.com/sdv-dev/Copulas/actions/workflows/unit.yml/badge.svg)](https://github.com/sdv-dev/Copulas/actions/workflows/unit.yml)
+[![Coverage Status](https://codecov.io/gh/sdv-dev/Copulas/branch/main/graph/badge.svg)](https://codecov.io/gh/sdv-dev/Copulas)
+[![Slack](https://img.shields.io/badge/Community-Slack-blue?style=plastic&logo=slack)](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)
+```
+
+![Quickstart](docs/images/quickstart.png)
+
+# Tutorials
+Click below to run the code yourself on a Colab Notebook and discover new features.
+
+[![Tutorial Notebook](https://img.shields.io/badge/Tutorial-Colab-F9AB00?style=for-the-badge&logo=googlecolab&color=525252)](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.