Numeric Annotation Glyphs Explained

Numeric Annotation Glyphs or NAGs are used to annotate chess games when using a computer, typically providing an assessment of a chess move or a chess position. NAGs exist to indicate a simple annotation in a language independent manner.

NAGs were first formally documented in 1994 by Steven J. Edwards in his Portable Game Notation Specification and Implementation Guide.[1] Within the PGN specification, 256 NAGs are proposed of which the first 140 are defined; the remainder were reserved for future definition.

Introduction

A Numeric Annotation Glyph is composed of a dollar sign character ("$") immediately followed by one or more digit characters. Each NAG then has a specific meaning and often a standard typographical representation. The meanings first defined stemmed from the use of specific typographic symbols when annotators were commenting upon chess games; most especially in Chess Informant[2] publications. The objective was to devise an alternative representation of these symbols which could be incorporated in the simple computer file format proposed as the PGN standard. This mechanism allowed often sophisticated typography to be expressed using the simple ASCII character set.

Since its inception there has been no attempt to further formalise or standardise the meaning of the undefined 116 NAGs although PGN editors, such as ChessPad, have variously used these higher glyphs.

NAG Groupings
NAG rangeClassification
$0provided for the convenience of software designers as a placeholder value;should not appear in PGN files and has no typographic representation
$1-$9Move assessments
$10-$135Positional Assessments
$136-$139Time Pressure Commentaries
$140+not defined

Standard NAGs

NAGMeaningSymbolUnicode[3] HTML[4] Name
$0null annotation
$1good move (traditional "!") see also Nunn Convention for alternate meaningsU+0021!single exclamation mark
$2poor move or mistake (traditional "?") (and Nunn Convention)?U+003F?single question mark
$3very good or brilliant move (traditional "!") (and Nunn Convention)U+203Cdouble exclamation mark
$4very poor move or blunder (traditional "??") (and Nunn Convention)U+2047double question mark
$5speculative or interesting move (traditional "!?") (and Nunn Convention)U+2049exclamation question mark
$6questionable or dubious move (traditional "?!") (and Nunn Convention)U+2048question mark and exclamation mark
$7forced move (all others lose quickly) or only moveU+25A1□white square
$8singular move (no reasonable alternatives)
$9worst move
$10drawish position or even=U+003D=equal sign
$11equal chances, quiet position
$12equal chances, active position
$13unclear positionU+221E∞infinity
$14White has a slight advantageU+2A72⩲plus sign above equals sign
$15Black has a slight advantageU+2A71⩱equals sign above plus sign
$16White has a moderate advantage±U+00B1±plus-minus sign
$17Black has a moderate advantageU+2213∓minus-or-plus sign
$18White has a decisive advantage+ −U+002B U+002D+ -plus sign, hyphen-minus sign
$19Black has a decisive advantage− +U+002D U+002B- +hyphen-minus sign, plus sign
$20White has a crushing advantage (Black should resign)
$21Black has a crushing advantage (White should resign)
$22White is in zugzwangU+2A00⨀N-ary circled dot operator
$23Black is in zugzwang
$24White has a slight space advantage
$25Black has a slight space advantage
$26White has a moderate space advantageU+25CB○White circle
$27Black has a moderate space advantage
$28White has a decisive space advantage
$29Black has a decisive space advantage
$30White has a slight time (development) advantage
$31Black has a slight time (development) advantage
$32White has a moderate time (development) advantageU+27F3clockwise gapped circle arrow
$33Black has a moderate time (development) advantage
$34White has a decisive time (development) advantage
$35Black has a decisive time (development) advantage
$36White has the initiativeU+2191↑upwards arrow
$37Black has the initiative
$38White has a lasting initiative
$39Black has a lasting initiative
$40White has the attackU+2192→rightwards arrow
$41Black has the attack
$42White has insufficient compensation for material deficit
$43Black has insufficient compensation for material deficit
$44White has sufficient compensation for material deficitU+2BF9[5] ⯹equals sign with infinity below
$45Black has sufficient compensation for material deficit
$46White has more than adequate compensation for material deficit
$47Black has more than adequate compensation for material deficit
$48White has a slight center control advantage
$49Black has a slight center control advantage
$50White has a moderate center control advantage
$51Black has a moderate center control advantage
$52White has a decisive center control advantage
$53Black has a decisive center control advantage
$54White has a slight kingside control advantage
$55Black has a slight kingside control advantage
$56White has a moderate kingside control advantage
$57Black has a moderate kingside control advantage
$58White has a decisive kingside control advantage
$59Black has a decisive kingside control advantage
$60White has a slight queenside control advantage
$61Black has a slight queenside control advantage
$62White has a moderate queenside control advantage
$63Black has a moderate queenside control advantage
$64White has a decisive queenside control advantage
$65Black has a decisive queenside control advantage
$66White has a vulnerable first rank
$67Black has a vulnerable first rank
$68White has a well protected first rank
$69Black has a well protected first rank
$70White has a poorly protected king
$71Black has a poorly protected king
$72White has a well protected king
$73Black has a well protected king
$74White has a poorly placed king
$75Black has a poorly placed king
$76White has a well placed king
$77Black has a well placed king
$78White has a very weak pawn structure
$79Black has a very weak pawn structure
$80White has a moderately weak pawn structure
$81Black has a moderately weak pawn structure
$82White has a moderately strong pawn structure
$83Black has a moderately strong pawn structure
$84White has a very strong pawn structure
$85Black has a very strong pawn structure
$86White has poor knight placement
$87Black has poor knight placement
$88White has good knight placement
$89Black has good knight placement
$90White has poor bishop placement
$91Black has poor bishop placement
$92White has good bishop placement
$93Black has good bishop placement
$94White has poor rook placement
$95Black has poor rook placement
$96White has good rook placement
$97Black has good rook placement
$98White has poor queen placement
$99Black has poor queen placement
$100White has good queen placement
$101Black has good queen placement
$102White has poor piece coordination
$103Black has poor piece coordination
$104White has good piece coordination
$105Black has good piece coordination
$106White has played the opening very poorly
$107Black has played the opening very poorly
$108White has played the opening poorly
$109Black has played the opening poorly
$110White has played the opening well
$111Black has played the opening well
$112White has played the opening very well
$113Black has played the opening very well
$114White has played the middlegame very poorly
$115Black has played the middlegame very poorly
$116White has played the middlegame poorly
$117Black has played the middlegame poorly
$118White has played the middlegame well
$119Black has played the middlegame well
$120White has played the middlegame very well
$121Black has played the middlegame very well
$122White has played the ending very poorly
$123Black has played the ending very poorly
$124White has played the ending poorly
$125Black has played the ending poorly
$126White has played the ending well
$127Black has played the ending well
$128White has played the ending very well
$129Black has played the ending very well
$130White has slight counterplay
$131Black has slight counterplay
$132White has moderate counterplayU+21C6⇆leftwards arrow over rightwards arrow
$133Black has moderate counterplay
$134White has decisive counterplay
$135Black has decisive counterplay
$136White has moderate time control pressure
$137Black has moderate time control pressure
$138White has severe time control pressure / zeitnotU+2A01⨁n-ary circle plus operator
$139Black has severe time control pressure / zeitnot

