https://github.com/crflynn/voting
Diversity / (dis)proportionality measures, election quotas, and apportionment methods in pure Python.
https://github.com/crflynn/voting
apportionment diversity-measures elections voting
Last synced: 10 months ago
JSON representation
Diversity / (dis)proportionality measures, election quotas, and apportionment methods in pure Python.
- Host: GitHub
- URL: https://github.com/crflynn/voting
- Owner: crflynn
- License: mit
- Created: 2018-01-07T01:54:11.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T05:52:17.000Z (over 3 years ago)
- Last Synced: 2025-03-28T23:43:25.507Z (over 1 year ago)
- Topics: apportionment, diversity-measures, elections, voting
- Language: Python
- Homepage: https://voting.readthedocs.io/en/latest/
- Size: 162 KB
- Stars: 15
- Watchers: 3
- Forks: 2
- Open Issues: 14
-
Metadata Files:
- Readme: README.rst
- Changelog: HISTORY.rst
- License: LICENSE.txt
Awesome Lists containing this project
README
voting
======
|travis| |rtd| |codecov| |pypi| |pyversions|
.. |travis| image:: https://img.shields.io/travis/crflynn/voting.svg
:target: https://travis-ci.org/crflynn/voting
.. |rtd| image:: https://img.shields.io/readthedocs/voting.svg
:target: http://voting.readthedocs.io/en/latest/
.. |codecov| image:: https://codecov.io/gh/crflynn/voting/branch/master/graphs/badge.svg
:target: https://codecov.io/gh/crflynn/voting
.. |pypi| image:: https://img.shields.io/pypi/v/voting.svg
:target: https://pypi.python.org/pypi/voting
.. |pyversions| image:: https://img.shields.io/pypi/pyversions/voting.svg
:target: https://pypi.python.org/pypi/voting
A pure Python module for election quotas, voting measures, and apportionment
methods.
Installation
------------
The ``voting`` package works in Python 2.7, 3.5, 3.6 and 3.7. It is available on
pypi and can be installed using pip.
.. code-block:: shell
pip install voting
Package structure
-----------------
* voting
* apportionment
* adams
* dhondt
* hagenbach_bischoff
* hamilton
* huntington_hill
* jefferson
* sainte_lague
* vinton
* webster
* diversity
* berger_parker
* general
* gini_simpson
* golosov
* inverse_simpson
* laakso_taagepera
* renyi
* shannon
* simpson
* proportion
* adjusted_loosemore_hanby
* dhondt
* gallagher
* grofman
* least_square
* lijphart
* loosemore_hanby
* rae
* regression
* rose
* sainte_lague
* quota
* droop
* hagenbach_bischoff
* hare
* imperiali
Examples
--------
Apportioning seats using the Huntington-Hill method.
.. code-block:: python
from voting import apportionment
votes = [2560, 3315, 995, 5012]
seats = 20
assignments = apportionment.huntington_hill(votes, seats)
Calculating the effective number of parties using Golosov's measure.
.. code-block:: python
from voting import diversity
parties = [750, 150, 50, 50]
effective_parties = diversity.golosov(parties)
Measuring the disproportionality of democratic representation using the
Sainte-Lague measure.
.. code-block:: python
from voting import proportion
votes = [750, 150, 50, 50]
seats = [80, 16, 2, 2]
disproportionality = proportion.sainte_lague(votes, seats)
Determining the Droop quota
.. code-block:: python
from voting import quota
votes = 1000
seats = 20
election_quota = quota.droop(votes, seats)