home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / OS2 / GNUCHESS.ZIP / GCHSDOC.ZIP / BOOKFILE < prev    next >
Text File  |  1992-12-01  |  3KB  |  77 lines

  1. With this release of Gnuchess the book file is being switched from a text-based file to
  2. a binary file. Where in the past the book file was "gnuchess.book" now the primary 
  3. book file is "gnuchess.book.data". It is intended that text book files will only be 
  4. used to generate the binary file.
  5.  
  6. The GDX based bookfile is the standard binary bookfile and should be used. This means the -DGDX
  7. compile option should be used and the instructions for generating a GDX book followed. The Makefile
  8. will generate a GDX book for the basic gnuchess.book text file if "make install" is entered or
  9. if "make gnuchess.book.data" is entered. Larger opening databases can be created using the opening
  10. data in the misc directory. If you use other than GDX based books follow the instructions below.
  11.  
  12. COMPILE TIME
  13.  
  14. There are now three choices for the binary book file at compile time. 
  15.  
  16. Compile option -DGDBM creates a GNU-dbm based book. It is fast carefree but
  17. not very space efficient and slow to generate. It is highly recommended that it
  18. be done on a memory based file system.
  19.  
  20. Compile option -DGDX creates a random file based book file. It is space efficient
  21. medium fast to generate, and allows large books.
  22.  
  23. If neither of the above options is choosen the memory based book is generated.
  24. The size of the book is then dependent on the memory you have available.
  25.  
  26.  
  27. Creating a Binary book file.
  28.  
  29.  
  30.  
  31. *GDX based.
  32.  
  33. GDX based creates a disk based hash file. You must specify the size of the file.
  34. It is the most efficient book to use.
  35.  
  36.     gnuchessr -b textfile -B binaryfile -S #entries [-P plys]
  37.  
  38. "#entries" is the number of unique position/move combinations  that will be kept plus an extra 20-30%
  39. since this is a hashfile. The size of the file will be:
  40.  
  41.     12 + (#entries)*12
  42.  
  43. A book with 528k moves which resulted in 319k entries. There can be
  44. multiple entries for a position. I put this in a binary file with space 
  45. for 450k entries and it took about 5 meg.
  46.  
  47.  
  48.  
  49.  
  50. GDBM based.
  51.  
  52. Use gnuchessr.
  53.  
  54.     gnuchessr -b textfile -B binaryfile [ -P plys ]
  55.  
  56. will read the text book file "textfile" add create a gdbm file "binaryfile".
  57. Data for 28 plys (14 moves each side) will be stored, unless the -P option
  58. is specified. With -P you can specify the number of plys. Less plys less space.
  59.  
  60. You then just move the binary file from your memory based file system to 
  61. the name and path specified in the Makefile for BINBOOKFILE and it will use it.
  62.  
  63.  
  64. *Memory based.
  65.  
  66. Memory based bookfiles are produced just like GDX based.
  67.  
  68.  
  69.  
  70. Misc.
  71.  
  72. You can add entries to an existing binary file. If the binary file exists the entries in the text file
  73. will be added to the binary file.
  74.  
  75.  
  76. If possible use a memory based file system when generating a binary book file. It will go much faster.
  77.