SGF棋谱属性详解

1、比赛信息属性列表NamePropertNotes执黑者 姓名/执 白者姓 名PB/PW执黑者或执白者的姓名尽量保持姓名的一致，职业棋手推荐使用官方公布的姓名。执黑者 级别/执 白者级 别BR/WR执黑者或执白者的棋力推荐使用下列格式：具有“级别”的棋手，使用“ 10k”或“10 kyu”具有“段位”的棋手使用“ 3d ”或“3 dan”围棋服务器通常在被确定的段位后加“*”，在不被确定的段位后加“？”，例如“ 10k*”、“3d?”由于围棋服务器段位和被围棋机构正式授予的段位都用“d”表示容易混 淆，些应用软件使用“p”作为被围棋机构正式授予的段位，以示区别。执黑者 队名/执 白者队 名BT/

2、WT执黑者或执白者所在的队名比赛结 果RE比赛结果强制使用以下格式：0表示和局B+score表示黑胜W+score表示白胜，例如B+2.5, W+64 or B+0.5 B+R/B+Resign 和W+R/W+Resign表示中盘胜 你不能写作“黑中盘胜”贴还KM贴还（指贴还后手方的数目）强制使用以下格式：使用实数，例如：5.5, 0, 0.5 or -10,等不要使用：5点，半目，五又一分之一子，等让子HA让子的数目强制使用以下格式：使用大于零的整数，例如：1, 5 or 9不要使用：二子，三等时间限 制TM每方规定的使用时间强制使用以下格式：时间使用以秒为单位的实数，例如4600, 300

3、不要使用：1小时如果你的应用软件不能把实数转换成易读的格式， 是一件尴尬的事情，尽管如此，还是请坚持使用实数值。比赛日 期DT比赛时间强制使用以下格式：使用ISO标准格式YYYY-MM-DD不要使用其它的分隔符诸如/或 或”：.赛事名 称EV赛事的名称（例如：应氏杯）回合数RO比赛的回合数，用于番棋比赛地 点八、PC比赛发生的地点（例如城市、国家），也可以是围棋网络服务器比赛规 则RU比赛规则（例如：中国规则、日本规则、韩国规则、应氏规则等）比赛名 称GN比赛的名称开局ON描述开局（例如：三连星）比赛评 论GC对比赛的一般的评论棋谱来 源SO棋谱来源（例如：书、杂志等）棋谱录 入US录入棋谱的

4、人或程序棋谱评 论AN评注者姓名版权信 息CP棋谱的版权信息其它属性目录走子属性B（Black，黑走子）,KO（KO,强制走子）,MN（set Move Number,设置手数）,W（White,白 走子）设置属性AB（Add Black,增加黑子）,AE（Add Empty,删除棋子）,AW（Add White,增加白子）, PL（PLayer to play,轮谁走）节点注释属性C（Comment，评论），DM（Even position,两分），GB（Good for Black，黑好），GW（Good for White,白好）,HO（HOtspot,热点）,N（Nodename,给节

5、 点命名）,UC（UnClear postion，形势不明）,V（Valu。形势判断）走子注释属性BM（Bad Move,恶手），DO（DOubtful,疑问手），IT（INteresting,有趣手），TE（TEsuji 或 Good Move,手筋或妙手）标记属性AR（ARrow,箭头），CR（CiRcle,圆形），DD（Dim position,模糊变虚），LB（LaBel,棋盘标 签），LN（LiNe,直线），MA（MArk,X 形记号），SL（SeLected,选择），SQ（SQuare,方块）, TR（TRiangle,三角）根属性AP（APplication,应用软件）,CA（C

6、hArset,字符集）,FF（File Format,文件格式）, GM（GaMe,对局类别）,ST（STyle分支显示风格）,SZ（SiZe，棋盘大小）对局信息属性AN（ANnotator,注解者），BR（Black Rank,执黑者等级），BT（Black Team，执黑者队名）, CP（CoPyright,版权）,DT（DaTe，对局日期）,EV（EVent name,赛事名称）,GN（Game Name，对局名称）,GC（Game Comment，对局评论）,ON（OpeNing name，开局名称）, OT（OverTime,读秒方式）,PB（Player Black，执黑者）,PC

