README

# Ballot Clustering Project Code

This repo contains code related to clustering/optimization methods to "learn" blocs and slates from ranked election data.  It contains the following files.

Tutorial.ipynb: start here to learn the toolkit.
Clustering_Functions.py: all of the functions used to cluster and study elections.
scot-elex: folder containing the 1070 Scottish elections
retuls.pkl: a pickled dataframe of the results of running our clustering methods on the Scottish elections.

THE "Supplemental explorations" folder contains ceveral experiments and analysis of the Scottish elections.