IPPT Utils

A module to calculate IPPT scores

November 20, 2020

Links

IPPT utils is a library containing functions to calculate SAF IPPT scores. I had originally created this library for my work in the Singapore Armed Forces.

The library contains functions to calculate age groups, pushup, situp, and IPPT scores:

import { getAgeGroup, getPushupScore, getSitupScore, getRunScore } from 'ippt-utils';
// Or
const { getAgeGroup, getPushupScore, getSitupScore, getRunScore } = require('ippt-utils');
 
const age = 22;
const ageGroup = getAgeGroup(age);
// => 2 (a 22-year old man is in the age group 2)
 
const pushupsDone = 31;
const pushupScore = getPushupScore(ageGroup, pushupsDone);
// => [17, 3] (for pushups, he got a score of 17
// and he needs to do three more pushup to get the next point)
 
const situpsDone = 37;
const situpScore = getSitupScore(ageGroup, situpsDone);
// => [19, 2] (for situps, he got a score of 19
// and he needs to do two more situps to get the next point)
 
// 10 min, 10 seconds
const runTime = 10 * 60 + 10; // in seconds
const runScore = getRunScore(ageGroup, runTime);
// => [40, 20] (score of 40 for run
// and he needs to reduce his time by 20 seconds for next point)
 
// Note that run times round up to the nearest 10 seconds, so a
// run time of 10 min 1 second is the same as 10 min 10 seconds

In addition, it also contains a helper function to calculate the entire IPPT score:

import { getAgeGroup, getIpptScore } from 'ippt-utils';
 
const age = 22;
const ageGroup = getAgeGroup(age); // age group 2
 
const pushupsDone = 31;
const situpsDone = 37;
const runTime = 10 * 60 + 10; // 10 min, 10 seconds
 
const result = getIpptScore(ageGroup, pushupsDone, situpsDone, runTime);
/* 
{
  pushups: { 
    score: 17, 
    next: 3  <-- 3 pushups more = 1 more point
  },
  situps: { 
    score: 19, 
    next: 2 
  },
  run: { 
    score: 40, 
    next: 20 
  },
  score: 76,
  ageGroup: 2,
  award: { 
    name: 'Silver', 
    cash: 300, 
    minScore: 75 
  }
}
*/
 
result.score;
// => 76
 
result.award.name;
// => 'Silver'