PokerAI.org Research @2007-2009

 

 

Free Hand History Database

We offer the general public (that is everyone) the possibility to build examples, test them with a sample database, and finally submit these examples to us. Upon short approval, we will execute these examples against the full database, and e-mail you back the results.

 

Note: Our software is still in beta. Please report any bugs that you encounter. We will address in a timely manner.

 

Usage of  the Database for The General Public

 

This is a step by step guide of how to build programs and examples that query the Hand History Database.

You can submit these examples, we will execute them against the complete database, and return back the results to you.

1) Download our sample (test) database

Use this link to download the sample database (About 65Mb, WinRar archive):
http://pokerftp.com/data/sampledb1.5.2.rar

2) Download the Java HHDB utility software library

Use this link to download the HHDB software (About 650Kb, WinRar archive):
http://pokerftp.com/data/hhdb1.5.2p.rar

3) Unzip both files in the same folder

For example, use C:\hhdb to unzip the above files.
If you want to choose different folder, then you can do that, without the need to adjust any scripts

Double-check: you should now have several files (of the kind pokeraidbxxxxxxx.hhex) in the root of the above folder

Double-check: You should have subfolder "dev" in the chosen root folder (So, e.g. C:\hhdb\dev)

 

4) Have your Java paths set correctly:
Make sure you have Java installed correctly: open command prompt cmd.exe, and type "java -version". You should get the version of java that is installed for you, and that should be at least Java SE 6. If you don't get this, then you have to either install java, or fix your environment paths:

 

Note: If you don't have java installed, install one from here, select the first JRE version available (e.g. JRE 6 Update 13)

If you have java installed, but your PATH is not set to it - set path to your jdk\bin folder (Right click on my computer -> properties -> advanced -> environment variables -> find "Path" -> edit -> add the path at the end, and click apply. Verify again (with launching cmd and then typing "java -version") that now Java is found correctly.

5) Check the sample scripts

Click on sampleUsage.bat script, found in C:\hhdb\dev. This scripting is executing the example Java program SampleUsage.java, which goes over all NL 9-max hands in the downloaded database, and calculates some aggregated statistics, and then displays the results (and also launches other examples).

6) Study the examples and start to build your own

There are further examples in C:\hhdb\dev\scr\pokerai\hhex\examples. Feel free to study them, compile them, run them. Feel free to extend them, or develop completely new examples. Please consider contributing back these examples back (so we can consider them and include them, under GPL v3., in the main distribution package). We would appreciate contributed examples.

7) Run your examples against the full database

Once you are done with developing your example, and you verified that it is running correctly against the sample database, you can submit it to us, and we will run it against our complete database, and return the results back to you. Use your favorite forum to submit your example (and get the results), or e-mail it to us at findbg@gmail.com and support@pokerftp.com.

 

Enjoy productive HH analysis!

       Academic Research        Public downloads        Examples         FAQ          Forums          About