search

voting-tools / pref_voting

pref_voting is a Python package that can be used to study and run elections with different preferential voting methods (graded voting methods and cardinal voting methods are also included for comparison).
https://pref-voting.readthedocs.io/
MIT License
11 stars 4 forks source link

Less ambiguous names #100

Closed ParadaCarleton closed 1 month ago

ParadaCarleton commented 4 months ago

A couple of the function names threw me off when I tried using them—

  1. Majority winner has also been used to mean Condorcet winner, which could cause some confusion. I've heard this called the Woodall winner or Woodall favorite in the past (since the name seems to be a reference to Woodall's majority criterion, rather than Condorcet's).
  2. The specific definition of "spoiler" threw me off quite a bit, since I've always heard it associated with IIA violations. I believe this is the original definition from sports, where it means a weak team—one with no chance of making it into the playoffs—spoiling another team's chances of making the playoffs (by beating them).
wesholliday commented 4 months ago

Thanks for the feedback!

  1. We changed 'majority' to 'absolute_majority', following Dodgson.

  2. We added a citation for the Immunity to Spoilers axiom (https://doi.org/10.1007/s11127-023-01042-3).