7、（PlaCe,对局地点）,PW（Player White,执白者），RE（REsult，对局结果），RO（ROunt，对局轮次），RU（RUles,对局规则）, SO（SOurce,棋谱来源）,TM（TiMelimit,对局时限）,US（USer,录入者）,WR（White Rank,执白者等级）,WT（White Team执白者队名）时间属性BL（Black time Left,执黑者剩余时间）,OB（Ot stone Black,执黑者在读秒期限内尚需 完成的手数）,OW（Ot stone White,执白者在读秒期限内尚需完成的手数）, WL（White time Left，执白者剩余时

8、间）其它未被分类的属性FG（FiGure,图形选项）,PM（Print Manner打印方式）,VW（VieW,可视区域）走子属性属性：B属性值：走子属性类型：走子功能：执行一个黑走子。在实战对局集中这是最常用的属性之一。只要该属性在句法上是正确的，走子就应当被执行，即使该走子不符合规则 （例如由KO属性指定的强制走子）。参看如何执行一个围棋走子。属性B和属性W不能处于同一个节点中。相关属性：W, KO属性：KO属性值：无值属性类型：走子功能：执行一个由属性B或W指定的走子，即使该走子不符合规则。这是一个可选的属性，SGF阅读器本身应当执行所有的走子。设立该属性是为了使其它应用软件（如计算机对

9、局者）可以更容易处理不符 合规则的走子。在包含属性KO的节点中，如果没有黑走子或白走子，则是非法的。相关属性：W, B属性：MN属性值：数属性类型:走子功能：设定手数的数值，就是指定该节点中走子具有这个确定的手数。该属性对于分支或打印很有用。相关属性：B, W, FG, PM属性：W属性值：走子属性类型:走子功能：执行一个白走子。在实战对局集中这是最常用的属性之一。只要该属性在句法上是正确的，走子就应当被执行，即使该走子不符合规则（例如由KO属性指定的强制走子）。参看如何执行一个围棋走子。属性B和属性W不能处于同一个节点中。相关属性：B, KO设置属性限制属性AB, AW和AE指定的点必须唯一

10、，就是说，在一个节点中在相同的点上放置不同色的棋子是非法 的。不能使用属性AB, AW和AE改变棋盘，就是说，在已经有黑子的点上再使用属性AB放置一枚黑子 是不好的风格。应用软件会删除这个值并且给出一条警告。属性：AB属性值：由棋子组成的列表属性类型：设置功能：在棋盘上增加黑子。该属性可用于设置棋形或问题。增加黑子就是在指定的点用黑子“覆盖”，无论该位置之前是什么情况。增加棋子不导致任何提子，也不导致任何其它吃子（例如自杀）。这样可能在棋盘上产生非法的棋子位置。被指定的点必须唯一。相关属性：AW, AE, PL属性：AE属性值：list of点属性类型：设置功能：清除棋盘上指定位置的棋子。该属

11、性可用于设置棋形或问题。清除棋子就是在指定的点用无子“覆盖”，无论该位置之前是什么情况。清除棋子不计入被提子数。被指定的点必须唯一。相关属性：AB, AW, PL属性：AW属性值：list of棋子属性类型：设置功能： 在棋盘上增加白子。该属性可用于设置棋形或问题。增加白子就是在指定的点用白子“覆盖”，无论该位置之前是什么情况。增加棋子不导致任何提子，也不导致任何其它吃子（例如自杀）。这样可能在棋盘上产生非法的棋子位置。被指定的点必须唯一。相关属性：AB, AE, PL属性：PL属性值：颜色属性类型：设置功能：属性PL描述轮谁走子。该属性可用于设置位置或问题。相关属性：AE, AB, AW节点

12、注释属性属性：c属性值：文本属性类型：-功能：提供该节点的一段评论文字。Provides a comment text for the given node. The purpose of providing both a node name and a comment is to have a short identifier like doesnt work or Dia. 15 that can be displayed directly with the properties of the node, even if the comment is turned off or shown

