- Check the wiki: https://androidaps.readthedocs.io
- Everyone who’s been looping with AndroidAPS needs to fill out the form after 3 days of looping https://docs.google.com/forms/d/14KcMjlINPMJHVt28MDRupa4sz4DDIooI4SrW0P3HSN8/viewform?c=0&w=1
DEV:
3KawK8aQe48478s6fxJ8Ms6VTWkwjgr9f2
This repo contains AndroidAPS code with some additions:
- Boost plugin
- Eating now plugin
- DynamicISF plugin
- SMB scaling for traditional AndroidAPSSMB & DynamicISF
- BG data smoothing from Tsunami project
- One-time passwords for SMS communicator are back
- Notes for bolus/carbs are now saved and sent to NS
Traditional Autosens is deprecated in this code and sensitivityRatio is calculated using 'Eight hour weighted average TDD / 7-day average TDD'.
Boost uses a similar version of DynamicISF for making predictions, however, unlike the hardoded quanta for the different values of insulin peak, when free-peak is used, it scales between the highest and lowest values.
The ISF for dosing decisions within Boost is slighty different to thhat in DynamicISF. The calculation is intended to mimic the effects of higher insulin sensitivty at lower glucose levels, and runs as follows:
- With COB and increasing deltas, use 75% of the predicted BG and 25% of the current BG.
- If current BG is accelerating fast, bg is below 180mg/dl/10mmol/l and eventual BG is higher than current, use 50% of both eventual and current BG.
- If BG is between 160 and 270 and almost flat, and eventual BG is lower than BG, use 60% min predicted BG and 40% current BG.
- If BG is increasing slowly, and above 198 or eventual BG is above current BG and current BG is above 198, use 40% min predicted BG and 60% current BG.
- If BG is increasing more slowy, or eventual BG is greater than current BG, use current BG.
- If BG is not increasing, use minimum predicted BG.
In Treatments Safety in preferences, there is now a user adjustable Low Glucose Suspend threshold. This allows the user to set a value higher than the system would normally use, such that when predictions drop below this level, a zero TBR is set.
You can use Boost when announcing carbs or without announcing carbs. With COB there is an additional piece of bolusing code that oeprates for the first 40 mins of COB. If you prefer to manually bolus, it fully supports that with no other code.
It also has variable insulin percentage determined by the user, and while boost time is valid, the algorithm can bolus up to a maximum bolus defined by the user in preferences.
The intention of this code is to deliver an early, larger bolus when rises are detected to intiate UAM deviations and to allow the algorithm to be more aggressive. Other than Boost, it relies on oref1 adjusted to use the variable ISF function based on TDD.
All of the additional code outside of the standard SMB calculation requires a time period to be specified within which it is active. The default time settings disable the code. The time period is specified in hours using a 24 hour clock in the Boost preferences section.
COB: With Carbs on Board, Boost has a 15 minute window to deliver the equivalent of a mealtime bolus and is allowed to go higher than your Boost Bolus Cap, up to InsulinRequired/insulin required percent calculated by the oref1 algorithm, taking carbs into account. In the following 40 mins after the carbs are added, it can do additional larger boluses, as long as there is a delta >5 and COB > 0. The max allowed is the greater of the Boost Bolus Cap or the "COB cap", which is calculated as COB / Carb Ratio.
During normal use, you should set your Boost Bolus Cap to be the max that boost delivers when Boost is enabled and no COB are entered.
Boost outside the first 40 mins of COB, or with 0 COB has four phases:
- Boost bolus
- Percentage Scale
- Enhanced oref1
- Regular oref1
Boost
When an initial rise is detected with a meal, but no announced COB, delta, short_avgDelta and long_avgDelta are used to trigger the early bolus (assuming IOB is below a user defined amount). The early bolus value is one hour of basal requirement and is based on the current period basal rate, unless this is smaller than "Insulin Required" when that is used instead.
The user defined Boost Scale Value can be used to increase the boost bolus if the user requires, however, users should be aware that this increases the risk of hypos when small rises occur.
If Boost Scale Value is less than 3, Boost is enabled.
The short and long average delta clauses disable boost once delta and the average deltas are aligned. There is a preferences setting (Boost Bolus Cap) that limits the maximum bolus that can be delivered by Boost outside of the standard UAMSMBBasalMinutes limit.
Boost Percentage Scale
Boost percentage Scale is a feature that allows Boost to scale the SMB from 150% of insulin required at 108 mg/dl (6 mmol/l) to the user entered insulin required PCT at 180mg/dl (10 mmol/l). It can be enabled via a switch in the preferences and the percentage values are hard coded. it is only active when [Delta - Short Average Delta ] is positive, meaning that it only happens when delta variation is accelerating.
Enhanced oref1
If none of the above conditions are met, standard SMB logic is used to size SMBs, with the insulin required PCT entered in preferences. This only works on positive deviations and similar to the percent scale, when deltas are getting larger. Enhanced oref1 uses regular insulin sizing logic but can dose up to the Boost Bolus cap.
Regular oref1
Once you are outside the Boost hours, "max minutes of basal to limit SMB to for UAM" is enabled, and the dosing works in the same way as regular OpenAPSSMB.
The BOOST settings have a number of extra items:
Note that the default settings are designed to disable most of the functions, and you will need to adjust them.
Boost insulin required percent - defaults to 50% can be increased, but increasing increases hypo risk.
Boost Scale Value - defaults to 1.0. Only increase multiplier once you have trialled.
Boost Bolus Cap - defaults to 0.1
UAM Boost max IOB - defaults to 0.1
UAM Boost Start Time (in hours using 24 hour clock) - defaults to 7
UAM Boost end time (in hours using 24 hour clock) - defaults to 8
BG level below which low glucose suspend occurs - defaults to standard algorithm behaviour; can be adjusted between 65 and 100.
Recommended Settings
Boost Bolus Cap - Start at 2.5% of TDD and increase to no more than 5% of 7 day average total daily dose.
UAM Boost max IOB - Start at 5% of TDD and increase to no more than 15% of 7 day average total daily dose.
UAMSMBBasalMinutes - 30 mins. This is only used overnight when IOB is large enough to trigger UAM, so it doesn't need to be a large value.
Boost insulin required percent - recommended not to exceed 75%. Start at 50% and increase as necessary.
Target - Set a target of 6.5mmol/l (120mg/dl) to get started with Boost. This provides a cushion as you adjust settings. Values below 5.5mmol/l (100mg/DL) are not recommended.
Start Time : The time the EN mode will start in hours as 24h clock format EN mode will be active after this time when there has been a COB or manual bolus entry of any size
End Time : The time that EN mode will finish. Normal maxBolus of 65% is resumed. If there are COB or a TT of normalTarget EN will be active after this time, however AAPS maxBolus will be used. No SMB will be given when inactive unless there is COB, detected resistance from autosens or BG is above SMB BG Threshold.
InsulinReqPct : Percentage that will be used for EN insulinReq as SMB to utilise prior to maxBolus restriction. This will be 65% when EN is not active.
Max IOB : The percentage of current max-iob setting that will be used as the limit for EN. EN will not add insulin when above this limit.
SMB BG Offset : There will be no SMB when below this BG offset at night without COB or detected resistance. e.g. if target bg is 99/5.5 and this setting is 27/1.5 there will be no SMB below 126/7.0
ISF BG Scaler : As BG increases ISF will become stronger. The level of scaling can be adjusted. 0 = normal scaling, 5 is 5% stronger, -5 is 5% weaker ISF scaling. Additional scaling does not happen when EN is not active.
ISF BG Offset : As BG increases ISF will become stronger. ISF will no longer scale when above this level. e.g. if target bg is 99/5.5 and this setting is 27/1.5 there will be no scaling above 126/7.0
UAMBoost Bolus Scale : Multiply the initial UAMBoost bolus by this amount. 0 will disable UAMBoost.
UAM maxBolus : maxBolus to use for all BG rises without COB. 0 will use maxSMBBasalMinutes or maxUAMSMBBasalMinutes.
Use GhostCOB : Ignore COB predictions after the COBBoost Window and rely purely on UAM. This setting can be handy when COB lingers for too long.
COBBoost InsulinReqPct : Percentage that will be used for EN insulinReq within the COBBoost Window.
COBBoost Window : If within the COBBoost Window the calculated insulinReq from COBPredBG may be delivered via a larger SMB using the COBBoost maxBolus. Once the time window has elapsed COBBoost maxBolus is no longer used. 0 minutes will disable this functionality.
COBBoost maxBolus : maxBolus to use within the COBBoost Window. 0 will use AAPS maxBolus.
COB maxBolus : maxBolus to use with COB outside of the initial COBBoost Window. 0 will use AAPS maxBolus.
Use 3PM Basal ISF Variance : Use 3PM Basal as the basis for ISF changes. The basal at 3PM is taken as the basis for baseline ISF. Basal variation from this point is used to scale the ISF, stronger basal will make ISF weaker. Only use when the profile uses a single ISF for 24 hours and the basal profile is fully populated.
Use TDD for ISF : Use the last 24H TDD for ISF. This will override the profile ISF and can be used with 3PM basal ISF variance.
TDD ISF Scaling : This will use a percentage of the calculated TDD ISF. If TDD ISF is too strong it can be reduced e.g. 50 will make TDD ISF 50% weaker.