Skip to main content

Profile Fields

When generating person-profile data, you often need several related presets together: a name, an email derived from that name, an address, a phone number, and so on. Rather than wiring up each column individually, the profile_fields() helper returns a ready-made dictionary of StringField objects that you can unpack directly into a Schema().

Basic Usage

With no arguments, profile_fields() returns the standard set of seven columns: first_name, last_name, email, city, state, postcode, and phone_number. All coherence rules apply automatically: emails are derived from names, and city/state/postcode/phone are internally consistent.

schema = pb.Schema(
    user_id=pb.int_field(unique=True, min_val=1),
    **pb.profile_fields(),
)

pb.preview(pb.generate_dataset(schema, n=100, seed=23))
PolarsRows100Columns8
user_id
Int64
first_name
String
last_name
String
email
String
city
String
state
String
postcode
String
phone_number
String
1 7188536481533917197 Weston Parker weston.parker23@gmail.com Lubbock Texas 79404 (832) 960-5399
2 2674009078779859984 Hazel Torres hazel723@hotmail.com Anaheim California 92873 (805) 988-7427
3 7652102777077138151 Lawrence Mitchell lawrence_mitchell@zoho.com Phoenix Arizona 85027 (928) 782-5894
4 157503859921753049 Maria Garcia m_garcia@hotmail.com Denver Colorado 80277 (303) 846-6634
5 2829213282471975080 Michael Hoffman michael.hoffman@gmail.com San Antonio Texas 78208 (214) 901-0009
96 7027508096731143831 Daniel Torres daniel_torres@icloud.com El Paso Texas 79944 (281) 769-2210
97 6055996548456656575 Helen Simpson hsimpson20@yandex.com El Paso Texas 79930 (210) 345-8803
98 3822709996092631588 Mark Graham mark.graham65@mail.com Charlotte North Carolina 28222 (336) 732-4609
99 1522653102058131295 Brian Moore bmoore95@zoho.com Los Angeles California 90058 (707) 702-7905
100 5690877051669225499 Michael Ward michael_ward@yahoo.com San Diego California 92147 (619) 940-2614

The ** operator unpacks the dictionary into keyword arguments, as if you had written each string_field(preset=...) call by hand.

Choosing a Set

Three built-in sets control how many columns are generated:

Set Columns
"minimal" first_name, last_name, email, phone_number
"standard" first_name, last_name, email, city, state, postcode, phone_number
"full" first_name, last_name, email, address, city, state, postcode, phone_number, company, job 
# Minimal profile: just name, email, and phone
pb.preview(
    pb.generate_dataset(
        pb.Schema(**pb.profile_fields(set="minimal")),
        n=100, seed=23,
    )
)
PolarsRows100Columns4
first_name
String
last_name
String
email
String
phone_number
String
1 Weston Parker weston.parker23@gmail.com (214) 673-2777
2 Hazel Torres hazel723@hotmail.com (213) 828-0231
3 Lawrence Mitchell lawrence_mitchell@zoho.com (623) 370-0982
4 Maria Garcia m_garcia@hotmail.com (970) 694-0476
5 Michael Hoffman michael.hoffman@gmail.com (682) 391-2143
96 Daniel Torres daniel_torres@icloud.com (915) 504-6717
97 Helen Simpson hsimpson20@yandex.com (940) 869-0705
98 Mark Graham mark.graham65@mail.com (984) 800-0885
99 Brian Moore bmoore95@zoho.com (650) 955-2724
100 Michael Ward michael_ward@yahoo.com (949) 771-2134 
# Full profile: includes address, company, and job title
pb.preview(
    pb.generate_dataset(
        pb.Schema(**pb.profile_fields(set="full")),
        n=100, seed=23,
    )
)
PolarsRows100Columns10
first_name
String
last_name
String
email
String
address
String
city
String
state
String
postcode
String
phone_number
String
company
String
job
String
1 Weston Parker wparker89@outlook.com 3365 Richmond Avenue, Suite 422, Lubbock, Texas 79421 Lubbock Texas 79470 (210) 460-3732 Patterson Networks System Administrator
2 Hazel Torres htorres35@aol.com 353 East South Street, Anaheim, California 92898 Anaheim California 92835 (858) 514-0644 Anaheim Real Estate Insurance Agent
3 Lawrence Mitchell lawrence.mitchell1@hotmail.com 2647 Tatum Boulevard, Phoenix, Arizona 85023 Phoenix Arizona 85041 (520) 301-6749 Ford Interior Designer
4 Maria Garcia mgarcia@aol.com 5145 Arizona Avenue, Apt 761, Denver, Colorado 80255 Denver Colorado 80287 (970) 458-9509 Carter Electric HVAC Technician
5 Michael Hoffman m_hoffman@outlook.com 5209 Grayson Street, Suite 333, San Antonio, Texas 78299 San Antonio Texas 78248 (512) 529-7287 San Antonio Engineering Group Construction Manager
96 Daniel Torres daniel.torres48@icloud.com 3678 Rim Road, Suite 33, El Paso, Texas 79943 El Paso Texas 79962 (972) 892-8539 Pioneer Strategy Group Consultant
97 Helen Simpson helen.simpson1@hotmail.com 1411 Mesa Street, El Paso, Texas 79930 El Paso Texas 79955 (512) 481-0603 Powell & Gordon Electrical Engineer
98 Mark Graham mgraham26@mail.com 2065 Craighead Road, Apt 521, Charlotte, North Carolina 28289 Charlotte North Carolina 28261 (980) 608-7729 Graham & Allen Mechanical Engineer
99 Brian Moore brian263@icloud.com 2072 2nd Street Los Angeles, Suite 893, Los Angeles, California 90034 Los Angeles California 90037 (408) 625-2327 The Quality Hotels Chef
100 Michael Ward m_ward@protonmail.com 7966 K Street, San Diego, California 92109 San Diego California 92194 (510) 252-2820 Morgan Stanley Bank Teller

