Running workout calculator

Calculates estimated distance and completion time of pace based workouts.

Imagine you have to do a training according to the following schema: 15 minutes warming up, then 3 kilometers in 10 km pace, then 5 times of 400 meters in 5 km pace followed by 30 seconds rest, after 5 repetitions do 1.5 km in easy pace and then 1.5 hours in marathon pace.

To calculate this program should get two input parameters:

1. pace block: WU=5:00,T10=3:40,E=4:30,T5=3:30,Rest=10:00,M=4:00
2. workout schema: 15:00WU + 3T10 + 1.5E + 5 * (0.4T5 + 00:30Rest) + 1.5E + 1:30:00M

After calculation result can be used in following format:

1. distance in kilometers (or miles): 33.750
2. time as number of seconds: 8340
3. time as formatted string: 02:19:00
4. everything together as a string in the format: Estimated distance - 33.750, time - 02:19:00

Notes:

• Pace name can't start with a number: T10 - ok, 10T - not ok
• Nested repetitions are not supported
• Time format - hh:mm:ss or mm:ss
• If distance is given in miles then pace is assumed to be in min/mile. If distance is in kilometers then pace is in min/km
• Mind the difference between imperial and metric systems when working with short intervals (fraction of kilometers/miles): 0.4 is 400 meters in metric system. In imperial system 0.4 will have a different meaning

Usage

Library is distributed as two jar files which can be downloaded from https://github.com/sandlex/runcalc/releases/latest:

• thin jar runcalc-xxx.jar which can be used as a library in your project
• fat jar runcalc-xxx-jar-with-dependencies.jar which can be executed as a standalone Java application

As a library

• runcalc requires commons-lang as a dependency so:
  • if your project already uses commons-lang as a dependency you can download and add jar file runcalc-xxx.jar to the classpath of your project
  • if your project is not dependent on commons-lang then download and add jar file runcalc-xxx-jar-with-dependencies.jar to the classpath of your project, this jar will bring along commons-lang
• library can be used as follows:

Estimation estimation = Calculator.getEstimation("WU=5:00,T10=3:40,E=4:30,T5=3:30,Rest=10:00,M=4:00", "15:00WU + 3T10 + 1.5E + 5 * (0.4T5 + 00:30Rest) + 1.5E + 1:30:00M");

BigDecimal distance = estimation.getDistance(); //decimal precision: 3 (4th rounded up)
int seconds = estimation.getSeconds();
String time = estimation.getFormattedTime(); //format: "hh:mm:ss"
String result = estimation.toString(); //format: "Estimated distance - %.3f, time - hh:mm:ss"

As a java app

• make sure you have jdk installed in your system
• download executable jar runcalc-xxx-jar-with-dependencies.jar and run application from a command line with two arguments:

java -jar runcalc-xxx-jar-with-dependencies.jar "WU=5:00,T10=3:40,E=4:30,T5=3:30,Rest=10:00,M=4:00" "15:00WU + 3T10 + 1.5E + 5 * (0.4T5 + 00:30Rest) + 1.5E + 1:30:00M"

• result will be printed out as follows:

Estimated distance - 33,750, time - 02:19:00