Skip to navigation
Tutorials

Seeding with an External Dataset

View as Markdown
Run in Google Colab

🎨 Data Designer Tutorial: Seeding Synthetic Data Generation with an External Dataset

📚 What you'll learn

In this notebook, we will demonstrate how to seed synthetic data generation in Data Designer with an external dataset.

If this is your first time using Data Designer, we recommend starting with the first notebook in this tutorial series.

📦 Import Data Designer

  • data_designer.config provides access to the configuration API.

  • DataDesigner is the main interface for data generation.

Python
1import data_designer.config as dd
2from data_designer.interface import DataDesigner
3

⚙️ Initialize the Data Designer interface

  • DataDesigner is the main object responsible for managing the data generation process.

  • When initialized without arguments, the default model providers are used.

Python
1data_designer = DataDesigner()
2

🎛️ Define model configurations

  • Each ModelConfig defines a model that can be used during the generation process.

  • The "model alias" is used to reference the model in the Data Designer config (as we will see below).

  • The "model provider" is the external service that hosts the model (see the model config docs for more details).

  • By default, we use build.nvidia.com as the model provider.

Python
1# This name is set in the model provider configuration.
2MODEL_PROVIDER = "nvidia"
3 
4# The model ID is from build.nvidia.com.
5MODEL_ID = "nvidia/nemotron-3.5-lightning-30b-a3b"
6 
7# We choose this alias to be descriptive for our use case.
8MODEL_ALIAS = "nemotron-lightning"
9 
10model_configs = [
11    dd.ModelConfig(
12        alias=MODEL_ALIAS,
13        model=MODEL_ID,
14        provider=MODEL_PROVIDER,
15        inference_parameters=dd.ChatCompletionInferenceParams(
16            temperature=1.0,
17            top_p=0.95,
18            max_tokens=2048,
19            extra_body={"chat_template_kwargs": {"enable_thinking": False}},
20        ),
21    )
22]
23

🏗️ Initialize the Data Designer Config Builder

  • The Data Designer config defines the dataset schema and generation process.

  • The config builder provides an intuitive interface for building this configuration.

  • The list of model configs is provided to the builder at initialization.

Python
1config_builder = dd.DataDesignerConfigBuilder(model_configs=model_configs)
2

🏥 Prepare a seed dataset

  • For this notebook, we'll create a synthetic dataset of patient notes.

  • We will seed the generation process with a symptom-to-diagnosis dataset.

  • The notebook downloads the source CSV before generation.


🌱 Why use a seed dataset?

  • Seed datasets let you steer the generation process by providing context that is specific to your use case.

  • Seed datasets are also an excellent way to inject real-world diversity into your synthetic data.

  • During generation, prompt templates can reference any of the seed dataset fields.

Python
1# Download sample dataset from Github
2import urllib.request
3 
4url = "https://raw.githubusercontent.com/NVIDIA/GenerativeAIExamples/refs/heads/main/nemo/NeMo-Data-Designer/data/gretelai_symptom_to_diagnosis.csv"
5local_filename, _ = urllib.request.urlretrieve(url, "gretelai_symptom_to_diagnosis.csv")
6 
7# Seed datasets are passed as reference objects to the config builder.
8seed_source = dd.LocalFileSeedSource(path=local_filename)
9 
10config_builder.with_seed_dataset(seed_source)
11
Output
DataDesignerConfigBuilder(
    seed_dataset: local seed
)

🎨 Designing our synthetic patient notes dataset

  • The prompt template can reference fields from our seed dataset:
    • {{ diagnosis }} - the medical diagnosis from the seed data
    • {{ patient_summary }} - the symptom description from the seed data
