Bolus Estimator v3.1
Warsaw Method • Educational ModelProfile Variables
Meal & Biometrics
| Component | Units | Logic Used |
|---|---|---|
| Meal Wave | -- | Net IOB Calculation |
| Warsaw Wave | -- | FPU Coverage |
| THEORETICAL REQ. | -- | Combined |
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.
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) / 100Insulin for FPU:
(FPU × 10) / ICRNote: 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 / ICRCorrection:
(Current BG - Target) / ISF
3. The Final Output (Net IOB)
Immediate Dose:
(Carb Dose + Correction) - IOBLogic 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]