with special symbols in Windows programs via AutoHotkey script
[Update from 23 October 2019]
for the purpose of:
separation of the engine's principal variations from the move annotations so that the
variations can be replayed in the chess GUI;
separation of the engine evaluations from the move annotations so that the evaluations
can be visually retraced in the game history by means of diagrams;
modification, elimination and addition of various informations in the move annotations
for better comprehensibility.
Download manual for the TCEC-PGN-files of various chess tournaments and games:
the modified text can then be saved again in the editor.
The following abbreviations are used in the move annotations:
SD – search depth/selective search depth
MT – move time in seconds, if < 1 second in milliseconds
RT – remaining time in seconds, if < 1 second in milliseconds
EM – in the opponent's previous half move expected move
SP – speed of position calculation - calculated positions per second
CP – calculated positions
TB – tablebase hits
R50 – remaining moves before application of the 50-move-draw-rule
Quantity abbreviations:
m – Milli 1/1,000
k – Kilo 1,000
M – Mega 1,000,000
G – Giga 1,000,000,000
In the replacement text, in particular the abbreviations and the English figure names (K Q R B N) can be
changed at will.
Information about the material balance has been omitted as it is graphically represented by both chess GUIs.
The program Notepad++ can be downloaded free of charge from the Internet.
Technical information on the regular expressions used:
Named capturing groups are used for the purpose of clarity and maintainability of the
code. Not all RegExp dialects are able to process this code correctly, especially the replacement code. In
this respect the programs LibreOffice and Grepwin for example are unsuitable.
The complexity of the code is not least due to the diverging annotation formats of TCEC
throughout its history. The format of Season 1, Division 1 to 3, is not supported because there are not
even principal variations specified.
A preventive note for users who want to present the search code directly in the browser
with the '<' and '>' characters instead of the HTML entities ‘<’ and ‘>’ intended for
this purpose: You can't! The code contains RegExp capturing groups that resemble HTML tags, so they are
interpreted as such in the browser and are not displayed correctly. The code must therefore first be
encoded, which can be achieved here on the Internet. In the Notepad++ ‘Find what :’ field this modified code
taken from the browser does not differ from the original.
Special information for Aquarium:
Move evaluations can be presented in Aquarium as a diagram by clicking on ‘Analysis’ in
the menu bar and on the ‘Chart’ button. They must be placed somewhere within the brackets ‘{’ and ‘}’ with
or without further comment in the format ‘[%eval x]’, where ‘x’ represents an evaluation in hundredths of a
pawn unit (for example ‘100’ instead of ‘1.00’). Plus signs are not required, negative signs are.
The PGN files modified for Aquarium contain codes for the game moves with which these
can be marked according to positive or negative evaluation as well as after moves for White or Black in
colour or by writing format. In order to avoid repetitions, reference is made to the explanations to be
found here on the Internet under point 12g) ‘Formatted
moves in the PGN file’).
The following move styles are used:
style
moves of the board side
evaluation
recommended color
Special Style 25
White/Black
0.00
Special Style 26
White
> 0
light green
Special Style 27
White
< 0
light red
Special Style 28
Black
< 0
dark green
Special Style 29
Black
> 0
dark red
If the user should not attach importance to the move styles, he can be content for
Aquarium with the following replacement code:
It is absolutely necessary to avoid opening PGN files from paths that use German
umlauts: It won't work!
Move evaluations and times can be presented in Scid vs. PC by clicking on ‘Tools’ in
the menu bar and on ‘Score Graph’ in the menu. By clicking on ‘Graph’ in the menu, various options can be
selected. In the case of ‘Score Combo’, the total time up to the respective move is apparently displayed.
The option ‘Time Combo’ seems to be unsuitable.
Move evaluations must be positioned somewhere within the (only) brackets ‘{’ and ‘}’
with or without further comment in the format ‘±x.yz’ (the format chosen by the script), ‘[% ±x.yz]’ or
‘[%eval ±x.yz]’. The latter two can be hidden in the PGN window by checking the box in the ‘PGN’ menu →
‘Options’ → ‘Hide square/arrow codes’.
Precondition for the move time diagram are move time informations in the annotations in
the format ‘[%emt hh:mm:ss]’ or - if the TCEC PGN file only contains seconds information - in the (due to
lack of documentation improvised) format ‘[%emt 0:x]’ (‘x’ stands for a number with a minimum height of 1
to about 5 digits). The replacement code makes this formatted informations available at the end of the
annotation, where it is less annoying. They can be hidden again by activating ‘PGN’ menu → ‘Options’ →
‘Hide square/arrow codes’. ‘emt’ stands for ‘elapsed move time’.
Mistakes are there to be made, and the author of these lines is a doer. In this sense:
Contact: mail@konrod.info
Ende Gelände ♦ Aus die Maus ♦ Schicht im Schacht ♦ Klappe zu - Affe tot
So long ♦ See You Later, Alligator - In A While, Crocodile ♦ Over And Out