In the first step of biproportional apportionment parties are given seats according to the sum of their votes across all districts.
Usage
upper_apportionment(
votes_matrix,
district_seats,
quorum,
weight_votes = TRUE,
method = "round"
)Arguments
- votes_matrix
Vote count matrix with votes by party in rows and votes by district in columns.
- district_seats
Vector defining the number of seats per district. Must be the same length as
ncol(votes_matrix). Values are name-matched tovotes_matrixcolumns if both are named.If the number of seats per district should be calculated according to the number of votes, a single number for the total number of seats can be used.
weight_voteswill be ignored, asvotes_matrixshows the number of voters. Note that apportioning district seats according to votes is not the general use case.
- quorum
Optional list of quorum parameters that describe how quorums should be applied prior to seat distributions, created with
quorum_any()orquorum_all(), see examples. Alternatively you can pass a precalculated logical vector. No quorum is applied if this parameter is missing orNULL.- weight_votes
By default (
TRUE) it is assumed that each voter in a district has as many votes as there are seats in a district. Thus, votes are weighted according to the number of available district seats withweight_votes_matrix(). Set toFALSEifvotes_matrixshows the number of voters (e.g. because they can only cast one vote for one party).- method
Apportion method that defines how seats are assigned, see
proporz(). Default is the Sainte-Laguë/Webster method.
Value
A named list with district seats (for votes_matrix columns) and party seats
(for rows). The third list entry, votes_matrix_quorum, shows the votes_matrix where
parties failing to reach the quorum had their votes set to zero.
Note
The results from the upper apportionment define the number of seats for each party and the number of seats for each district for the whole voting area. The lower apportionment will only determine where (i.e. which district) the party seats are allocated. Thus, after the upper apportionment is done, the final strength of a party/district within the parliament is definite.
Examples
votes_matrix = matrix(c(123,912,312,45,714,255,815,414,215), nrow = 3)
district_seats = c(7,5,8)
upper_apportionment(votes_matrix, district_seats)
#> $district
#> [1] 7 5 8
#>
#> $party
#> [1] 5 11 4
#>
#> $votes_matrix_quorum
#> [,1] [,2] [,3]
#> [1,] 123 45 815
#> [2,] 912 714 414
#> [3,] 312 255 215
#>
# with qourum
upper_apportionment(votes_matrix, district_seats,
quorum_any(total_voters = 125))
#> $district
#> [1] 7 5 8
#>
#> $party
#> [1] 6 14 0
#>
#> $votes_matrix_quorum
#> [,1] [,2] [,3]
#> [1,] 123 45 815
#> [2,] 912 714 414
#> [3,] 0 0 0
#>
