health-calculator v1.0.0

health-calculator

A library to help calculate well known health-related metrics.

Install

npm i health-calculator

Usage

import { dietary } from 'health-calculator';

console.log( dietary.tdee( 'male', 20, 80, 180, 'moderate' ) );

or:

import { tdee } from 'health-calculator/dietary';

console.log( tdee( 'male', 20, 80, 180, 'moderate' ) );

See API reference for more.

API Reference

Modules

body_measurement

• body_measurement
  • ~bmi(weight, height, imperial) ⇒ number
  • ~whtr(waistCircumference, height, imperial) ⇒ number
  • ~whtrCategory(gender, age, ratio) ⇒ BodyCategory
  • ~whtrChildren(ratio) ⇒ BodyCategory
  • ~whtrMale(ratio) ⇒ BodyCategory
  • ~whtrFemale(ratio) ⇒ BodyCategory
  • ~whr(waistCircumference, hipCircumference, imperial) ⇒ number
  • ~bfp(gender, age, bmi) ⇒ number
  • ~lbm(gender, weight, height, imperial) ⇒ number
  • ~rfm(gender, height, waistCircumference, imperial) ⇒ number
  • ~ffmi(weight, height, bodyFat, imperial) ⇒ number

body_measurement~bmi(weight, height, imperial) ⇒ number

Calculates body mass index (BMI).

Kind: inner method of body_measurement
Returns: number - BMI.

body_measurement~whtr(waistCircumference, height, imperial) ⇒ number

Calculates waist-to-height ratio (WHtR).

Kind: inner method of body_measurement
Returns: number - WHtR.
See: https://en.wikipedia.org/wiki/Waist-to-height_ratio

body_measurement~whtrCategory(gender, age, ratio) ⇒ BodyCategory

Categorize the boundaries for WHtR in terms of their health implications.

Kind: inner method of body_measurement
Returns: BodyCategory - Category.
See: https://en.wikipedia.org/wiki/Waist-to-height_ratio#Health_implications

body_measurement~whtrChildren(ratio) ⇒ BodyCategory

WHtR category for children (up to 15 yeard old).

Kind: inner method of body_measurement
Returns: BodyCategory - Category.

body_measurement~whtrMale(ratio) ⇒ BodyCategory

WHtR category for adult male.

Kind: inner method of body_measurement
Returns: BodyCategory - Category.

body_measurement~whtrFemale(ratio) ⇒ BodyCategory

WHtR category for adult female.

Kind: inner method of body_measurement
Returns: BodyCategory - Category.

body_measurement~whr(waistCircumference, hipCircumference, imperial) ⇒ number

Calculates waist-to-hip ratio (WHR).

Kind: inner method of body_measurement
Returns: number - WHR.
See: https://en.wikipedia.org/wiki/Waist%E2%80%93hip_ratio

body_measurement~bfp(gender, age, bmi) ⇒ number

Calculates body fat percentage (BFP) using BMI.

Kind: inner method of body_measurement
Returns: number - BFP.
See: https://en.wikipedia.org/wiki/Body_fat_percentage#From_BMI

body_measurement~lbm(gender, weight, height, imperial) ⇒ number

Calculates lean body mass (LBM) using the Boer formula.

Kind: inner method of body_measurement
Returns: number - LBM.
See: https://en.wikipedia.org/wiki/Lean_body_mass#Boer[3]

body_measurement~rfm(gender, height, waistCircumference, imperial) ⇒ number

Calculates relative fat mass (RFM).

Kind: inner method of body_measurement
Returns: number - RFM.

body_measurement~ffmi(weight, height, bodyFat, imperial) ⇒ number

Calculates fat-free mass index (FFMI).

Kind: inner method of body_measurement
Returns: number - FFMI.

dietary

• dietary
  • ~bmr(gender, age, weight, height, imperial, equation) ⇒ number
  • ~bmrHarrisBenedict(gender, age, weight, height) ⇒ number
  • ~bmrRozaAndShizgal(gender, age, weight, height) ⇒ number
  • ~bmrMifflin(gender, age, weight, height) ⇒ number
  • ~tdee(gender, age, weight, height, activity, imperial, equation) ⇒ number
  • ~amdr(gender, age, weight, height, activity, imperial, equation) ⇒ number

dietary~bmr(gender, age, weight, height, imperial, equation) ⇒ number

Calculates basal metabolic rate (BMW); the number of calories our body needs to accomplish its most basic (basal) life-sustaining functions.

Kind: inner method of dietary
Returns: number - BMI.

dietary~bmrHarrisBenedict(gender, age, weight, height) ⇒ number

Calculates BMR using Harris-Benedict equation.

Kind: inner method of dietary
Returns: number - BMR.
See: https://en.wikipedia.org/wiki/Harris%E2%80%93Benedict_equation

dietary~bmrRozaAndShizgal(gender, age, weight, height) ⇒ number

Calculates BMR using revised Harris-Benedict equation by Roza and Shizgal.

Kind: inner method of dietary
Returns: number - BMR.
See: https://en.wikipedia.org/wiki/Harris%E2%80%93Benedict_equation

dietary~bmrMifflin(gender, age, weight, height) ⇒ number

Calculates BMR using revised Harris-Benedict equation by Mifflin.

Kind: inner method of dietary
Returns: number - BMR.
See: https://en.wikipedia.org/wiki/Harris%E2%80%93Benedict_equation

dietary~tdee(gender, age, weight, height, activity, imperial, equation) ⇒ number

Calculates total daily energy expenditure (TDEE); the number of calories our body burns daily to perform its bodily functions based on activity level.

Kind: inner method of dietary
Returns: number - BMR.

dietary~amdr(gender, age, weight, height, activity, imperial, equation) ⇒ number

Calculates acceptable macronutrient range (AMDR).

Kind: inner method of dietary
Returns: number - BMR.

sports

• sports
  • ~oneRm(reps, weight, formula) ⇒ number
  • ~hrMax(age, formula) ⇒ number

sports~oneRm(reps, weight, formula) ⇒ number

Calculates one-repetition maximum (1RM) using various formula.

Kind: inner method of sports
Returns: number - One rep max.

sports~hrMax(age, formula) ⇒ number

Calculates maximum heart rate (HR) of a given age and formula.

Kind: inner method of sports
Returns: number - HRmax in BPM (beats per minute).

util

• util
  • ~cmToInch(cm) ⇒ number
  • ~inchToCm(inch) ⇒ number
  • ~lbToKg(lb) ⇒ number
  • ~kgToLb(kg) ⇒ number

util~cmToInch(cm) ⇒ number

Converts cm to inch.

Kind: inner method of util
Returns: number - Length in inch.

util~inchToCm(inch) ⇒ number

Converts inch to cm.

Kind: inner method of util
Returns: number - Length in cm.

util~lbToKg(lb) ⇒ number

Converts lb to kg.

Kind: inner method of util
Returns: number - Weight in kg.

util~kgToLb(kg) ⇒ number

Converts kg to lb.

Kind: inner method of util
Returns: number - Weight in lb.