calcpace 1.9.3 → 1.9.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ee49b6b99023d43bef8396cb0c1ab9ba4ef99e6c96285b4c4405eb3d163807d
-  data.tar.gz: 442169e5414c141390261da86e5cc312eda98c685bbc64530ca7692d39773119
+  metadata.gz: db7effb21592146022bf3df34ecdb8a8688fb4d79d618c43c5b99a9912ac967a
+  data.tar.gz: 2e009f5c0fa7856f65c3f8a447fa9a4de2e51e5057bf1606810d3bc38e3d9a02
 SHA512:
-  metadata.gz: ae31a9047296eb8848030d08d35af80bd9af22f5ae5ac65de727e99b7448155918198caa2467edb5a3371c92d6f3f4b4c54adef1d0d8da51bc19b4b9cafb680d
-  data.tar.gz: 57b06d49de20b1415ec230c1d2bfd3ac495dc4c8c3ed25e684fcdf3072fef142728394942706aa39892b69eea3ce9b1b1e9f8c2fdb3efea7fbd3bd7e90016fa3
+  metadata.gz: 129467189d43ea17a4ac31f371e813b08a12d7d0482a3f4717414087db3ffa0f5134478e5134cb512c5c6f242f7eab57b2172bf40b61107ed7a204f2043bf78e
+  data.tar.gz: c716d04864bdf92ab64259c938a05d1cce552a9c35738f1b7b76848b4c32d36119ed71c9ddcd8c0725b4002c660eee8cb51e5a020fdf9ac7d29d062ea3801002

data/CHANGELOG.md

@@ -5,6 +5,54 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [1.9.5] - 2026-05-02
+
+### Added
+- Age-grading module (`AgeGrading`) with:
+  - `age_grade(distance_km, time, age:, sex:)`
+  - `age_grade_percent(distance_km, time, age:, sex:)`
+  - `age_grade_label(percent)`
+- Versioned data file loader using YAML + `YAML.safe_load` from
+  `lib/calcpace/data/wma_2023_road.yml`
+- Interpolation support for in-between ages (e.g., 57 between 55 and 60)
+- Initial road-race support: 5K, 10K, half marathon, marathon
+- WMA 2023 one-year age factors integrated for `M`/`F` road distances in meters
+  - Source: World Masters Athletics (WMA) competition rules documents
+    https://world-masters-athletics.org/documents/competition-rules/
+- Race-style age-factored time rounding up to the next hundredth
+- Test suite for validation, interpolation, and error handling
+
+## [1.9.4] - 2026-04-18
+
+### Added
+- Standard race distance support for **100K** (100.0 km)
+  - Supported in `PaceCalculator`, `RacePredictor`, `CameronPredictor`, and `RaceSplits`
+  - Updated `list_races` to include 100K
+  - Added integration tests for 100K race distance across all modules
+
+## [1.9.3] - 2026-04-05
+
+### Added
+- VO2max Estimator module (`Vo2maxEstimator`)
+  - Daniels & Gilbert (1979) formula for VO2max estimation from race results
+  - Performance level labels (Elite, Excellent, etc.)
+- Improved time validation using strict `check_time` and `convert_to_seconds`
+- Updated YARD documentation for all calculation methods
+
+### Fixed
+- Gemspec formatting and line length constraints
+- README structure and documentation examples
+
+## [1.9.2] - 2026-03-31
+
+### Added
+- Track Calculator module (`TrackCalculator`)
+  - Haversine distance calculation for GPS coordinates
+  - Elevation gain and loss analysis
+  - Automated track splits based on GPS points
+
 ## [1.9.1] - 2026-03-30
 
 ### Changed
@@ -116,5 +164,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 See git history for changes in earlier versions.
 
-[Unreleased]: https://github.com/0jonjo/calcpace/compare/v1.6.0...HEAD
+[Unreleased]: https://github.com/0jonjo/calcpace/compare/v1.9.5...HEAD
+[1.9.5]: https://github.com/0jonjo/calcpace/compare/v1.9.4...v1.9.5
 [1.6.0]: https://github.com/0jonjo/calcpace/releases/tag/v1.6.0

data/Gemfile.lock

@@ -1,13 +1,13 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.9)
+    addressable (2.9.0)
       public_suffix (>= 2.0.2, < 8.0)
     ast (2.4.3)
     bigdecimal (4.1.0)
     date (3.5.1)
     docile (1.4.1)
-    erb (6.0.2)
+    erb (6.0.4)
     json (2.19.2)
     json-schema (6.2.0)
       addressable (~> 2.8)

data/README.md

@@ -1,4 +1,4 @@
-# Calcpace [![Gem Version](https://d25lcipzij17d.cloudfront.net/badge.svg?id=rb&r=r&ts=1683906897&type=6e&v=1.9.3&x2=0)](https://badge.fury.io/rb/calcpace)
+# Calcpace [![Gem Version](https://d25lcipzij17d.cloudfront.net/badge.svg?id=rb&r=r&ts=1683906897&type=6e&v=1.9.5&x2=0)](https://badge.fury.io/rb/calcpace)
 
 A Ruby gem for running and cycling calculations: pace, time, distance, unit conversions, race predictions, GPS track analysis, and VO2max estimation.
 
@@ -64,7 +64,7 @@ calc.pace_mi_to_km('08:00')   # => "00:04:58"
 ```ruby
 calc.race_time_clock('05:00', 'marathon')          # => "03:30:58"
 calc.race_pace_clock('04:00:00', 'marathon')       # => "00:05:41"
-calc.list_races  # => { '5k' => 5.0, '10k' => 10.0, 'half_marathon' => 21.0975, ... }
+calc.list_races  # => { '5k' => 5.0, '10k' => 10.0, 'half_marathon' => 21.0975, 'marathon' => 42.195, '100k' => 100.0, ... }
 ```
 
 ---
