Smart Game Format

Smart Game Format
Filename extension	.sgf
Developed by	Anders Kierulf (1987, FF1), Martin Mueller (1993, FF3), Arno Hollosi (1997, FF4)
Initial release	1987
Latest release	4; 1997
Type of format	mark up text
Container for	Go (game) record
Open format?	yes
Website	red-bean.com/sgf/

The Smart Game Format (SGF) is a file format used for storing records of board games. Go is the game that is most commonly represented in this format and is the default. SGF was originally created under a different name by Anders Kierulf for his SmartGO program.

The main purposes of SGF are to store records of played games and to provide features for storing annotated and analyzed games (e.g. board markup, variations). It is a text-only, tree-based format.

Most Internet Go servers and Go software from 1990 support this format.

About the format[edit]

An SGF file is composed of pairs of properties and property values, each of which describes a feature of the game. A partial list of properties appears below.^[1]

AB	Add Black: locations of Black stones to be placed on the board prior to the first move
AW	Add White: locations of White stones to be placed on the board prior to the first move.
AN	Annotations: name of the person commenting the game.
AP	Application: application that was used to create the SGF file (e.g. CGOban2,...).
B	a move by Black at the location specified by the property value.
BR	Black Rank: rank of the Black player.
BT	Black Team: name of the Black team.
C	Comment: a comment.
CP	Copyright: copyright information.
DT	Date: date of the game.
EV	Event: name of the event (e.g. 58th Honinbō Title Match).
FF	File format: version of SGF specification governing this SGF file.
GM	Game: type of game represented by this SGF file. A property value of 1 refers to Go.
GN	Game Name: name of the game record.
HA	Handicap: the number of handicap stones given to Black. Placement of the handicap stones are set using the AB property.
KM	Komi: komi.
ON	Opening: information about the opening (Fuseki), rarely used in any file.
OT	Overtime: overtime system.
PB	Black Name: name of the black player.
PC	Place: place where the game was played (e.g.: Tokyo).
PL	Player: color of player to start.
PW	White Name: name of the white player.
RE	Result: result, usually in the format "B+R" (Black wins by resign) or "B+3.5" (black wins by 3.5).
RO	Round: round (e.g.: 5th game).
RU	Rules: ruleset (e.g.: Japanese).
SO	Source: source of the SGF file.
SZ	Size: size of the board, non-square boards are supported.
TM	Time limit: time limit in seconds.
US	User: name of the person who created the SGF file.
W	a move by White at the location specified by the property value.
WR	White Rank: rank of the White player.
WT	White Team: name of the White team.

There is no strict checking of the contents of these tags, so it is possible to put any text into the result tag for example.

Variations are nested in brackets, and also usually assigned letters. The first branch (variation A) is the main branch.^[2] This notation stems from Newick format.

Coordinate system for points and moves[edit]

The first letter designates the column (left to right), the second the row (top to bottom). The upper left part of the board is used for smaller boards, e.g. letters "a"-"m" for 13*13.

The author intentionally broke with the tradition of labeling moves (and points) with letters "A"-"T" (excluding "i") and numbers 1-19. Two lower-case letters in the range "a"-"s" were used instead, for reasons of simplicity and compactness.

The upper left corner as origin of the board corresponds to the way most modern computers represent screen coordinates to simplify integration of text and graphics.

Supported games[edit]

Games currently supported^[3] are Amazons, Ataxx, Backgammon, Blokus,^[4] Byte, Chase, Chess, DVONN, Exxit, Focus, Gess, GIPF, Go, Gobblet, Gomoku+Renju, Hex, Hive, Hnefatafl, Jungle, Kropki, Kuba, Lines of Action, Neutron, Nine men's morris, Octi, Philosopher's Football, Plateau, PÜNCT, Quadrature, Reversi (Othello), Sahara, Shogi, TAMSK, Tantrix, Trax, Tripples, Tumbling Down, TwixT, Xiangqi, YINSH and ZÈRTZ. Although not officially supported, the sgf format is also used for Meridians. The standard specifies additional game-specific properties for Go, Backgammon, Lines of Action, Hex, Amazons, Octi, Gess, and TwixT.

Format Versions[edit]

The first version of SGF, FF[1], was conceived by Anders Kierulf in 1987. It is Appendix A in his Ph.D. thesis.^[5] FF[3] was written by Martin Müller in 1993. The current version of the SGF is FF[4] by Arno Hollosi, and is supported by most current SGF readers. FF[2] was never made public. The format has been published under the Open Content License. Current development status (2016) is "not active".