13、 in a separate window. See text-type for more info.相关属性：N, ST, V, UC, DM, HO属性：DM属性值：程度属性类型：-功能：形势是两分。SGF阅读器应当显示一条信息。The position is even. SGF viewers should display a message. This property may indicate main variations in opening libraries (joseki) too. Thus DM2 indicates an even result for both pl

14、ayers and that this is a main variation of this joseki/opening.This property must not be mixed with UC, GB or GW within a node.相关属性： UC, GW, GB属性： GB属性值：程度属性类型：-功能：黑好。SGF阅读器应当显示一条信息。Something good for black. SGF viewers should display a message. The property is not related to any specific place on t

15、he board, but marks the whole node instead.GB must not be mixed with GW, DM or UC within a node.相关属性：GW, C, UC, DM属性： GW属性值：程度属性类型：-功能：白好。SGF阅读器应当显示一条信息。Something good for white. SGF viewers should display a message. The property is not related to any specific place on the board, but marks the whole

16、 node instead.GW must not be mixed with GB, DM or UC within a node.相关属性： GB, C, UC, DM属性：HO属性值：程度属性类型：-功能： Node is a hotspot, i.e. something interesting (e.g. node contains a game-deciding move).SGF viewers should display a message.The property is not related to any specific place on the board, but

17、marks the whole node instead.Sophisticated applications could implement the navigation command next/previous hotspot.相关属性： GB, GW, C, UC, DM属性： N属性值：单文本属性类型：-功能： Provides a name for the node. For more info have a look at the C-property.相关属性：C, ST, V属性： UC属性值：程度属性类型：-功能： The position is unclear. SGF

18、viewers should display a message. This property must not be mixed with DM, GB or GW within a node.相关属性：DM, GW, GB属性：V属性值：实数属性类型：-功能： Define a value for the node. Positive values are good for black, negative values are good for white.The interpretation of particular values is game-specific.In Go, thi

19、s is the estimated score.相关属性：C, N, RE走子注释属性属性： BM属性值：程度属性类型：走子功能： The played move is bad.Viewers should display a message.相关属性：TE, DO, IT属性：DO属性值：无值属性类型： 走子功能： The played move is doubtful.Viewers should display a message.相关属性： BM, TE, IT属性： IT属性值：无值属性类型： 走子功能： The played move is interesting.Viewers

20、 should display a message.相关属性： BM, DO, TE属性： TE属性值：程度属性类型： 走子功能： The played move is a tesuji (good move).Viewers should display a message.相关属性： BM, DO, IT标记属性属性：AR属性值： list of composed 点： 点属性类型：-功能： Viewers should draw an arrow pointing FROM the first point TO the second point.It,s illegal to speci

21、fy the same arrow twice,e.g. (Go) ARaa:bbaa:bb. Different arrows may have the same starting or ending point though.It,s illegal to specify a one point arrow, e.g. ARcc:cc as it,s impossible to tell into which direction the arrow points.相关属性：TR, CR, LB, SL, MA, SQ, LN属性：CR属性值： list of 点属性类型：-功能： Mark

22、s the given points with a circle.Points must be unique.相关属性： TR, MA, LB, SL, AR, SQ, LN属性： DD属性值： elist of 点属性类型：后继性功能： Dim (grey out) the given points.Have a look at the picture to get an idea.DD clears any setting, i.e. it undims everything.相关属性：VW属性： LB属性值： list of composed 点：,单文本属性类型：-功能： Writes

23、 the given text on the board. The text should becentered around the given point. Note： theres no longer a restriction to the length of the text to be displayed. Have a look at the FF4 example file on possibilities to display long labels (pictures five and six).Points must be unique.相关属性： TR, CR, MA,

24、 SL, AR, SQ, LN属性： LN属性值： list of composed 点,：, 点属性类型：-功能： Applications should draw a simple line form one point to the other.It,s illegal to specify the same line twice,e.g. (Go) LNaa:bbaa:bb. Different lines may have the same starting or ending point though.It,s illegal to specify a one point line