@@ -124,6 +124,44 @@ calc.track_splits(points, 1.0) # => [{ km: 1, elapsed: 312, pace: "05:12" }, ...
 
 ---
 
+### Age Grading (Road Races)
+
+Age grading compares race results across different ages and sexes by using
+age factors and open standards.
+
+```ruby
+result = calc.age_grade(10.0, '00:45:00', age: 55, sex: :male)
+# => {
+#      age_grade_percent: 64.6,
+#      category: "Local Class",
+#      age_graded_time_seconds: 2376.0,
+#      age_graded_time_clock: "00:39:36",
+#      open_standard_seconds: 1571.0,
+#      open_standard_clock: "00:26:11",
+#      factor: 0.88,
+#      table_version: "WMA_2023_ONE_YEAR_FACTORS_V1"
+#    }
+
+calc.age_grade_percent(5.0, '00:22:30', age: 40, sex: :female) # => 74.1
+calc.age_grade_label(74.1)                                      # => "Regional Class"
+```
+
+Supported distances: 5K, 10K, half marathon, marathon.
+
+Age factors are based on WMA 2023 one-year age grading tables:
+https://world-masters-athletics.org/documents/competition-rules/
+
+Open standards used in `open_standard_seconds` / `open_standard_clock` are loaded
+from the bundled WMA 2023 open standards dataset
+(`lib/calcpace/data/wma_2023_open_standards.yml`).
+
+Field meanings:
+- `age_graded_time_clock`: your result after applying the WMA age factor (normalized performance time).
+- `open_standard_clock`: the open standard reference time used to compute the percentage for that distance/sex.
+- `age_grade_percent`: `(open_standard_seconds / age_graded_time_seconds) * 100`.
+
+---
+
 ### VO2max Estimation
 
 Estimate aerobic fitness from a race result using the **Daniels & Gilbert formula** (1979):

data/lib/calcpace/age_grading.rb

