Uploads and run details are stored securely for service operation, abuse prevention, and analytics. Guest sessions are not saved to your account — sign in to keep reports longer.

Sample CSV kits

Fictional example studies with step-by-step instructions. Download files, edit ratings, then upload or run the bundled template in Studio. Required for every study: profiles.csv and attributes.csv.

Column guide ↓ Studio home

Sample data Share simulation

Train commute

2 attributes (ticket price, platform wait), 9 profiles, choice set for share simulation.

  1. Download the zip (or at least profiles.csv and attributes.csv).
  2. Open profiles.csv — change only the rating column (0–100) for each row.
  3. Upload via Studio → Study files, or run the bundled template from Examples.
  4. Open Report for market share and attribute importance charts.

Download all (.zip)

Upload your CSVs

FileDownload
attributes.csv attributes.csv
choice_set.csv choice_set.csv
choice_tasks.csv choice_tasks.csv
profiles.csv profiles.csv
settings.csv settings.csv
Sample data Share simulation

Coffee subscription

Monthly price vs delivery speed — 9 profiles with share simulation.

  1. Download the Coffee subscription zip.
  2. Edit ratings in profiles.csv to reflect your taste (0–100 per bundle).
  3. Run bundled from Examples, or upload your edited CSVs under Study files.
  4. Compare plans in the market share chart on Report.

Download all (.zip)

Upload your CSVs

FileDownload
attributes.csv attributes.csv
choice_set.csv choice_set.csv
choice_tasks.csv choice_tasks.csv
profiles.csv profiles.csv
settings.csv settings.csv
Sample data Share simulation

Hotel weekend

Nightly rate vs distance to city center — weekend stay trade-offs.

  1. Download the Hotel weekend kit.
  2. Adjust rating scores for each room/distance combo in profiles.csv.
  3. Upload under Study files or run the bundled template from Examples.
  4. Use Report to see which weekend option wins share.

Download all (.zip)

Upload your CSVs

FileDownload
attributes.csv attributes.csv
choice_set.csv choice_set.csv
choice_tasks.csv choice_tasks.csv
profiles.csv profiles.csv
settings.csv settings.csv
Sample data Share simulation

Streaming plan

Monthly fee vs ad load — fictional streaming tiers with share simulation.

  1. Download the Streaming plan zip.
  2. Set ratings in profiles.csv for each fee/ad combination.
  3. Run from Examples or upload via Study files.
  4. Review share simulation on Report.

Download all (.zip)

Upload your CSVs

FileDownload
attributes.csv attributes.csv
choice_set.csv choice_set.csv
choice_tasks.csv choice_tasks.csv
profiles.csv profiles.csv
settings.csv settings.csv
Sample data

Blueberry phones

5 attributes, 32 profiles, catalog + shortlist for purchase ranking.

  1. Download profiles.csv, attributes.csv, and catalog.csv.
  2. Edit ratings in profiles.csv; optional: adjust catalog.csv SKUs.
  3. Upload via Study files or run the bundled template.
  4. Open Report for part-worths and purchase ranking.

Download all (.zip)

Upload your CSVs

FileDownload
attributes.csv attributes.csv
catalog.csv catalog.csv
profiles.csv profiles.csv
settings.csv settings.csv
shortlist.csv shortlist.csv
Sample data Share simulation Panel

Metro auto market

10 respondents, panel max-utility market share across scenarios.

  1. Download the panel kit zip.
  2. Panel studies: keep respondent structure unless you know the format.
  3. Run bundled from Examples — pick a market scenario on Report.
  4. Compare current vs new-product share on Report.

Download all (.zip)

Upload your CSVs

FileDownload
attributes.csv attributes.csv
choice_set.csv choice_set.csv
choice_set_scenario1.csv choice_set_scenario1.csv
choice_set_scenario2.csv choice_set_scenario2.csv
partworth_map.csv partworth_map.csv
respondents.csv respondents.csv
settings.csv settings.csv
Sample data Share simulation

Bike purchase

E-bike price vs battery range — ratings conjoint with share simulation.

  1. Download the Bike purchase zip.
  2. Edit ratings in profiles.csv for each price/range combo.
  3. Run bundled from Examples (Ratings) or upload via Study files.
  4. See which bike configuration wins share on Report.

Download all (.zip)

Upload your CSVs

FileDownload
attributes.csv attributes.csv
choice_set.csv choice_set.csv
choice_tasks.csv choice_tasks.csv
profiles.csv profiles.csv
settings.csv settings.csv
Sample data Share simulation

Car purchase

