Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pokermania/pokereval


https://github.com/pokermania/pokereval

Last synced: 30 days ago
JSON representation

Awesome Lists containing this project

README 

        
$Id$



Introduction

============



poker-eval is a C library to evaluate poker hands. The result of the

evalution for a given hand is a number. The general idea is that if

the evalution of your hand is lower than the evaluation of the hand of

your opponent, you lose. Many poker variants are supported (draw,

holdem, omaha, etc.) and more can be added.  poker-eval is designed

for speed so that it can be used within poker simulation software

using either exhaustive exploration or Monte Carlo.



The poker-eval library is Free Software and is released under the

terms of the GNU General Public License. See the COPYING file in the

root directory of the distribution.



Compiling -- GNU/Linux and Unix systems

=========================

This library uses the GNU Autoconf self-configuration mechanism, so

compiling on a GNU/Linux and Unix system should be fairly simple.  



To build both the C library and the examples:

  autoreconf --install

  ./configure

  make 



To build and run the tests:



  AUTOMAKE=automake-1.9 ACLOCAL=aclocal-1.9 autoreconf --install

  ./configure

  make check



The "make check" command will run several test programs to ensure that

everything works correctly.  On slow machines, the tests may take

several minutes.



To install the library and the headers (by default they will

install in /usr/local/lib and /usr/local/include/poker-eval 

respectively):



   ./configure

   make install



To run the examples:



   cd examples

   read the usage at the beginning of the source file

   and run the program accordingly



Compiling -- Windows, using cygwin 

==================================

If you have the cygwin package installed, you can build the library as

per the directions above for GNU/Linux and Unix systems.



Compiling -- DOS / Windows (May be obsolete, please send updates

to [email protected])

================================================================

The library can also be compiled using Microsoft Visual C++.  In each

directory, special DOS makefiles are provided, called makefile.dos.

To compile the library, make sure that the VC tools are on the path

and that the LIB variable is properly set (VC provides a batch file,

vcvars32.bat, to set this up), and enter the following commands:

  cd lib

  nmake -f makefile.dos

  cd ..\examples

  nmake -f makefile.dos

  cd ..\tests

  nmake -f makefile.dos



You can't use make to run the test programs under Windows as you can

on Unix, but you can run them (digtest5 and digtest7, in the tests

directory) and compare the output value with the value in the make

file (makefile.dos in the tests directory) to ensure that the right

thing happened.  



Once the library is built, you can use the resulting library

(libpoker.lib) in other Visual C++ projects.  Make sure to put the

include directory of the pokersource library package in the include

path for projects that will be using the library.  



Download

========

The library may be obtained from the pokersource project at

http://gna.org/projects/pokersource/



Reporting bugs, suggesting improvements

=======================================

As of August 2005, the poker-eval library is maintained by

Loic Dachary.  Bug reports, suggestions for improvements, or candidates

for inclusion should be sent to

     Loic Dachary 

     Tim Showalter  

     Michael Maurer 



You can also check out the pokersource user group at

http://groups.yahoo.com/group/pokersource or the mailing list

at https://mail.gna.org/listinfo/pokersource-users/