@@ -0,0 +1,198 @@
+# frozen_string_literal: true
+
+require 'yaml'
+
+# Module for age-grading race performances with a versioned table
+#
+# Age grading allows fairer comparison across ages by applying an age factor
+# to the raw performance time.
+#
+# Current scope:
+# - Common road distances: 5K, 10K, half marathon, marathon
+# - Sex: male/female
+# - Age: 18+
+# - Data file is versioned and replaceable (`lib/calcpace/data/wma_2023_road.yml`)
+#
+# Returned values include:
+# - age grade percentage
+# - age-graded time
+# - open standard time for the selected distance/sex
+# - performance category
+# rubocop:disable Metrics/ModuleLength
+module AgeGrading
+  DATA_PATH = File.expand_path('data/wma_2023_road.yml', __dir__).freeze
+  OPEN_STANDARDS_DATA_PATH = File.expand_path('data/wma_2023_open_standards.yml', __dir__).freeze
+  WMA_DATA = YAML.safe_load_file(DATA_PATH, permitted_classes: [],
+                                            aliases: false).freeze
+  OPEN_STANDARDS_DATA = YAML.safe_load_file(OPEN_STANDARDS_DATA_PATH, permitted_classes: [],
+                                                                      aliases: false).freeze
+  TABLE_VERSION = OPEN_STANDARDS_DATA.fetch('meta').fetch('table_version').freeze
+
+  AGE_GRADE_LABELS = OPEN_STANDARDS_DATA.fetch('age_grade_classifications').map do |entry|
+    { min: entry.fetch('min').to_f, label: entry.fetch('label') }
+  end.freeze
+
+  DISTANCE_TO_METERS = {
+    5.0 => '5000',
+    10.0 => '10000',
+    21.0975 => '21097',
+    42.195 => '42195'
+  }.freeze
+  RACE_TO_METERS = {
+    '5k' => '5000',
+    '10k' => '10000',
+    'half_marathon' => '21097',
+    'marathon' => '42195'
+  }.freeze
+
+  SUPPORTED_DISTANCES_KM = DISTANCE_TO_METERS.keys.freeze
+
+  # Returns a full age-grading report for a race performance
+  #
+  # @param distance_km [Numeric, String, Symbol] race distance in kilometres
+  #   (5.0, 10.0, 21.0975, 42.195) or race key (:5k, :10k, :half_marathon, :marathon)
+  # @param time [String, Numeric] performance time as HH:MM:SS / MM:SS, or total seconds
+  # @param age [Integer] athlete age (must be >= 18)
+  # @param sex [String, Symbol] male or female
+  # @return [Hash] age-grading result details
+  def age_grade(distance_km, time, age:, sex:)
+    distance_m = normalize_distance(distance_km)
+    seconds = parse_time_seconds(time)
+    age_value = normalize_age(age)
+    sex_value = normalize_sex(sex)
+
+    check_positive(seconds, 'Time')
+
+    factor = interpolated_factor(sex_value, age_value, distance_m)
+    age_graded_time = round_up_hundredth(seconds * factor)
+    open_standard = open_standard_seconds(sex_value, distance_m)
+    grade_percent = (open_standard / age_graded_time) * 100.0
+    rounded_percent = grade_percent.round(1)
+
+    {
+      age_grade_percent: rounded_percent,
+      category: age_grade_label(rounded_percent),
+      age_graded_time_seconds: age_graded_time,
+      age_graded_time_clock: convert_to_clocktime(age_graded_time),
+      open_standard_seconds: open_standard,
+      open_standard_clock: convert_to_clocktime(open_standard),
+      factor: factor.round(4),
+      table_version: TABLE_VERSION
+    }
+  end
+
+  # Returns only the age-grade percentage
+  #
+  # @param distance_km [Numeric] race distance in kilometres
+  # @param time [String, Numeric] performance time
+  # @param age [Integer] athlete age
+  # @param sex [String, Symbol] male or female
+  # @return [Float] age-grade percentage
+  def age_grade_percent(distance_km, time, age:, sex:)
+    age_grade(distance_km, time, age: age, sex: sex)[:age_grade_percent]
+  end
+
+  # Returns a descriptive label for an age-grade percentage
+  #
+  # @param percent [Numeric] age-grade percentage
+  # @return [String] category label
+  def age_grade_label(percent)
+    percent_value = begin
+      Float(percent)
+    rescue ArgumentError, TypeError
+      raise ArgumentError, 'Age-grade percent must be a numeric value greater than or equal to 0'
+    end
+
+    raise ArgumentError, 'Age-grade percent must be greater than or equal to 0' if percent_value.negative?
+
+    AGE_GRADE_LABELS.find { |entry| percent_value >= entry[:min] }[:label]
+  end
+
+  private
+
+  def normalize_distance(distance_km)
+    if distance_km.is_a?(String) || distance_km.is_a?(Symbol)
+      key = distance_km.to_s.strip.downcase
+      return RACE_TO_METERS.fetch(key) if RACE_TO_METERS.key?(key)
+
+      raise ArgumentError,
+            "Unsupported race '#{distance_km}'. Supported: #{RACE_TO_METERS.keys.join(', ')}"
+    end
+
+    distance = distance_km.to_f
+    check_positive(distance, 'Distance')
+
+    match = SUPPORTED_DISTANCES_KM.find { |value| (distance - value).abs <= 0.001 }
+    return DISTANCE_TO_METERS.fetch(match) if match
+
+    raise ArgumentError,
+          "Unsupported distance #{distance_km}km. Supported: #{SUPPORTED_DISTANCES_KM.join(', ')}"
+  end
+
+  def parse_time_seconds(time)
+    return time.to_f if time.is_a?(Numeric)
+
+    check_time(time.to_s)
+    convert_to_seconds(time.to_s)
+  end
+
+  def normalize_age(age)
+    age_value = Integer(age)
+  rescue ArgumentError, TypeError
+    raise ArgumentError, 'Age must be an integer greater than or equal to 18'
+  else
+    raise ArgumentError, 'Age must be at least 18' if age_value < 18
+
+    age_value
+  end
+
+  def normalize_sex(sex)
+    normalized = sex.to_s.strip.downcase.to_sym
+    return normalized if %i[male female].include?(normalized)
+
+    raise ArgumentError, "Sex must be 'male' or 'female'"
+  end
+
+  def interpolated_factor(sex, age, distance_m)
+    table = factor_table(sex, distance_m)
+    ages = table.keys.map(&:to_i).sort
+
+    return table.fetch(ages.first).to_f if age <= ages.first
+    return table.fetch(ages.last).to_f if age >= ages.last
+
+    lower_age, upper_age = neighboring_ages(ages, age)
+    return table.fetch(lower_age).to_f if lower_age == upper_age
+
+    interpolated_value(table, lower_age, upper_age, age)
+  end
+
+  def factor_table(sex, distance_m)
+    WMA_DATA.fetch(sex_key(sex)).fetch(distance_m)
+  end
+
+  def sex_key(sex)
+    sex == :male ? 'M' : 'F'
+  end
+
+  def open_standard_seconds(sex, distance_m)
+    OPEN_STANDARDS_DATA.fetch('open_standards_seconds').fetch(sex_key(sex)).fetch(distance_m).to_f
+  end
+
+  def round_up_hundredth(value)
+    (value * 100.0).ceil / 100.0
+  end
+
+  def neighboring_ages(ages, age)
+    lower_age = ages.select { |value| value <= age }.max
+    upper_age = ages.select { |value| value >= age }.min
+    [lower_age, upper_age]
+  end
+
+  def interpolated_value(table, lower_age, upper_age, age)
+    lower_factor = table.fetch(lower_age).to_f
+    upper_factor = table.fetch(upper_age).to_f
+    ratio = (age - lower_age).to_f / (upper_age - lower_age)
+    lower_factor + ((upper_factor - lower_factor) * ratio)
+  end
+end
+# rubocop:enable Metrics/ModuleLength

data/lib/calcpace/cameron_predictor.rb

@@ -24,7 +24,7 @@ module CameronPredictor
 
   # Predicts race time using the Cameron formula
   #
-  # @param from_race [String, Symbol] known race distance ('5k', '10k', 'half_marathon', 'marathon', etc.)
+  # @param from_race [String, Symbol] known race distance ('5k', '10k', 'half_marathon', 'marathon', '100k', etc.)
   # @param from_time [String, Numeric] time achieved at known distance (HH:MM:SS or seconds)
   # @param to_race [String, Symbol] target race distance to predict
   # @return [Float] predicted time in seconds

data/lib/calcpace/data/wma_2023_open_standards.yml

@@ -0,0 +1,30 @@
+meta:
+  source: "WMA/Masters Rankings age grading tables (2023)"
+  url: "https://howardgrubb.co.uk/athletics/wmatnf23.html"
+  table_version: "WMA_2023_ONE_YEAR_FACTORS_V1"
+
+age_grade_classifications:
+  - min: 100.0
+    label: "Approximate World Record Level"
+  - min: 90.0
+    label: "World Class"
+  - min: 80.0
+    label: "National Class"
+  - min: 70.0
+    label: "Regional Class"
+  - min: 60.0
+    label: "Local Class"
+  - min: 0.0
+    label: "Developing"
+
+open_standards_seconds:
+  M:
+    "5000": 755.0
+    "10000": 1571.0
+    "21097": 3451.0
+    "42195": 7269.0
+  F:
+    "5000": 846.0
+    "10000": 1741.0
+    "21097": 3772.0
+    "42195": 8044.0