Non-standard NAGs

NAGUsed byMeaningSymbolUnicodeHTMLName
$140ChessPad[6] With the idea...U+2206increment
$141ChessPadAimed against...U+2207nabla
$142ChessPadBetter is...U+2313⌓segment
$143ChessPadWorse is...<=less than, equal to
$144ChessPadEquivalent is...==equal to, equal to
$145ChessPadEditorial commentRRcapital R, capital R
$146ChessPadNoveltyNcapital N
$147–$219Not defined
$220ChessPadDiagram⬒ (UI only)
$221ChessPadDiagram (from Black)⬓ (UI only)
$222–$237Not defined
$238ChessPadSpace advantageU+25CB&cir;white circle
$239ChessPadFile (columns on the chessboard labeled a-h)U+21D4&hArr;left right double arrow
$240ChessPadDiagonalU+21D7&neArr;north east double arrow
$241ChessPadCentreU+229E&boxplus;squared plus
$242ChessPadKing-sideU+27EB&Rang;right double angle bracket
$243ChessPadQueen-sideU+27EA&Lang;left double angle bracket
$244ChessPadWeak pointU+2715multiplication x
$245ChessPadEndingU+22A5&perp;up tack
$246ChessPadBishop pairCA Chess font: white square with white square to northeast
$247ChessPadOpposite BishopsCA Chess font: white square with black square to northeast
$248ChessPadSame BishopsCA Chess font: black square with black square to northeast
$249ChessPadConnected pawnsU+2BFA&#x2bfa;united symbol
$250ChessPadIsolated pawnsU+2BFB&#x2bfb;separated symbol
$251ChessPadDoubled pawnsU+2BFC&#x2bfc;doubled symbol
$252ChessPadPassed pawnU+2BFD&#x2bfd;passed symbol
$253ChessPadPawn majoritytext
$254ChessPadWithU+221F&#x221f;right angle
$255ChessPadWithoutU+2BFE&#x2bfe;reversed right angle

Notes on tables

  1. Some of the symbols are not rendered by some browsers
  2. The more exotic symbols used by Chess Informator are often derived from common mathematical typographic symbols; their mathematical meaning rarely has any relevance to their chess meaning
  3. The entries in the Unicode column are, respectively, the decimal and hexadecimal reference for the character or symbol
  4. The entries in the HTML column are named HTML entities for representing the symbol or character; the Unicode numeric value can always be used where a specific entity does not exist. For example, the left right double arrow ($239) can be represented as either Unicode decimal &#8660; (⇔) or Unicode hexadecimal &#x21D4; (⇔) or HTML &hArr; (⇔). Unless explicitly noted, the Unicode representation can be interpreted as a default.

See also

References

  1. Web site: Formal PGN File Specification:section 8.2.4 defines 256 NAGs while section 10 identifies first 140 NAGs. 1 Oct 2016. 1994.
  2. Web site: Chess Informant: System of Signs. https://web.archive.org/web/20170101061157/http://www.chessinformant.org/pages.php?pageid=15. 2017-01-01. Uses FigurineCB webfont.
  3. Web site: Unicode and multilingual support in HTML, fonts, Web browsers and other applications. Alan. Wood. www.alanwood.net.
  4. Web site: Character Entity Reference Chart. HTML5 (W3C).
  5. Book: Character Code Charts . The Unicode Consortium . 2022 . Unicode Consortium . Subsection "Symbols used in chess notation" . en . Miscellaneous Symbols and Arrows . PDF . https://www.unicode.org/charts/PDF/U2B00.pdf . PDF.
  6. Web site: ChessPad: a PGN editor. www.wmlsoftware.com.

Sources

Krogius, N; Livsic, A; Parma, B; Tajmanov, M. Encyclopedia of Chess Middlegames. (1980) Belgrade: Chess Informant.

Malanovic, Aleksander (Editor) Encyclopedia of Chess Openings, volumes A-E. (1978) Belgrade: Chess Informant.