Usage
Command line
1. Add ECO
pgnhelper addeco --inpgnfn candidates_zurich_1953.pgn --outpgnfn eco_candidates_zurich_1953.pgn --inecopgnfn eco.pgn
Note
You can get the eco.pgn from the pgnhelper github repository.
2. Sort
pgnhelper sort --inpgnfn sinqcup21.pgn --outpgnfn sorted_sinqcup21.pgn --sort-tag eco --sort-direction hightolow
3. Generates a round-robin result table
pgnhelper roundrobin --inpgnfn sinqcup21.pgn --output sinqcup21.txt
Output with rating change and tie-break scores DE, Wins, SB and Koya:
Rank Name Rating RChg 1 2 3 4 5 6 7 8 9 10 Games Score Score% DE Wins SB Koya
1 Vachier-Lagrave, Maxime 2751 13.74 x 0.5 0.0 0.5 0.5 1.0 1.0 0.5 1.0 1.0 9 6.0 66.67 0.0 0 0.00 0.0
2 Caruana, Fabiano 2806 1.03 0.5 x 0.5 0.5 0.5 1.0 0.0 1.0 0.5 1.0 9 5.5 61.11 1.0 3 23.00 2.0
3 Dominguez Perez, Leinier 2758 7.75 1.0 0.5 x 0.5 0.5 0.5 0.5 0.5 0.5 1.0 9 5.5 61.11 1.0 2 24.00 2.5
4 So, Wesley 2772 5.77 0.5 0.5 0.5 x 0.5 0.5 0.5 0.5 1.0 1.0 9 5.5 61.11 1.0 2 22.75 2.0
5 Rapport, Richard 2763 -2.96 0.5 0.5 0.5 0.5 x 0.5 0.5 0.0 1.0 0.5 9 4.5 50.00 0.0 0 0.00 0.0
6 Shankland, Sam 2709 -0.32 0.0 0.0 0.5 0.5 0.5 x 0.5 1.0 0.5 0.5 9 4.0 44.44 1.5 1 16.75 1.5
7 Xiong, Jeffery 2710 -0.46 0.0 1.0 0.5 0.5 0.5 0.5 x 0.5 0.5 0.0 9 4.0 44.44 1.0 1 19.00 2.5
8 Mamedyarov, Shakhriyar 2782 -10.64 0.5 0.0 0.5 0.5 1.0 0.0 0.5 x 0.5 0.5 9 4.0 44.44 0.5 1 18.00 2.5
9 Svidler, Peter 2714 -6.02 0.0 0.5 0.5 0.0 0.0 0.5 0.5 0.5 x 1.0 9 3.5 38.89 0.0 0 0.00 0.0
10 Swiercz, Dariusz 2655 -7.89 0.0 0.0 0.0 0.0 0.5 0.5 1.0 0.5 0.0 x 9 2.5 27.78 0.0 0 0.00 0.0
4. Generates a round-robin table with armageddon tie-break as in Norway Chess
pgnhelper roundrobin --inpgnfn norwaychess.pgn --armageddon-file norwaychess_arm.pgn --output norwaychess.html --win-point 3.0 --win-point-arm 1.5 --loss-point-arm 1.0 --show-max-score
Rank Name Rating RChg 1 2 3 4 5 6 7 8 9 10 Games Score MaxScore Score% DE Wins
1 Carlsen, Magnus 2864 -0.05 x 3.0 1.0 1.5 1.0 3.0 1.5 1.0 3.0 1.5 9 16.5 27.0 61.11 0.0 0
2 Mamedyarov, Shakhriyar 2759 9.31 0.0 x 3.0 1.0 1.5 3.0 1.5 1.5 1.0 3.0 9 15.5 27.0 57.41 0.0 0
3 Anand, Viswanathan 2751 5.44 1.5 0.0 x 3.0 1.0 1.5 3.0 1.5 1.5 1.5 9 14.5 27.0 53.70 0.0 0
4 Vachier-Lagrave, Maxime 2750 5.58 1.0 1.5 0.0 x 3.0 1.5 1.5 3.0 1.0 1.5 9 14.0 27.0 51.85 0.0 0
5 So, Wesley 2776 -3.09 1.5 1.0 1.5 0.0 x 1.5 1.0 1.5 3.0 1.5 9 12.5 27.0 46.30 0.0 0
6 Giri, Anish 2761 -0.97 0.0 0.0 1.0 1.0 1.0 x 1.5 3.0 3.0 1.5 9 12.0 27.0 44.44 0.0 0
7 Topalov, Veselin 2730 -1.60 1.0 1.0 0.0 1.0 1.5 1.0 x 1.5 1.5 1.0 9 9.5 27.0 35.19 1.5 0
8 Tari, Aryan 2654 8.79 1.5 1.0 1.0 0.0 1.0 0.0 1.0 x 1.0 3.0 9 9.5 27.0 35.19 1.0 1
9 Radjabov, Teimour 2753 -14.84 0.0 1.5 1.0 1.5 0.0 0.0 1.0 1.5 x 1.5 9 8.0 27.0 29.63 0.0 0
10 Wang, Hao 2744 -8.57 1.0 0.0 1.0 1.0 1.0 1.0 1.5 0.0 1.0 x 9 7.5 27.0 27.78 0.0 0
5. Generates swiss table
pgnhelper swiss --inpgnfn "./pgn/fide_grand_swiss_2021_riga.pgn" --output "fide_swiss.txt"
# pgnhelper swiss --inpgnfn "./pgn/fide_grand_swiss_2021_riga.pgn" --output "fide_swiss.html"
Rank Name Rating RChg R1 R2 R3 R4 R5 R6 R7 R8 R9 R10 R11 Games Score Score% TB1 TB2 TB3 TB4 TB5 TB6
1 Firouzja, Alireza 2770 11.31 93W1 35B1 7W1 4B= 6W= 8B= 33W1 31W1 2B0 9W1 3B= 11 8.0 72.73 0.0 0.0 0.00 0.0 0 0
2 Caruana, Fabiano 2800 1.06 55W1 18B= 36W= 35B= 9W1 33B= 13W= 24B1 1W1 6B= 7W= 11 7.5 68.18 67.0 72.5 49.75 0.0 4 1
3 Oparin, Grigoriy 2654 21.62 62W= 78B1 17W= 70B= 26W= 5B= 73W1 19B1 7W= 23B1 1W= 11 7.5 68.18 63.5 68.5 45.75 0.0 4 3
4 Yu, Yangyi 2704 9.20 5W= 63B1 61W1 1W= 49B= 13B= 15W= 28B= 33W1 8B= 6W= 11 7.0 63.64 66.5 72.0 44.50 0.0 3 1
5 Keymer, Vincent 2630 22.06 4B= 27W1 25B= 10W= 59B= 3W= 24B0 82W1 53B1 29W1 9B= 11 7.0 63.64 65.5 70.0 43.25 0.0 4 1
6 Vachier-Lagrave, Maxime 2763 2.12 52B= 51W1 71B= 60W1 1B= 32W1 31B= 8W= 11B= 2W= 4B= 11 7.0 63.64 65.0 70.0 43.50 0.0 3 0
7 Predke, Alexandr 2666 14.22 46B1 54W1 1B0 47W= 42B1 31W0 57B1 49W1 3B= 11W= 2B= 11 7.0 63.64 64.5 70.0 42.25 0.0 5 3
8 Shirov, Alexei 2659 16.99 43B= 87W1 50B= 92W1 36B1 1W= 14B= 6B= 23W= 4W= 10B= 11 7.0 63.64 64.5 68.5 41.50 0.0 3 1
9 Howell, David W L 2658 15.43 82B1 92W= 72B= 50W= 2B0 54W1 47B1 14W1 12W1 1B0 5W= 11 7.0 63.64 62.5 66.5 40.25 0.0 5 2
10 Sargissian, Gabriel 2664 10.56 72W= 83B= 94W1 5B= 70W1 15B= 18W= 34B= 28W1 13B= 8W= 11 7.0 63.64 61.5 65.5 40.50 0.0 3 0
11 Anton Guijarro, David 2658 13.25 37W= 70B= 62W1 17B0 98W1 91B1 19W= 21B1 6W= 7B= 13W= 11 7.0 63.64 61.0 65.0 39.25 0.0 4 2
12 Korobov, Anton 2690 6.07 48B= 20W1 47B= 42W= 50B1 49W= 17B= 41W1 9B0 34W= 31B1 11 7.0 63.64 60.5 66.0 41.50 0.0 4 2
13 Sevian, Samuel 2654 15.89 80B= 84W1 92B= 72W1 32B= 4W= 2B= 53W1 30B= 10W= 11B= 11 7.0 63.64 60.5 64.5 39.75 0.0 3 0
14 Esipenko, Andrey 2720 3.08 58B= 42W= 81B= 63W1 71B= 56W1 8W= 9B0 64B1 31W1 15B= 11 7.0 63.64 60.0 64.5 40.00 0.0 4 1
15 Deac, Bogdan-Daniel 2643 15.05 89B= 104W= 106B1 53W= 29B1 10W= 4B= 25W= 18B= 38B1 14W= 11 7.0 63.64 60.0 63.0 39.25 0.0 3 3
16 Artemiev, Vladislav 2699 4.40 76B1 50W= 75B= 31W= 51B= 47W= 48B= 52W= 49B1 17W= 34B1 11 7.0 63.64 56.5 61.5 39.00 0.0 3 3
...
Tie-breaks:
TB1 = Buchholz Cut 1
TB2 = Buchholz
TB3 = Sonneborn-Berger
TB4 = Direct Encounter
TB5 = Number of wins
TB6 = Number of wins as black
6. Generates standing table
Command line:
pgnhelper standing --inpgnfn "./pgn/interzonal_1970_palma_de_mallorca.pgn" --output palma.txt
Output:
Rank Name Games Score Score% DE Wins SB Koya
1 Fischer R 23 18.5 80.43 0.0 0 0.00 0.0
2 Geller E 23 15.0 65.22 1.5 8 167.00 7.5
3 Larsen B 23 15.0 65.22 1.0 9 167.50 7.0
4 Huebner R 23 15.0 65.22 0.5 10 155.25 5.0
5 Uhlmann W 23 14.0 60.87 0.5 10 141.50 5.5
6 Taimanov M 23 14.0 60.87 0.5 8 146.50 5.5
7 Portisch L 23 13.5 58.70 0.5 7 149.75 6.5
8 Smyslov V 23 13.5 58.70 0.5 7 141.00 5.5
9 Gligoric S 23 13.0 56.52 0.5 7 135.50 5.5
10 Polugaevsky L 23 13.0 56.52 0.5 5 146.75 6.5
11 Mecking H 23 12.5 54.35 0.5 7 130.00 5.5
12 Panno O 23 12.5 54.35 0.5 6 130.75 4.5
13 Hort V 23 11.5 50.00 0.0 0 0.00 0.0
14 Ivkov B 23 10.5 45.65 0.0 0 0.00 0.0
15 Minic D 23 10.0 43.48 1.0 5 96.00 2.5
16 Suttles D 23 10.0 43.48 0.0 4 105.75 4.5
17 Reshevsky S 23 9.5 41.30 0.0 0 0.00 0.0
18 Addison W 23 9.0 39.13 0.5 3 95.25 4.5
19 Matulovic M 23 9.0 39.13 0.5 2 98.50 4.5
20 Filip M 23 8.5 36.96 1.5 1 91.50 3.5
21 Ujtumen T 23 8.5 36.96 1.0 5 85.25 2.5
22 Naranja R 23 8.5 36.96 0.5 5 88.75 2.5
23 Rubinetti J 23 6.0 26.09 0.0 0 0.00 0.0
24 Jimenez Zerquera E 23 5.5 23.91 0.0 0 0.00 0.0
Script
1. Add ECO
import pgnhelper.app
a = pgnhelper.app.PgnHelper(
'addeco',
inpgnfn='mygames.pgn',
outpgnfn='out_eco.pgn',
inecopgnfn='eco.pgn')
a.start()
2. Sort games
import pgnhelper.app
a = pgnhelper.app.PgnHelper(
'sort',
inpgnfn='mygames.pgn',
outpgnfn='out_sorted.pgn',
sort_tag='eco',
sort_direction='hightolow')
a.start()
3. Generate round-robin table
"""
The output can be a pandas dataframe, txt, csv and html.
"""
import pgnhelper.roundrobin
import pgnhelper.utility
# Get the dataframe output.
rr = pgnhelper.roundrobin.RoundRobin(
"airthings.pgn",
winpoint=3.0, drawpoint=1.0)
df = rr.table()
# Print to console.
print(df.to_string(index=False))
# Save to html.
pgnhelper.utility.save(df, "airthings.html")
# Save to csv.
df.to_csv("airthings.csv", index=False)
4. Generate round-robin table with armageddon games as tie-break as in Norway Chess
"""
Generate a round-robin table and save results and html.
"""
import pgnhelper.roundrobin
import pgnhelper.utility
rr = pgnhelper.roundrobin.RoundRobin(
"./pgn/norway_chess_2022_classical.pgn",
infnarm="./pgn/norway_chess_2022_armageddon.pgn",
winpoint=3.0,
winpointarm=1.5,
losspointarm=1.0)
df = rr.table()
pgnhelper.utility.save(df, "norway_chess.html")
5. Find the frequency of opening names played by players in a tournament
"""Get frequency of players that plays sicilian opening.
"""
import pgnhelper
import pandas as pd
opening_name = 'Sicilian'
pgnfn = 'wchcand22.pgn'
df, players, israting = pgnhelper.record.get_pgn_data(pgnfn)
openings = df.Opening.unique()
# for o in openings:
# print(o)
data = {}
for p in players:
data1 = {}
for o in openings:
dfw = df.loc[(df.Opening == o) & (df.White == p)]
dfb = df.loc[(df.Opening == o) & (df.Black == p)]
wcnt = len(dfw)
bcnt = len(dfb)
total = wcnt + bcnt
data1.update({o: {'w': wcnt, 'b': bcnt, 'total': total}})
data.update({p: {'data': data1}})
mydata = []
for p in players:
mydata.append([opening_name, p,
data[p]['data'][opening_name]['w'],
data[p]['data'][opening_name]['b'],
data[p]['data'][opening_name]['total']])
mydf = pd.DataFrame(
mydata,
columns=['Opening', 'Player', 'Wgames', 'Bgames', 'Total'])
mydf = mydf.sort_values(by=['Total', 'Wgames'], ascending=[False, False])
mydf = mydf.reset_index(drop=True)
print(mydf)
Output:
Opening Player Wgames Bgames Total
0 Sicilian Rapport, Richard 0 4 4
1 Sicilian Caruana, Fabiano 3 0 3
2 Sicilian Nakamura, Hikaru 3 0 3
3 Sicilian Nepomniachtchi, Ian 2 0 2
4 Sicilian Radjabov, Teimour 1 1 2
5 Sicilian Duda, Jan-Krzysztof 0 2 2
6 Sicilian Firouzja, Alireza 0 2 2
7 Sicilian Ding, Liren 0 0 0