libgolf

libgolf is a C++ library designed to simulate golf ball trajectories based on initial conditions like velocity, atmospheric data, and more. It provides easy-to-use functions to visualize or calculate the ball's flight path and landing point (now including bounces, rolling, and dynamic ground surfaces!).

The in-air math here is based on work done by Prof. Alan M. Nathan at the University of Illinois Urbana-Champaign.

Requirements

• C++20 or later
• CMake 3.14+

Build

git clone https://github.com/gdifiore/libgolf.git

cd libgolf

chmod +x build.sh

./build.sh

Features

• Full trajectory simulation with automatic phase transitions (aerial → bounce → roll)
• Dynamic ground surfaces - fairways, roughs, greens, elevation changes
• 3D terrain system with slopes and varying surface normals
• Efficient step-by-step numerical integration

Documentation

• Getting Started - Basic usage and examples
• Ground Providers - Dynamic ground surfaces (fairways, roughs, greens)
• Terrain System - 3D terrain with elevation and slopes

Quick Example

#include <libgolf.hpp>

const LaunchData ball{
    .ballSpeedMph = 160.0f,
    .launchAngleDeg = 11.0f,
    .directionDeg = 0.0f,
    .backspinRpm = 3000.0f,
    .sidespinRpm = 0.0f,
};
const AtmosphericData atmos{
    .temp = 70.0f,
    .elevation = 0.0f,
    .vWind = 0.0f,
    .phiWind = 0.0f,
    .hWind = 0.0f,
    .relHumidity = 50.0f,
    .pressure = 29.92f,
};
GroundSurface ground; // Default fairway

FlightSimulator sim(ball, atmos, ground);
sim.run();

LandingResult result = sim.getLandingResult();
printf("Distance: %.1f yards\n", result.distance);

For dynamic ground surfaces (fairway/rough/green), see the Ground Providers Guide.