beatpath 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2a3814f16d34b25057e169e19a0d389039b27f14
+  data.tar.gz: cac724e3ee0104f529936cfb4da331705d5790c2
+SHA512:
+  metadata.gz: 4275c9c37e92c67dbdf5bb973c13d906b99b6f199ed4a8397650c46def621e081e5657f2a1d875cefa1ad481503ad3e784b6b80f91cd0960a4f5033b5820b238
+  data.tar.gz: 7776cd3a9197c4fab90513058afdd266e5e1f7063dbfbc0fe3f05769fe8ca10d244ce6cd8d1404c955d33d82cdebbd39d08204a2a1b5b048518f12c82bdd0e55

data/.gitignore

@@ -0,0 +1,19 @@
+.DS_Store
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.swp

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,218 @@
+AllCops:
+  Exclude:
+    - .git/**/*
+    - tmp/**/*
+
+Lint/DuplicateMethods:
+  Enabled: true
+
+Lint/DeprecatedClassMethods:
+  Enabled: true
+
+Style/TrailingWhitespace:
+  Enabled: true
+
+Style/Tab:
+  Enabled: true
+
+Style/TrailingBlankLines:
+  Enabled: true
+
+Style/NilComparison:
+  Enabled: true
+
+Style/NonNilCheck:
+  Enabled: true
+
+Style/Not:
+  Enabled: true
+
+Style/RedundantReturn:
+  Enabled: true
+
+Style/ClassCheck:
+  Enabled: true
+
+Style/EmptyLines:
+  Enabled: true
+
+Style/EmptyLiteral:
+  Enabled: true
+
+Style/Alias:
+  Enabled: true
+
+Style/MethodCallParentheses:
+  Enabled: true
+
+Style/MethodDefParentheses:
+  Enabled: true
+
+Style/SpaceBeforeBlockBraces:
+  Enabled: true
+
+Style/SpaceInsideBlockBraces:
+  Enabled: true
+
+Style/SpaceInsideParens:
+  Enabled: true
+
+Style/DeprecatedHashMethods:
+  Enabled: true
+
+Style/HashSyntax:
+  Enabled: true
+
+Style/SpaceInsideHashLiteralBraces:
+  Enabled: true
+  EnforcedStyle: no_space
+
+Style/SpaceInsideBrackets:
+  Enabled: true
+
+Style/AndOr:
+  Enabled: false
+
+Style/TrailingCommaInLiteral:
+  Enabled: true
+
+Style/SpaceBeforeComma:
+  Enabled: true
+
+Style/SpaceBeforeComment:
+  Enabled: true
+
+Style/SpaceBeforeSemicolon:
+  Enabled: true
+
+Style/SpaceAroundBlockParameters:
+  Enabled: true
+
+Style/SpaceAroundOperators:
+  Enabled: true
+
+Style/SpaceAfterColon:
+  Enabled: true
+
+Style/SpaceAfterComma:
+  Enabled: true
+
+Style/SpaceAroundKeyword:
+  Enabled: true
+
+Style/SpaceAfterNot:
+  Enabled: true
+
+Style/SpaceAfterSemicolon:
+  Enabled: true
+
+Lint/UselessComparison:
+  Enabled: true
+
+Lint/InvalidCharacterLiteral:
+  Enabled: true
+
+Lint/LiteralInInterpolation:
+  Enabled: true
+
+Lint/LiteralInCondition:
+  Enabled: true
+
+Lint/UnusedBlockArgument:
+  Enabled: true
+
+Style/VariableInterpolation:
+  Enabled: true
+
+Style/RedundantSelf:
+  Enabled: true
+
+Style/ParenthesesAroundCondition:
+  Enabled: true
+
+Style/WhileUntilDo:
+  Enabled: true
+
+Style/EmptyLineBetweenDefs:
+  Enabled: true
+
+Style/EmptyLinesAroundAccessModifier:
+  Enabled: true
+
+Style/EmptyLinesAroundMethodBody:
+  Enabled: true
+
+Style/ColonMethodCall:
+  Enabled: true
+
+Lint/SpaceBeforeFirstArg:
+  Enabled: true
+
+Lint/UnreachableCode:
+  Enabled: true
+
+Style/UnlessElse:
+  Enabled: true
+
+Style/ClassVars:
+  Enabled: true
+
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Metrics/CyclomaticComplexity:
+  Max: 10
+
+Metrics/LineLength:
+  Max: 128
+
+Metrics/MethodLength:
+  Max: 32
+
+Metrics/PerceivedComplexity:
+  Max: 8
+
+# Disabled
+
+Style/EvenOdd:
+  Enabled: false
+
+Style/AsciiComments:
+  Enabled: false
+
+Style/NumericLiterals:
+  Enabled: false
+
+Style/UnneededPercentQ:
+  Enabled: false
+
+Style/SpecialGlobalVars:
+  Enabled: false
+
+Style/TrivialAccessors:
+  Enabled: false
+
+Style/PerlBackrefs:
+  Enabled: false
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/BlockNesting:
+  Enabled: false
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/ParameterLists:
+  Enabled: false
+
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.2
+before_install: gem install bundler -v 1.13.6

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in beatpath.gemspec
+gemspec

data/README.md