25、, e.g. LNcc:cc.相关属性：TR, CR, MA, SL, AR, SQ, LB属性：MA属性值：list of点属性类型：-功能： Marks the given points with an X.Points must be unique.相关属性：TR, CR, LB, SL, AR, SQ, LN属性：SL属性值：list of点属性类型：-功能： Selected points. Type of markup unknown(though SGB inverts the colors of the given points).Points must be unique.相

26、关属性：TR, CR, LB, MA, AR, LN属性：SQ属性值:list of点属性类型：-功能： Marks the given points with a square.Points must be unique.相关属性：TR, CR, LB, SL, AR, MA, LN属性：TR属性值：list of点属性类型：-功能： Marks the given points with a triangle.Points must be unique.相关属性：MA, CR, LB, SL, AR, LN6.根属性属性：AP属性值：composed单文本：单文本属性类型：根功能： Pro

27、vides the name and version number of the application used to create this gametreeThe name should be unique and must not be changed for different versions of the same program.The version number itself may be of any kind, but the format used must ensure that by using an ordinary string-compare, one is

28、 able to tell if the version is lower or higher than another version number.Here,s the list of known applications and their names:ApplicationSystem NameCGoban:1.6.2Hibiscus:2.1IGS:5.0Many Faces of Go:10.0MGT:?NNGS:?Primiview:3.0SGB:?SmartGo:1.0UnixWindows 95WindowsDOS/Unix UnixAmiga OS3.0 Macintosh

29、Windows95CGobanHibiscus Go EditorInternet Go ServerThe Many Faces of GoMGTNo Name Go Server PrimiviewSmart Game Board SmartGo相关属性：FF, GM, SZ, ST, CA属性：CA属性值：单文本属性类型：根功能： Provides the used charset for SimpleText and Text type.Default value is ISO-8859T aka Latin1.Only charset names (or their aliases)

30、 as specified in RFC 1345 (or updates thereof) are allowed.Basically this field uses the same names as MIME messages in their charset=field (in Content-Type).RFC,s can be obtained via FTP from DS.INTERNIC.NET NIS.NSF.NET, WUARCHIVE.WUSTL.EDU, SRC.DOC.IC.AC.UK or HYPERLINK ftp:/ftp.imag.fr/pub/archiv

31、e/IETF/rfc ftp:/ftp.imag.fr/pub/archive/IETF/rfc相关属性：FF, C, text type属性：FF属性值：数(range: 1-4)属性类型：根功能： Defines the used file format. For difference between those formats have a look at the history of SGF.Default value: 1Applications must be able to deal with different file formats within a collection

32、相关属性：GM, SZ, ST, AP, CA属性：GM属性值：数(range: 1-16)属性类型：根功能： Defines the type of game, which is stored in the current gametree. The property should help applications to reject games, they cannot handle.Valid numbers are: Go = 1, Othello = 2, chess = 3,Gomoku+Renju = 4, Nine Mens Morris = 5, Backgammon =

33、6, Chinese chess = 7, Shogi = 8, Lines of Action = 9, Ataxx = 10, Hex = 11, Jungle = 12, Neutron = 13, Philosophers Football = 14, Quadrature = 15, Trax = 16, Tantrix = 17, Amazons = 18, Octi = 19, Gess = 20. Default value: 1 Different kind of games may appear within a collection. 相关属性： FF, SZ, ST,

34、AP, CA属性： ST属性值：数(range: 0-3)属性类型： 根功能： Defines how variations should be shown (this is needed tosynchronize the comments with the variations). If ST is omitted viewers should offer the possibility to change the mode online. Basically most programs show variations in two ways:as markup on the board

35、(if the variation contains a move) and/or as a list (in a separate window).The style number consists two options.show variations of successor node (children) (value: 0) show variations of current node (siblings) (value: 1) affects markup & listdo board markup(value: 0)no (auto-) board markup (value:

36、 2) affects markup only.Using no board markup could be used in problem collections or if variations are marked by subsequent properties.Viewers should take care, that the automatic variation board markup DOESNT overwrite any markup of other properties.The final number is calculated by adding the val