Combined vs. Split Names

By default, names are split into first_name and last_name columns. Set split_name=False to get a single name column instead:

pb.preview(
    pb.generate_dataset(
        pb.Schema(**pb.profile_fields(set="minimal", split_name=False)),
        n=100, seed=23,
    )
)
PolarsRows100Columns3
name
String
email
String
phone_number
String
1 Weston Parker weston.parker23@gmail.com (214) 673-2777
2 Hazel Torres hazel723@hotmail.com (213) 828-0231
3 Lawrence Mitchell lawrence_mitchell@zoho.com (623) 370-0982
4 Maria Garcia m_garcia@hotmail.com (970) 694-0476
5 Michael Hoffman michael.hoffman@gmail.com (682) 391-2143
96 Daniel Torres daniel_torres@icloud.com (915) 504-6717
97 Helen Simpson hsimpson20@yandex.com (940) 869-0705
98 Mark Graham mark.graham65@mail.com (984) 800-0885
99 Brian Moore bmoore95@zoho.com (650) 955-2724
100 Michael Ward michael_ward@yahoo.com (949) 771-2134

Adding and Removing Columns

Use include= to add presets to the base set and exclude= to remove them. Both accept lists of preset names. The available profile presets are: first_name, last_name, name, email, address, city, state, postcode, phone_number, company, and job.

# Standard set + company column
pb.preview(
    pb.generate_dataset(
        pb.Schema(**pb.profile_fields(include=["company"])),
        n=100, seed=23,
    )
)
PolarsRows100Columns8
first_name
String
last_name
String
email
String
city
String
state
String
postcode
String
phone_number
String
company
String
1 Weston Parker weston.parker23@gmail.com Lubbock Texas 79404 (832) 960-5399 Innovative Systems Solutions
2 Hazel Torres hazel723@hotmail.com Anaheim California 92873 (805) 988-7427 Sterling Engineering
3 Lawrence Mitchell lawrence_mitchell@zoho.com Phoenix Arizona 85027 (928) 782-5894 Goldman Sachs
4 Maria Garcia m_garcia@hotmail.com Denver Colorado 80277 (303) 846-6634 Evans Group
5 Michael Hoffman michael.hoffman@gmail.com San Antonio Texas 78208 (214) 901-0009 Goodwin and Garrett
96 Daniel Torres daniel_torres@icloud.com El Paso Texas 79944 (281) 769-2210 Henry Construction
97 Helen Simpson hsimpson20@yandex.com El Paso Texas 79930 (210) 345-8803 Thompson Technologies
98 Mark Graham mark.graham65@mail.com Charlotte North Carolina 28222 (336) 732-4609 Universal Consulting
99 Brian Moore bmoore95@zoho.com Los Angeles California 90058 (707) 702-7905 Long Industries
100 Michael Ward michael_ward@yahoo.com San Diego California 92147 (619) 940-2614 Pioneer Solutions 
# Standard set without city and state
pb.preview(
    pb.generate_dataset(
        pb.Schema(**pb.profile_fields(exclude=["city", "state"])),
        n=100, seed=23,
    )
)
PolarsRows100Columns5
first_name
String
last_name
String
email
String
postcode
String
phone_number
String
1 Weston Parker weston.parker23@gmail.com 79404 (832) 960-5399
2 Hazel Torres hazel723@hotmail.com 92873 (805) 988-7427
3 Lawrence Mitchell lawrence_mitchell@zoho.com 85027 (928) 782-5894
4 Maria Garcia m_garcia@hotmail.com 80277 (303) 846-6634
5 Michael Hoffman michael.hoffman@gmail.com 78208 (214) 901-0009
96 Daniel Torres daniel_torres@icloud.com 79944 (281) 769-2210
97 Helen Simpson hsimpson20@yandex.com 79930 (210) 345-8803
98 Mark Graham mark.graham65@mail.com 28222 (336) 732-4609
99 Brian Moore bmoore95@zoho.com 90058 (707) 702-7905
100 Michael Ward michael_ward@yahoo.com 92147 (619) 940-2614

