How to use the Hud

This page is out of date and needs to be spruced up for the latest release.
3 September, 2008fpdb version alpha 3

Initial Configuration

Install and configure the import/tracker program as detailed elsewhere. You should have this line in your default.conf file.
imp-callFpdbHud=True
When you downloaded fpdb you got an example HUD configuration file named HUD_config.xml.
1. Open the subdirectory where you installed fpdb.
2. Make a backup copy of HUD_config.xml.
3. Check that the db_user and db_pass parameters are the ones you specified during database setup. This line is near the bottom of your config file and specifies the database parameters to be used.
<database db_name="fpdb" db_server="mysql" db_ip="localhost" db_user="fpdb" db_pass="fpdb" db_type="fpdb"></database>
This should allow you to use the HUD with the stats and layout in the example configuration file.

Running the HUD

1. Open fpdb and select Auto Import from the menu. The fpdb main screen will change to show the autoimport dialog.
[[image:http://fpdb.sourceforge.net/img/docs.HudHowTo1.png]]
Check that the path is pointing to your hand history subdirectory, if it is not, then click the browse button and select it. ?You can also adjust the interval between imports. Smaller intervals will get your updated HUD data more often, but might cause lag. If you experience lag, increase the interval.
2. Click "Start Autoimport" to start the import. fpdb will automatically start the HUD. When the HUD starts it will open a HUD main window.
[[image:http://fpdb.sourceforge.net/img/docs.HudHowTo2.png]]
2. This window currently has no purpose other than providing a close button that will cause the HUD to exit.
3. Play a hand of poker (good luck). A few seconds after the completion of the hand the stat windows should overlay the poker client window.
[[image:http://fpdb.sourceforge.net/img/docs.HudHowTo3.png]]
You will also see a small main window for each table that has a HUD. Clicking the close button on that window will kill the HUD stat windows for that table. The stat windows will not go away automatically when you close the table.
[[image:http://fpdb.sourceforge.net/img/docs.HudHowTo4.png]]
4. Adjust the positions of the stat windows. By default, the stat windows are created without decorations (title bar, border, etc.). Double clicking on a stat will add the decorations to that stat window. You can then use the title bar to move the window and double click again to make the decorations disappear.
[[image:http://fpdb.sourceforge.net/img/docs.HudHowTo5.png]] [[image:http://fpdb.sourceforge.net/img/docs.HudHowTo6.png]]
5. So play some poker: raise, bet, float, get all-in. You can find out what each stat is by hovering the mouse over the stat and looking at the tool tip. The tool tip also has the name of the player that the stat corresponds to, so it is useful in figuring out which stat window goes where if your windows are not in the right place. You can also get a pop up window with additional stats by single clicking on a stat.
[[image:http://fpdb.sourceforge.net/img/docs.HudHowTo7.png]]
These windows do not automatically update when a new hand is imported, but they can be moved around the same way the stat window are moved. Single clicking anywhere on the popup will make it disappear.

Configuring Stat Layouts

OK, back to the HUD_config.xml file—saving a backup would be a good idea. Before you ask, yes, there will be a neat configuration function in the HUD, to make this quicker and easier. We thought you would prefer to have the HUD now rather than wait for us to write the configuration code.
1. Open your HUD_config.xml file in you text editor and scroll down to site entry for the layout you want to configure. For example, if you want to change a layout for Pokerstars, find the line that starts like this.
<site site_name="PokerStars" …
Below that line you will find several blocks of lines defining the stat layouts for tables with the various numbers of seats. For example the layout for 6-seated tables looks like this:
<layout max="6" width="792" height="546" fav_seat="0>
<location seat="1" x="681" y="119"> </location>
<location seat="2" x="681" y="301"> </location>
<location seat="3" x="487" y="369"> </location>
<location seat="4" x="226" y="369"> </location>
<location seat="5" x="0" y="301"> </location>
<location seat="6" x="0" y="119"> </location>
</layout>
The first line of this layout specifies that it is for a 6-max (max="6") table that has been sized to 792 x 546 (width="792" height="546"). The fav_seat parameter is not used at this time.
The next 6 lines specify where the stat windows are placed on the poker client window. The x and y positions are measured from the inside upper left of the poker client window. That is x = 0, y = 0 would be the first usable pixel to the right of the window border and below the title bar.
So if you are using the layout in the example above and decide that the stat window for seat 3 is being place 9 pixels too high, you would change the line for seat="3" to be:
<location seat="3" x="487" y="378"> </location>
If you use smaller or larger client windows you should correct the width and height parameters so that they are up-to-date when automatic resizing is implemented.

Configuring the Stats Shown in the stat windows

The definition of the stat window stats is in the "supported games" paragraph of the HUD_config.xml file. For example:
<game game_name="studhilo" db="fpdb" rows="2" cols="3">
<stat row="0" col="0" stat_name="vpip" tip="tip1" click="tog_decorate" popup="default"> </stat>
<stat row="0" col="1" stat_name="pfr" tip="tip1" click="tog_decorate" popup="default"> </stat>
<stat row="0" col="2" stat_name="ffreq_1" tip="tip1" click="tog_decorate" popup="default"> </stat>
<stat row="1" col="0" stat_name="n" tip="tip1" click="tog_decorate" popup="default"> </stat>
<stat row="1" col="1" stat_name="wtsd" tip="tip1" click="tog_decorate" popup="default"> </stat>
<stat row="1" col="2" stat_name="wmsd" tip="tip1" click="tog_decorate" popup="default"> </stat>
</game>
The first line specifies the game that this stat paragraph is used for (game = "studhilo") and the number of rows and columns in the stat window. In this case we have specified 2 rows and 3 columns so we can have 2x3 = 6 stats. Rows and columns are numbered from 0, so the 3 columns are numbered 0, 1, and 2.
The subsequent lines in the stat paragraph specify which stats are displayed in the various parts of the window. In this example, vpip is displayed in col 0, row 0.
So to create stat windows with 4 columns of 2 rows you would change the cols parameter in the first line to cols = "4" and add 2 additional rows to specify the stats for row 2, col 3 and row 1, col 3.
The click and tip parameters in this paragraph are not currently used. The popup parameter is explained in the next section.

Configuring Popup Windows

Each stat location can display a different popup window when clicked. In the example just above, each of the stats has the "default" popup specified. You can see the definition of the default popup by scrolling farther down in your config file. It should look like this.
<popup_windows>
<pu pu_name="default">
<pu_stat pu_stat_name = "n"> </pu_stat>
<pu_stat pu_stat_name = "vpip"> </pu_stat>
<pu_stat pu_stat_name = "pfr"> </pu_stat>

<pu_stat pu_stat_name = "ffreq_4"> </pu_stat>
</pu>
</popup_windows>
You can create a new popup by making a new pu elelment, with a new name and a new list of stats. You then specify that popup name in the popup parameter in one or more of your stats.

Currently Supported Stats

stat meaning
a_freq_1 Flop/4th aggression frequency
a_freq_2 Turn/5th aggression frequency
a_freq_3 River/6th aggression frequency
a_freq_4 7th street aggression frequency
cb_1 Flop continuation bet
cb_2 Turn continuation bet
cb_3 River continuation bet
cb_4 7th street continuation bet
f_BB_steal Folded BB to steal
f_SB_steal Folded SB to steal
ffreq_1 Flop/4th fold frequency
ffreq_2 Turn/5th fold frequency
ffreq_3 River/6th fold frequency
ffreq_4 7th fold frequency
n Number of hands played
pfr Preflop (3rd street) raise
saw_f Saw flop/4th
steal Steal %
three_B_0 Three bet preflop/3rd
vpip Voluntarily put $ in the pot
wmsd Won $ at showdown
wtsd Went to SD when saw flop/4th
WMsF Won $ when saw flop/4th
Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License