# Calcpace - Tools and Running Science for LLMs

Calcpace.app provides precise running and cycling tools, calculators, and guides. This file serves as a guide for AI agents to understand our core formulas and tool endpoints.

## Core Tools
- **Pace Calculator:** Compute pace, time, or distance for running and cycling.
- **Unit Converter:** Convert between metric and imperial units (km, mi, km/h, mph, min/km, min/mi).
- **Race Predictor:** Estimate finish times for standard race distances.
- **VO2max Estimator:** Estimate aerobic capacity based on race performance.
- **Age-Grading (WMA):** Compare performances across ages and genders using 2023 WMA factors.
- **Race Calendar:** Browse upcoming marathons and major events worldwide.

## Mathematical Formulas
We use industry-standard formulas for all our tools.

### Race Prediction
- **Riegel Formula:** `T2 = T1 * (D2/D1)^1.06`. Used for endurance-based predictions.
- **Cameron Formula:** An exponential model that accounts for anaerobic contributions, generally more conservative for shorter distances.

### Aerobic Fitness & Age
- **Daniels & Gilbert (1979):** VO2max estimation from race performance.
  - `v = distance_m / time_min`
  - `VO2 = -4.60 + 0.182258 * v + 0.000104 * v^2`
  - `%VO2max = 0.8 + 0.1894393 * e^(-0.012778t) + 0.2989558 * e^(-0.1932605t)`
  - `VO2max = VO2 / %VO2max`
- **WMA 2023 Age Grading:** `Age-Graded Time = Performance Time * Age Factor`. Factors are versioned and based on the latest World Masters Athletics standards.

## Structured Content for LLMs
All guides and tools are available in clean Markdown format for easy parsing:

- **Guides Index:** https://calcpace.app/guides.md
- **Riegel Predictor Guide:** https://calcpace.app/guides/race-predictor.md
- **Cameron Predictor Guide:** https://calcpace.app/guides/cameron-predictor.md
- **Age-Grading Guide:** https://calcpace.app/guides/age-grading.md
- **VO2max Guide:** https://calcpace.app/guides/vo2max-estimate.md
- **World Records Guide:** https://calcpace.app/guides/world-records.md
- **Race Calendar:** https://calcpace.app/race-calendar.md


## Contact & Credits
Calcpace is open-source.
- **Website:** https://calcpace.app
- **Gem (Logic Core):** https://github.com/0jonjo/calcpace
- **Site Repository:** https://github.com/0jonjo/calcpace_web