GolfPal WHS calculator

This World Handicap System (WHS) Simulator is an educational tool designed to help users understand the basic principles and calculations involved in the WHS. It allows you to manage courses, add golfers, enter scores, and see how Handicap Indexes are calculated and updated.

Disclaimer: This simulator is for educational and illustrative purposes only. It is not an official WHS tool and should not be used for maintaining an official Handicap Index. Always refer to your authorized handicapping body for official handicap management.

The calculations are based on generally understood WHS rules. For precise and official rules, please consult resources from the USGA or The R&A.

The simulator is divided into a few main sections accessible via the top navigation bar:

1. Course Management:
   • Add new golf courses and specific tees (9-hole or 18-hole).
   • You must provide the Course Name, Tee Name, Number of Holes, Course Rating (CR), Slope Rating (SR), and Total Par for the selected number of holes.
   • Enter hole-by-hole Par and Stroke Index (SI) accurately.
   • You can edit or delete existing course/tee configurations from the list.
2. Golfers & Scores:
   • Add new golfers. You can optionally provide an Initial Handicap Index (HI) and Initial Low Handicap Index (LHI).
   • Enter new scores for registered golfers. Select the golfer, course, tee, and date.
   • Choose a "Score Type" (e.g., General Play, Competition) from the dropdown.
   • Input a "PCC Adjustment" (Playing Conditions Calculation). In this simulator, this is a manual input (-1 to +3). In the real WHS, this is an automated daily calculation. Use '0' for normal conditions.
   • Enter the raw gross score for each hole played.
   • The "Calculation Log" at the bottom of this page shows a detailed breakdown of how the Handicap Index was derived for the submitted score.
3. Handicap Overview:
   • View a summary table of all registered golfers, their current HI, LHI, number of scores, and last played date.
   • Click on a golfer to see their detailed score history. Highlighted scores in the history indicate those used in the calculation of their current Handicap Index.
   • Click the `[+]` icon next to a score in the detail view to see hole-by-hole scores (Raw vs. NDB Adjusted) and how 9-hole scores were scaled (if applicable).

• Handicap Index (HI): A measure of a golfer's demonstrated ability on a course of standard playing difficulty. It is portable from course to course.
• Low Handicap Index (LHI): The lowest Handicap Index a player has held during the last 365 days. It's used for applying caps to prevent an HI from rising too quickly.
• Course Rating (CR): The evaluation of the playing difficulty of a course for scratch golfers under normal course and weather conditions.
• Slope Rating (SR): Measures the relative playing difficulty of a course for bogey golfers compared to scratch golfers. It ranges from 55 to 155. A course of "standard" difficulty has an SR of 113.
• Adjusted Gross Score (AGS): A player's gross score adjusted under WHS procedures for unfinished holes, conceded strokes, or when a hole score exceeds a maximum (Net Double Bogey). This is the score used for handicap calculations.
• Net Double Bogey (NDB): The maximum score for any hole for handicap purposes. It is Par + 2 + any handicap strokes received on that hole. This prevents one or two bad holes from having an excessive impact on a player's handicap.
• Score Differential (SD): Measures the performance on a round in relation to the difficulty of the course played. Formula: (113 / SR) * (AGS - CR - PCC). For 9-hole scores, an 18-hole equivalent SD is calculated.
• Playing Conditions Calculation (PCC): An adjustment that accounts for abnormal course or weather conditions on a given day. It can adjust Score Differentials by -1, 0, +1, +2, or +3. (Manually entered in this simulator).
• Course Handicap (CH): The number of strokes a player receives to play down to the Par of the tees being played. The Course Handicap is calculated using a player's Handicap Index® and is specific to the particular set of tees on the course they are playing. It is a crucial number for several reasons: Determining Strokes Received: It indicates the number of strokes a player receives for a round of 18 or 9 holes. Maximum Hole Score: The Course Handicap is used to determine a player's maximum score on a hole for handicap purposes, which is a Net Double Bogey. This is calculated as Par + 2 + any handicap strokes the player receives on that hole based on their Course Handicap.
• Gross Score: The total number of strokes taken by a player during a round, including any penalty strokes. Essentially, the Gross Score is a player's raw, unadjusted score for a round. It is the fundamental measure of a player's performance before any handicap allowances are applied. It is important to distinguish the Gross Score from the Adjusted Gross Score. While the Gross Score is the actual number of strokes played, the Adjusted Gross Score is the score used for handicap purposes. The Adjusted Gross Score is the Gross Score modified for any holes where a player exceeded their maximum hole score (Net Double Bogey). This adjustment prevents a single disastrous hole from having an excessive impact on a player's handicap calculation, ensuring the handicap remains a true reflection of their demonstrated ability.

9-Hole Scores:

• 9-hole scores are acceptable if played on a rated 9-hole course.
• A 9-hole Score Differential is calculated using the 9-hole CR, SR, and 0.5 * PCC adjustment.
• This 9-hole SD is then scaled to an 18-hole equivalent SD.
  • If the player has an existing HI: 18h SD = 9h SD + (HI / 2).
  • If the player is new (no HI): In this simulator, 18h SD = 9h SD * 2 (a simplification).

