Portable Game Notation (PGN) désigne un format standard de codage des parties d'échecs.
Il est principalement utilisé pour la retransmission des parties sur internet et dans les bases de données de parties. Il utilise la notation algébrique anglaise abrégée. La plupart des programmes d’échecs la reconnaissent.
Le fichier PGN d’une partie d'échecs est composée de deux parties : la première est une liste d’en-têtes qui décrivent la date et le lieu de la rencontre, les noms des protagonistes, etc. La seconde est constituée des coups joués et d’éventuels commentaires et qui est ponctuée par le résultat.
Exemple Exemple simple Dans l'exemple suivant, seuls les sept en-têtes obligatoires sont présents. Ils sont séparés de la liste des coups joués par une ligne vide. Il n'y a aucun commentaire associé aux coups joués, et le résultat final termine la partie.
[Event "F/S Return Match"] [Site "Belgrade, Serbia JUG"] [Date "1992.11.04"] [Round "29"] [White "Fischer, Robert J."] [Black "Spassky, Boris V."] [Result "1/2-1/2"]
1. e4 e5 2. Nf3 Nc6 3. Bb5 a6 4. Ba4 Nf6 5. O-O Be7 6. Re1 b5 7. Bb3 d6 8. c3 O-O 9. h3 Nb8 10. d4 Nbd7 11. c4 c6 12. cxb5 axb5 13. Nc3 Bb7 14. Bg5 b4 15. Nb1 h6 16. Bh4 c5 17. dxe5 Nxe4 18. Bxe7 Qxe7 19. exd6 Qf6 20. Nbd2 Nxd6 21. Nc4 Nxc4 22. Bxc4 Nb6 23. Ne5 Rae8 24. Bxf7+ Rxf7 25. Nxf7 Rxe1+ 26. Qxe1 Kxf7 27. Qe3 Qg5 28. Qxg5 hxg5 29. b3 Ke6 30. a3 Kd6 31. axb4 cxb4 32. Ra5 Nd5 33. f3 Bc8 34. Kf2 Bf5 35. Ra7 g6 36. Ra6+ Kc5 37. Ke1 Nf4 38. g3 Nxh3 39. Kd2 Kb5 40. Rd6 Kc5 41. Ra6 Nf2 42. g4 Bd3 43. Re6 1/2-1/2
Exemple plus complexe Dans cet exemple sont illustrés les variantes et commentaires.
[Event "Interclubs FRA"] [Site "?"] [Date "????.??.??"] [Round "?"] [White "Calistri, Tristan"] [Black "Bauduin, Etienne"] [Result "1-0"]
1.e4 c5 2.Nf3 e6 3.d4 cxd4 4.Nxd4 Nc6 5.Nc3 a6 6.Be2 Qc7 7.O-O Nf6 8.Be3 Bb4 9.Na4 O-O 10.c4 Bd6 11.g3 Nxe4 12.Bf3 f5 13.Bxe4 fxe4 14.c5 Be7 {Les Noirs ont un pion d'avance mais de gros problèmes pour mettre leur Fc8 et leur Ta8 en jeu} 15.Qg4 Ne5 16.Qxe4 d5 17.cxd6 Bxd6 18.Rac1 Qa5 19.Nb3 {Les blancs ont récupéré leur pion et toutes leurs pièces sont mobilisées} 19...Qb4 (19...Qd5 20.Qxd5 exd5 21.Nb6 Bh3 22.Nxa8 Nf3+ 23.Kh1 Bxf1 24.Rxf1 Rxa8 25.Rd1) (19...Nf3+ 20.Kg2 Qh5) 20.Qxb4 Bxb4 21.Nb6 $18 {Les noirs n'arriveront jamais à sortir leur Fc8} 21...Rb8 22.Bc5 Bxc5 (22...Nd3 23.Bxf8 Nxc1 24.Rxc1 Bxf8 25.Rxc8 Rxc8 26.Nxc8) 23.Nxc5 Rd8 24.Rfd1 Re8 25.Ne4 Nf7 26.Rc7 Kf8 27.Rdc1 1-0
Syntaxe Format d'importation et format d'exportation On distingue deux types de formats : d'exportation : c'est le format rigoureusement conforme à la norme PGN et tel que deux programmes différents produiront pour les mêmes données un résultat parfaitement identique, d'importation : c'est le format qui sera toléré en lecture, qui sera plus laxiste que le format d'exportation.
Par exemple, en format d'exportation, les lignes auront une taille maximale de 80 caractères, tandis qu'en importation, les programmes liront des lignes de taille quelconque.
Jeu de caractères Le jeu de caractères utilisés par PGN est celui de la norme ISO/CEI 8859-1 codé sur 8 bits avec les restrictions suivantes : 0 à 31 : interdits sauf retour à la ligne (10) et TAB (9) 32 à 126 : autorisés 127 à 159 : sont interdits 160 à 191 : utilisation déconseillée 192 à 255 : autorisés
Les lignes sont terminées par le caractère ASCII 0x0A (LF, \n), et leur longueur maximale est de 80 caractères.
En-têtes Le fichier commence par 7 en-têtes obligatoires :
Event Le nom du tournoi ou de l'événement. Exemples : [Event "FIDE World Championship"] [Event "Moscow City Championship"] [Event "ACM North American Computer Championship"] [Event "Casual Game"] Site Le lieu, de préférence utilisant des abréviations standardisées pour les noms de pays, comme celles du comité olympique international. Exemples : [Site "New York City, NY USA"] [Site "St. Petersburg RUS"] [Site "Riga LAT"] Date La date du début de la partie en format AAAA.MM.JJ Exemples : [Date "1992.08.31"] [Date "1993.??.??"] [Date "2001.01.01"] Round Le numéro de la ronde Exemples : [Round "1"] [Round "3.1"] [Round "4.1.2"] White Le joueur blanc (en format "Nom, Prénom") Exemples : [White "Tal, Mikhail N."] [White "van der Wiel, Johan"] [White "Acme Pawngrabber v.3.2"] [White "Fine, R."] Black Le joueur noir Result Le résultat (* pour une partie en cours ou un résultat inconnu) [Result "0-1"] [Result "1-0"] [Result "1/2-1/2"] [Result "*"]
D'autres en-têtes facultatifs sont également possibles :
WhiteTitle, BlackTitle : titre des joueurs blanc et noir (GM, IM, -), WhiteElo, BlackElo : classement Elo des Blancs et des Noirs, WhiteUSCF, BlackUSCF : classement Elo américain des Blancs et des Noirs, WhiteNA, BlackNA : adresse électronique des joueurs blanc et noir, WhiteType, BlackType : human ou program (homme ou machine), EventDate : date de début du tournoi, EventSponsor : sponsor de l'événement, Section : open, Reserver, etc. Stage : Preliminary, Semifinal, ... (stade préliminaire, demi-finale, ...) Board : échiquier, Opening : ouverture, Variation : variante, SubVariation : sous-variante, ECO : code ECO, NIC : code NIC, Time : heure sous forme HH:MM:SS UTCTime : heure UTC UTCDate : date UTC Timecontrol : de la forme coups/temps (en s): par exemple: 40/7200, 300, 3600+30 SetUp : 0 pour la position initiale, 1 pour une position différente, FEN : la position initiale dans le standard de la notation Forsyth-Edwards Termination : résultat "abandoned" : abandon "adjudication" : décision "emergency" : urgence "normal" "rules infraction" : infraction aux règles "time forfeit" : perte au temps "unterminated" : partie inachevée Annotator : commentateur Mode: "OTB" (over the board), "PM" (paper mail), "EM" (electronic mail), "ICS" (Internet Chess Server), "TC" (general telecommunication). PlyCount: nombre de demi-coups
Commentaires Des commentaires peuvent apparaître dans les données PGN : soit introduits par un point-virgule ';', et le commentaire s'étend alors jusqu'à la fin de la ligne soit entouré d'accolades '{' et '}', les accolades ne peuvent être imbriquées.
Extensions
Si une ligne commence par le caractère « pour cent » (%) dans la première colonne, alors le reste de la ligne est destiné à une extension du format PGN et sera ignoré par les autres implémentations.
L’extension pgn étant faite de texte, les formats textes comme txt sont également possibles.
SAN Les coups joués sont décrits par le format SAN (Standard Algebraic Notation), qui se rapproche fort de la notation algébrique abrégée en anglais, toutefois : la promotion est indiquée par un signe "=" : e8=Q et non e8Q en cas d'ambigüité, on préfère toujours le nom de la colonne à celui de la rangée: Nce4 et non N3e4 il n'y a pas d'indication de la prise en passant le mat est indiqué par #, l'échec par +, il n'y a pas de signe particulier pour l'échec double
Des commentaires habituels tels que "!", "?", "!!", "!?", "?!", et "??" peuvent figurer à la fin du coup en format d'importation. En format d'exportation, ils seront remplacés par les NAG correspondants (voir plus loin)
NAG Les NAG (Numeric Annotation Glyph) sont des commentaires standardisés introduits par le caractère $ suivi d'un nombre, en voici la liste :
NAG de 0 à 9 Les NAG de 0 à 9 sont un commentaire du coup qui précède immédiatement :
0 null annotation : pas d'annotation 1 good move (traditional "!") : bon coup 2 poor move (traditional "?") : mauvais coup 3 very good move (traditional "!!") : coup excellent 4 very poor move (traditional "??") : très mauvais coup 5 speculative move (traditional "!?") : coup spéculatif 6 questionable move (traditional "?!") : coup douteux 7 forced move (all others lose quickly) : coup forcé (tous les autres coups perdent rapidement) 8 singular move (no reasonable alternatives) : seul coup (pas d'alternative raisonnable) 9 worst move : le plus mauvais coup
NAG de 10 à 135 Les NAG de 10 à 135 sont des commentaires sur la position :
10 drawish position : position égale 11 equal chances, quiet position : chances égales, position équilibrée 12 equal chances, active position : chances égales, position dynamique 13 unclear position : position peu claire 14 White has a slight advantage : les Blancs ont un avantage minime 15 Black has a slight advantage : les Noirs ont un avantage minime 16 White has a moderate advantage : les Blancs ont un avantage modéré 17 Black has a moderate advantage : les Noirs ont un avantage modéré 18 White has a decisive advantage : les Blancs ont un avantage décisif 19 Black has a decisive advantage : les Noirs ont un avantage décisif 20 White has a crushing advantage (Black should resign) : les Blancs ont un avantage insurmontable (les Noirs devraient abandonner) 21 Black has a crushing advantage (White should resign) : les Noirs ont un avantage insurmontable (les Blancs devraient abandonner) 22 White is in zugzwang : les Blancs sont en zugzwang 23 Black is in zugzwang : les Noirs sont en zugzwang 24 White has a slight space advantage : les Blancs ont un léger avantage spatial 25 Black has a slight space advantage : les Noirs ont un léger avantage spatial 26 White has a moderate space advantage : les Blancs ont un avantage spatial modéré 27 Black has a moderate space advantage : les Noirs ont un avantage spatial modéré 28 White has a decisive space advantage : les Blancs ont un avantage spatial décisif 29 Black has a decisive space advantage : les Noirs ont un avantage spatial décisif 30 White has a slight time (development) advantage : les Blancs ont un léger avantage de développement 31 Black has a slight time (development) advantage : les Noirs ont un léger avantage de développement 32 White has a moderate time (development) advantage : les Blancs ont un avantage de développement modéré 33 Black has a moderate time (development) advantage : les Noirs ont un avantage de développement modéré 34 White has a decisive time (development) advantage : les Blancs ont un avantage de développement décisif 35 Black has a decisive time (development) advantage : les Noirs ont un avantage de développement décisif 36 White has the initiative : les Blancs ont l'initiative 37 Black has the initiative : les Noirs ont l'initiative 38 White has a lasting initiative : les Blancs ont une initiative durable 39 Black has a lasting initiative : les Noirs ont une initiative durable 40 White has the attack : les Blancs sont à l'attaque 41 Black has the attack : les Noirs sont à l'attaque 42 White has insufficient compensation for material deficit : les Blancs ont une compensation insuffisante pour le matériel sacrifié 43 Black has insufficient compensation for material deficit : les Noirs ont une compensation insuffisante pour le matériel sacrifié 44 White has sufficient compensation for material deficit : les Blancs ont une compensation suffisante pour le matériel sacrifié 45 Black has sufficient compensation for material deficit : les Noirs ont une compensation suffisante pour le matériel sacrifié 46 White has more than adequate compensation for material deficit : les Blancs ont une nette compensation pour le matériel sacrifié 47 Black has more than adequate compensation for material deficit : les Noirs ont une nette compensation pour le matériel sacrifié 48 White has a slight center control advantage : Les Blancs ont un léger avantage au centre 49 Black has a slight center control advantage : les Noirs ont un léger avantage au centre 50 White has a moderate center control advantage : les Blancs ont un avantage modéré au centre 51 Black has a moderate center control advantage : les Noirs ont un avantage modéré au centre 52 White has a decisive center control advantage : les Blancs ont un avantage décisif au centre 53 Black has a decisive center control advantage : les Noirs ont un avantage décisif au centre