running-tools

A collection of tools for runners and their coaches
git clone https://git.ashermorgan.net/running-tools/
Log | Files | Refs | README

AboutPage.vue (8042B)


      1 <template>
      2   <div class="text">
      3     <p>
      4       Running Tools is an <a :href="git_url">open source</a> collection of tools for runners
      5         and their coaches.
      6       All calculations are performed locally on your device.
      7       This is Running Tools version <router-link :to="{ name: 'changelog' }">
      8         {{ version }}</router-link>{{ development ? ' (dev)' : '' }}.
      9     </p>
     10 
     11     <h2>Installation</h2>
     12     <p>
     13       Running Tools can be installed as a progressive web app so it works offline:
     14     </p>
     15     <ul>
     16       <li>On iOS devices, open Running Tools in Safari, press <span aria-label="Share">
     17         <vue-feather type="share" aria-hidden="true"/></span>, and select Add to Home Screen</li>
     18       <li>On all other platforms, open Running Tools in Chrome and click Install
     19         <img src="@/assets/chrome-install.png" height="24" class="chrome-install" alt=""/>
     20       </li>
     21     </ul>
     22 
     23     <h2>The Calculators</h2>
     24     <p>
     25       Running Tools consists of six calculators.
     26       The Pace, Race, and Unit Calculators are the simplest to use, while the Batch, Split, and
     27         Workout Calculators are designed for more advanced use cases.
     28     </p>
     29 
     30     <h3>Batch Calculator</h3>
     31     <p>
     32       The <router-link :to="{ name: 'calculate-batch' }">Batch Calculator</router-link> calculates
     33         results for a range of input times using the Pace, Race, or Workout Calculators.
     34       Options such as the default unit system, selected target set, and race prediction model are
     35         synced from the active calculator.
     36       If the Workout Calculator is being used with custom workout names enabled, a custom name may
     37         also be specified for the batch column header.
     38     </p>
     39     <p>
     40       The Batch Calculator is useful for tasks such as:
     41     </p>
     42     <ul class="questions">
     43       <li>Generating a table of marathon finish times and the corresponding mile splits.</li>
     44       <li>Generating a table of equivalent race results for many distances and speeds.</li>
     45       <li>Generating a table of workout split times for an entire team.</li>
     46     </ul>
     47 
     48     <h3>Pace Calculator</h3>
     49     <p>
     50       The <router-link :to="{ name: 'calculate-paces' }">Pace Calculator</router-link> takes a
     51         distance and duration as input and shows other distances and times that result in
     52         the same pace.
     53       The selected target set controls which distances and/or times the calculator shows output for.
     54     </p>
     55     <p>
     56       The Pace Calculator is useful for answering questions like:
     57     </p>
     58     <ul class="questions">
     59       <li>How far would I go in 30 minutes if I run 8 minutes per mile? (3.75 miles)</li>
     60       <li>What do I have to run per mile to finish a marathon in three hours? (6:52 per mile)</li>
     61     </ul>
     62 
     63     <h3>Race Calculator</h3>
     64     <p>
     65       The <router-link :to="{ name: 'calculate-races' }">Race Calculator</router-link> takes a
     66         distance and duration as input and shows other distances and durations that would be
     67         equivalent race results.
     68       The selected target set controls which distances and/or times the calculator predicts race
     69         results for.
     70       Extra output statistics for the input race result are also available under the Race Statistics
     71         section.
     72     </p>
     73     <p>
     74       The Advanced Options section includes the option to switch between the five supported race
     75         prediction models:
     76     </p>
     77       <ul>
     78         <li>The Purdy Points Model</li>
     79         <li>The V&#775;O&#8322; Max Model</li>
     80         <li>Dave Cameron's Model</li>
     81         <li>Pete Riegel's Model (includes a configurable exponent)</li>
     82         <li>Average Model (averages the output of the other four models)</li>
     83       </ul>
     84       <p>
     85     </p>
     86     <p>
     87       The Race Calculator is useful for answering questions like:
     88     </p>
     89     <ul class="questions">
     90       <li>If I raced a 5k in 20:00, how fast could I race a 10k? (about 41:35)</li>
     91       <li>Which is a better race result, a 20:00 5K or a 5:00 Mile? (a 5:00 Mile)</li>
     92     </ul>
     93     <p>
     94       <strong>Note:</strong> Output race times and V&#775;O&#8322; / V&#775;O&#8322; Max values are
     95         just estimates.
     96       Race predictions assume equivalent fitness and conditions to the input race, and are most
     97         accurate for similar distances.
     98     </p>
     99 
    100     <h3>Split Calculator</h3>
    101     <p>
    102       The <router-link :to="{ name: 'calculate-splits' }">Split Calculator</router-link> takes a set
    103         of split times at certain distances as input and calculates the pace and cumulative time for
    104         each split.
    105       The selected target set controls which distances are used for the splits.
    106     </p>
    107     <p>
    108       The Split Calculator is useful for answering questions like:
    109     </p>
    110     <ul class="questions">
    111       <li>How fast would I finish a 1600m if I ran the 400m laps in 90s, 85s, 80s, and 75s? (5:30)</li>
    112       <li>If I finished a 5K in 20:00 and ran the first 2 miles in 13:00, how fast was the last ~1.1
    113         miles? (6:19 / mi pace)</li>
    114     </ul>
    115 
    116     <h3>Unit Calculator</h3>
    117     <p>
    118       The <router-link :to="{ name: 'calculate-units' }">Unit Calculator</router-link> converts
    119         between different units and formats.
    120     </p>
    121     <p>
    122       This is useful for answering questions like:
    123     </p>
    124     <ul class="questions">
    125       <li>How many miles is a 5K? (3.107 miles)</li>
    126       <li>What is 10 mph in time per mile? (6:00 / mi)</li>
    127       <li>What is 123.4 minutes in hh:mm:ss? (02:03:24)</li>
    128     </ul>
    129 
    130     <h3>Workout Calculator</h3>
    131     <p>
    132       The <router-link :to="{ name: 'calculate-workouts' }">Workout Calculator</router-link> takes a
    133         distance and duration as input and shows intermediate splits for other equivalent race
    134         results.
    135       The selected target set controls which race distances and/or times the calculator calculates
    136         outputs for and the distances of the splits that are shown for these races.
    137       The Advanced Options section includes the option to switch between the same five prediction
    138         models that are available in the Race Calculator, as well as the ability to enable support
    139         for specifying custom workout names (e.g. "1 mile threshold" instead of "1 mi @ 1:00:00").
    140     </p>
    141     <p>
    142       The Workout Calculator is useful for answering questions like:
    143     </p>
    144     <ul class="questions">
    145       <li>If I raced a 5K in 20:00, how fast should I run 400m reps at mile pace? (about 1:27)</li>
    146       <li>If I raced a mile in 5:00, what is my "threshold" (~1 hr race) pace? (about 5:52 / mi)</li>
    147     </ul>
    148     <p>
    149       <strong>Note:</strong> Results are just estimated race splits that are helpful for estimating
    150         target workout splits.
    151       As with the Race Calculator, splits assume equivalent fitness and conditions to the input
    152         race, and are most accurate for similar paces.
    153     </p>
    154 
    155     <h2>Target Sets</h2>
    156     <p>
    157       A target set is a collection of distances and/or times that the Pace, Race, Split, or Workout
    158         Calculators will calculate results for.
    159       These calculators will output a duration for each distance target and a distance for each time
    160         target.
    161       Each of these calculators comes with a default target set and allows you to add new target
    162         sets, modify existing target sets, and switch between sets that belong to the same
    163         calculator.
    164     </p>
    165     <p>
    166       <strong>Note:</strong> The Split Calculator only supports distance targets. The Workout
    167         Calculator also includes a split distance field for each target.
    168     </p>
    169   </div>
    170 </template>
    171 
    172 <script setup lang="ts">
    173 import { repository, version } from '/package.json';
    174 
    175 import VueFeather from 'vue-feather';
    176 
    177 const development: boolean = process.env.NODE_ENV === 'development';
    178 const git_url: string = repository.url.slice(4);
    179 </script>
    180 
    181 <style scoped>
    182 .questions {
    183   font-style: italic;
    184 }
    185 .vue-feather {
    186     position: relative;
    187     top: 3px;
    188 }
    189 .chrome-install {
    190     vertical-align: top;
    191 }
    192 @media only screen and (prefers-color-scheme: dark) {
    193     .chrome-install {
    194         filter: invert(1);
    195     }
    196 }
    197 </style>