From cb97a44b739bda3339ac4484374447f567b0f30c Mon Sep 17 00:00:00 2001 From: RunasSudo Date: Mon, 23 Aug 2021 14:26:39 +1000 Subject: [PATCH] Update documentation --- docs/options.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/docs/options.md b/docs/options.md index 5b42202..a0aabbe 100644 --- a/docs/options.md +++ b/docs/options.md @@ -51,7 +51,7 @@ where *V* is the number of votes and *S* is the number of seats. The ‘*(exact)*’ version of each quota has effect only if *Round quota to [n] d.p.* is enabled. When that setting is enabled, *Droop* and *Hare* will increment the quota up to the next available rounded unit (even if the quotient is exact already), while the ‘*(exact)*’ versions will round the quota up if and only if the quotient is not already exact. -When *Round quota to [n] d.p.* is not enabled, *Droop* (or *Droop (exact)*) is also known as the Newland–Britton or Hagenbach-Bischoff quota. +When *Round quota to [n] d.p.* is not enabled, or when the exact form is used, the Droop quota is also known as the Newland–Britton or Hagenbach-Bischoff quota. ### Quota criterion (-c/--quota-criterion) @@ -110,8 +110,8 @@ The use of a random sample method requires *Normalise ballots* to be enabled, an When *Surplus method* is set to a Gregory method, this option controls how candidates are excluded: * *Single stage* (default): When excluding candidate(s), transfer all their ballot papers in one stage. -* *By value*: When excluding candidate(s), transfer their ballot papers in descending order of accumulated transfer value. Each transfer of all ballots of a certain transfer value forms a separate stage, i.e. if a transfer allows another candidate to meet the quota criterion, no further papers are transferred to that candidate. -* *By source*: When excluding candidate(s), transfer their ballot papers according to the candidate from which those papers were received, in the order received, i.e. in the order the transferring candidates were elected or excluded. Each transfer of all ballots received from a certain candidate forms a separate stage. +* *By value*: When excluding candidate(s), transfer their ballot papers in descending order of accumulated transfer value. Each transfer of all ballots of a certain transfer value forms a separate stage, i.e. if a transfer allows another candidate to meet the quota, no further papers are transferred to that candidate. +* *By source*: When excluding candidate(s), transfer their ballot papers according to the candidate from which those papers were received, in the order the transferring candidates were elected or excluded. Each transfer of all ballots received from a certain candidate forms a separate stage. * *By parcel (by order)*: When excluding a candidate, transfer their ballot papers one parcel at a time, in the order each was received. Each parcel forms a separate stage. This option cannot be combined with bulk exclusion. * *Wright method (re-iterate)*: When excluding candidate(s), reset the count from the distribution of first preferences, disregarding the excluded candidates. @@ -245,7 +245,7 @@ Likewise, when *Surplus method* is set to *Meek method*: ### Minimum threshold (--min-threshold) -In the first stage when candidates are excluded, all candidates with votes less than or equal to this threshold are excluded at once. The default value is 0, i.e. all candidates with no votes are excluded at once. +When candidates are first to be excluded, all candidates with votes less than or equal to this threshold are excluded at once. The default value is 0, i.e. all candidates with no votes are excluded at once. ## Rounding @@ -253,9 +253,9 @@ In the first stage when candidates are excluded, all candidates with votes less When rounding is enabled, the specified values are rounded to the specified number of decimal places. This enables, for example, votes to be counted only in integers, while ballot values and surplus fractions are calculated to higher precision (according to the *Numbers* option). -When enabled, the quota is incremented or rounded up (according to the *Quota* option), whereas votes, surplus fractions and ballot values are always rounded down. +When enabled, the quota is incremented or rounded up (according to the *Quota* option). When *Surplus method* is set to a Gregory method, votes, surplus fractions and ballot values are always rounded down. -In relation to *Round surplus fractions to [n] d.p.* (--round-tvs) – note that surplus fractions are used in STV in calculations of the form *A* × (*B*/*C*), where (*B*/*C*) is the surplus fraction. The order of operations depends on this setting: +In relation to *Round surplus fractions to [n] d.p.* – note that surplus fractions are used in STV in calculations of the form *A* × (*B*/*C*), where (*B*/*C*) is the surplus fraction. The order of operations depends on this setting: * When this option is disabled (default), (*A* × *B*) is calculated first, then divided by *C*. This minimises rounding errors. * When this option is enabled, (*B*/*C*) is calculated separately first and rounded to the specified precision, before being multiplied by *A*. Many STV rules designed for hand counting prescribe this method of manipulating surplus fractions. @@ -267,6 +267,7 @@ When *Surplus method* is set to *Meek method*: * --round-values instead controls the rounding of candidate keep values * --round-surplus-fractions instead controls the rounding of each intermediate product when computing candidates' votes * --round-votes controls the rounding of the final number of votes credited to each candidate +* Keep values, intermediate products and candidate votes are rounded *up* ### (Gregory) Sum surplus transfers (--sum-surplus-transfers)