data/lib/calcpace/data/wma_2023_road.yml

@@ -0,0 +1,16 @@
+
+F:
+  "1500": { 30: 1.0000, 31: 1.0000, 32: 1.0000, 33: 0.9960, 34: 0.9886, 35: 0.9812, 36: 0.9738, 37: 0.9664, 38: 0.9590, 39: 0.9515, 40: 0.9441, 41: 0.9367, 42: 0.9293, 43: 0.9218, 44: 0.9144, 45: 0.9069, 46: 0.8995, 47: 0.8921, 48: 0.8846, 49: 0.8772, 50: 0.8697, 51: 0.8623, 52: 0.8548, 53: 0.8473, 54: 0.8399, 55: 0.8324, 56: 0.8249, 57: 0.8175, 58: 0.8100, 59: 0.8025, 60: 0.7951, 61: 0.7876, 62: 0.7801, 63: 0.7726, 64: 0.7651, 65: 0.7576, 66: 0.7501, 67: 0.7427, 68: 0.7352, 69: 0.7277, 70: 0.7202, 71: 0.7127, 72: 0.7052, 73: 0.6976, 74: 0.6897, 75: 0.6812, 76: 0.6722, 77: 0.6628, 78: 0.6529, 79: 0.6425, 80: 0.6316, 81: 0.6202, 82: 0.6083, 83: 0.5960, 84: 0.5832, 85: 0.5698, 86: 0.5561, 87: 0.5418, 88: 0.5270, 89: 0.5118, 90: 0.4960, 91: 0.4798, 92: 0.4631, 93: 0.4460, 94: 0.4283, 95: 0.4102, 96: 0.3915, 97: 0.3724, 98: 0.3528, 99: 0.3327, 100: 0.3122, 101: 0.2911, 102: 0.2696, 103: 0.2476, 104: 0.2251, 105: 0.2021, 106: 0.1787, 107: 0.1547, 108: 0.1303, 109: 0.1054, 110: 0.0800 }
+  "3000": { 30: 1.0000, 31: 1.0000, 32: 1.0000, 33: 1.0000, 34: 1.0000, 35: 1.0000, 36: 1.0000, 37: 1.0000, 38: 0.9930, 39: 0.9849, 40: 0.9767, 41: 0.9685, 42: 0.9603, 43: 0.9521, 44: 0.9438, 45: 0.9355, 46: 0.9271, 47: 0.9188, 48: 0.9104, 49: 0.9019, 50: 0.8935, 51: 0.8850, 52: 0.8765, 53: 0.8680, 54: 0.8594, 55: 0.8509, 56: 0.8423, 57: 0.8336, 58: 0.8250, 59: 0.8163, 60: 0.8076, 61: 0.7989, 62: 0.7901, 63: 0.7813, 64: 0.7725, 65: 0.7637, 66: 0.7549, 67: 0.7460, 68: 0.7371, 69: 0.7282, 70: 0.7193, 71: 0.7103, 72: 0.7013, 73: 0.6923, 74: 0.6833, 75: 0.6743, 76: 0.6652, 77: 0.6561, 78: 0.6470, 79: 0.6379, 80: 0.6288, 81: 0.6196, 82: 0.6098, 83: 0.5993, 84: 0.5881, 85: 0.5762, 86: 0.5637, 87: 0.5505, 88: 0.5366, 89: 0.5220, 90: 0.5067, 91: 0.4908, 92: 0.4742, 93: 0.4569, 94: 0.4390, 95: 0.4204, 96: 0.4010, 97: 0.3811, 98: 0.3604, 99: 0.3391, 100: 0.3171, 101: 0.2944, 102: 0.2711, 103: 0.2470, 104: 0.2223, 105: 0.1970, 106: 0.1709, 107: 0.1442, 108: 0.1168, 109: 0.0887, 110: 0.0600 }
+  "5000": { 30: 1.0000, 31: 1.0000, 32: 1.0000, 33: 1.0000, 34: 1.0000, 35: 0.9974, 36: 0.9904, 37: 0.9833, 38: 0.9761, 39: 0.9689, 40: 0.9615, 41: 0.9541, 42: 0.9467, 43: 0.9392, 44: 0.9316, 45: 0.9239, 46: 0.9162, 47: 0.9084, 48: 0.9006, 49: 0.8926, 50: 0.8847, 51: 0.8766, 52: 0.8685, 53: 0.8603, 54: 0.8521, 55: 0.8438, 56: 0.8355, 57: 0.8271, 58: 0.8186, 59: 0.8101, 60: 0.8015, 61: 0.7929, 62: 0.7842, 63: 0.7755, 64: 0.7667, 65: 0.7578, 66: 0.7489, 67: 0.7399, 68: 0.7309, 69: 0.7219, 70: 0.7128, 71: 0.7036, 72: 0.6944, 73: 0.6851, 74: 0.6758, 75: 0.6665, 76: 0.6571, 77: 0.6476, 78: 0.6381, 79: 0.6286, 80: 0.6190, 81: 0.6094, 82: 0.5997, 83: 0.5893, 84: 0.5783, 85: 0.5665, 86: 0.5541, 87: 0.5410, 88: 0.5272, 89: 0.5127, 90: 0.4975, 91: 0.4816, 92: 0.4650, 93: 0.4478, 94: 0.4299, 95: 0.4112, 96: 0.3919, 97: 0.3719, 98: 0.3513, 99: 0.3299, 100: 0.3079, 101: 0.2852, 102: 0.2618, 103: 0.2377, 104: 0.2129, 105: 0.1875, 106: 0.1613, 107: 0.1345, 108: 0.1070, 109: 0.0788, 110: 0.0500 }
+  "10000": { 30: 1.0000, 31: 1.0000, 32: 1.0000, 33: 1.0000, 34: 0.9937, 35: 0.9869, 36: 0.9801, 37: 0.9731, 38: 0.9661, 39: 0.9591, 40: 0.9519, 41: 0.9447, 42: 0.9374, 43: 0.9301, 44: 0.9227, 45: 0.9152, 46: 0.9077, 47: 0.9001, 48: 0.8925, 49: 0.8848, 50: 0.8770, 51: 0.8692, 52: 0.8613, 53: 0.8533, 54: 0.8453, 55: 0.8373, 56: 0.8291, 57: 0.8210, 58: 0.8127, 59: 0.8045, 60: 0.7961, 61: 0.7877, 62: 0.7793, 63: 0.7708, 64: 0.7623, 65: 0.7537, 66: 0.7450, 67: 0.7363, 68: 0.7276, 69: 0.7188, 70: 0.7100, 71: 0.7011, 72: 0.6922, 73: 0.6832, 74: 0.6742, 75: 0.6651, 76: 0.6560, 77: 0.6468, 78: 0.6376, 79: 0.6284, 80: 0.6191, 81: 0.6098, 82: 0.6004, 83: 0.5903, 84: 0.5795, 85: 0.5679, 86: 0.5556, 87: 0.5425, 88: 0.5287, 89: 0.5142, 90: 0.4990, 91: 0.4830, 92: 0.4662, 93: 0.4488, 94: 0.4306, 95: 0.4116, 96: 0.3920, 97: 0.3716, 98: 0.3505, 99: 0.3286, 100: 0.3060, 101: 0.2827, 102: 0.2586, 103: 0.2339, 104: 0.2084, 105: 0.1821, 106: 0.1551, 107: 0.1275, 108: 0.0990, 109: 0.0699, 110: 0.0400 }
+  "21097": { 30: 1.0000, 31: 1.0000, 32: 1.0000, 33: 0.9935, 34: 0.9869, 35: 0.9802, 36: 0.9734, 37: 0.9666, 38: 0.9596, 39: 0.9526, 40: 0.9455, 41: 0.9384, 42: 0.9311, 43: 0.9238, 44: 0.9164, 45: 0.9090, 46: 0.9014, 47: 0.8938, 48: 0.8862, 49: 0.8784, 50: 0.8706, 51: 0.8627, 52: 0.8548, 53: 0.8468, 54: 0.8387, 55: 0.8306, 56: 0.8224, 57: 0.8141, 58: 0.8058, 59: 0.7974, 60: 0.7889, 61: 0.7804, 62: 0.7718, 63: 0.7632, 64: 0.7545, 65: 0.7457, 66: 0.7369, 67: 0.7280, 68: 0.7191, 69: 0.7101, 70: 0.7011, 71: 0.6920, 72: 0.6828, 73: 0.6736, 74: 0.6644, 75: 0.6551, 76: 0.6457, 77: 0.6363, 78: 0.6268, 79: 0.6173, 80: 0.6078, 81: 0.5982, 82: 0.5879, 83: 0.5769, 84: 0.5653, 85: 0.5530, 86: 0.5401, 87: 0.5265, 88: 0.5122, 89: 0.4972, 90: 0.4816, 91: 0.4653, 92: 0.4484, 93: 0.4307, 94: 0.4125, 95: 0.3935, 96: 0.3739, 97: 0.3536, 98: 0.3327, 99: 0.3111, 100: 0.2888, 101: 0.2659, 102: 0.2424, 103: 0.2181, 104: 0.1932, 105: 0.1677, 106: 0.1414, 107: 0.1146, 108: 0.0870, 109: 0.0588, 110: 0.0300 }
+  "42195": { 30: 1.0000, 31: 1.0000, 32: 1.0000, 33: 1.0000, 34: 1.0000, 35: 0.9982, 36: 0.9918, 37: 0.9854, 38: 0.9789, 39: 0.9722, 40: 0.9654, 41: 0.9585, 42: 0.9515, 43: 0.9444, 44: 0.9371, 45: 0.9298, 46: 0.9223, 47: 0.9148, 48: 0.9071, 49: 0.8993, 50: 0.8915, 51: 0.8835, 52: 0.8754, 53: 0.8672, 54: 0.8590, 55: 0.8506, 56: 0.8421, 57: 0.8336, 58: 0.8249, 59: 0.8162, 60: 0.8073, 61: 0.7984, 62: 0.7894, 63: 0.7803, 64: 0.7711, 65: 0.7618, 66: 0.7524, 67: 0.7430, 68: 0.7335, 69: 0.7239, 70: 0.7142, 71: 0.7044, 72: 0.6946, 73: 0.6846, 74: 0.6746, 75: 0.6646, 76: 0.6544, 77: 0.6442, 78: 0.6339, 79: 0.6235, 80: 0.6131, 81: 0.6025, 82: 0.5914, 83: 0.5795, 84: 0.5670, 85: 0.5538, 86: 0.5400, 87: 0.5254, 88: 0.5103, 89: 0.4944, 90: 0.4779, 91: 0.4608, 92: 0.4429, 93: 0.4245, 94: 0.4053, 95: 0.3855, 96: 0.3651, 97: 0.3439, 98: 0.3222, 99: 0.2997, 100: 0.2767, 101: 0.2529, 102: 0.2285, 103: 0.2035, 104: 0.1778, 105: 0.1515, 106: 0.1245, 107: 0.0968, 108: 0.0685, 109: 0.0396, 110: 0.0100 }
+
+M:
+  "1500": { 30: 1.0000, 31: 1.0000, 32: 1.0000, 33: 0.9973, 34: 0.9911, 35: 0.9849, 36: 0.9786, 37: 0.9723, 38: 0.9660, 39: 0.9596, 40: 0.9532, 41: 0.9468, 42: 0.9403, 43: 0.9338, 44: 0.9272, 45: 0.9206, 46: 0.9140, 47: 0.9073, 48: 0.9006, 49: 0.8939, 50: 0.8871, 51: 0.8803, 52: 0.8734, 53: 0.8666, 54: 0.8596, 55: 0.8527, 56: 0.8457, 57: 0.8387, 58: 0.8316, 59: 0.8246, 60: 0.8174, 61: 0.8103, 62: 0.8031, 63: 0.7959, 64: 0.7887, 65: 0.7814, 66: 0.7741, 67: 0.7668, 68: 0.7594, 69: 0.7520, 70: 0.7446, 71: 0.7371, 72: 0.7296, 73: 0.7221, 74: 0.7146, 75: 0.7070, 76: 0.6994, 77: 0.6918, 78: 0.6835, 79: 0.6746, 80: 0.6651, 81: 0.6549, 82: 0.6440, 83: 0.6325, 84: 0.6204, 85: 0.6076, 86: 0.5942, 87: 0.5801, 88: 0.5654, 89: 0.5501, 90: 0.5341, 91: 0.5175, 92: 0.5002, 93: 0.4823, 94: 0.4638, 95: 0.4446, 96: 0.4248, 97: 0.4043, 98: 0.3832, 99: 0.3614, 100: 0.3390, 101: 0.3160, 102: 0.2923, 103: 0.2680, 104: 0.2431, 105: 0.2175, 106: 0.1913, 107: 0.1644, 108: 0.1369, 109: 0.1088, 110: 0.0800 }
+  "3000": { 30: 1.0000, 31: 1.0000, 32: 1.0000, 33: 1.0000, 34: 1.0000, 35: 0.9993, 36: 0.9922, 37: 0.9851, 38: 0.9780, 39: 0.9708, 40: 0.9636, 41: 0.9564, 42: 0.9491, 43: 0.9419, 44: 0.9345, 45: 0.9272, 46: 0.9199, 47: 0.9125, 48: 0.9051, 49: 0.8976, 50: 0.8901, 51: 0.8827, 52: 0.8751, 53: 0.8676, 54: 0.8600, 55: 0.8524, 56: 0.8448, 57: 0.8372, 58: 0.8295, 59: 0.8218, 60: 0.8141, 61: 0.8064, 62: 0.7986, 63: 0.7908, 64: 0.7830, 65: 0.7752, 66: 0.7674, 67: 0.7595, 68: 0.7516, 69: 0.7437, 70: 0.7357, 71: 0.7278, 72: 0.7198, 73: 0.7118, 74: 0.7038, 75: 0.6957, 76: 0.6877, 77: 0.6796, 78: 0.6715, 79: 0.6634, 80: 0.6552, 81: 0.6464, 82: 0.6367, 83: 0.6263, 84: 0.6151, 85: 0.6032, 86: 0.5905, 87: 0.5771, 88: 0.5629, 89: 0.5480, 90: 0.5323, 91: 0.5158, 92: 0.4986, 93: 0.4806, 94: 0.4619, 95: 0.4425, 96: 0.4222, 97: 0.4013, 98: 0.3795, 99: 0.3570, 100: 0.3338, 101: 0.3098, 102: 0.2851, 103: 0.2596, 104: 0.2333, 105: 0.2063, 106: 0.1785, 107: 0.1500, 108: 0.1208, 109: 0.0908, 110: 0.0600 }
+  "5000": { 30: 1.0000, 31: 1.0000, 32: 1.0000, 33: 1.0000, 34: 1.0000, 35: 1.0000, 36: 1.0000, 37: 0.9943, 38: 0.9863, 39: 0.9782, 40: 0.9701, 41: 0.9621, 42: 0.9540, 43: 0.9460, 44: 0.9380, 45: 0.9299, 46: 0.9219, 47: 0.9139, 48: 0.9059, 49: 0.8980, 50: 0.8900, 51: 0.8820, 52: 0.8740, 53: 0.8661, 54: 0.8582, 55: 0.8502, 56: 0.8423, 57: 0.8344, 58: 0.8265, 59: 0.8185, 60: 0.8106, 61: 0.8028, 62: 0.7949, 63: 0.7870, 64: 0.7791, 65: 0.7713, 66: 0.7634, 67: 0.7556, 68: 0.7477, 69: 0.7399, 70: 0.7321, 71: 0.7242, 72: 0.7164, 73: 0.7086, 74: 0.7008, 75: 0.6930, 76: 0.6852, 77: 0.6775, 78: 0.6697, 79: 0.6619, 80: 0.6541, 81: 0.6464, 82: 0.6367, 83: 0.6263, 84: 0.6151, 85: 0.6032, 86: 0.5905, 87: 0.5771, 88: 0.5629, 89: 0.5480, 90: 0.5323, 91: 0.5158, 92: 0.4986, 93: 0.4806, 94: 0.4619, 95: 0.4425, 96: 0.4222, 97: 0.4013, 98: 0.3795, 99: 0.3570, 100: 0.3338, 101: 0.3098, 102: 0.2851, 103: 0.2596, 104: 0.2333, 105: 0.2063, 106: 0.1785, 107: 0.1500, 108: 0.1208, 109: 0.0908, 110: 0.0600 }
+  "10000": { 30: 1.0000, 31: 1.0000, 32: 1.0000, 33: 1.0000, 34: 0.9973, 35: 0.9897, 36: 0.9822, 37: 0.9747, 38: 0.9672, 39: 0.9597, 40: 0.9523, 41: 0.9449, 42: 0.9375, 43: 0.9301, 44: 0.9228, 45: 0.9155, 46: 0.9082, 47: 0.9009, 48: 0.8937, 49: 0.8865, 50: 0.8793, 51: 0.8722, 52: 0.8650, 53: 0.8579, 54: 0.8509, 55: 0.8438, 56: 0.8368, 57: 0.8298, 58: 0.8228, 59: 0.8158, 60: 0.8089, 61: 0.8019, 62: 0.7950, 63: 0.7882, 64: 0.7813, 65: 0.7745, 66: 0.7677, 67: 0.7609, 68: 0.7541, 69: 0.7474, 70: 0.7407, 71: 0.7340, 72: 0.7273, 73: 0.7206, 74: 0.7140, 75: 0.7073, 76: 0.7007, 77: 0.6942, 78: 0.6868, 79: 0.6787, 80: 0.6698, 81: 0.6601, 82: 0.6496, 83: 0.6383, 84: 0.6263, 85: 0.6135, 86: 0.5999, 87: 0.5856, 88: 0.5704, 89: 0.5545, 90: 0.5378, 91: 0.5203, 92: 0.5021, 93: 0.4830, 94: 0.4632, 95: 0.4426, 96: 0.4213, 97: 0.3991, 98: 0.3762, 99: 0.3524, 100: 0.3279, 101: 0.3027, 102: 0.2766, 103: 0.2498, 104: 0.2221, 105: 0.1937, 106: 0.1646, 107: 0.1346, 108: 0.1038, 109: 0.0723, 110: 0.0400 }
+  "21097": { 30: 1.0000, 31: 1.0000, 32: 1.0000, 33: 1.0000, 34: 1.0000, 35: 0.9953, 36: 0.9885, 37: 0.9816, 38: 0.9748, 39: 0.9680, 40: 0.9612, 41: 0.9544, 42: 0.9476, 43: 0.9408, 44: 0.9340, 45: 0.9272, 46: 0.9204, 47: 0.9137, 48: 0.9069, 49: 0.9002, 50: 0.8934, 51: 0.8867, 52: 0.8799, 53: 0.8732, 54: 0.8665, 55: 0.8598, 56: 0.8531, 57: 0.8464, 58: 0.8397, 59: 0.8331, 60: 0.8264, 61: 0.8197, 62: 0.8131, 63: 0.8064, 64: 0.7998, 65: 0.7931, 66: 0.7865, 67: 0.7799, 68: 0.7733, 69: 0.7666, 70: 0.7600, 71: 0.7534, 72: 0.7468, 73: 0.7396, 74: 0.7318, 75: 0.7233, 76: 0.7142, 77: 0.7044, 78: 0.6941, 79: 0.6831, 80: 0.6715, 81: 0.6592, 82: 0.6463, 83: 0.6328, 84: 0.6187, 85: 0.6039, 86: 0.5885, 87: 0.5725, 88: 0.5558, 89: 0.5385, 90: 0.5206, 91: 0.5021, 92: 0.4829, 93: 0.4631, 94: 0.4426, 95: 0.4216, 96: 0.3999, 97: 0.3776, 98: 0.3546, 99: 0.3310, 100: 0.3068, 101: 0.2820, 102: 0.2565, 103: 0.2304, 104: 0.2036, 105: 0.1763, 106: 0.1483, 107: 0.1197, 108: 0.0904, 109: 0.0605, 110: 0.0300 }
+  "42195": { 30: 1.0000, 31: 1.0000, 32: 1.0000, 33: 1.0000, 34: 1.0000, 35: 1.0000, 36: 1.0000, 37: 1.0000, 38: 0.9947, 39: 0.9876, 40: 0.9804, 41: 0.9733, 42: 0.9661, 43: 0.9589, 44: 0.9517, 45: 0.9445, 46: 0.9372, 47: 0.9299, 48: 0.9226, 49: 0.9153, 50: 0.9079, 51: 0.9005, 52: 0.8931, 53: 0.8857, 54: 0.8783, 55: 0.8708, 56: 0.8633, 57: 0.8558, 58: 0.8483, 59: 0.8407, 60: 0.8331, 61: 0.8255, 62: 0.8179, 63: 0.8103, 64: 0.8026, 65: 0.7950, 66: 0.7873, 67: 0.7796, 68: 0.7718, 69: 0.7641, 70: 0.7563, 71: 0.7485, 72: 0.7407, 73: 0.7329, 74: 0.7250, 75: 0.7165, 76: 0.7074, 77: 0.6976, 78: 0.6871, 79: 0.6760, 80: 0.6643, 81: 0.6519, 82: 0.6388, 83: 0.6251, 84: 0.6108, 85: 0.5958, 86: 0.5801, 87: 0.5638, 88: 0.5469, 89: 0.5293, 90: 0.5110, 91: 0.4921, 92: 0.4726, 93: 0.4524, 94: 0.4316, 95: 0.4101, 96: 0.3879, 97: 0.3651, 98: 0.3417, 99: 0.3176, 100: 0.2929, 101: 0.2675, 102: 0.2415, 103: 0.2148, 104: 0.1875, 105: 0.1595, 106: 0.1309, 107: 0.1017, 108: 0.0718, 109: 0.0412, 110: 0.0100 }

