User Guide
How to measure a mechanical watch with Timegrapher: every button, pane and function, what it does, and why you’d use it.
Timegrapher states measured facts. It doesn’t grade a watch or say what is wrong with it. Interpreting the facts is the watchmaker’s job; this guide explains what each fact means and where it can mislead.
Contents
Start
- What a Timegrapher Measures: the beat, its three sounds, rate, amplitude and beat error
- Your First Take: Quick Listen, from install to a saved take
- Setting Up the Microphone: the input, the level, clipping, automatic gain and Quartz Correction
The App
- The Window: the top row, Bench and Watches, panes, the status bar, menus and keys
- The Readings Cards and the Calibre Card: the position, the calibre, Listen, the readings, their ± and chips
- The Paper Strip: reading the strip, moving around, the track, masking and the Position Brush
- The Tick Tock Profile and the Scope: the average beat and its marks, and single beats
- Charts and Distributions: each reading over the take, and how its values spread
Steadiness
- Steadiness: What It Is For, the Toolbar and Info: the nine views, the Info panel, what the tests read and how sure they are
- Readings Over Time: every reading in order, its levels and two states
- Periods: what the readings repeat at, matched to the wheels
- Cycle: one repeat’s shape and size
- Autocorrelation: whether each reading follows the last
- Allan Deviation: how the scatter of an average changes as it gets longer
- CUSUM and Change Points: whether the level changed, and when
- FFT: the size of every period’s swing over the whole take
- STFT Map: each period’s size through the take, in 20-minute windows
- Wavelet Map: where and when each swing is, sharply
Tests and History
- Isochronism: the rate at each amplitude, as the curve or the walk
- Positions Test: the six positions, guided, and full wind against 24 hours
- Power Reserve Test: how long a full wind lasts, hour by hour
- The Watches View: your watches, their details and every take
- Takes and Sound Files: keeping, opening and what is in a take
- Settings and Calibres: General, the Watches folder, and Manage Calibres
How the Numbers Are Made
Each page says what a measure is, how it is computed, why it is done that way, when you’d use it, what it helps find, and what it can’t tell you.
- M1. Beats
- M2. Rate
- M3. The Sound Card’s Clock
- M4. Amplitude and Lift Angle
- M5. Beat Error
- M6. Averaging, Windows and Cuts
- M7. The ± and Correlated Readings
- M8. Positions Test Figures
- M9. Steadiness Statistics
- M10. Finding Cycles
- M11. Time and Frequency Maps
- M12. Isochronism and Rate against Amplitude
Beyond the App
- The Command Line: every command, its options, and its JSON (JavaScript Object Notation) output for scripts and agents
- Claude Desktop: the timegrapher in an AI (artificial intelligence) chat app, what it can do and what it never does
- Problems and Reports: Report a Problem, the log and crash records, and a window that won’t open
- Glossary: the words this guide uses
Other Documents
- Installing and updating
- The desktop app reference: every detail of the app, for checking a specific behaviour.
- The agent interface: the command line’s JSON.