⚠️ Educational Use Only

This tool is a mathematical model designed for educational purposes. It demonstrates how insulin variables interact in theory.

It is not a medical device. The values generated are simulations and must not be used to determine actual insulin doses.

Bolus Estimator v3.1

Warsaw Method • Educational Model

Profile Variables

mg/dL
mmol/L
×
×
×
×

Meal & Biometrics

×
×
×
×
×
Simulation Only • Not Medical Advice
Component Units Logic Used
Meal Wave -- Net IOB Calculation
Warsaw Wave -- FPU Coverage
THEORETICAL REQ. -- Combined
🕒 Execution Strategy
Dual/Square Wave
Pre-Bolus: --

Logic Constraints Applied

  • IOB Factor: Active insulin reduces output.
  • Low Value Threshold: Logic blocks below 60.
  • Warsaw Method: < 1 FPU discarded.
Disclaimer: This is a mathematical model for educational purposes only. It is not a medical device. Always consult your doctor before changing insulin therapy. Data is stored locally on your device for convenience and is not transmitted.
Code generated by AI and verified by human review. Users should verify all math independently.

This calculator was designed to help you think about insulin dosing beyond just counting carbs. Built through a collaborative process with Google Gemini, it explores concepts beyond standard pump logic to include modern strategies for handling fat, protein, and active insulin.

Instead of treating every meal the same, this tool helps you visualize complex situations—that involve more than just carbs.

What Drives the Decisions?

Most calculators only look at Carbs and Current Glucose. This mathematical model visualizes two critical layers of context:

The Warsaw Method (Fat & Protein): Carbs aren't the only thing that impacts blood sugar. This calculator scans your Fat and Protein intake and converts them into Fat-Protein Units (FPU). It estimates the theoretical extra insulin those macros might require and suggests extending that dose over time (3 to 8 hours) to match digestion, helping address delayed spikes. [Learn more about the Warsaw Method].

Net IOB (Total Insulin Tracking): Many standard pumps use a conservative formula that ignores active insulin when calculating meal doses. This calculator uses a Dynamic approach. It looks at your Theoretical Total Insulin Need (Food + Correction) and subtracts All Active Insulin. This is designed to minimize the risk of "stacking" (insulin overlap) in the simulation and helps account for insulin already working in your system.

How to Use It

1. Set Your Profile Enter your personal settings: ICR (Insulin-to-Carb Ratio), ISF (Sensitivity Factor), Target BG, and Calculation Cap. Note: The calculator saves these settings locally for your next visit, but it always clears meal data on refresh to ensure a clean start.

2. Enter Your Meal Input your Carbs, Fat, and Protein. Tip: If you are just eating carbs, leave fat/protein blank. The advanced logic stays dormant until you need it.

3. Enter Context Input your Current BG, Trend, and IOB (Insulin on Board). Trend Logic: The calculator provides a "Wait Time" suggestion based on your trend arrow, helping you visualize pre-bolus timing.

4. Generate Strategy Hit Simulate Strategy. You will see a breakdown:

  • Meal Wave: The theoretical immediate requirement.

  • Warsaw Wave: The theoretical extension (using a dual or square wave) and the recommended duration.

5. Do you need a starting point for ICR, ISF and other settings?

Under the Hood: The Math

For those who want to know how the model generates numbers, here are the formulas used in the code:

1. The Warsaw Method (Fat/Protein)

  • FPU Calculation: (Fat × 9 kcal) + (Protein × 4 kcal) / 100

  • Insulin for FPU: (FPU × 10) / ICR

    • Note: This assumes 1 FPU requires the same insulin as 10g of carbs.

  • Duration:

    • 1–2 FPUs: 3 Hours

    • 2–3 FPUs: 4 Hours

    • 3–4 FPUs: 5 Hours

    • 4+ FPUs: 8 Hours

2. Standard Dosing

  • Carb Dose: Carbs / ICR

  • Correction: (Current BG - Target) / ISF

3. The Final Output (Net IOB)

  • Immediate Dose: (Carb Dose + Correction) - IOB

  • Logic Constraint: If the result is negative, it defaults to 0 (it will never suggest a negative dose).

  • Total Dose: Immediate Dose + Warsaw Dose

Disclaimer: This tool was coded by an AI (Google Gemini) based on specific user parameters. It is a mathematical model designed for educational and strategy planning purposes only. It is not a medical device and does not replace the advice of your endocrinologist. [Read full disclaimer]