data/lib/calcpace/pace_calculator.rb

@@ -3,7 +3,7 @@
 # Module for calculating race times and paces for standard distances
 #
 # This module provides convenience methods for calculating finish times
-# and paces for common race distances like 5K, 10K, half-marathon, and marathon.
+# and paces for common race distances like 5K, 10K, half-marathon, marathon, and 100K.
 module PaceCalculator
   # Standard race distances in kilometers
   RACE_DISTANCES = {
@@ -11,6 +11,7 @@ module PaceCalculator
     '10k' => 10.0,
     'half_marathon' => 21.0975,
     'marathon' => 42.195,
+    '100k' => 100.0,
     '1mile' => 1.60934,
     '5mile' => 8.04672,
     '10mile' => 16.0934
@@ -19,7 +20,7 @@ module PaceCalculator
   # Calculates the finish time for a race given a pace per kilometer
   #
   # @param pace_per_km [Numeric, String] pace in seconds per km or time string (MM:SS)
-  # @param race [String, Symbol] race distance ('5k', '10k', 'half_marathon', 'marathon')
+  # @param race [String, Symbol] race distance ('5k', '10k', 'half_marathon', 'marathon', '100k')
   # @return [Float] total time in seconds
   # @raise [ArgumentError] if race distance is not recognized
   #
@@ -36,7 +37,7 @@ module PaceCalculator
   # Calculates the finish time for a race and returns it as a clock time string
   #
   # @param pace_per_km [Numeric, String] pace in seconds per km or time string (MM:SS)
-  # @param race [String, Symbol] race distance ('5k', '10k', 'half_marathon', 'marathon')
+  # @param race [String, Symbol] race distance ('5k', '10k', 'half_marathon', 'marathon', '100k')
   # @return [String] finish time in HH:MM:SS format
   #
   # @example
@@ -49,7 +50,7 @@ module PaceCalculator
   # Calculates the required pace per kilometer to finish a race in a target time
   #
   # @param target_time [Numeric, String] target finish time in seconds or time string (HH:MM:SS)
-  # @param race [String, Symbol] race distance ('5k', '10k', 'half_marathon', 'marathon')
+  # @param race [String, Symbol] race distance ('5k', '10k', 'half_marathon', 'marathon', '100k')
   # @return [Float] required pace in seconds per kilometer
   #
   # @example
@@ -65,7 +66,7 @@ module PaceCalculator
   # Calculates the required pace and returns it as a clock time string
   #
   # @param target_time [Numeric, String] target finish time in seconds or time string (HH:MM:SS)
-  # @param race [String, Symbol] race distance ('5k', '10k', 'half_marathon', 'marathon')
+  # @param race [String, Symbol] race distance ('5k', '10k', 'half_marathon', 'marathon', '100k')
   # @return [String] required pace in MM:SS format
   #
   # @example

data/lib/calcpace/race_predictor.rb

@@ -19,7 +19,7 @@ module RacePredictor
   # - D2 = target distance
   # - 1.06 = endurance/fatigue factor (longer races require proportionally more time)
   #
-  # @param from_race [String, Symbol] known race distance ('5k', '10k', 'half_marathon', 'marathon', etc.)
+  # @param from_race [String, Symbol] known race distance ('5k', '10k', 'half_marathon', 'marathon', '100k', etc.)
   # @param from_time [String, Numeric] time achieved at known distance (HH:MM:SS or seconds)
   # @param to_race [String, Symbol] target race distance to predict
   # @return [Float] predicted time in seconds

data/lib/calcpace/race_splits.rb

@@ -7,7 +7,7 @@
 module RaceSplits
   # Calculates split times for a race
   #
-  # @param race [String, Symbol] race distance ('5k', '10k', 'half_marathon', 'marathon', etc.)
+  # @param race [String, Symbol] race distance ('5k', '10k', 'half_marathon', 'marathon', '100k', etc.)
   # @param target_time [String] target finish time in HH:MM:SS or MM:SS format
   # @param split_distance [String, Numeric] distance for each split ('5k', '1k', '1mile', or numeric in km)
   # @param strategy [Symbol] pacing strategy - :even (default), :negative, or :positive
@@ -42,7 +42,7 @@ module RaceSplits
     if split_distance.is_a?(Numeric)
       split_distance.to_f
     elsif split_distance.is_a?(String)
-      # Try to get from RACE_DISTANCES first (includes standard distances like '5k', '1mile', etc.)
+      # Try to get from RACE_DISTANCES first (includes standard distances like '5k', '100k', '1mile', etc.)
       distance_key = split_distance.to_s.downcase
 
       # Check if it's a standard race distance

data/lib/calcpace/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class Calcpace
-  VERSION = '1.9.3'
+  VERSION = '1.9.5'
 end

data/lib/calcpace.rb

@@ -2,6 +2,7 @@
 
 require_relative 'calcpace/calculator'
 require_relative 'calcpace/cameron_predictor'
+require_relative 'calcpace/age_grading'
 require_relative 'calcpace/checker'
 require_relative 'calcpace/converter'
 require_relative 'calcpace/converter_chain'
@@ -35,6 +36,7 @@ require_relative 'calcpace/vo2max_estimator'
 #
 # @see https://github.com/0jonjo/calcpace
 class Calcpace
+  include AgeGrading
   include Calculator
   include CameronPredictor
   include Checker

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: calcpace
 version: !ruby/object:Gem::Version
-  version: 1.9.3
+  version: 1.9.5
 platform: ruby
 authors:
 - João Gilberto Saraiva
@@ -31,11 +31,14 @@ files:
 - Rakefile
 - calcpace.gemspec
 - lib/calcpace.rb
+- lib/calcpace/age_grading.rb
 - lib/calcpace/calculator.rb
 - lib/calcpace/cameron_predictor.rb
 - lib/calcpace/checker.rb
 - lib/calcpace/converter.rb
 - lib/calcpace/converter_chain.rb
+- lib/calcpace/data/wma_2023_open_standards.yml
+- lib/calcpace/data/wma_2023_road.yml
 - lib/calcpace/errors.rb
 - lib/calcpace/pace_calculator.rb
 - lib/calcpace/pace_converter.rb