Draw Generation (BP)¶
The draw generator for British Parliamentary tournaments tries to rotate teams through positions by assigning them positions they’ve been in less often before the current round.
Summary of options¶
Options are set in the Configuration page as described in starting a tournament. Options in italics with an asterisk are not WUDCcompliant. The recommended options are shown in bold.
Option  Description  Allowable values 

Pullup distribution  Where pullup teams get placed 

Position cost  Which cost function to use to indicate which position profiles are preferred 

Rényi order  Order of Rényi entropy  Any nonnegative number (default: 1, i.e. Shannon entropy) 
Position cost exponent  Degree to which large position imbalances should be prioritised  Any nonnegative number (default: 4) 
Assignment method  Algorithm used to assign positions 

The big picture¶
To try to achieve position balance, Tabbycat treats the allocation of teams to debates as an assignment problem. That is, it computes the “cost” of assigning each team to each position in each debate, and finds an assignment of all teams to a position in a debate that minimises the total cost (the sum over all teams).
A simple example¶
Here’s a small example, to illustrate the idea. Say you have a tournament with 16 teams, and you’re about to draw round 4. There are sixteen “places” in the draw: four positions in each of four rooms. Tabbycat calculates the “cost” of putting each team in each place, and puts them in a matrix, like this:
Room  Top  Second  Third  Bottom  

Position  OG  OO  CG  CO  OG  OO  CG  CO  OG  OO  CG  CO  OG  OO  CG  CO 
A (8)  16  16  16  0  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞ 
B (7)  16  0  16  16  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞ 
C (7)  16  16  0  16  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞ 
D (6)  16  0  16  16  16  0  16  16  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞ 
E (6)  0  16  16  16  0  16  16  16  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞ 
F (6)  16  16  0  16  16  16  0  16  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞ 
G (5)  ∞  ∞  ∞  ∞  16  0  16  16  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞ 
H (5)  ∞  ∞  ∞  ∞  16  0  16  16  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞ 
I (4)  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  16  16  0  16  ∞  ∞  ∞  ∞ 
J (4)  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  16  16  16  0  ∞  ∞  ∞  ∞ 
K (3)  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  0  16  16  16  0  16  16  16 
L (3)  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  16  16  0  16  16  16  0  16 
M (3)  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  16  16  16  0  16  16  16  0 
N (3)  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  0  16  16  16  0  16  16  16 
O (1)  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  16  16  16  0 
P (1)  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  ∞  0  16  16  16 
Each “16” is the cost of putting a team in a position it’s seen once; each “0” is the cost of putting a team in the position it hasn’t. (Details of how this is calculated are below.) For example, team A (on 8 points) has been in every position except CO. The ∞’s indicate places where the team isn’t allowed to go, because the room isn’t in their bracket. For example, the three teams on 6 points (D, E, F) can go in either the top or second room, because any of them can be the pullup team.
The algorithm then chooses entries so that one is selected from each row and one is selected from each column, in a way that minimises the sum of the selected entries. In this case, the selected entries are highlighted in blue. For example, the top room comprises teams E (OG), B (OO), C (CG) and A (CO).
Sometimes, particularly in round 4, it simply isn’t possible to “satisfy” everyone. For example, among the top eight teams, five haven’t been in OO, but only two can be accommodated within those brackets. In this case, teams B and G got lucky; there are also many other draws that would have incurred the same total cost.
More generally, in most cases, there will be many optimal solutions. To randomise the selection among them, Tabbycat (under default settings) randomly permutes the rows and columns of the matrix before starting the assignment algorithm.
Explanations of options¶
Pullup distribution¶
If the number of teams in a bracket is not a multiple of four, it pulls up teams from the next bracket down. The pullup distribution then governs how those teams are paired into the upper bracket.
The available options are as follows:
 Anywhere in bracket: The pullup teams are treated as if they were any other team in their new bracket. For example, if there are 17 teams in a 10point bracket, then the three 9point teams that get pulled up may be paired anywhere in the 10point bracket, independently of each other. Chance might put them in the same room, but more likely, they will not all be in the same room, so there will be multiple pullup rooms in the 10point bracket.
 All in the same room: All of the pullup teams will be paired into the same room. This means that there will be at most one pullup room per bracket, effectively creating an “intermediate bracket”.
Note
While it can be argued that the All in the same room setting is fairer, it is prohibited by the WUDC constitution. If your tournament follows WUDC rules, you cannot use this setting.
The teams that get pulled up aren’t specifically chosen—they’re just assigned as part of the algorithm described above, which optimises for position balance. Tabbycat doesn’t support taking anything else into account when choosing pullup teams. (WUDC rules wouldn’t allow it, either.)
Position cost options¶
The position cost function is a function that indicates how “bad” it would be if a team were to be allocated a certain position (OG, OO, CG, CO) in a debate. When generating a draw, Tabbycat chooses from among the draws that minimise the sum of the position costs for each team.
More formally:
 A position history or just history is a 4tuple where each element is the number of times a team has already been in the corresponding position. For example, means that a team has been in OO twice, CG and CO once each, and hasn’t been in OG.
 A cost function is a function specifying how “bad” it would be if a team with position history were assigned the position in the next round.