37、ues of each option. Example: 3 = no board markup/variations of current node1 = board markup/variations of current nodeDefault value: 0相关属性：C, FF, GM, SZ, AP, CA属性：SZ属性值：(数composed数：数)属性类型：根功能： Defines the size of the board. If only a single valueis given, the board is a square; with two numbers give

38、n, rectangular boards are possible.If a rectangular board is specified, the first number specifies the number of columns, the second provides the number of rows. Square boards must not be defined using the compose type value： e.g. SZ19：19 is illegal.The valid range for SZ is any size greater or equa

39、l to 1x1.For Go games the maximum size is limited to 52x52.Default value： game specificfor Go： 19 (square board)for Chess： 8 (square board)Different board sizes may appear within a collection.See move-/point-type for more info.相关属性：FF, GM, ST, AP, CA7.对局信息属性属性：AN属性值：单文本属性类型：对局信息功能： Provides the name

40、 of the person, who made the annotations to the game.相关属性：US, SO, CP属性：BR属性值：单文本属性类型： 对局信息功能： Provides the rank of the black player.For Go (GM1) the following format is recommended：.k or .kyu for kyu ranks and .d or .dan for dan ranks.Go servers may want to add ? for an uncertain rating and * for an

41、 established rating.相关属性：PB, BT, WR属性：BT属性值：单文本属性类型：对局信息功能：Provides the name of the black team, if game was part of ateam-match (e.g. China-Japan Supermatch).相关属性：PB, PW, WT属性：CP属性值：单文本属性类型：对局信息功能：Any copyright information (e.g. for the annotations) shouldbe included here.相关属性：US, SO, AN生生生赤 性性性 属属属

42、功DTgame was played.It is MANDATORY to use the ISO-standard format for DT. Note: ISO format implies usage of the Gregorian calendar. Syntax:YYYY-MM-DD year (4 digits), month (2 digits), day (2 digits) Do not use other separators such as /， , ， or . Partial dates are allowed:YYYY - game was played in

43、YYYYYYYY-MM - game was played in YYYY, month MMFor games that last more than one day: separate other dates by a comma (no spaces!); following shortcuts may be used: MM-DD - if preceded by YYYY-MM-DD, YYYY-MM, MM-DD, MM or DD MM - if preceded by YYYY-MM or MMDD - if preceded by YYYY-MM-DD, MM-DD or D

44、D Shortcuts acquire the last preceding YYYY and MM (if necessary).Note: interpretation is done from left to right. Examples:1996-05,06 = played in May,June 1996相关属性:1996-05-06,07,08 = played on 6th,7th,8th May 1996 1996,1997 = played in 1996 and 1997 1996-12-27,28,1997-01-03,04 = played on 27th,28th

45、 of December 1996 and on 3rd,4th January 1997 Note: its recommended to use shortcuts whenever possible, e.g. 1997-05-05,06 instead of 1997-05-05,1997-05-06 EV, RO, PC, RU, RE, TM属性：EV属性值：单文本属性类型：对局信息功能： Provides the name of the event (e.g. tournament).Additional information (e.g. final, playoff,.) s

46、houldnt be included (see RO).相关属性：GC, RO, DT, PC, RU, RE, TM属性：GN属性值：单文本属性类型： 对局信息功能： Provides a name for the game. The name is used to easily find games within a collection The name should therefore contain some helpful information for identifying the game. GameName could also be used as the file-n

47、ame, if a collection is split into single files.相关属性：GC, EV, DT, PC, RO, ID属性： GC属性值：文本属性类型： 对局信息功能： Provides some extra information about the following game.The intend of GC is to provide some background information and/or to summarize the game itself.相关属性： GN, ON, AN, CP属性： ON属性值：单文本属性类型： 对局信息功能：

