Editing Module:Sports table/Chess/doc (section)

====Sonneborn–Berger score====

In addition to other automatic calculations done by this module, there is also the possibility to calculate the [[Sonneborn–Berger score]].
{| class="wikitable" style="background:white;"
|-
|'''What you type'''
|<syntaxhighlight lang=moin>{{#invoke:Sports table|main|style=Chess

|team1=AAA |team2=BBB |team3=CCC |team4=DDD |team5=CAR

|name_AAA=[[Grandmaster (chess)|Grandmaster]]
|name_BBB=Team 2
|name_CCC=Team 3
|name_DDD=Team 4
|name_CAR={{flagathlete|[[Fabiano Caruana]]|USA}}

|winpoints=2
|drawpoints=1
|losspoints=-0.1
|show_sb=yes
|sb_iff_hth=yes
|disp_fractions=no

|match_AAA_BBB=1+0
|match_AAA_CCC=1+½
|match_AAA_DDD=½+
|match_AAA_CAR= +0
|hth_AAA=1.9

|match_BBB_AAA=1+0
|match_BBB_CCC=½+½
|match_BBB_DDD=½+0
|match_BBB_CAR=½
|hth_BBB=1.9
|nosb_BBB=yes

|match_CCC_AAA=½+0
|match_CCC_BBB=½+½
|match_CCC_DDD=1
|match_CCC_CAR=

|match_DDD_AAA= +½
|match_DDD_BBB=1+½
|match_DDD_CCC= +0

|match_CAR_AAA=1+
|match_CAR_BBB= +½
}}</syntaxhighlight>
|-
|'''What it looks like'''
|{{#invoke:Sports table|main|style=Chess

|team1=AAA |team2=BBB |team3=CCC |team4=DDD |team5=CAR

|name_AAA=[[Grandmaster (chess)|Grandmaster]]
|name_BBB=Team 2
|name_CCC=Team 3
|name_DDD=Team 4
|name_CAR={{flagathlete|[[Fabiano Caruana]]|USA}}

|winpoints=2
|drawpoints=1
|losspoints=-0.1
|show_sb=yes
|sb_iff_hth=yes
|disp_fractions=no

|match_AAA_BBB=1+0
|match_AAA_CCC=1+½
|match_AAA_DDD=½+
|match_AAA_CAR= +0
|hth_AAA=1.9

|match_BBB_AAA=1+0
|match_BBB_CCC=½+½
|match_BBB_DDD=½+0
|match_BBB_CAR=½
|hth_BBB=1.9
|nosb_BBB=yes

|match_CCC_AAA=½+0
|match_CCC_BBB=½+½
|match_CCC_DDD=1
|match_CCC_CAR=

|match_DDD_AAA= +½
|match_DDD_BBB=1+½
|match_DDD_CCC= +0

|match_CAR_AAA=1+
|match_CAR_BBB= +½
}}
|}
The {{para|show_sb}} parameter shows a column containing the [[Sonneborn–Berger score]] of each player calculated from their match results.
The Sonneborn–Berger score is calculated by taking the number of points gained against a given opponent multiplied by the total number of points that opponent scored, and then summing this product over all of the players.
If the parameter {{para|sb_before_w}} is set to yes, then the column containing the Sonneborn–Berger score of each player appears immediately before the win column. If {{para|hth_before_w}} is also set to yes, the column containing the [[Sonneborn–Berger score]] of each player comes after the HTH column.
If the parameter {{para|sb_before_w}} is set to the default value of no, then this column comes after both the H2H column as well as whichever of the Wins, Draws, and Losses columns are present.
The values in this column are always given as decimals regardless of {{para|disp_fractions}}.
If the parameter {{para|sb_iff_hth}} is set to yes, then a calculated Sonneborn–Berger score will only be displayed if head to head data has been defined for a given player.
Additionally, you may set the {{para|nosb_XXX}} parameter to yes for any given player with team code XXX in order to prevent that particular player's Sonneborn–Berger score from being displayed.