You can combine include= and exclude= in the same call, as long as the same preset does not appear in both.

Column Prefixes

The prefix= parameter prepends a string to every column name. This is especially useful when a schema needs two independent profiles (e.g., sender and recipient):

schema = pb.Schema(
    **pb.profile_fields(set="minimal", prefix="sender_"),
    **pb.profile_fields(set="minimal", prefix="recipient_"),
)

pb.preview(pb.generate_dataset(schema, n=100, seed=23))
PolarsRows100Columns8
sender_first_name
String
sender_last_name
String
sender_email
String
sender_phone_number
String
recipient_first_name
String
recipient_last_name
String
recipient_email
String
recipient_phone_number
String
1 Weston Parker weston.parker23@gmail.com (214) 673-2777 Weston Parker weston.parker@outlook.com (915) 827-6385
2 Hazel Torres hazel723@hotmail.com (213) 828-0231 Hazel Torres hazeltorres@yandex.com (510) 430-0382
3 Lawrence Mitchell lawrence_mitchell@zoho.com (623) 370-0982 Lawrence Mitchell lmitchell@hotmail.com (480) 609-6977
4 Maria Garcia m_garcia@hotmail.com (970) 694-0476 Maria Garcia maria993@zoho.com (303) 564-2441
5 Michael Hoffman michael.hoffman@gmail.com (682) 391-2143 Michael Hoffman michael.hoffman84@gmail.com (940) 486-1122
96 Daniel Torres daniel_torres@icloud.com (915) 504-6717 Daniel Torres daniel.torres@gmail.com (832) 313-0333
97 Helen Simpson hsimpson20@yandex.com (940) 869-0705 Helen Simpson helensimpson@gmail.com (512) 818-5803
98 Mark Graham mark.graham65@mail.com (984) 800-0885 Mark Graham markgraham@gmail.com (984) 656-7349
99 Brian Moore bmoore95@zoho.com (650) 955-2724 Brian Moore bmoore93@yahoo.com (408) 902-9175
100 Michael Ward michael_ward@yahoo.com (949) 771-2134 Michael Ward michael.ward4@hotmail.com (650) 916-0907

Each prefixed group maintains its own coherence: the sender’s email is derived from the sender’s name, and the recipient’s email from the recipient’s name.

Combining with Other Field Types

Since profile_fields() returns a plain dictionary, it composes naturally with any other field types:

schema = pb.Schema(
    id=pb.int_field(unique=True, min_val=1000),
    **pb.profile_fields(),
    active=pb.bool_field(p_true=0.8),
    signup_date=pb.date_field(
        min_date="2024-01-01",
        max_date="2025-12-31",
    ),
)

pb.preview(pb.generate_dataset(schema, n=100, seed=23, country="DE"))
PolarsRows100Columns10
id
Int64
first_name
String
last_name
String
email
String
city
String
state
String
postcode
String
phone_number
String
active
Boolean
signup_date
Date
1 7188536481533918196 Agathe Kramer akramer@gmail.com Potsdam Brandenburg 14820 (0335) 989-6751 False 2024-10-23
2 2674009078779860983 Rüdiger Altmann ruediger.altmann69@gmail.com Halle (Saale) Sachsen-Anhalt 06210 (0345) 239-7780 False 2024-03-26
3 7652102777077139150 Bodo Meyer bodo723@web.de Frankfurt am Main Hessen 60473 (0611) 231-3262 False 2024-01-18
4 157503859921754048 Stefanie Meyer stefanie_meyer@posteo.de Leipzig Sachsen 04277 (0371) 874-7863 True 2025-08-29
5 2829213282471976079 Fabian Thomas f_thomas@web.de Cologne Nordrhein-Westfalen 50708 (0203) 870-5463 True 2024-11-10
96 7027508096731144830 Maike Fuchs maike_fuchs@yahoo.de Frankfurt am Main Hessen 60188 (0611) 017-4531 True 2024-06-20
97 6055996548456657574 Sebastian König sebastian_koenig@t-online.de Augsburg Bayern 86110 (0841) 916-6870 True 2025-04-05
98 3822709996092632587 Diana Henkel dhenkel20@arcor.de Frankfurt am Main Hessen 60198 (06151) 561-5880 False 2024-02-04
99 1522653102058132294 Matthias Keßler matthias.kessler65@outlook.de Zwickau Sachsen 08826 (0351) 850-7507 False 2024-02-27
100 5690877051669226498 Dirk Neumann dneumann95@posteo.de Nuremberg Bayern 90954 (0941) 885-4226 False 2025-10-07