@@ -0,0 +1,48 @@
+# Beatpath
+
+Ruby implementation of the Schulze voting method (https://en.wikipedia.org/wiki/Schulze_method).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem "beatpath"
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install beatpath
+
+## Usage
+
+```ruby
+# expected input is an array of arrays
+ballots = [
+  [55, 34, 56, 76], # each array is a ballot with candidate IDs, in ranked order
+                    # so, this ballot implies that they preferred candidate ID 55 first, then
+                    # candidate ID 34 second
+                    # the candidate ID can be any unique object (symbol, AR record, etc.)
+  [55, 56, 76, 34],
+  [76, 55, 56, 34],
+  [55, 56, 76, 34]
+]
+
+winners = Beatpath::Vote.new(ballots).winners
+# [55, 56, 76, 34] means that candidate ID 55 is in first place, 56 is in second place, 76 in third, and 34 is last
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/nickelser/beatpath.
+

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/beatpath.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "beatpath/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "beatpath"
+  spec.version       = Beatpath::VERSION
+  spec.authors       = ["Nick Elser"]
+  spec.email         = ["nick.elser@gmail.com"]
+
+  spec.summary       = %q{Schulze (Condorcet) voting calculation.}
+  spec.homepage      = "https://github.com/nickelser/beatpath"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.13"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "beatpath"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/beatpath.rb

@@ -0,0 +1,14 @@
+require "beatpath/version"
+require "beatpath/vote_matrix"
+
+module Beatpath
+  class Vote
+    attr_reader :pairwise_matrix, :strongest_paths, :winners
+
+    def initialize(ballots, candidates = nil)
+      @pairwise_matrix = VoteMatrix.pairwise_from_ballots(ballots, candidates)
+      @strongest_paths = @pairwise_matrix.floyd_warshall
+      @winners = @strongest_paths.winners
+    end
+  end
+end

data/lib/beatpath/version.rb

@@ -0,0 +1,3 @@
+module Beatpath
+  VERSION = "0.1.0"
+end

data/lib/beatpath/vote_matrix.rb

@@ -0,0 +1,124 @@
+require "matrix"
+require "set"
+
+module Beatpath
+  class VoteMatrix < ::Matrix
+    # why?
+    public :"[]=", :set_element, :set_component
+    attr_accessor :vote_candidates
+
+    def self.zero_with_candidates(candidates = [])
+      zeroed = zero(candidates.size)
+      zeroed.vote_candidates = candidates
+      zeroed
+    end
+
+    def self.pairwise_from_ballots(ballots, candidates = nil)
+      if candidates.nil?
+        candidates = SortedSet.new
+
+        # compute distinct candidates
+        ballots.each do |b|
+          candidates += b
+        end
+
+        candidates = candidates.to_a
+      end
+
+      d = zero_with_candidates(candidates)
+
+      # compute pairwise rankings from all ballots
+      ballots.each do |b|
+        # for each ballot, compute which candidates were not voted on
+        unvoted_candidates = candidates - b
+
+        # for each candidate on the given ballot
+        b.each_with_index do |c1, idx|
+          # compute our internal mapping of the candidate
+          c1_idx = candidates.find_index(c1)
+
+          # for each candidate, c2, that follows this candidate in order of preference,
+          # mark c1 as pairwise better than c2
+          b[(idx + 1)..-1].each do |c2|
+            d[c1_idx, candidates.find_index(c2)] += 1
+          end
+
+          # candidates not mentioned on this ballot are always strictly worse
+          # than the candidates on the ballot (c1)
+          unvoted_candidates.each do |c2|
+            d[c1_idx, candidates.find_index(c2)] += 1
+          end
+        end
+      end
+
+      d
+    end
+
+    # https://en.wikipedia.org/wiki/Schulze_method
+    # Input: self[i,j], the number of voters who prefer candidate i to candidate j.
+    # Output: p[i,j], the strength of the strongest path from candidate i to candidate j.
+    def floyd_warshall
+      p = VoteMatrix.zero_with_candidates(vote_candidates)
+
+      # for i from 1 to C
+      #    for j from 1 to C
+      #       if (i ≠ j) then
+      #          if (d[i,j] > d[j,i]) then
+      #             p[i,j] := d[i,j]
+      #          else
+      #             p[i,j] := 0
+      row_count.times do |i|
+        row_count.times do |j|
+          next if i == j
+
+          if self[i, j] > self[j, i]
+            p[i, j] = self[i, j]
+          else
+            p[i, j] = 0
+          end
+        end
+      end
+
+      # for i from 1 to C
+      #    for j from 1 to C
+      #       if (i ≠ j) then
+      #          for k from 1 to C
+      #             if (i ≠ k and j ≠ k) then
+      #                p[j,k] := max ( p[j,k], min ( p[j,i], p[i,k] )
+      row_count.times do |i|
+        row_count.times do |j|
+          next if i == j
+
+          row_count.times do |k|
+            next if i == k || j == k
+
+            p[j, k] = [p[j, k], [p[j, i], p[i, k]].min].max
+          end
+        end
+      end
+
+      p
+    end
+
+    def winners
+      results = VoteMatrix.zero_with_candidates(vote_candidates)
+
+      # compute which candidate has the strongest path
+      row_count.times do |i|
+        row_count.times do |j|
+          next if i == j
+
+          # candidate i is strictly better than j if the strongest path goes through i
+          results[i, j] += 1 if self[i, j] > self[j, i]
+        end
+      end
+
+      # and finally compute the final ordering of the candidates
+      results = Hash[results.row_vectors.each_with_index.map do |r, i|
+        [vote_candidates[i], r.inject(:+)]
+      end]
+
+      results.sort_by { |_, v| v }.map(&:first).reverse
+    end
+  end
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: beatpath
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nick Elser
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-04-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: 
+email:
+- nick.elser@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- Gemfile
+- README.md
+- Rakefile
+- beatpath.gemspec
+- bin/console
+- bin/setup
+- lib/beatpath.rb
+- lib/beatpath/version.rb
+- lib/beatpath/vote_matrix.rb
+homepage: https://github.com/nickelser/beatpath
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2
+signing_key: 
+specification_version: 4
+summary: Schulze (Condorcet) voting calculation.
+test_files: []