From a9050e412412fe01786f1db04e086bea7e9358c2 Mon Sep 17 00:00:00 2001 From: RunasSudo Date: Mon, 4 Jan 2021 19:35:09 +1100 Subject: [PATCH] Update documentation --- docs/options.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/options.md b/docs/options.md index 9553729..de71638 100644 --- a/docs/options.md +++ b/docs/options.md @@ -71,14 +71,14 @@ When deferred surpluses is enabled, the transfer of all surpluses is deferred if ## Round quota/votes/transfer values/ballot weights to [n] d.p. (--round-quota, --round-votes, --round-tvs, --round-weights) -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 weights and transfer values are calculated to higher precision (according to the *Numbers*) option. +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 weights and transfer values are calculated to higher precision (according to the *Numbers* option). -The quota is incremented or rounded up (according to the *Quota* option), whereas votes, transfer values and weights are always rounded down. +When enabled, the quota is incremented or rounded up (according to the *Quota* option), whereas votes, transfer values and weights are always rounded down. In relation to *Round transfer values to [n] d.p.* – note that transfer values are used in STV in calculations of the form *A* × (*B*/*C*), where (*B*/*C*) is the transfer value. 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*. +* 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 transfer values. ## Surplus order (-s/--surplus-order) @@ -110,7 +110,7 @@ Other surplus transfer methods, such as non-fractional transfers (e.g. random sa ### Exclusion method (--exclusion) * *Exclude in one round* (default): When excluding candidate(s), transfer all their ballot papers in one stage. -* *Exclude by parcel (by order)*: When excluding a candidate, transfer their ballot papers one parcel at a time, in their order each was received. Each parcel 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. This option cannot be combined with bulk exclusion. +* *Exclude 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, i.e. if a transfer allows another candidate to meet the quota criterion, no further papers are transferred to that candidate. This option cannot be combined with bulk exclusion. * *Exclude 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. * *Wright method (re-iterate)*: When candidate(s) are excluded, the count is reset from the beginning (minus the excluded candidate(s)).