Python
1config_builder.add_column(
2    dd.SamplerColumnConfig(
3        name="patient_sampler",
4        sampler_type=dd.SamplerType.PERSON_FROM_FAKER,
5        params=dd.PersonFromFakerSamplerParams(),
6    )
7)
8 
9config_builder.add_column(
10    dd.SamplerColumnConfig(
11        name="doctor_sampler",
12        sampler_type=dd.SamplerType.PERSON_FROM_FAKER,
13        params=dd.PersonFromFakerSamplerParams(),
14    )
15)
16 
17config_builder.add_column(
18    dd.SamplerColumnConfig(
19        name="patient_id",
20        sampler_type=dd.SamplerType.UUID,
21        params=dd.UUIDSamplerParams(
22            prefix="PT-",
23            short_form=True,
24            uppercase=True,
25        ),
26    )
27)
28 
29config_builder.add_column(dd.ExpressionColumnConfig(name="first_name", expr="{{ patient_sampler.first_name }}"))
30 
31config_builder.add_column(dd.ExpressionColumnConfig(name="last_name", expr="{{ patient_sampler.last_name }}"))
32 
33config_builder.add_column(dd.ExpressionColumnConfig(name="dob", expr="{{ patient_sampler.birth_date }}"))
34 
35config_builder.add_column(
36    dd.SamplerColumnConfig(
37        name="symptom_onset_date",
38        sampler_type=dd.SamplerType.DATETIME,
39        params=dd.DatetimeSamplerParams(start="2024-01-01", end="2024-12-31"),
40    )
41)
42 
43config_builder.add_column(
44    dd.SamplerColumnConfig(
45        name="date_of_visit",
46        sampler_type=dd.SamplerType.TIMEDELTA,
47        params=dd.TimeDeltaSamplerParams(dt_min=1, dt_max=30, reference_column_name="symptom_onset_date"),
48    )
49)
50 
51config_builder.add_column(dd.ExpressionColumnConfig(name="physician", expr="Dr. {{ doctor_sampler.last_name }}"))
52 
53config_builder.add_column(
54    dd.LLMTextColumnConfig(
55        name="physician_notes",
56        prompt="""\
57You are a primary-care physician who just had an appointment with {{ first_name }} {{ last_name }},
58who has been struggling with symptoms from {{ diagnosis }} since {{ symptom_onset_date }}.
59The date of today's visit is {{ date_of_visit }}.
60 
61{{ patient_summary }}
62 
63Write careful notes about your visit with {{ first_name }},
64as Dr. {{ doctor_sampler.first_name }} {{ doctor_sampler.last_name }}.
65 
66Format the notes as a busy doctor might.
67Respond with only the notes, no other text.
68""",
69        model_alias=MODEL_ALIAS,
70    )
71)
72 
73data_designer.validate(config_builder)
74
Output
[02:07:27] [INFO] ✅ Validation passed

🔁 Iteration is key – preview the dataset!

  1. Use the preview method to generate a sample of records quickly.

  2. Inspect the results for quality and format issues.

  3. Adjust column configurations, prompts, or parameters as needed.

  4. Re-run the preview until satisfied.

