Portable Game Notation

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

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^{[réf. nécessaire]}.

NAG

Les NAG (Numeric Annotation Glyph) sont des commentaires standardisés introduits par le caractère $ suivi d'un nombre, en voici la liste :

Lecture des en-têtes

Détecter les crochets : [ et ] Le nom est à gauche de la valeur qui elle est entre guillemets : " "

Détection des coups

Découper les mots.

Pour chacun des mots :

• Soit le mot est un numéro de tour : 1. ; 2. ; ... ; 30. ; ...
• Soit le mot est un coup : voir paragraphe suivant et l'appliquer aux blancs si c'est le premier coup du tour
• Soit le mot est une fin de partie : 1/2-1/2 (nul) ; 1-0 (les blancs gagnent) ; 0-1 (les noirs gagnent) ; * (partie interrompue)

Analyse d'un coup

Recherche de la pièce :

• Si la première lettre est un O, il s'agit d'un roque, le roi et la tour bougent :
  • Si le mot est O-O, c'est un petit roque.
  • Si le mot est O-O-O, c'est un grand roque.
  • Alors le coup est analysé.
• Sinon, si la première lettre est K, Q, B, N ou R, il s'agit de Roi, Dame, Fou, Cavalier ou Tour :
  • On peut alors retirer la première lettre du mot.
• Sinon la pièce concernée est un pion (P).

Recherche du prérequis, pour distinguer deux pièces (ou plus) pouvant effectuer le coup :

• Si la première lettre est de a à h et la seconde un x ou une lettre de a à h
  • Prérequis : la pièce doit être dans la colonne désignée par cette lettre
  • On peut alors retirer la première lettre du mot.
• Sinon, si la première lettre est un chiffre de 1 à 8 et la seconde un x ou une lettre de a à h
  • Prérequis : la pièce doit être dans la ligne désignée par ce chiffre
  • On peut alors retirer la première lettre du mot.
• Sinon, si la première lettre est de a à h et si la seconde lettre est un chiffre de 1 à 8 et la troisième un x ou une lettre de a à h
  • Prérequis : la pièce doit être dans la case désignée par la lettre et le chiffre
  • On peut alors retirer la première et la seconde lettre du mot.
• Sinon, il n'y a pas de prérequis (donc pas d'ambiguité)

Cas d'une attaque, lorsque le déplacement capture une pièce ennemie :

• Si la première lettre est un x, alors il y a capture de la pièce ennemie :
  • On peut alors retirer la première lettre du mot.
• Sinon il n'y a pas de capture de pièce ennemie.

Coordonnées du déplacement en lui-même

• Première lettre : colonne (a,b,c,d,e,f,g,h)
• Seconde lettre (un chiffre) : ligne (1,2,3,4,5,6,7,8)
• On peut alors retirer la première et la seconde lettre du mot.

Promotion d'un pion :

• Si la première lettre est un signe =, alors il y a promotion :
  • La seconde lettre indique la nouvelle pièce, Q, B, N ou R pour Dame, Fou, Cavalier ou Tour
  • On peut alors retirer la première et la seconde lettre du mot.
• Sinon il n'y a pas de promotion.

Mise en échec du roi :

• Si la première lettre est un signe + ou un signe #, alors il y a échec :
  • On peut alors retirer la première lettre du mot.
• Sinon il n'y a pas échec.

Le coup est analysé.