org.bolson.vote
Class Bucklin

java.lang.Object
  org.bolson.vote.VotingSystem
      org.bolson.vote.RankedVotingSystem
          org.bolson.vote.Bucklin

All Implemented Interfaces:

java.io.Serializable

public class Bucklin
extends RankedVotingSystem

Bucklin election method. May be mathematically flawed, and is as computationally inconvenient as IRV.

See Also:

Serialized Form

Field Summary

protected java.util.Vector

votes

Fields inherited from class org.bolson.vote.VotingSystem

debug, NO_VOTE, numc

Constructor Summary

Bucklin(int numCandidates)

Method Summary

int[]	getWinners() Do processing if necessary, return winners.
java.lang.String	htmlSummary(java.lang.String[] names) A fancy html representation.
VotingSystem	init(java.lang.String[] argv) Arguments to modify behavior of VotingSystem
java.lang.String	name() Return name of this voting system.
java.lang.String	toString()
java.lang.String	toString(java.lang.String[] names) A more interesting representation.
int	voteRanking(int[] ranking)

Methods inherited from class org.bolson.vote.RankedVotingSystem

voteRating, voteRating, voteRating

Methods inherited from class org.bolson.vote.VotingSystem

checkRatedVote, getDebugHTML, getDebugText, getNumberOfCandidates, getWinners, getWinners, getWinners, isValidRankedVote, isValidRatedVote, normalize, normalize, normalize, normalize, normalize, normalizeL2, normalizeL2, normalizeL2, normalizeL2, normalizeL2, stretch, voteRating

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

votes

protected java.util.Vector votes

Constructor Detail

Bucklin

public Bucklin(int numCandidates)

Method Detail

init

public VotingSystem init(java.lang.String[] argv)

Description copied from class: VotingSystem

Arguments to modify behavior of VotingSystem

Overrides:

init in class VotingSystem

Returns:

this so that you can do

vs = (new VS(numc)).init( new String[]{"blah", "grunt"} );

name

public java.lang.String name()

Description copied from class: VotingSystem

Return name of this voting system. This is a function so that it can potentially construct a detailed name based on options set in init().

Overrides:

name in class VotingSystem

Returns:

a descriptive name

voteRanking

public int voteRanking(int[] ranking)

Specified by:

voteRanking in class VotingSystem

Parameters:

ranking - An array int[N]. ranking[i] is the ranking of choice i. rankings are 1 (most preferred) through N (least). INT_MAX, N, or NO_VOTE for unspecified.

Returns:

0 on success

getWinners

public int[] getWinners()

Description copied from class: VotingSystem

Do processing if necessary, return winners.

It is recommended to cache the return value in such a way that calling this function again does not do complex recalculation. That cache should be cleared if voteRating or voteRanking is called.

Specified by:

getWinners in class VotingSystem

Returns:

indecies of winners (hopefully 1 of them)

htmlSummary

public java.lang.String htmlSummary(java.lang.String[] names)

Description copied from class: VotingSystem

A fancy html representation. Include the names of the choices voted upon in the representation.

Specified by:

htmlSummary in class VotingSystem

Parameters:

names - The names of the choices. May be null.

Returns:

state, with names!

toString

public java.lang.String toString(java.lang.String[] names)

Description copied from class: VotingSystem

A more interesting representation. Include the names of the choices voted upon in the representation.

Specified by:

toString in class VotingSystem

Parameters:

names - The names of the choices.

Returns:

state, with names!

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object