======================================================================
SOURCE FILE:     02b_c3_b2_three-candidates.yaml
TABULATED FILE:  02b_c3_b2_three-candidates_tabulated.txt
======================================================================

election_title: Three candidates, two ballots - single-winner STAR
scenario_description: |-
  Election: Pick your favorite ice cream flavor. Two voters (two ballots).
  Same as before, but now we add a second ballot from David.

  David:
  - He likes Vanilla best (5 stars)
  - He quite likes Almond (4 stars)
  - He dislikes Choco (0 stars)

  Watch the winner change. Choco flavor candidate is polarizing (Caroline 5, David 0), while
  Vanilla has broad support (Caroline 3, David 5) - so Vanilla now wins. 
  STAR rewards the broadly-liked compromise over a candidate that half the voters reject.

voting_method: STAR   # STAR Voting - Single-winner
num_winners: 1
ballots: |-
  Choco,Vanilla,Almond
      5,      3,     0 # Caroline likes Choco (5) and Vanilla (3)
      0,      5,     4 # David likes Vanilla (5) best and Almond (4)

expected_winners:
  - Vanilla

# file: 02b_c3_b2_three-candidates.yaml

======================================================================
TABULATION RESULTS
======================================================================

=== Three candidates, two ballots - single-winner STAR ===
  Election: Pick your favorite ice cream flavor. Two voters (two ballots).
  Same as before, but now we add a second ballot from David.

  David:
  - He likes Vanilla best (5 stars)
  - He quite likes Almond (4 stars)
  - He dislikes Choco (0 stars)

  Watch the winner change. Choco flavor candidate is polarizing (Caroline 5, David 0), while
  Vanilla has broad support (Caroline 3, David 5) - so Vanilla now wins. 
  STAR rewards the broadly-liked compromise over a candidate that half the voters reject.

--- Runoff (Preference) Matrix ---
Head-to-head / pairwise comparison
Legend: For - Equal Support - Against
        * indicates Top 2 Finalist
                |   * Choco   | * Vanilla  |   Almond   |
---------------------------------------------------------
      * Choco > |     ---     | 1 - 0 - 1  | 1 - 0 - 1  |
    * Vanilla > |  1 - 0 - 1  |    ---     | 2 - 0 - 0  |
       Almond > |  1 - 0 - 1  | 0 - 0 - 2  |    ---     |

[Condorcet Winner]
  No strict Condorcet winner; unbeaten candidates: Choco, Vanilla (pairwise ties)

[Condorcet Loser]
  No strict Condorcet loser; jointly weak Condorcet losers: Choco, Almond (winless — pairwise ties) — Choco elected by Choose-One (Plurality)!

[Divergence from STAR]
  STAR                   = Vanilla
  Choose-One (Plurality) = Choco   (differs from STAR)

--- STAR Voting Method (single winner) ---
[STAR Voting]
 Tabulating 2 ballots.
Choco,Vanilla,Almond
    5,      3,     0
    0,      5,     4

[Score Distribution] (how many ballots gave each star rating)
                Score
Candidate  5  4  3  2  1  0  | Total   Avg
Choco      1  0  0  0  0  1  |     5   2.5
Vanilla    1  0  1  0  0  0  |     8   4.0
Almond     0  1  0  0  0  1  |     4   2.0

[STAR Voting: Scoring Round]
 The two highest-scoring candidates advance to the next round.
   Vanilla       -- 8 -- First place
   Choco         -- 5 -- Second place
   Almond        -- 4
 Vanilla and Choco advance.

[STAR Voting: Automatic Runoff Round]
 The candidate preferred in the most head-to-head matchups wins.
   Choco         -- 1 -- Tied for first place
   Vanilla       -- 1 -- Tied for first place
   Equal Support -- 0
 There's a two-way tie for first.

[STAR Voting: Automatic Runoff Round: First tiebreaker]
 The highest-scoring candidate wins.
   Vanilla       -- 8 -- First place
   Choco         -- 5
 Vanilla wins.

[STAR Voting: Winner — STAR Voting Method (single winner)]
 Vanilla