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.
Train commute
2 attributes (ticket price, platform wait), 9 profiles, choice set for share simulation.
Steps
- Download the zip (or at least profiles.csv and attributes.csv).
- Open profiles.csv — change only the rating column (0–100) for each row.
- Upload via Studio → Study files, or run the bundled template from Examples.
- Open Report for market share and attribute importance charts.
| File | Download |
|---|---|
attributes.csv |
attributes.csv |
choice_set.csv |
choice_set.csv |
choice_tasks.csv |
choice_tasks.csv |
profiles.csv |
profiles.csv |
settings.csv |
settings.csv |
Coffee subscription
Monthly price vs delivery speed — 9 profiles with share simulation.
Steps
- Download the Coffee subscription zip.
- Edit ratings in profiles.csv to reflect your taste (0–100 per bundle).
- Run bundled from Examples, or upload your edited CSVs under Study files.
- Compare plans in the market share chart on Report.
| File | Download |
|---|---|
attributes.csv |
attributes.csv |
choice_set.csv |
choice_set.csv |
choice_tasks.csv |
choice_tasks.csv |
profiles.csv |
profiles.csv |
settings.csv |
settings.csv |
Hotel weekend
Nightly rate vs distance to city center — weekend stay trade-offs.
Steps
- Download the Hotel weekend kit.
- Adjust rating scores for each room/distance combo in profiles.csv.
- Upload under Study files or run the bundled template from Examples.
- Use Report to see which weekend option wins share.
| File | Download |
|---|---|
attributes.csv |
attributes.csv |
choice_set.csv |
choice_set.csv |
choice_tasks.csv |
choice_tasks.csv |
profiles.csv |
profiles.csv |
settings.csv |
settings.csv |
Streaming plan
Monthly fee vs ad load — fictional streaming tiers with share simulation.
Steps
- Download the Streaming plan zip.
- Set ratings in profiles.csv for each fee/ad combination.
- Run from Examples or upload via Study files.
- Review share simulation on Report.
| File | Download |
|---|---|
attributes.csv |
attributes.csv |
choice_set.csv |
choice_set.csv |
choice_tasks.csv |
choice_tasks.csv |
profiles.csv |
profiles.csv |
settings.csv |
settings.csv |
Blueberry phones
5 attributes, 32 profiles, catalog + shortlist for purchase ranking.
Steps
- Download profiles.csv, attributes.csv, and catalog.csv.
- Edit ratings in profiles.csv; optional: adjust catalog.csv SKUs.
- Upload via Study files or run the bundled template.
- Open Report for part-worths and purchase ranking.
| File | Download |
|---|---|
attributes.csv |
attributes.csv |
catalog.csv |
catalog.csv |
profiles.csv |
profiles.csv |
settings.csv |
settings.csv |
shortlist.csv |
shortlist.csv |
Metro auto market
10 respondents, panel max-utility market share across scenarios.
Steps
- Download the panel kit zip.
- Panel studies: keep respondent structure unless you know the format.
- Run bundled from Examples — pick a market scenario on Report.
- Compare current vs new-product share on Report.
| File | Download |
|---|---|
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 |
Bike purchase
E-bike price vs battery range — ratings conjoint with share simulation.
Steps
- Download the Bike purchase zip.
- Edit ratings in profiles.csv for each price/range combo.
- Run bundled from Examples (Ratings) or upload via Study files.
- See which bike configuration wins share on Report.
| File | Download |
|---|---|
attributes.csv |
attributes.csv |
choice_set.csv |
choice_set.csv |
choice_tasks.csv |
choice_tasks.csv |
profiles.csv |
profiles.csv |
settings.csv |
settings.csv |
Car purchase
MSRP vs fuel economy — vehicle configuration trade-offs with share simulation.
Steps
- Download the Car purchase kit.
- Set ratings in profiles.csv for each MSRP/MPG profile.
- Run from Examples or upload your CSVs.
- Review market share on Report.
| File | Download |
|---|---|
attributes.csv |
attributes.csv |
choice_set.csv |
choice_set.csv |
choice_tasks.csv |
choice_tasks.csv |
profiles.csv |
profiles.csv |
settings.csv |
settings.csv |
Laptop purchase
5 attributes (brand, form factor, RAM, screen, storage) — 32-profile ratings study.
Steps
- Download profiles.csv, attributes.csv, and catalog.csv.
- Edit ratings per laptop configuration in profiles.csv.
- Run bundled from Examples or upload via Study files.
- Open Report for utilities and purchase ranking.
| File | Download |
|---|---|
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.
| Column | Meaning | Example |
|---|---|---|
(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.
| Column | Meaning | Example |
|---|---|---|
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.
| Column | Meaning | Example |
|---|---|---|
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.
| Column | Meaning | Example |
|---|---|---|
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.
| Column | Meaning | Example |
|---|---|---|
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).
| Column | Meaning | Example |
|---|---|---|
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 rowname=S1, ticket_price=$1.50, platform_wait=8 min, rating=100 (your commute preference)
Coffee subscription — profiles rowname=S1, monthly_price=$12, delivery_days=Next day, rating=88 (your bundle preference)
Hotel weekend — profiles rowname=S1, nightly_rate=$89, distance_center=5 min walk, rating=72
Streaming plan — profiles rowname=S1, monthly_fee=$7.99, ads_per_hour=No ads, rating=91
Blueberry phones — profiles rowprofile=2, brand=Blueberry, style=Flip, talk_time_h=9, weight_g=115, camera_mp=2, rating=95