Skip to content

Commit

Permalink
clarify some algorithm language, update link names
Browse files Browse the repository at this point in the history
  • Loading branch information
marionbarker committed Nov 23, 2024
1 parent 96b5fb6 commit 36e4f75
Show file tree
Hide file tree
Showing 4 changed files with 16 additions and 9 deletions.
17 changes: 12 additions & 5 deletions docs/operation/algorithm/auto-adjust.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,23 @@
## Calculated Dose

The *Loop* algorithm takes one of four actions depending upon the eventual glucose, predicted glucose, target range and glucose safety threshold when Closed Loop operation is enabled.
The *Loop* algorithm takes one of [four actions](#four-possible-actions) depending upon the glucose prediction, target range and glucose safety threshold when Closed Loop operation is enabled.

The recommended insulin dose (positive or negative) is calculated first, then the Temp Basal or Automatic Bolus to be enacted is modified based on the recommended dose, dosing strategy, maximum Temp Basal and maximum Bolus settings. The automated dosing (increase or decrease) is updated with every CGM value - typically every 5 minutes.
The recommended insulin dose (positive or negative) is calculated first, including all safety checks, and then the insulin delivery adjustments are applied based on the dosing strategy, while respecting the maximum Temp Basal and maximum Bolus values in the user's [Therapy Settings](../../loop-3/therapy-settings.md){: target="_blank" }. The automated dosing (increase or decrease) is updated with every CGM value - typically every 5 minutes.

If a decrease in insulin dose is recommended, this is always applied using a temporary basal rate that is less than the scheduled basal rate.

!!! abstract "Temporary Basal Duration"
All temporary basal rate commands are issued for a duration of 30 minutes. If communication with the pump is lost, the last issued temporary basal rate will last for at most 30 minutes before the pump reverts to the user’s scheduled basal rates.

The *Loop* app may enact a new temporary basal rate every 5 minutes based on incoming glucose readings.

**Dosing Strategy: Temp Basal Only**

All temporary basal rate commands are issued for 30 minutes, however they may be updated (re-issued) every 5 minutes. Said another way, *Loop* may enact a new temporary basal rate every 5 minutes. But, if communication with the pump is lost, the last issued temporary basal rate will last for at most 30 minutes before the pump reverts to the user’s scheduled basal rates.
If the Looper has selected Temp Basal Only Dosing Strategy and an increase in insulin dose is recommended, that increase is converted to a temporary basal rate that exceeds the current scheduled basal rate.

**Dosing Strategy: Automatic Bolus**

If the Looper has selected Automatic Bolus Dosing Strategy and an increase in insulin dose is recommended, then the Four Actions discussion below applies to the automatic bolus decision.
If the Looper has selected Automatic Bolus Dosing Strategy and an increase in insulin dose is recommended, then an automatic bolus, which is less than the recommended dose, is delivered promptly.

### No Automatic Dosing

Expand Down Expand Up @@ -152,4 +159,4 @@ The table below shows the $\mathit{BR_temp}$ for different $\mathit{BG_eventual}
* [Algorithm Overview](overview.md)
* [Bolus Recommendations](bolus.md)
* [Glucose Prediction](prediction.md)
* [Temp Basal Adjustments](auto-adjust.md)
* [Automatic Dosing Adjustments](auto-adjust.md)
2 changes: 1 addition & 1 deletion docs/operation/algorithm/bolus.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,4 +33,4 @@ Finally, *Loop* checks that the result of the calculations is below the maximum
* [Algorithm Overview](overview.md)
* [Bolus Recommendations](bolus.md)
* [Glucose Prediction](prediction.md)
* [Temp Basal Adjustments](auto-adjust.md)
* [Automatic Dosing Adjustments](auto-adjust.md)
4 changes: 2 additions & 2 deletions docs/operation/algorithm/overview.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
## The *Loop* Algorithm

Loop’s algorithm for adjusting insulin delivery is oriented around making a glucose prediction and modifying delivery to bring that prediction within target range without going below the Glucose Safety Limit. Every five minutes, triggered by new glucose data, it generates a new prediction. Both [bolus recommendations](bolus.md) and [temporary basal rate adjustments](auto-adjust.md) are set based on this [prediction](prediction.md).
The *Loop* algorithm for adjusting insulin delivery is oriented around making a glucose prediction and modifying delivery to bring that prediction within target range without going below the Glucose Safety Limit. Every five minutes, triggered by new glucose data, it generates a new prediction. Both [bolus recommendations](bolus.md) and [temporary basal rate adjustments](auto-adjust.md) are set based on this [prediction](prediction.md).

!!! abstract "Glucose Prediction"
The *prediction* is a calculation based on the known parameters of current and historical glucose values, current and historical insulin delivery using any entered carbs. Loop's model predictive control (MPC) calculation includes the user's therapy settings modified by active overrides. This calculation is updated at the next glucose reading and the recommended insulin delivery may be updated.
Expand Down Expand Up @@ -36,4 +36,4 @@ status screen of Loop.
* [Algorithm Overview](overview.md)
* [Bolus Recommendations](bolus.md)
* [Glucose Prediction](prediction.md)
* [Temp Basal Adjustments](auto-adjust.md)
* [Automatic Dosing Adjustments](auto-adjust.md)
2 changes: 1 addition & 1 deletion docs/operation/algorithm/prediction.md
Original file line number Diff line number Diff line change
Expand Up @@ -311,4 +311,4 @@ Each individual effect along with the combined effects are illustrated in the fi
* [Algorithm Overview](overview.md)
* [Bolus Recommendations](bolus.md)
* [Glucose Prediction](prediction.md)
* [Temp Basal Adjustments](auto-adjust.md)
* [Automatic Dosing Adjustments](auto-adjust.md)

0 comments on commit 36e4f75

Please sign in to comment.