Overview
The SDMetrics library evaluates synthetic data by comparing it to the real data that you're trying to mimic. It includes a variety of metrics to capture different aspects of the data, for example quality and privacy. It also includes reports that you can run to generate insights, visualize data and share with your team.
The SDMetrics library is model-agnostic, meaning you can use any synthetic data. The library does not need to know how you created the data.
Install
Install SDMetrics using pip or conda. We recommend using a virtual environment to avoid conflicts with other software on your device.
pip install sdmetrics
conda install -c conda-forge sdmetrics
For more information about using SDMetrics, visit the SDMetrics Documentation.
Usage
Get started with SDMetrics Reports using some demo data,
from sdmetrics import load_demo
from sdmetrics.reports.single_table import QualityReport
real_data, synthetic_data, metadata = load_demo(modality='single_table')
my_report = QualityReport()
my_report.generate(real_data, synthetic_data, metadata)
Creating report: 100%|██████████| 4/4 [00:00<00:00, 5.22it/s]
Overall Quality Score: 82.84%
Properties:
Column Shapes: 82.78%
Column Pair Trends: 82.9%
Once you generate the report, you can drill down on the details and visualize the results.
my_report.get_visualization(property_name='Column Pair Trends')
Save the report and share it with your team.
my_report.save(filepath='demo_data_quality_report.pkl')
# load it at any point in the future
my_report = QualityReport.load(filepath='demo_data_quality_report.pkl')
Want more metrics? You can also manually apply any of the metrics in this library to your data.
# calculate whether the synthetic data respects the min/max bounds
# set by the real data
from sdmetrics.single_column import BoundaryAdherence
BoundaryAdherence.compute(real_data['start_date'], synthetic_data['start_date'])
0.8503937007874016
# calculate whether the synthetic data is new or whether it's an exact copy of the real data
from sdmetrics.single_table import NewRowSynthesis
NewRowSynthesis.compute(real_data, synthetic_data, metadata)
1.0
What's next?
To learn more about the reports and metrics, visit the SDMetrics Documentation.
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.
9 maintainers
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 sdmetrics-0.30.0.tar.gz.
File metadata
- Download URL: sdmetrics-0.30.0.tar.gz
- Upload date:
- Size: 144.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
20fd019b8a687147c1e95952c8a417d90bf53474e108f52946cb9cebc04a1e01
|
|
| MD5 |
e2dea6744b8b57efd3cf7706882e7202
|
|
| BLAKE2b-256 |
93199bc799d648b33265845c401f103f3edb90f38c5cff1abc933e5fc83f18ab
|
Provenance
The following attestation bundles were made for sdmetrics-0.30.0.tar.gz:
Publisher:
release.yml on sdv-dev/SDMetrics
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sdmetrics-0.30.0.tar.gz -
Subject digest:
20fd019b8a687147c1e95952c8a417d90bf53474e108f52946cb9cebc04a1e01 - Sigstore transparency entry: 2625736249
- Sigstore integration time:
-
Permalink:
sdv-dev/SDMetrics@120273e09f1a4265bf591a290c52242db74cc97c -
Branch / Tag:
refs/tags/v0.30.0 - Owner: https://github.com/sdv-dev
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@120273e09f1a4265bf591a290c52242db74cc97c -
Trigger Event:
release
-
Statement type:
File details
Details for the file sdmetrics-0.30.0-py3-none-any.whl.
File metadata
- Download URL: sdmetrics-0.30.0-py3-none-any.whl
- Upload date:
- Size: 213.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e285378efa368ea488277426cf355f71f9e09315fd533dcdae6252f705743d75
|
|
| MD5 |
48ab22504379867ca0d40db90bd04906
|
|
| BLAKE2b-256 |
7f7638175345557067a8cd53df39790a321bb0e4d3db31ae4b5f15b71ba0800b
|
Provenance
The following attestation bundles were made for sdmetrics-0.30.0-py3-none-any.whl:
Publisher:
release.yml on sdv-dev/SDMetrics
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sdmetrics-0.30.0-py3-none-any.whl -
Subject digest:
e285378efa368ea488277426cf355f71f9e09315fd533dcdae6252f705743d75 - Sigstore transparency entry: 2625736267
- Sigstore integration time:
-
Permalink:
sdv-dev/SDMetrics@120273e09f1a4265bf591a290c52242db74cc97c -
Branch / Tag:
refs/tags/v0.30.0 - Owner: https://github.com/sdv-dev
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@120273e09f1a4265bf591a290c52242db74cc97c -
Trigger Event:
release
-
Statement type:
