AP and OpenAPS high-level terminology¶
APS or AP - Artificial Pancreas System. A term for a closed-loop automated insulin delivery system in which temporary basal adjustments are used to maintain BG levels at a user-specified target range.
Basal - baseline insulin level that is pre-programmed into your pump and mimics the insulin your pancreas would give throughout the day and night
Basal IOB - difference (positive or negative) between amount of insulin on board delivered via basal rates (including any temporary basal rates), and the amount specified by your standard profile basal rate.
BG - Blood Glucose
BGI (Blood Glucos Impact) - The degree to which Blood Glucose (BG) “should” be rising or falling. OpenAPS calculates this value to determine the ‘Eventual Blood Glucose’. This value can be used to make other high/low basal decisions in advanced implementations of OpenAPS.
Bolus - extra insulin given by a pump, usually to correct for a high Blood Glucose (BG) or for carbohydrates
CGM - Continuous Glucose Monitor, a temporary glucose sensor that is injected into your skin (the needle is removed) for and provides BG readings approximately every 5 minutes. Different models exist in the market with various calibration requirements varianing from no calibrations to 2 a day, and official sensor lifetimes varying from 6-10 days.
closed-loop - closed-loop systems make automatic adjustments to basal delivery, without needing user-approval, based on an algorithm.
COB - Carbs-on-board. Describes an estimation of how many Carbs are still active in the body.
COBpredBG - a variable that uses carbs and insulin together in predicting the BG curve. It is represented by a purple prediction line in Nightscout (NS). The default behaviour has changed for carb absorption in oref0 0.6.0 and beyond, with the adoption of a /\ shaped bilenear carb absorption model. This line in your Nightscout (NS) display will show an S-curve shape immediately after entering carbs that starts out flat (in line with current BG trends) and then rises sharply after about an hour before flattening out. A typical meal absorption time of about 3 hours is assumed which is then extended overtime so that Oref0 gradually relies more on actual observed carb absorption as carbs are absorbed. When the carbs are first entered, remainingCATime is set to 3 hours. When 50% of carbs have absorbed, the remainder (that aren’t seen to be absorbing already) are predicted to take another 4.5h. And as COB approaches zero, remainingCATime will approach 6 hours.
CR - Carb Ratio, or carbohydrate ratio - the amount of carbohydrates that are covered by one unit of insulin. Example: 1 u of insulin for 10 carbs.
DIA - Duration of Insulin Action, or how long the insulin is active in your body (Ranges 3-6 hours typically).
IOB - Insulin On Board, or insulin active in your body. Note that most commercially available pumps calculate IOB based on bolus activity only. Usually, but not always, Net IOB is what Nightscout displays as ‘IOB’. While what’s displayed in your Nightscout (NS) IOB pill may match what IOB is in your current loop, it’s probably a good practice to not rely on this pill alone for determining IOB.
IOBpredBG - also a variable reported in your Openaps Pill in Nightscout - this is a predicted BG curve that is based on insulin only. It is represented by the purple prediction lines ISF - insulin sensitivity factor - the expected decrease in BG as a result of one unit of insulin. Example: 1 u of insulin for 40 mg/dL (2.2 mmol/L)
MINpredBG - this variable is the lowest predicted value that Openaps has made for your future BG.
Net IOB - amount of Insulin On Board, taking into account any adjusted (higher or lower) basal rates (see Basal IOB above) plus bolus activity.
NS, or Nightscout - a cloud-based visualization and remote-monitoring tool.
OpenAPS - refers to an example build of the system when used without a hashtag (#)
openaps - the core suite of software tools under development by this community for use in an OpenAPS implementation
#OpenAPS - stands for Open Artificial Pancreas System. It is an open-source movement to develop an artificial pancreas using commercial medical devices, a few pieces of inexpensive hardware, and freely-available software. A full description of the #OpenAPS project can be found at openaps.org. #OpenAPS (with the hashtag) generally refers to the broad project and open source movement.
open-loop - open-loop systems will suggest recommended adjustments to basal delivery, but will require specific user-approval prior to implementing.
oref0 - “reference design implementation version 0” of the OpenAPS reference design. Aka, the key algorithm behind OpenAPS.
Treatments IOB - amount of Insulin On Board delivered via boluses. Reported by some pumps as ‘active insulin’.
UAM Unannounced Meal provides an alternative method (in addition to or instead of carb entry) for detecting and safely dosing insulin in response to significant BG rises, whether they are due to meals, adrenaline, or any other reason.
UAMpredBG’s - this variable represents the impact of ‘floating carbs’ and insulin together in predicting the BG curve, giving a prediction line for the new feature Unannounced Meals (or carbs).
SMB - Super Micro Bolus. An alternetive insulin delivery method introduced in oref1 which allows oref1 to safely dose mealtime insulin more rapidly.
OpenAPS Nightscout Status Messages appear when the OpenAPS plugin is enabled.
- Looping ↻ - Success; Temp basal rate has been suggested.
- Enacted ⌁ - Success; Temp basal rate has been set.
- Not Enacted x - Success; No action taken on suggested temp basal rate.
- Waiting ◉ - Timeout; No recent status received from OpenAPS.
⚠- Error or Timeout; OpenAPS has reported a failure, or has reported no status for many hours.
Avg. Delta - average BG delta between 5 min intervals.
Delta - difference between the last two BG values. An asterick (*) is displayed in Nightscout when estimating due to missing BG values.
Eventual BG - BG after DIA hours (or maybe a bit sooner if most of your insulin was awhile ago), considering the current IOB and COB.
Exponential Curves - Most insulin types reach their peak performance and decay along a curve. OpenAPS can calculate active insulin along a rapid-acting, ultra-rapid, or custom curve, or a bilinear non-curve.
- Rapid-acting: This curve, the default, reaches activity peak at 75 minutes by default, and is recommended for use with Apidra, Humalog, Novolog, and Novorapid insulin.
- Ultra-rapid: This curve reaches activity peak at 55 minutes by default, and is recommended for use with Fiasp insulin.
- Bilinear: This is a non-curve insulin activity model that OpenAPS users can set in their preferences file to use an older insulin activity model.
- Custom Insulin Peak Time: Users may set a custom insulin peak time in their preference file with useCustomPeakTime, with legal values of insulinPeakTime from 35 to 120. The value refers to the amount of time until your insulin reaches maximum effect, defined as minutes from bolus to peak.
Exp. Delta - expected BG delta right now, considering all OpenAPS inputs (IOB, COB, etc).
predBGs - predicted Blood Glucose over next N many minutes based on openAPS logic, in 5 minute increments