Skip to main content

Start Here

site-information
New to AffineDrift? What the site is, its big idea in one picture, a reading path for you, and how to read its evidence labels.

What AffineDrift Is

AffineDrift is a free, open notebook about how a golf swing moves and why. It uses physics models to split each moment of the swing into what the body and club would do on their own and what the golfer adds. Each page says how strong its evidence is, so you can judge each claim for yourself.

The Big Idea in One Picture

Picture a swing as a point moving across a map of every possible state. At each point, two arrows add up. One arrow is the drift: where gravity and momentum would carry the motion with no effort at all. The other is the push: the change the golfer’s muscles add. The picture below draws both arrows from a simple pendulum model.

Drift plus control Phase plane of a pendulum model. A passive drift arrow and a torque push arrow add head to tail to give the state velocity. drift f(x) push G(x)u actual angle θ (rad) angular velocity ω (rad/s)
Drift plus control. At every state, the model's motion is a passive drift (blue) plus a push from the declared input (orange). Dashed: the same model with zero torque. Illustrative values from the pendulum model in src/tangent_models/examples.py; not a golfer measurement.
Long description

The horizontal axis is the pendulum angle from straight down, in radians; the vertical axis is its angular velocity, in radians per second. Faint arrows show the drift: the direction the model's state moves at each point with no torque. Both runs start at rest at an angle of -2.2 rad. The dashed curve is the zero-torque run, which follows the drift alone. The solid curve is the run under a constant 5 N m pivot torque, which swings faster and further. At the marked state, angle -1.94 rad and angular velocity 2.68 rad/s, three arrows show the change over 0.35 s: the drift arrow (2.68, 9.16) per second, the push arrow (0, 5.00) per second, which only changes angular velocity because torque acts on acceleration, and their sum, the state velocity the run actually has.

Drift Plus Control Vector Field Decomposition

State-space vector addition of passive mechanical drift f(x) and active golfer control push G(x)u into the total swing trajectory tangent dx/dt = f(x) + G(x)u, shown alongside the dashed pointwise Zero-Torque Counterfactual (ZTCF) rollout curve.

The point of the split is not that one arrow matters more. It is that you can only ask “what did the golfer add?” once you know what would have happened anyway. The Big Idea in Five Minutes explains it with everyday examples, and the Overview explains the scope of the site in more detail.

Choose Your Path

Choose what you want to do first. Each path includes a short start and a route to deeper work.

Understand the Science

Explore golf mechanics in plain language, starting with a five-minute introduction.

Study the Mathematics

Build a foundation in mechanics and control, then follow the derivations.

Explore Models

Try simulations and inspect the assumptions behind their results.

Looking to review, integrate, or contribute? Specialist Reading Paths has all eight reader plans, with 5-minute, 30-minute, and 3-hour options.

How to Read the Evidence Labels

Pages and claims carry a label that says how far they have been checked. Read the label before you trust a claim.

  • Available: The text, code, or derivation is complete, readable, and open for inspection. Does not imply independent peer review, clinical consensus, or empirical human validation.
  • Validated: Specific claims name verifiable empirical evidence, calibration datasets, and exact error bounds. Neighboring claims, untested swing regimes, or full-body extensions do not inherit validation.
  • Experimental: Exploratory modeling or software available for discussion and sensitivity testing. Does not guarantee numerical convergence, stable APIs, or verified real-world predictive fidelity.
  • Planned: A formal specification or tracking issue exists, but the deliverable is not yet completed. Does not imply active implementation in the current release cycle or guaranteed delivery dates.
  • Deprecated: Material preserved strictly for historical context, backwards compatibility, or audit history. Not recommended for current modeling, active research, or pedagogical study.
  • Opinion: Editorial synthesis, philosophical positioning, or speculative research agendas. Does not represent mathematical proof, empirical data, or institutional consensus.

A separate evidence ladder says how strong the support is, from pure math up to tests on real people. The full definitions are in How to Read This Site.

What This Site Is Not

  • It is not coaching advice. The models explain motion. They do not tell you how to swing.
  • It is not peer reviewed by default. A page being online means you can read and check it. It does not mean experts have signed off on it.
  • It is not a validated model of a human. Most results come from simple models of links and joints. They are tools for thinking, not a measured picture of any real golfer.

Citation

BibTeX citation: Download .bib
@online{untitled,
  author = {},
  title = {Start {Here}},
  url = {https://affinedrift.com/pages/start-here.html},
  langid = {en}
}
For attribution, please cite this work as:
“Start Here.” n.d. https://affinedrift.com/pages/start-here.html.