Initial Handicap Index:

• A Handicap Index is calculated once a minimum of 54 holes worth of scores are submitted (e.g., three 18-hole scores, or six 9-hole scores, or a combination).
• The calculation uses a specific WHS table based on the number of initial scores (1 to 5 18-hole equivalent SDs). For example, with 3 scores, the lowest SD minus an adjustment is used.

Handicap Index Updates:

• Based on the average of the best 8 Score Differentials from the most recent 20 acceptable scores.
• If fewer than 20 scores are available, a WHS table determines how many SDs are used and if any adjustment applies.

Safeguards:

• Exceptional Score Reduction (ESR): If a Score Differential is 7.0 or more strokes better than the player's HI at the time, the HI is further reduced.
• Caps (Soft & Hard): Limit the upward movement of an HI based on the player's Low Handicap Index (LHI) to ensure it remains reflective of demonstrated ability.

For detailed calculations for any score you enter, always refer to the "Calculation Log" on the "Golfers & Scores" page.

• PCC is Manual: The Playing Conditions Calculation (PCC) is a manual input in this simulator. In a real WHS, this is an automated daily calculation based on all scores submitted on a course by eligible players.
• Low Handicap Index (LHI): For simplicity, the LHI used for cap calculations is the golfer's lowest HI recorded within this simulator. A full WHS implementation uses a rolling 365-day window from the date of the score being processed.
• Initial 9-Hole Scaling (No HI): When a new golfer (with no HI) submits a 9-hole score, this simulator scales the 9-hole SD by doubling it to get an 18-hole equivalent. Official WHS procedures for initial handicap allocation can be more nuanced.
• Combining Two 9-Hole Scores: This simulator currently processes each 9-hole score individually by scaling it up. It does not support combining two separate 9-hole scores to form one 18-hole score directly.
• Data Storage: All data (courses, golfers, scores) is stored in your web browser's local storage. This means it is specific to the browser you are using and will not be available on other devices or different browsers unless manually transferred. Clearing your browser's cache/data for this site will erase all simulator data.

The Playing Conditions Calculation (PCC) is a statistical adjustment that accounts for abnormal course or weather conditions on a given day. It compares actual scores submitted against expected scores to determine if conditions were significantly harder or easier than normal.

Under the World Handicap System (WHS):

• PCC is an automatic, daily calculation performed by authorized handicapping bodies.
• It requires a minimum number of acceptable scores (usually 8) from players with a Handicap Index of 36.0 or below.
• The result can be an adjustment of -1 (easier), 0 (normal), or +1, +2, +3 (harder).
• This adjustment is then applied to the calculation of Score Differentials for all eligible scores on that day.

PCC in GolfPal Simulator:

• GolfPal does not automatically calculate PCC. This is because a standalone simulator does not have access to the large volume of daily scores from various players required for the official WHS statistical calculation.
• You can manually enter a PCC adjustment when submitting a score if you know the official PCC that was in effect for your round (e.g., obtained from your club or the official handicapping authority).
• If no official PCC was calculated for your round, or if you are unsure, you should leave the PCC input as 0 (zero).
• The simulator will correctly apply any manually entered PCC value when calculating your Score Differentials. For 9-hole scores that are combined to form an 18-hole Score Differential, 50% of the entered PCC is applied to the 9-hole portion, as per WHS guidelines.

For more detailed information on PCC, please refer to WHS Rule 5.6.

Q: Why isn't my newly registered golfer showing on the Overview page?
A: This can sometimes happen if there's an issue with how data is saved or loaded. Try refreshing the Overview page. If the problem persists, ensure you haven't manually edited the HTML files in a way that might cause inconsistencies in local storage keys. As a last resort for developers, clearing local storage for this site (via browser developer tools) and starting fresh can help, but this will erase all data.

Q: My Handicap Index changed significantly after one round. Why?
A: Several WHS mechanisms can cause this:

• An **Exceptional Score Reduction (ESR)** might have been applied if your score was much lower than your previous Handicap Index.
• The new score might be one of your best, replacing an older, higher score in the "best 8 of 20" calculation.
• Conversely, if a very good old score dropped out of your most recent 20, your HI might increase.
• Check the "Calculation Log" on the "Golfers & Scores" page for details on the specific round.

Q: How do I clear all data and start over?
A: You can clear all data stored by this simulator by using your browser's developer tools:

1. Open Developer Tools (usually by pressing F12, or right-clicking on the page and selecting "Inspect" or "Inspect Element").
2. Go to the "Application" tab (it might be called "Storage" in some browsers).
3. Find "Local Storage" in the left-hand panel and expand it.
4. Select the entry for this website (e.g., `handicap-calc.netlify.app` or `localhost` if running locally).
5. You can then right-click and choose "Clear" or find a button to clear all local storage for this site. Warning: This will delete all your saved courses, golfers, and scores.