Tabbycat allows you to choose from a number of different position cost functions, as well as a position cost exponent . Then, when allocating teams to debates, Tabbycat allocates teams to positions to minimise
where is the set of all teams, is the position history of team and is the position to which team would be allocated.
Position cost exponent¶
The position cost exponent controls how different teams trade off with each other.
 The larger is, the more concerned it is with preventing very bad situations. That is, it will give more teams some slight unevenness in order to prevent one team from getting a very uneven history.
 The smaller is, the more concerned it is with preventing any unevenness. That is, it will try to keep more teams from being uneven at all, at the cost of possibly letting just one team get a very uneven history.
 At the large extreme, as , it will do everything it can to minimise the plight of the worstoff team, and it won’t care for any team other than the worstoff.
 At the small extreme, as , it will do everything it can to minimise the number of teams with a nonoptimal profile—but if it’s impossible to protect a team from suboptimality, it won’t care how uneven the unlucky team gets.
The “balanced” approach would be , which just takes the cost function asis. This doesn’t mean that this is the best idea, however—you’d typically want to bias towards preventing very uneven histories a bit more. Most tournaments will probably want to be somewhere between 2 and 5. (Note that need not be an integer.)
Position cost functions¶
Tabbycat allows you to choose between three position cost functions : Simple, Rényi entropy and Population variance.
In the descriptions that follow, , the set of all BP positions.
Simple¶
The simple cost function returns the number of times the team has already been in position , less the number of times the team has been in its least frequent position. That is,
where is the element of corresponding to position .
Rényi entropy¶
Informally speaking, the Rényi entropy is a measure of the diversity of the positions in a team’s history. A history consisting only of one position has low entropy, while a history that is perfectly evenly distributed has high entropy. The Rényi entropy cost function reverses this intuition, so that an even hypothetical history has low cost, while an uneven hypothetical history has high cost.
The Rényi entropy takes one parameter, known as its order, , which will be further discussed below.
More formally, the Rényi entropy cost function is defined as
where
is the number of rounds the team has competed in so far.
is the normalised hypothetical position history that would arise if a team with history were to be allocated position in the next round; that is,
Note that is a probability distribution (that is, its elements sum to 1).
is the Rényi entropy of order of a probability distribution, defined as
In the special (limiting) case where , it reduces to the Shannon entropy,
Note that for all , (since there are four positions in BP).
The Rényi order is the parameter above, and it controls what it means to be “even among positions” for a team. Note that “evenness” is not easily defined. After round 8, which position history is more even: (0, 2, 3, 3) or (1, 1, 1, 5)? The Rényi order allows us to tune this definition.
 The smaller is, the more it cares that teams compete in every position at least once, favouring (1, 1, 1, 5) over (0, 2, 3, 3): it’s worse to have never OGed, than it is to have COed five times.
 The larger is, the more it cares that teams do not compete in any (one) position too many times, favouring (0, 2, 3, 3) over (1, 1, 1, 5): it’s worse to have COed five times, than it is to have never OGed.
 At the small extreme, as , it only counts how many positions a team has seen at least once, and doesn’t care about the distribution among them so long as a team has been in each position once.
 At the large extreme, as , it only looks at how many times each team has seen its most frequent position, and tries to keep this number even among all teams.
The “balanced” approach would be (the Shannon entropy), though of course it’s arguable what “balanced” means. Tabbycat defaults to this value.
To give some intuition for the useful range: In round 9, a strict ordering by number of positions seen at least once occurs for approximately . A strict ordering by number of times in the most frequent position occurs for . Changing outside the range will still affect the relative (cardinal) weighting between teams, but will not affect the ordinal ranking of possible histories.
The purpose of weighting costs by is to prioritise those teams who have competed in every round over those who have competed in fewer rounds.
Population variance¶
The population variance cost function is just the population variance of the history 4tuple,
where is the hypothetical position history that would arise if a team with history were to be allocated position in the next round; that is,
and where is the mean of ,
At the extremes, a team that has seen all positions evenly will have a population variance of zero, while a team that has seen just one position times will have a population variance of .
Assignment method¶
Tabbycat uses the Hungarian algorithm to solve the assignment problem of assigning teams to positions in debates. This can be run with or without preshuffling:
Hungarian algorithm just runs the Hungarian algorithm asis, with no randomness. This probably isn’t what you want.
Hungarian algorithm with preshuffling also runs the Hungarian algorithm on the position cost matrix, but shuffles the input so that the draw is randomised, subject to having optimal position allocations.
Preshuffling doesn’t compromise the optimality of position allocations: It simply shuffles the order in which teams and debates appear in the input to the algorithm, by randomly permuting the rows and columns of the position cost matrix. The Hungarian algorithm still guarantees an optimal position assignment, according to the chosen position cost function.
Note
Running the Hungarian algorithm without preshuffling has the side effect of grouping teams with similar speaker scores in to the same room, and is therefore prohibited by WUDC rules. Its inclusion as an option is mainly academic; most tournaments will not want to use it in practice.
No other assignment methods are currently supported. For example, Tabbycat can’t run fold (highlow) or adjacent (highhigh) pairing within brackets.