Python
1preview = data_designer.preview(config_builder, num_records=2)
2
Output
[02:07:27] [INFO] 🔭 Preview generation in progress
[02:07:27] [INFO]   |-- 🔒 Jinja rendering engine: secure
[02:07:27] [INFO] ✅ Validation passed
[02:07:27] [INFO] ⛓️ Sorting column configs into a Directed Acyclic Graph
[02:07:27] [INFO] Skipping model health checks because DATA_DESIGNER_SKIP_MODEL_HEALTH_CHECKS=1
[02:07:27] [INFO] ⚡ Using async task-queue preview
[02:07:27] [INFO] 📝 llm-text model config for column 'physician_notes'
[02:07:27] [INFO]   |-- model: 'nvidia/nemotron-3.5-lightning-30b-a3b'
[02:07:27] [INFO]   |-- model alias: 'nemotron-lightning'
[02:07:27] [INFO]   |-- model provider: 'nvidia'
[02:07:27] [INFO]   |-- inference parameters:
[02:07:27] [INFO]   |  |-- generation_type=chat-completion
[02:07:27] [INFO]   |  |-- max_parallel_requests=4
[02:07:27] [INFO]   |  |-- extra_body={'chat_template_kwargs': {'enable_thinking': False}}
[02:07:27] [INFO]   |  |-- temperature=1.00
[02:07:27] [INFO]   |  |-- top_p=0.95
[02:07:27] [INFO]   |  |-- max_tokens=2048
[02:07:27] [INFO] ⚡️ Async generation: 1 column(s) (column 'physician_notes'), 2 tasks across 1 row group(s)
[02:07:27] [INFO] 🚀 (1/1) Dispatching with 2 records
[02:07:27] [INFO] 🎲 (1/1) Preparing samplers to generate 2 records across 5 columns
[02:07:27] [INFO] 🌱 (1/1) Sampling 2 records from seed dataset
[02:07:27] [INFO]   |-- seed dataset size: 820 records
[02:07:27] [INFO]   |-- sampling strategy: ordered
[02:07:27] [INFO] 🧩 (1/1) Generating column `dob` from expression
[02:07:27] [INFO] 🧩 (1/1) Generating column `first_name` from expression
[02:07:27] [INFO] 🧩 (1/1) Generating column `last_name` from expression
[02:07:27] [INFO] 🧩 (1/1) Generating column `physician` from expression
[02:07:32] [INFO] 📊 Progress [5.0s]:
[02:07:32] [INFO]   |-- 🐔 column 'physician_notes': 2/2 (100%) 0.4 rec/s
[02:07:32] [INFO] ✅ Async generation complete [5.0s]: 2 ok, 0 failed across 1 column(s)
[02:07:32] [INFO] 📊 Model usage summary:
[02:07:32] [INFO]   |-- model: nvidia/nemotron-3.5-lightning-30b-a3b
[02:07:32] [INFO]   |-- tokens: input=328, output=899, reasoning=0, total=1227, tps=245
[02:07:32] [INFO]   |-- requests: success=2, failed=0, total=2, rpm=23
[02:07:32] [INFO] 📐 Measuring dataset column statistics:
[02:07:32] [INFO]   |-- 🎲 column: 'patient_sampler'
[02:07:32] [INFO]   |-- 🎲 column: 'doctor_sampler'
[02:07:32] [INFO]   |-- 🎲 column: 'patient_id'
[02:07:32] [INFO]   |-- 🧩 column: 'first_name'
[02:07:32] [INFO]   |-- 🧩 column: 'last_name'
[02:07:32] [INFO]   |-- 🧩 column: 'dob'
[02:07:32] [INFO]   |-- 🎲 column: 'symptom_onset_date'
[02:07:32] [INFO]   |-- 🎲 column: 'date_of_visit'
[02:07:32] [INFO]   |-- 🧩 column: 'physician'
[02:07:32] [INFO]   |-- 📝 column: 'physician_notes'
[02:07:32] [INFO]   |-- 🌱 column: 'diagnosis'
[02:07:32] [INFO]   |-- 🌱 column: 'patient_summary'
[02:07:32] [INFO] 👏 Preview complete!
Python
1# Run this cell multiple times to cycle through the 2 preview records.
2preview.display_sample_record()
3
Output
[index: 0]
                                                                                                              
                                                 Seed Columns                                                 
┏━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Name            ┃ Value                                                                                    ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ diagnosis       │ cervical spondylosis                                                                     │
├─────────────────┼──────────────────────────────────────────────────────────────────────────────────────────┤
│ patient_summary │ I've been having a lot of pain in my neck and back. I've also been having trouble with   │
│                 │ my balance and coordination. I've been coughing a lot and my limbs feel weak.            │
└─────────────────┴──────────────────────────────────────────────────────────────────────────────────────────┘
                                                                                                              
                                                                                                              
                                              Generated Columns                                               