48、Provides some information about the opening played(e.g. san-ren-sei, Chinese fuseki, etc.).相关属性： GN, GC属性： OT属性值：单文本属性类型： 对局信息功能： Describes the method used for overtime (byo-yomi).Examples: 5 mins Japanese style, 1 move / min”, 25 moves / 10 min”.相关属性：TM, BL, WL, OB, OW属性：PB属性值：单文本属性类型：对局信息功能： Provi

49、des the name of the black player.相关属性：PW, BT, WT 属性：PC属性值：单文本属性类型：对局信息功能： Provides the place where the games was played.相关属性：EV, DT, RO, RU, RE, TM属性： PW属性值：单文本属性类型：对局信息功能： Provides the name of the white player.相关属性：PB, BT, WT属性： RE属性值：单文本属性类型： 对局信息功能： Provides the result of the game. It is MANDATOR

50、Y to use the following format:0 (zero) or Draw for a draw (jigo),B+ score for a black win andW+ score for a white winScore is optional (some games dont have a score e.g. chess). If the score is given it has to be given as a real value, e.g. B+0.5, W+64, B+12.5Use B+R or B+Resign and W+R or W+Resign

51、for a win by resignation. Applications must not write Black resigns.Use B+T or B+Time and W+T or W+Time for a win on time, B+F or B+Forfeit and W+F or W+Forfeit for a win by forfeit,Void for no result or suspended play and ? for an unknown result.相关属性： EV, DT, PC, RO, RU, TM属性： RO属性值：单文本属性类型： 对局信息功能

52、： Provides round-number and type of round. It should bewritten in the following way: ROxx (tt), where xx is the number of the round and (tt) the type: final, playoff, league, .相关属性:EV, DT, PC, RU, RE, TM属性：RU属性值：单文本属性类型：对局信息功能： Provides the used rules for this game.Because there are many different r

53、ules, SGF requires mandatory names only for a small set of well known rule sets. Note: its beyond the scope of this specification to give an exact specification of these rule sets.Mandatory names for Go (GM1):AGA (rules of the American Go Association)GOE (the Ing rules of Goe)Japanese (the Nihon-Kii

54、n rule set)NZ (New Zealand rules)相关属性： EV, DT, PC, RO, RE, TM属性： SO属性值：单文本属性类型：对局信息功能： Provides the name of the source (e.g. book, journal, .).相关属性：US, AN, CP属性： TM属性值：实数属性类型： 对局信息功能： Provides the time limits of the game.The time limit is given in seconds.相关属性： EV, DT, PC, RO, RU, RE属性： US属性值：单文本属性类

55、型： 对局信息功能： Provides the name of the user (or program), who entered the game.相关属性： SO, AN, CP属性：WR属性值：单文本属性类型： 对局信息功能： Provides the rank of the white player. For recommended format see BR.相关属性： PW, WT, BR属性：WT属性值：单文本属性类型：对局信息功能： Provide the name of the white team, if game was part of a team-match (e.

56、g. China-Japan Supermatch).相关属性：PB, PW, BT8.时间属性属性：BL属性值：实数属性类型：走子功能： Time left for black, after the move was made.Value is given in seconds.相关属性：TM, OT, WL, OB, OW属性：OB属性值：数属性类型： 走子功能： Number of black moves left (after the move of this node was played) to play in this byo-yomi period.相关属性： TM, OT,

57、BL, WL, OW属性： OW属性值：数属性类型： 走子功能： Number of white moves left (after the move of this node was played) to play in this byo-yomi period.相关属性： TM, OT, BL, WL, OB属性： WL属性值：实数属性类型： 走子功能： Time left for white after the move was made.Value is given in seconds.相关属性： TM, OT, BL, OB, OW9.其它未被分类的属性属性：FG属性值：无值 |

58、composition of 数”:SimpleText属性类型：-功能： The figure property is used to divide a game into different figures for printing: a new figure starts at the node containing a figure property.If the value is not empty thenSimpletext provides a name for the diagramNumber specifies some flags (for printing). These flags are:-coordinates on/off (value: 0/1)-diagram name on/off (value: 0/2)-list moves not shown in figure)n/of