README

@vicentecalfo/ngx-insulin-calculator

This Angular component was created to show you how to calculate insulin dose with as little effort as possible.

This tool can never replace a professional medical advice.

Installation

First you need to install the npm module.

npm install @vicentecalfo/ngx-insulin-calculator

Usage

1. Import the module

import { NgModule } from '@angular/core';
import { AppRoutingModule } from './app-routing.module';
import { AppComponent } from './app.component';
import { InsulinCalculatorModule } from '@vicentecalfo/ngx-insulin-calculator';

@NgModule({
  declarations: [
    AppComponent
  ],
  imports: [
    BrowserModule,
    AppRoutingModule,
    InsulinCalculatorModule
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

2. Use the component

<insulin-calculator></insulin-calculator>

3. Change Styles

::ng-deep.ic-calculator {
    width: 450px;
    font-family: 'Raleway', sans-serif;
    display: block;
    margin:0 auto;
    .ic-title{
      font-weight: 900;
    }
  }

3.1 HTML Class anatomy

Class name	Description
ic-calculator	Wraps the entire component.
ic-step	Represents a section of the calculator.
ic-title	Section title.
ic-field	Represents the entire row of a calculator field.
ic-label	Field label.
ic-input	Input field.
ic-measure	Unit of measure field.
round-top	Round the top corners.
round-bottom	Round the bottom corners.

HTML markup structure.

<div class="ic-calculator round-top round-bottom">
  <div class="ic-step">
    <span class="ic-title round-top">
      Sensitivy factor 
    </span>
    <div class="ic-field">
      <div class="ic-label">
        Total daily insulin dose 
      </div>
      <div class="ic-input">
        <input type="number" min="0" value="18"/>
      </div>
      <div class="ic-measure">
        units
      </div>
    </div>
      <!-- others fields --->
  </div>
    <!-- others steps --->
</div>

4. API reference

4.1 Properties

Name	Description	Default value
`@Input() targetGlucose: number`	Target blood glucose in mg/dL.	100
`@Input() sensitivityFactorConst: number`	Constant used for the calculation of insulin sensitivity factor. See "Rule of 1800".	1800
`@Input() mealBolusConst: number`	Constant used for the calculation of the carbohydrate ratio. See "Rule of 500".	500
`@Input() labels`	JSON structure for i18n.	See JSON structure.
`@Output() valuesChange: InsulinCalculatorOutput`	Event emitted for each value changed in the calculator fields with all updated values.	See output structure.

JSON structure for i18n.

{
    sensitivityFactor: {
    title: 'Sensitivy factor',
        label: 'Total daily insulin dose',
        measure: 'units'
    },
    correctionBolus: {
      title: 'Correction bolus',
        currentGlucose: {
            label: 'Current blood glucose',
            measure: 'mg/dL'
        },
        targetGlucose: {
            label: 'Target blood glucose',
            measure: 'mg/dL'
        },
        sensitivityFactor: {
            label: 'Insulin sensitivity factor',
            measure: 'mg/dL'
        },
        result: {
            label: 'Insulin dose',
            measure: 'units'
        }
    },
    mealBolus: {
        title: 'Meal bolus',
        intakeCarbs: {
            label: 'Intake carbs',
            measure: 'g'
        },
        carbRatio: {
            label: 'Carb ratio',
            measure: 'g'
        },
        result: {
            label: 'Insulin dose',
            measure: 'units'
        }
    },
    totalResult: {
        title: 'Total insulin dose',
        label: 'Meal + Correction bolus',
        measure: 'units'
    }
}

Output structure.

{
    dailyInsulinDose: 18,
    intakeCarbs: 60,
    carbRatio: 28,
    mealBolus: 2,
    currentGlucose: 120,
    targetGlucose: 100,
    sensitivityFactor: 100,
    correctionBolus: 0,
    totalDosage: 2
}

5. Calculator inputs

Field	Description
Total daily insulin dose	The daily dose of insulin is used to calculate the carbohydrate ratio and then calculate the correction bolus and meal bolus.
Intake carbohydrate	Total grams of carbohydrates to be eaten.
Carbohydrate ratio	This is how many grams of carbohydrates are covered by one unit of insulin.
Meal bolus	It is the amount (in units) of ultra-fast insulin needed to cover the grams of carbohydrates.
Current blood glucose	Your current blood glucose concentration in mg/dL.
Target blood glucose	Your target blood glucose concentration in mg/dL.
Correction bolus	It is the amount (in units) of insulin needed to reduce glucose to the target.
Insulin sensitivity factor	The insulin sensitivity factor tells you how many points, in mg/dL, your blood glucose will drop for each unit of insulin that you take.

6. Insulin calculator service

First, inject the service into the component.

constructor(private insulinCalculator: InsulinCalculatorService){}

6.1 Methods

Method	Description	Return
`sensitivityFactorCalc(dailyInsulineDose: number, constant = 1800)`	Calculates the value of the insulin sensitivity factor.	Number (in mg/dL)
`correctionBolusCalc(currentGlucose: number, targetGlucose: number, sensitivityFactor: number)`	Calculates the correction bolus.	Number (insulin units)
`mealBolusCalc(intakeCarbs: number,dailyInsulineDose: number,constant = 500)`	Calculates the meal bolus.	{ carbCoveragePerUnit (carb ratio in mg/dL), mealBolus (insulin units) }
`mealBolusDefaultCalc(intakeCarbs: number, defaultCarbCoverage = 15)`	Calculates the meal bolus by default carb coverage	{ carbCoveragePerUnit (carb ratio in mg/dL), mealBolus (insulin units) }
`convertMgdlToMmoll(mgdlValue: number, constant = 18)`	Convert milligrams per deciliter to millimoles per liter	Number (in mmol/L)
`convertMmollToMgdl(mmollValue: number, constant = 18)`	Convert millimoles per liter to milligrams per deciliter	Number (in mg/dL)

7. Notice

This tool can never replace a professional medical advice.

Usage no npm install needed!