STV Results Visualization

View animated round-by-round results of STV elections.

Load Election Data

Select a previous Icenian senate election or import a custom RCVis-format JSON file from the STV Calculator.

How to Use

  1. Select a previous Icenian senate election from the dropdown menu above, or
  2. Go to the STV Calculator to run your own election.
  3. Click "Export for RCVis" to download the results JSON file.
  4. Return here and upload that file to see the animated visualization.

Expected File Format

The visualization expects RCVis-compatible JSON with this structure:

{
  "config": {
    "contest": "Election Name",
    "date": "2025-01-09",
    "threshold": "5.000"
  },
  "results": [
    {
      "round": 1,
      "tally": {
        "Alice": "10.000",
        "Bob": "8.000",
        "Carol": "6.000"
      },
      "tallyResults": [...]
    }
  ]
}

🗳️ Faction & Similarity Analysis

Analyze political factions and candidate similarities based on raw ballot data. This reveals which candidates share voter bases and how votes would flow between them.

Load Raw Election Data

Import the raw STV election JSON file (with ballots) from the STV Calculator.

About This Analysis

This tool analyzes raw ballot data to reveal political factions and candidate relationships. Unlike the RCVis visualization above (which shows round-by-round results), this analysis examines the underlying voter preferences directly.

What You'll Learn:

  • Vote Transfer Network: Who are natural coalition partners?
  • Similarity Heatmap: Which candidates have overlapping or opposing voter bases?
  • Political Map: Where do candidates sit in "political space"?

Required File Format:

This requires the raw STV election JSON with ballot data:

{
  "candidates": ["Alice", "Bob", "Carol"],
  "ballots": [
    { "voter": "voter1", "rankings": ["Alice", "Carol", "Bob"] },
    { "voter": "voter2", "rankings": ["Bob", "Alice"] }
  ],
  "nameMatches": { ... }  // Optional: for name normalization
}