# Single-race demo exercising EVERY supported field and `options:` flag.
# Run:  python STARVote_LH_tabulation_engine/starvote_larry_hastings.py \
#         "01_STAR/02_Examples/cases/04b_c4_b3_display-options-all.yaml"

# election_title + scenario_description print as a header above the results.
election_title: All options demo
scenario_description: |-
  Reference example that sets every supported field and display option, so you
  can see exactly what each one does. Single-winner STAR over four candidates;
  the finalists-only matrix, Condorcet line, and score distribution are all on.

num_winners: 1        # 1 = single-winner STAR; >=2 requires voting_method: bloc
voting_method: STAR   # STAR (single winner) or bloc (multi-winner Bloc STAR)

options:
  show_description: false   # clean demo: description stays in the file (+_tabulated), hidden on screen
  # --- Preference (head-to-head) matrix ---
  show_matrix: true            # show the Runoff (Preference) Matrix
  matrix_finalists_only: true  # true = only the 2 finalists (decisive matchup);
                               # false = full N×N grid. Requires show_matrix.

  # --- Analyses ---
  show_condorcet: true     # show the [Condorcet Winner] line
  show_score_counts: true  # show the per-candidate [Score Distribution] table

  # --- Output style ---
  brief: true              # true = collapse repetitive "[STAR Voting: ...]" headers
                           # into plain sub-headings; false = keep full headers
  collapse_ballots: true   # true = group identical ballots as "count <sep> scores"
                           # (most common first); false = show every ballot
  count_separator: "×"     # separator for the collapsed count: "×", ":", or "x"/"X"
                           # (all round-trip back to valid input)

ballots: |-
  Choco,Almond,Vanilla,Strawberry
       0,     2,     3,         5
       0,     2,     3,         5
       0,     2,     5,         3

expected_winners:
  - Strawberry

# file: 04b_c4_b3_display-options-all.yaml