┏━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Name               ┃ Value                                                                                 ┃
┡━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ patient_sampler    │ {                                                                                     │
│                    │     'uuid': 'fbfa1354-c845-4da2-9ae4-5c2610f15a9b',                                   │
│                    │     'locale': 'en_US',                                                                │
│                    │     'first_name': 'Vincent',                                                          │
│                    │     'last_name': 'Weeks',                                                             │
│                    │     'middle_name': None,                                                              │
│                    │     'sex': 'Male',                                                                    │
│                    │     'street_number': '53024',                                                         │
│                    │     'street_name': 'Nicole Glens',                                                    │
│                    │     'city': 'Jonestown',                                                              │
│                    │     'state': 'New York',                                                              │
│                    │     'postcode': '52171',                                                              │
│                    │     'age': 50,                                                                        │
│                    │     'birth_date': '1976-03-25',                                                       │
│                    │     'country': 'Moldova',                                                             │
│                    │     'marital_status': 'married_present',                                              │
│                    │     'education_level': 'associates',                                                  │
│                    │     'unit': '',                                                                       │
│                    │     'occupation': 'Insurance risk surveyor',                                          │
│                    │     'phone_number': '001-938-687-8840x19309',                                         │
│                    │     'bachelors_field': 'no_degree'                                                    │
│                    │ }                                                                                     │
├────────────────────┼───────────────────────────────────────────────────────────────────────────────────────┤
│ doctor_sampler     │ {                                                                                     │
│                    │     'uuid': '8151a6db-f14a-486f-9da5-8c473df087ca',                                   │
│                    │     'locale': 'en_US',                                                                │
│                    │     'first_name': 'Sandy',                                                            │
│                    │     'last_name': 'Nguyen',                                                            │
│                    │     'middle_name': None,                                                              │
│                    │     'sex': 'Female',                                                                  │
│                    │     'street_number': '28766',                                                         │
│                    │     'street_name': 'Beth Vista',                                                      │
│                    │     'city': 'East Gloria',                                                            │
│                    │     'state': 'Kansas',                                                                │
│                    │     'postcode': '52254',                                                              │
│                    │     'age': 53,                                                                        │
│                    │     'birth_date': '1973-05-25',                                                       │
│                    │     'country': 'Saint Kitts and Nevis',                                               │
│                    │     'marital_status': 'never_married',                                                │
│                    │     'education_level': 'graduate',                                                    │
│                    │     'unit': '',                                                                       │
│                    │     'occupation': 'Camera operator',                                                  │
│                    │     'phone_number': '825-936-7843',                                                   │
│                    │     'bachelors_field': 'stem_related'                                                 │
│                    │ }                                                                                     │
├────────────────────┼───────────────────────────────────────────────────────────────────────────────────────┤
│ patient_id         │ PT-C14002EE                                                                           │
├────────────────────┼───────────────────────────────────────────────────────────────────────────────────────┤
│ symptom_onset_date │ 2024-07-03T00:00:00                                                                   │
├────────────────────┼───────────────────────────────────────────────────────────────────────────────────────┤
│ date_of_visit      │ 2024-07-11T00:00:00                                                                   │
├────────────────────┼───────────────────────────────────────────────────────────────────────────────────────┤
│ physician_notes    │ **Patient Name:** Vincent Weeks                                                       │
│                    │ **Date of Birth:** [DOB not provided]                                                 │
│                    │ **Date of Visit:** 2024-07-11                                                         │
│                    │ **Reason for Visit:** Acute exacerbation of cervical spondylosis; progressive         │
│                    │ weakness; chronic cough.                                                              │
│                    │                                                                                       │
│                    │ **HPI:**                                                                              │
│                    │ Patient presents with a several-month history of cervical spondylosis symptoms        │
│                    │ initially noted around July 3rd. Chief complaints include significant neck and back   │
│                    │ pain. Patient reports a notable decline in balance and coordination. Complains of     │
│                    │ generalized limb weakness. Also reports a persistent, productive cough. Symptoms      │
│                    │ appear to be worsening significantly since initial onset.                             │
│                    │                                                                                       │
│                    │ **Review of Systems:**                                                                │
│                    │ + Neck/back: Severe pain, stiffness.                                                  │
│                    │ + Neurological: Gait instability, frequent tripping. Upper and lower extremity        │
│                    │ weakness. Fine motor difficulty.                                                      │
│                    │ + Respiratory: Chronic cough, possibly infectious or related to posture.              │
│                    │ + Muscular: Proximal and distal weakness.                                             │
│                    │                                                                                       │
│                    │ **Physical Exam:**                                                                    │
│                    │ Vitals: BP 138/82, HR 76, RR 16, SpO2 97% RA.                                         │
│                    │ General: Patient appears uncomfortable, guarded movement.                             │
│                    │ Neurological: Gait assessment shows mild truncal instability. Cranial nerves grossly  │
│                    │ intact. Muscle strength: 4/5 bilateral upper extremities; 4/5 bilateral lower         │
│                    │ extremities. Deep tendon reflexes 2+ at knees and ankles. Positive Romberg's test.    │
│                    │ Sensation decreased to light touch bilaterally at C5/C6 dermatomes.                   │
│                    │ Orthopedic: Limited ROM neck due to pain and spasm. Spurling's test positive right.   │
│                    │                                                                                       │
│                    │ **Assessment:**                                                                       │
│                    │ 1. Cervical spondylosis with myelopathic symptoms (balance/weakness).                 │
│                    │ 2. Acute on chronic cervical radiculomyelopathy.                                      │
│                    │ 3. Chronic cough (etiology: unclear - possible aspiration vs. respiratory infection   │
│                    │ vs. somatic).                                                                         │
│                    │ 4. Muscle deconditioning.                                                             │
│                    │                                                                                       │
│                    │ **Plan:**                                                                             │
│                    │ - Order MRI C-spine with and without contrast to assess for cord compression.         │
│                    │ - Order CBC, ESR, CRP to rule out inflammatory/infectious process given systemic      │
│                    │ symptoms.                                                                             │
│                    │ - Prescribe low-dose gabapentin for neuropathic pain and spasm.                       │
│                    │ - Prescribe muscle relaxant (cyclobenzaprine) PRN.                                    │
│                    │ - Refer to Physical Therapy for gait training and cervical stabilization.             │
│                    │ - Schedule follow-up in 2 weeks to reassess neurology.                                │
│                    │ - Counsel patient on fall prevention strategies given balance issues.                 │
├────────────────────┼───────────────────────────────────────────────────────────────────────────────────────┤
│ first_name         │ Vincent                                                                               │
├────────────────────┼───────────────────────────────────────────────────────────────────────────────────────┤
│ last_name          │ Weeks                                                                                 │
├────────────────────┼───────────────────────────────────────────────────────────────────────────────────────┤
│ dob                │ 1976-03-25                                                                            │
├────────────────────┼───────────────────────────────────────────────────────────────────────────────────────┤
│ physician          │ Dr. Nguyen                                                                            │
└────────────────────┴───────────────────────────────────────────────────────────────────────────────────────┘
Python
1# The preview dataset is available as a pandas DataFrame.
2preview.dataset
3
Output
diagnosis patient_summary patient_sampler doctor_sampler patient_id symptom_onset_date date_of_visit dob last_name physician first_name physician_notes
0 cervical spondylosis I've been having a lot of pain in my neck and ... {'uuid': 'fbfa1354-c845-4da2-9ae4-5c2610f15a9b... {'uuid': '8151a6db-f14a-486f-9da5-8c473df087ca... PT-C14002EE 2024-07-03T00:00:00 2024-07-11T00:00:00 1976-03-25 Weeks Dr. Nguyen Vincent **Patient Name:** Vincent Weeks  \n**Date of B...
1 impetigo I have a rash on my face that is getting worse... {'uuid': '40d18e49-caea-44dd-9630-74ff5cec6271... {'uuid': '4dee7bb3-0651-42ba-91b9-c90b2e6d1e7c... PT-9C63CA94 2024-06-16T00:00:00 2024-06-29T00:00:00 1925-12-21 Richard Dr. Stevens Timothy **Patient Name:** Timothy Richard\n**Date of V...

📊 Analyze the generated data

  • Data Designer automatically generates a basic statistical analysis of the generated data.

  • This analysis is available via the analysis property of generation result objects.

Python
1# Print the analysis as a table.
2preview.analysis.to_report()
3
Output
──────────────────────────────────────── 🎨 Data Designer Dataset Profile ─────────────────────────────────────────

                                                                                                                   
                                                 Dataset Overview                                                  
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ number of records               ┃ number of columns               ┃ percent complete records                    ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 2                               │ 12                              │ 100.0%                                      │
└─────────────────────────────────┴─────────────────────────────────┴─────────────────────────────────────────────┘
                                                                                                                   
                                                                                                                   
                                              🌱 Seed-Dataset Columns                                              
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ column name                          ┃               data type ┃                           number unique values ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ diagnosis                            │                  string │                                     2 (100.0%) │
├──────────────────────────────────────┼─────────────────────────┼────────────────────────────────────────────────┤
│ patient_summary                      │                  string │                                     2 (100.0%) │
└──────────────────────────────────────┴─────────────────────────┴────────────────────────────────────────────────┘
                                                                                                                   
                                                                                                                   
                                                🎲 Sampler Columns                                                 
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ column name                   ┃       data type ┃             number unique values ┃               sampler type ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ patient_sampler               │            dict │                       2 (100.0%) │          person_from_faker │
├───────────────────────────────┼─────────────────┼──────────────────────────────────┼────────────────────────────┤
│ doctor_sampler                │            dict │                       2 (100.0%) │          person_from_faker │
├───────────────────────────────┼─────────────────┼──────────────────────────────────┼────────────────────────────┤
│ patient_id                    │          string │                       2 (100.0%) │                       uuid │
├───────────────────────────────┼─────────────────┼──────────────────────────────────┼────────────────────────────┤
│ symptom_onset_date            │          string │                       2 (100.0%) │                   datetime │
├───────────────────────────────┼─────────────────┼──────────────────────────────────┼────────────────────────────┤
│ date_of_visit                 │          string │                       2 (100.0%) │                  timedelta │
└───────────────────────────────┴─────────────────┴──────────────────────────────────┴────────────────────────────┘
                                                                                                                   
                                                                                                                   
                                                📝 LLM-Text Columns                                                
┏━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━┓
┃                       ┃               ┃                            ┃     prompt tokens ┃      completion tokens ┃
┃ column name           ┃     data type ┃       number unique values ┃        per record ┃             per record ┃
┡━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━┩
│ physician_notes       │        string │                 2 (100.0%) │     134.0 +/- 4.0 │         456.5 +/- 77.1 │
└───────────────────────┴───────────────┴────────────────────────────┴───────────────────┴────────────────────────┘
                                                                                                                   
                                                                                                                   
                                               🧩 Expression Columns                                               
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ column name                    ┃                 data type ┃                               number unique values ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ first_name                     │                    string │                                         2 (100.0%) │
├────────────────────────────────┼───────────────────────────┼────────────────────────────────────────────────────┤
│ last_name                      │                    string │                                         2 (100.0%) │
├────────────────────────────────┼───────────────────────────┼────────────────────────────────────────────────────┤
│ dob                            │                    string │                                         2 (100.0%) │
├────────────────────────────────┼───────────────────────────┼────────────────────────────────────────────────────┤
│ physician                      │                    string │                                         2 (100.0%) │
└────────────────────────────────┴───────────────────────────┴────────────────────────────────────────────────────┘
                                                                                                                   
                                                                                                                   
╭────────────────────────────────────────────────── Table Notes ──────────────────────────────────────────────────╮
│                                                                                                                 │
│  1. All token statistics are based on a sample of max(1000, len(dataset)) records.                              │
│  2. Tokens are calculated using tiktoken's cl100k_base tokenizer.                                               │
│                                                                                                                 │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
                                                                                                                   
───────────────────────────────────────────────────────────────────────────────────────────────────────────────────

🆙 Scale up!

  • Happy with your preview data?

  • Use the create method to submit larger Data Designer generation jobs.

Python
1results = data_designer.create(config_builder, num_records=10, dataset_name="tutorial-3")
2
Output
[02:07:32] [INFO] OpenTelemetry metrics available at http://127.0.0.1:9464/metrics
[02:07:32] [INFO] 🎨 Creating Data Designer dataset
[02:07:32] [INFO]   |-- 🔒 Jinja rendering engine: secure
[02:07:32] [INFO] ✅ Validation passed
[02:07:32] [INFO] ⛓️ Sorting column configs into a Directed Acyclic Graph
[02:07:32] [INFO] Skipping model health checks because DATA_DESIGNER_SKIP_MODEL_HEALTH_CHECKS=1
[02:07:32] [INFO] ⚡ Using async task-queue builder
[02:07:32] [INFO] 📝 llm-text model config for column 'physician_notes'
[02:07:32] [INFO]   |-- model: 'nvidia/nemotron-3.5-lightning-30b-a3b'
[02:07:32] [INFO]   |-- model alias: 'nemotron-lightning'
[02:07:32] [INFO]   |-- model provider: 'nvidia'
[02:07:32] [INFO]   |-- inference parameters:
[02:07:32] [INFO]   |  |-- generation_type=chat-completion
[02:07:32] [INFO]   |  |-- max_parallel_requests=4
[02:07:32] [INFO]   |  |-- extra_body={'chat_template_kwargs': {'enable_thinking': False}}
[02:07:32] [INFO]   |  |-- temperature=1.00
[02:07:32] [INFO]   |  |-- top_p=0.95
[02:07:32] [INFO]   |  |-- max_tokens=2048
[02:07:32] [INFO] ⚡️ Async generation: 1 column(s) (column 'physician_notes'), 10 tasks across 1 row group(s)
[02:07:32] [INFO] 🚀 (1/1) Dispatching with 10 records
[02:07:32] [INFO] 🎲 (1/1) Preparing samplers to generate 10 records across 5 columns
[02:07:32] [INFO] 🌱 (1/1) Sampling 10 records from seed dataset
[02:07:32] [INFO]   |-- seed dataset size: 820 records
[02:07:32] [INFO]   |-- sampling strategy: ordered
[02:07:32] [INFO] 🧩 (1/1) Generating column `dob` from expression
[02:07:32] [INFO] 🧩 (1/1) Generating column `first_name` from expression
[02:07:32] [INFO] 🧩 (1/1) Generating column `last_name` from expression
[02:07:32] [INFO] 🧩 (1/1) Generating column `physician` from expression
[02:07:38] [INFO] 📊 Progress [5.3s]:
[02:07:38] [INFO]   |-- 🌦️ column 'physician_notes': 4/10 (40%) 0.8 rec/s
[02:07:43] [INFO] 📊 Progress [10.4s]:
[02:07:43] [INFO]   |-- 🌤️ column 'physician_notes': 8/10 (80%) 0.8 rec/s
[02:08:03] [INFO] 📊 Progress [30.3s]:
[02:08:03] [INFO]   |-- ☀️ column 'physician_notes': 10/10 (100%) 0.3 rec/s
[02:08:03] [INFO] ✅ Async generation complete [30.4s]: 10 ok, 0 failed across 1 column(s)
[02:08:03] [INFO] 📊 Model usage summary:
[02:08:03] [INFO]   |-- model: nvidia/nemotron-3.5-lightning-30b-a3b
[02:08:03] [INFO]   |-- tokens: input=1615, output=4378, reasoning=0, total=5993, tps=195
[02:08:03] [INFO]   |-- requests: success=10, failed=0, total=10, rpm=19
[02:08:03] [INFO] 📐 Measuring dataset column statistics:
[02:08:03] [INFO]   |-- 🎲 column: 'patient_sampler'
[02:08:03] [INFO]   |-- 🎲 column: 'doctor_sampler'
[02:08:03] [INFO]   |-- 🎲 column: 'patient_id'
[02:08:03] [INFO]   |-- 🧩 column: 'first_name'
[02:08:03] [INFO]   |-- 🧩 column: 'last_name'
[02:08:03] [INFO]   |-- 🧩 column: 'dob'
[02:08:03] [INFO]   |-- 🎲 column: 'symptom_onset_date'
[02:08:03] [INFO]   |-- 🎲 column: 'date_of_visit'
[02:08:03] [INFO]   |-- 🧩 column: 'physician'
[02:08:03] [INFO]   |-- 📝 column: 'physician_notes'
[02:08:03] [INFO]   |-- 🌱 column: 'diagnosis'
[02:08:03] [INFO]   |-- 🌱 column: 'patient_summary'
Python
1# Load the generated dataset as a pandas DataFrame.
2dataset = results.load_dataset()
3 
4dataset.head()
5
Output
patient_sampler doctor_sampler patient_id symptom_onset_date date_of_visit diagnosis patient_summary first_name dob last_name physician physician_notes
0 {'uuid': '86a29420-aaea-4597-9bae-1eb2fb88c92c... {'uuid': 'c32816a8-da2d-452b-b039-dd12c81faad7... PT-A4F6C357 2024-06-06T00:00:00 2024-06-12T00:00:00 cervical spondylosis I've been having a lot of pain in my neck and ... David 1921-06-11 Moore Dr. Martin **DAVID MOORE** **DATE:** 2024/06/12 **CHIEF C...
1 {'uuid': '48273ab3-9f0a-48ca-98cf-7d8469f8f6da... {'uuid': '55b0fa5d-4ca6-48f2-9ddb-11c0acd4a694... PT-874C731F 2024-07-27T00:00:00 2024-08-08T00:00:00 impetigo I have a rash on my face that is getting worse... Patrick 1957-10-12 Gonzalez Dr. Huff **Patient Name:** Patrick Gonzalez **Date of V...
2 {'uuid': '9c7e036e-2429-4a4f-8e44-8bac8e341f37... {'uuid': '19175c31-3738-4e21-8d0f-e7cb9ae63fba... PT-76583D85 2024-08-21T00:00:00 2024-09-13T00:00:00 urinary tract infection I have been urinating blood. I sometimes feel ... Andrew 1931-11-01 Allen Dr. Montes **PRIMARY CARE CLINIC - DR. CHRISTOPHER MONTES...
3 {'uuid': '3a56a4b3-6906-452d-9c83-a467d04be7bc... {'uuid': 'fa20185b-989e-46d8-9a99-bb722cdbdeef... PT-B579FBF1 2024-04-21T00:00:00 2024-05-07T00:00:00 arthritis I have been having trouble with my muscles and... Gregory 1983-07-03 Dougherty Dr. Newton **Patient Name:** Gregory Dougherty   **Date o...
4 {'uuid': '291922f8-5d9a-448e-944d-0a436172782d... {'uuid': 'ebca03a0-b2b7-49a4-9613-774d0fb7552c... PT-474B95EA 2024-01-03T00:00:00 2024-01-28T00:00:00 dengue I have been feeling really sick. My body hurts... Brittany 1965-12-28 Lewis Dr. Perez ***** PATIENT ENCOUNTER NOTES *** **Provider:...
Python
1# Load the analysis results into memory.
2analysis = results.load_analysis()
3 
4analysis.to_report()
5
Output
──────────────────────────────────────── 🎨 Data Designer Dataset Profile ─────────────────────────────────────────

                                                                                                                   
                                                 Dataset Overview                                                  
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ number of records               ┃ number of columns               ┃ percent complete records                    ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 10                              │ 12                              │ 100.0%                                      │
└─────────────────────────────────┴─────────────────────────────────┴─────────────────────────────────────────────┘
                                                                                                                   
                                                                                                                   
                                              🌱 Seed-Dataset Columns                                              
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ column name                          ┃               data type ┃                           number unique values ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ diagnosis                            │                  string │                                      7 (70.0%) │
├──────────────────────────────────────┼─────────────────────────┼────────────────────────────────────────────────┤
│ patient_summary                      │                  string │                                    10 (100.0%) │
└──────────────────────────────────────┴─────────────────────────┴────────────────────────────────────────────────┘
                                                                                                                   
                                                                                                                   
                                                🎲 Sampler Columns                                                 
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ column name                   ┃       data type ┃             number unique values ┃               sampler type ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ patient_sampler               │            dict │                      10 (100.0%) │          person_from_faker │
├───────────────────────────────┼─────────────────┼──────────────────────────────────┼────────────────────────────┤
│ doctor_sampler                │            dict │                      10 (100.0%) │          person_from_faker │
├───────────────────────────────┼─────────────────┼──────────────────────────────────┼────────────────────────────┤
│ patient_id                    │          string │                      10 (100.0%) │                       uuid │
├───────────────────────────────┼─────────────────┼──────────────────────────────────┼────────────────────────────┤
│ symptom_onset_date            │          string │                      10 (100.0%) │                   datetime │
├───────────────────────────────┼─────────────────┼──────────────────────────────────┼────────────────────────────┤
│ date_of_visit                 │          string │                      10 (100.0%) │                  timedelta │
└───────────────────────────────┴─────────────────┴──────────────────────────────────┴────────────────────────────┘
                                                                                                                   
                                                                                                                   
                                                📝 LLM-Text Columns                                                
┏━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━┓
┃                       ┃               ┃                            ┃     prompt tokens ┃      completion tokens ┃
┃ column name           ┃     data type ┃       number unique values ┃        per record ┃             per record ┃
┡━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━┩
│ physician_notes       │        string │                10 (100.0%) │     130.5 +/- 5.2 │         435.0 +/- 78.5 │
└───────────────────────┴───────────────┴────────────────────────────┴───────────────────┴────────────────────────┘
                                                                                                                   
                                                                                                                   
                                               🧩 Expression Columns                                               
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ column name                    ┃                 data type ┃                               number unique values ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ first_name                     │                    string │                                          9 (90.0%) │
├────────────────────────────────┼───────────────────────────┼────────────────────────────────────────────────────┤
│ last_name                      │                    string │                                        10 (100.0%) │
├────────────────────────────────┼───────────────────────────┼────────────────────────────────────────────────────┤
│ dob                            │                    string │                                        10 (100.0%) │
├────────────────────────────────┼───────────────────────────┼────────────────────────────────────────────────────┤
│ physician                      │                    string │                                        10 (100.0%) │
└────────────────────────────────┴───────────────────────────┴────────────────────────────────────────────────────┘
                                                                                                                   
                                                                                                                   
╭────────────────────────────────────────────────── Table Notes ──────────────────────────────────────────────────╮
│                                                                                                                 │
│  1. All token statistics are based on a sample of max(1000, len(dataset)) records.                              │
│  2. Tokens are calculated using tiktoken's cl100k_base tokenizer.                                               │
│                                                                                                                 │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
                                                                                                                   
───────────────────────────────────────────────────────────────────────────────────────────────────────────────────

⏭️ Next Steps

Check out the following notebook to learn more about: