PokerHandEvaluator

PokerHandEvaluator (PH Evaluator) is an efficient poker hand evaluator based on a perfect hash algorithm. Instead of traversing all the combinations, it looks up the hand strength from a pre-computed hash table, which only costs very few CPU cycles and a considerably small amount of memory (~100kb for the 7-card evaluation). With slight modifications the same algorithm is also applied to evaluating Omaha and Pot Limit Omaha hands.

This site is organised into three sections:

• Algorithm - the description of the underlying perfect-hash algorithm.

• C/C++ - usage and examples of the C/C++ library.

• Python - usage and API reference of the phevaluator Python package.

• Changelog - the history of notable changes across releases.

Contents:

• Algorithm
  • Table of Contents
  • Chapter 1: A Basic Evaluation Algorithm
  • Chapter 2: Evaluate the Flushes First
  • Chapter 3: Hash For a Restricted Quinary
  • Chapter 4: The Ultimate Dynamic Programming Algorithm
• C/C++
  • Building and testing
  • Using the libraries
  • Examples
  • Card Id
• Python
  • Installation
  • Usage
  • Card Id
  • API reference
• Changelog
  • [0.6.0] - 2026-07-11
  • [0.5.3.1] - 2024-03-21
  • [0.5.3] - 2024-03-14
  • [0.5.2] - 2023-03-10
  • [0.5.1] - 2022-04-22
  • [0.5.0.4] - 2021-10-31
  • [0.5.0] - 2021-10-19
  • [0.4.0.3] - 2021-10-18
  • [0.4.0.2] - 2021-10-16
  • [0.4.0.1] - 2021-10-11
  • [0.4.0] - 2021-10-06
  • [0.3.1] - 2020-05-25
  • [0.3.0] - 2020-05-24
  • [0.2.0] - 2019-11-25
  • [0.1.0] - 2019-11-20

Indices and tables

• Index

• Module Index

• Search Page