FF[4] is outdated, but has not been replaced by something more recent. For a description of current usage and some recommendations, see.^[6]

Limitations[edit]

The FF[4] standard has some problems that make it impossible, or at least unreasonable, to adopt it for large game collections. For some discussion, see.^[7]

The fact that there is no standard designation for many properties that one might wish to represent is not really a limitation. The system is extensible, one can invent new labels, and of course that has happened already. After a while, the popular ones among the new labels become standard.

References[edit]

^ "SGF file format FF[4]". red-bean.com. 6 August 2006. Retrieved 2 June 2023.
^ "SGF - Variations". red-bean.com. 7 January 1999. Retrieved 2 June 2023.
^ https://homepages.cwi.nl/~aeb/go/misc/sgf.html
^ https://github.com/enz/pentobi/blob/master/libpentobi_base/Pentobi-SGF.md
^ "Definition of the Smart Game Format". British Go Association. Retrieved 2 June 2023.
^ "The SGF Format".
^ "Notes on the SGF format".

External links[edit]

Sensei's Library SGF page

[1] "SGF file format FF[4]". red-bean.com. 6 August 2006. Retrieved 2 June 2023.

[2] "SGF - Variations". red-bean.com. 7 January 1999. Retrieved 2 June 2023.

[3] ttps://homepages.cwi.nl/~aeb/go/misc/sgf.html

[4] ttps://github.com/enz/pentobi/blob/master/libpentobi_base/Pentobi-SGF.md

[5] "Definition of the Smart Game Format". British Go Association. Retrieved 2 June 2023.

[6] "The SGF Format".

[7] "Notes on the SGF format".

[1]

[2]

[3]

[4]

[5]

[6]

[7]

v t e Go
Overview	Handicaps Komi Rules
Equipment	Bowls Goban Katsura Kaya Stones Clamshell Slate Yunzi
Terms	Aji Atari Board positions Dame Divine move Double hane Eyes Gote, sente and tenuki Hane Hayago Jigo Joseki Kakari Keima Kiai Kikashi Ko Komi Korigatachi Kosumi Ladder Liberty Miai Monkey jump Moyo Myoushu Nakade Nerai Myoushu Peep Pincer Probe Sabaki Seki Sente Shape Shoulder hit Tesuji Thickness Yose
Strategy and tactics	Capturing race Fuseki Chinese Kobayashi Shinfuseki Shusaku Jōseki Nadare Taisha Ko fight Ladder Life and death Mirror Go Opening theory Proverbs Shape Empty triangle Ponnuki Tenuki Tsumego
History	Classic of Arts Dunhuang Go Manual Emperor Yao Four Go houses Four arts Hoensha 9 Pin Zhi Oskar Korschelt Oshirogo Players European players Female players Nihon Ki-in Hall of Fame Professional handicaps
Competition	Go professional Ranks and ratings Dan Kyū Honorary titles Jubango Title holders Tournaments
Games and matches	AlphaGo vs. Fan Hui AlphaGo vs. Ke Jie AlphaGo vs. Lee Sedol Atomic bomb game Blood-vomiting game Ear-reddening game The Game of the Century Kamakura jubango Lee's broken ladder game
Art and media	AlphaGo The Divine Move The Girl Who Played Go The Go Master The Go Player Go World Hikaru no Go Igo Hatsuyōron Long Ode to Watching Weiqi The MANIAC The Master of Go Ranka Sensei's Library Shibumi The Surrounding Game The Weiqi Devil
Computers	Computer Go UEC Cup Engines AlphaGo AlphaGo Master AlphaGo Zero AlphaZero Crazy Stone Darkforest Fine Art GNU Go KataGo Leela Leela Zero Zen Future of Go Summit Monte Carlo tree search Smart Game Format Servers KGS Go Server Pandanet Tygem
Organizations	American Go Association Australian Go Association British Go Association China China Qiyuan Chinese Weiqi Association Hong Kong Go Association European Go Federation French Federation of Go International Go Federation Irish Go Association Japan All Japan Student Go Federation Kansai Ki-in Nihon Ki-in Korea Korea Baduk Association Myongji University Mind Sports Organisation New Zealand Go Society Singapore Weiqi Association Taiwan Chi Yuan Culture Foundation
Other	Benson's algorithm Game record (kifu) Games played with Go equipment Go and mathematics Variants Batoo Capture go Sygo
Go portal Category