MSRP vs fuel economy — vehicle configuration trade-offs with share simulation.

  1. Download the Car purchase kit.
  2. Set ratings in profiles.csv for each MSRP/MPG profile.
  3. Run from Examples or upload your CSVs.
  4. Review market share on Report.

Download all (.zip)

Upload your CSVs

FileDownload
attributes.csv attributes.csv
choice_set.csv choice_set.csv
choice_tasks.csv choice_tasks.csv
profiles.csv profiles.csv
settings.csv settings.csv
Sample data

Laptop purchase

5 attributes (brand, form factor, RAM, screen, storage) — 32-profile ratings study.

  1. Download profiles.csv, attributes.csv, and catalog.csv.
  2. Edit ratings per laptop configuration in profiles.csv.
  3. Run bundled from Examples or upload via Study files.
  4. Open Report for utilities and purchase ranking.

Download all (.zip)

Upload your CSVs

FileDownload
attributes.csv attributes.csv
catalog.csv catalog.csv
profiles.csv profiles.csv
settings.csv settings.csv
shortlist.csv shortlist.csv

Column guide — what each file means

First-time users: you usually only edit rating values in profiles.csv. Keep attribute level text identical to the sample files unless you are designing a new study.

profiles.csv required

One row per design profile you asked the respondent to rate. Each attribute column must use a level label exactly as listed in attributes.csv.

ColumnMeaningExample
(id column) Unique profile id — column name from settings id_key (e.g. name, profile, S1). One row per design profile. S1 or 1
(attribute columns) One column per attribute; header = profile_key from attributes.csv. Cell value = one level label for that profile. $1.55 or Flip
rating Respondent score 0–100 (higher = more preferred). Replace demo values with your respondent's scores. 85
rank Alternative to rating: rank order 1 = best, 2 = second, … Use when response_mode=rank in settings.csv. 3
  • Every design profile needs a rating (or rank) — missing rows cause errors.
  • Level text must match attributes.csv exactly (spacing and $ signs matter for transport).
  • In Excel: save as CSV UTF-8; avoid extra blank rows at the bottom.

attributes.csv required

Defines attributes, allowed levels, and how the engine codes them for regression. You rarely change this unless you are designing a new study.

ColumnMeaningExample
attribute Display name (report labels, RIMP). Fare
profile_key Column header used in profiles.csv and catalog/choice_set. fare
levels All level labels separated by | (pipe). $1.55|$1.85|$2.15
baseline Reference level; part-worth = 0 for this level. $2.15
dummy_prefix Prefix for regression dummies (internal coefficients). XF
level_format Optional display template for ordered attrs. {value} = numeric part. {value} h
value_type nominal (default), ordered, or ideal — affects prediction/interpolation. ordered
level_values For ordered attrs: numeric values parallel to levels (| separated). 1.55|1.85|2.15
  • baseline must be one of the levels.
  • Ordered price/wait attributes enable interpolation between design levels.

settings.csv optional

Optional key/value configuration. First row must be key,value.

ColumnMeaningExample
key Setting name. id_key
value Setting value. name
  • Common keys: scenario_name, id_key, rating_key, response_mode, holdout_ids, coding_scheme.
  • id_key must match the id column header in profiles.csv.

catalog.csv optional

Real products (SKUs) to rank using your estimated part-worths.

ColumnMeaningExample
item_id Unique SKU id. SKU01
name Display name in reports. Alpha Flip Pro
(attribute columns) Same profile_key columns as profiles.csv. Nokia, Flip, 9, 115, 6
  • Levels should match design levels when possible; off-design rows are flagged.

shortlist.csv optional

Subset of catalog item_ids the respondent is considering.

ColumnMeaningExample
item_id One column listing catalog ids. SKU01
  • Report highlights best in shortlist vs best overall catalog.

choice_set.csv optional

Fixed competitors for market share simulation (logit / BTL).

ColumnMeaningExample
option_id Unique option id. A
name Label in market share report. Fast cheap
(attribute columns) Same keys as attributes.csv. $1.55, 10 min
  • Used for market share in the web report and run_share_simulation.py.

Worked examples (from sample kits)

Train commute — profiles row
name=S1, ticket_price=$1.50, platform_wait=8 min, rating=100 (your commute preference)

Coffee subscription — profiles row
name=S1, monthly_price=$12, delivery_days=Next day, rating=88 (your bundle preference)

Hotel weekend — profiles row
name=S1, nightly_rate=$89, distance_center=5 min walk, rating=72

Streaming plan — profiles row
name=S1, monthly_fee=$7.99, ads_per_hour=No ads, rating=91

Blueberry phones — profiles row
profile=2, brand=Blueberry, style=Flip, talk_time_h=9, weight_g=115, camera_mp=2, rating=95