/* OpenTally: Open-source election vote counting * Copyright © 2021 Lee Yingtong Li (RunasSudo) * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Affero General Public License for more details. * * You should have received a copy of the GNU Affero General Public License * along with this program. If not, see . */ use opentally::stv; use opentally::election::{Candidate, CandidateState, CountCard, CountState, CountStateOrRef, Election, StageResult}; use opentally::numbers::{Fixed, GuardedFixed, NativeFloat64, Number, Rational}; use clap::{AppSettings, Clap}; use std::fs::File; use std::io::{self, BufRead}; use std::ops; /// Open-source election vote counting #[derive(Clap)] #[clap(name="OpenTally", version=opentally::VERSION)] struct Opts { #[clap(subcommand)] command: Command, } #[derive(Clap)] enum Command { STV(STV), } /// Count a single transferable vote (STV) election #[derive(Clap)] #[clap(setting=AppSettings::DeriveDisplayOrder)] struct STV { // ---------------- // -- File input -- /// Path to the BLT file to be counted filename: String, // ---------------------- // -- Numbers settings -- /// Numbers mode #[clap(help_heading=Some("NUMBERS"), short, long, possible_values=&["rational", "fixed", "gfixed", "float64"], default_value="rational", value_name="mode")] numbers: String, /// Decimal places if --numbers fixed #[clap(help_heading=Some("NUMBERS"), long, default_value="5", value_name="dps")] decimals: usize, /// Convert ballots with value >1 to multiple ballots of value 1 #[clap(help_heading=Some("NUMBERS"), long)] normalise_ballots: bool, // ----------------------- // -- Rounding settings -- /// Round transfer values to specified decimal places #[clap(help_heading=Some("ROUNDING"), long, value_name="dps")] round_tvs: Option, /// Round ballot weights to specified decimal places #[clap(help_heading=Some("ROUNDING"), long, value_name="dps")] round_weights: Option, /// Round votes to specified decimal places #[clap(help_heading=Some("ROUNDING"), long, value_name="dps")] round_votes: Option, /// Round quota to specified decimal places #[clap(help_heading=Some("ROUNDING"), long, value_name="dps")] round_quota: Option, /// How to calculate votes to credit to candidates in surplus transfers #[clap(help_heading=Some("ROUNDING"), long, possible_values=&["single_step", "by_value", "per_ballot"], default_value="single_step", value_name="mode")] sum_surplus_transfers: String, // ----------- // -- Quota -- /// Quota type #[clap(help_heading=Some("QUOTA"), short, long, possible_values=&["droop", "hare", "droop_exact", "hare_exact"], default_value="droop_exact")] quota: String, /// Whether to elect candidates on meeting (geq) or strictly exceeding (gt) the quota #[clap(help_heading=Some("QUOTA"), short='c', long, possible_values=&["geq", "gt"], default_value="gt", value_name="criterion")] quota_criterion: String, /// Whether to apply a form of progressive quota #[clap(help_heading=Some("QUOTA"), long, possible_values=&["static", "ers97"], default_value="static", value_name="mode")] quota_mode: String, // ------------------ // -- STV variants -- /// Tie-breaking method #[clap(help_heading=Some("STV VARIANTS"), short='t', long, possible_values=&["forwards", "backwards", "random", "prompt"], default_value="prompt", value_name="methods")] ties: Vec, /// Random seed to use with --ties random #[clap(help_heading=Some("STV VARIANTS"), long, value_name="seed")] random_seed: Option, /// Method of surplus distributions #[clap(help_heading=Some("STV VARIANTS"), short='s', long, possible_values=&["wig", "uig", "eg", "meek"], default_value="wig", value_name="method")] surplus: String, /// Order to distribute surpluses #[clap(help_heading=Some("STV VARIANTS"), long, possible_values=&["by_size", "by_order"], default_value="by_size", value_name="order")] surplus_order: String, /// Examine only transferable papers during surplus distributions #[clap(help_heading=Some("STV VARIANTS"), long)] transferable_only: bool, /// Method of exclusions #[clap(help_heading=Some("STV VARIANTS"), long, possible_values=&["single_stage", "by_value", "parcels_by_order"], default_value="single_stage", value_name="method")] exclusion: String, // ------------------------- // -- Count optimisations -- /// Use bulk exclusion #[clap(help_heading=Some("COUNT OPTIMISATIONS"), long)] bulk_exclude: bool, /// Defer surplus distributions if possible #[clap(help_heading=Some("COUNT OPTIMISATIONS"), long)] defer_surpluses: bool, // ---------------------- // -- Display settings -- /// Hide excluded candidates from results report #[clap(help_heading=Some("DISPLAY"), long)] hide_excluded: bool, /// Sort candidates by votes in results report #[clap(help_heading=Some("DISPLAY"), long)] sort_votes: bool, /// Print votes to specified decimal places in results report #[clap(help_heading=Some("DISPLAY"), long, default_value="2", value_name="dps")] pp_decimals: usize, } fn main() { // Read arguments let opts: Opts = Opts::parse(); let Command::STV(cmd_opts) = opts.command; // Read BLT file let file = File::open(&cmd_opts.filename).expect("IO Error"); let lines = io::BufReader::new(file).lines(); // Create and count election according to --numbers if cmd_opts.numbers == "rational" { let election: Election = Election::from_blt(lines.map(|r| r.expect("IO Error").to_string()).into_iter()); count_election(election, cmd_opts); } else if cmd_opts.numbers == "float64" { let election: Election = Election::from_blt(lines.map(|r| r.expect("IO Error").to_string()).into_iter()); count_election(election, cmd_opts); } else if cmd_opts.numbers == "fixed" { Fixed::set_dps(cmd_opts.decimals); let election: Election = Election::from_blt(lines.map(|r| r.expect("IO Error").to_string()).into_iter()); count_election(election, cmd_opts); } else if cmd_opts.numbers == "gfixed" { GuardedFixed::set_dps(cmd_opts.decimals); let election: Election = Election::from_blt(lines.map(|r| r.expect("IO Error").to_string()).into_iter()); count_election(election, cmd_opts); } } fn count_election(mut election: Election, cmd_opts: STV) where for<'r> &'r N: ops::Sub<&'r N, Output=N>, for<'r> &'r N: ops::Div<&'r N, Output=N>, for<'r> &'r N: ops::Neg { // Copy applicable options let stv_opts = stv::STVOptions::new( cmd_opts.round_tvs, cmd_opts.round_weights, cmd_opts.round_votes, cmd_opts.round_quota, &cmd_opts.sum_surplus_transfers, cmd_opts.normalise_ballots, &cmd_opts.quota, &cmd_opts.quota_criterion, &cmd_opts.quota_mode, &cmd_opts.ties, &cmd_opts.random_seed, &cmd_opts.surplus, &cmd_opts.surplus_order, cmd_opts.transferable_only, &cmd_opts.exclusion, cmd_opts.bulk_exclude, cmd_opts.defer_surpluses, cmd_opts.pp_decimals, ); // Describe count let total_ballots = election.ballots.iter().fold(N::zero(), |acc, b| { acc + &b.orig_value }); print!("Count computed by OpenTally (revision {}). Read {:.0} ballots from \"{}\" for election \"{}\". There are {} candidates for {} vacancies. ", opentally::VERSION, total_ballots, cmd_opts.filename, election.name, election.candidates.len(), election.seats); let opts_str = stv_opts.describe::(); if opts_str.len() > 0 { println!("Counting using options \"{}\".", opts_str); } else { println!("Counting using default options."); } println!(); // Normalise ballots if requested if cmd_opts.normalise_ballots { election.normalise_ballots(); } // Initialise count state let mut state = CountState::new(&election); // Distribute first preferences stv::count_init(&mut state, &stv_opts); let mut stage_num = 1; make_and_print_result(stage_num, &state, &cmd_opts); loop { let is_done = stv::count_one_stage(&mut state, &stv_opts); if is_done.unwrap() { break; } stage_num += 1; make_and_print_result(stage_num, &state, &cmd_opts); } println!("Count complete. The winning candidates are, in order of election:"); let mut winners = Vec::new(); for (candidate, count_card) in state.candidates.iter() { if count_card.state == CandidateState::Elected { winners.push((candidate, count_card.order_elected)); } } winners.sort_unstable_by(|a, b| a.1.partial_cmp(&b.1).unwrap()); for (i, (winner, _)) in winners.into_iter().enumerate() { println!("{}. {}", i + 1, winner.name); } } fn print_candidates<'a, N: 'a + Number, I: Iterator)>>(candidates: I, cmd_opts: &STV) { for (candidate, count_card) in candidates { if count_card.state == CandidateState::Elected { println!("- {}: {:.dps$} ({:.dps$}) - ELECTED {}", candidate.name, count_card.votes, count_card.transfers, count_card.order_elected, dps=cmd_opts.pp_decimals); } else if count_card.state == CandidateState::Excluded { // If --hide-excluded, hide unless nonzero votes or nonzero transfers if !cmd_opts.hide_excluded || !count_card.votes.is_zero() || !count_card.transfers.is_zero() { println!("- {}: {:.dps$} ({:.dps$}) - Excluded {}", candidate.name, count_card.votes, count_card.transfers, -count_card.order_elected, dps=cmd_opts.pp_decimals); } } else if count_card.state == CandidateState::Withdrawn { if !cmd_opts.hide_excluded || !count_card.votes.is_zero() || !count_card.transfers.is_zero() { println!("- {}: {:.dps$} ({:.dps$}) - Withdrawn", candidate.name, count_card.votes, count_card.transfers, dps=cmd_opts.pp_decimals); } } else { println!("- {}: {:.dps$} ({:.dps$})", candidate.name, count_card.votes, count_card.transfers, dps=cmd_opts.pp_decimals); } } } fn print_stage(stage_num: usize, result: &StageResult, cmd_opts: &STV) { // Print stage details match result.kind { None => { println!("{}. {}", stage_num, result.title); } Some(kind) => { println!("{}. {} {}", stage_num, kind, result.title); } }; println!("{}", result.logs.join(" ")); let state = result.state.as_ref(); // Print candidates if cmd_opts.sort_votes { // Sort by votes if requested let mut candidates: Vec<(&Candidate, &CountCard)> = state.candidates.iter() .map(|(c, cc)| (*c, cc)).collect(); // First sort by order of election (as a tie-breaker, if votes are equal) candidates.sort_unstable_by(|a, b| b.1.order_elected.partial_cmp(&a.1.order_elected).unwrap()); // Then sort by votes candidates.sort_by(|a, b| a.1.votes.partial_cmp(&b.1.votes).unwrap()); print_candidates(candidates.into_iter().rev(), cmd_opts); } else { let candidates = state.election.candidates.iter() .map(|c| (c, state.candidates.get(c).unwrap())); print_candidates(candidates, cmd_opts); } // Print summary rows println!("Exhausted: {:.dps$} ({:.dps$})", state.exhausted.votes, state.exhausted.transfers, dps=cmd_opts.pp_decimals); println!("Loss by fraction: {:.dps$} ({:.dps$})", state.loss_fraction.votes, state.loss_fraction.transfers, dps=cmd_opts.pp_decimals); let mut total_vote = state.candidates.values().fold(N::zero(), |acc, cc| { acc + &cc.votes }); total_vote += &state.exhausted.votes; total_vote += &state.loss_fraction.votes; println!("Total votes: {:.dps$}", total_vote, dps=cmd_opts.pp_decimals); println!("Quota: {:.dps$}", state.quota.as_ref().unwrap(), dps=cmd_opts.pp_decimals); if cmd_opts.quota_mode == "ers97" { println!("Vote required for election: {:.dps$}", state.vote_required_election.as_ref().unwrap(), dps=cmd_opts.pp_decimals); } println!(""); } fn make_and_print_result(stage_num: usize, state: &CountState, cmd_opts: &STV) { let result = StageResult { kind: state.kind, title: &state.title, logs: state.logger.render(), state: CountStateOrRef::from(&state), }; print_stage(stage_num, &result, &cmd_opts); }