An election is run on the geometry to generate output data structures. It handles casting votes and applying a social choice function.

• Parent Pages: Architecture, SimMode
• Subpages: VoteCasters, SocialChoice, ElectionSampler

Election

Election runs one of two election functions: electionRun or districtElection.

The function districtElection compiles district and statewide votes and results.

Election may be called by ElectionSampler to run multiple elections.

Steps:

• If there is a geography, then the geometry is run in several tracts, each with slight variations in political geometry.
• VoteCasters: Votes are cast.
• If there is a geography, then votes from tracts are combined into districts.
• A social choice function runs on the votes to determine winners.
• Election results are assembled.
• All the options, geometry, votes, and social choice outputs are combined into an electionResults data structure.

Election Results

The election results are all the data you need for making explanations. They are output by the election step in the sim. They are input for the visualizers. They are composed of several parts:

• electionOptions
• geometry
• votes - see VoteCasters for more explanation.
  • preferencesLists
  • preferenceTallies
  • candidateTallies
  • pairwiseTallies
  • votesByGeom
  • parties
• socialChoiceResults
  • iWinner or allocation
• colorRGBAofCandidates
• error
  • An error message string or undefined.
• future
  • simOptions
  • voter labels
  • candidate labels

The districtElectionResults have additional variables by tract and district.

• votesByTract
• votesByDistrict
• scResultsByDistrict