Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New Crowdin updates #2125

Merged
merged 18 commits into from
Oct 20, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 38 additions & 14 deletions docs/CROWDIN/cs/Usage/DynamicISF.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,60 @@
(Open-APS-features-DynamicISF)=
## DynamicISF (DynISF)
DynamicISF was added in AAPS version 3.2 and requires you to start Objective 11 to use. Select DynamicISF in the config builder > APS to activate. It is recommended only for advanced users that have a good handle on AAPS controls and monitoring.
**Dynamic ISF** was added in **AAPS** version 3.2 and requires Objective 11 to be started before **Dynamic ISF** can be activated. Select **Dynamic ISF** in the Config Builder > **AAPS** to activate. **Dynamic ISF** is recommended only for advanced users that have a good handle on their **AAPS'** controls and monitoring.

Please note that to use Dynamic ISF effectively, the AndroidAPS database needs a minimum of five days of data.
To use **Dynamic ISF** effectively, **AAPS'** database requires a minimum of five (5) days of the user's **AAPS** data.

DynamicISF adapts the insulin sensitivity factor dynamically based on total daily dose of insulin (TDD) and current and predicted blood glucose values.
**Dynamic ISF** adapts the user's insulin sensitivity factor (**ISF**) dynamically based on the user's:

Dynamic ISF uses Chris Wilson’s model to determine ISF instead of a static profile settings.
- Total Daily Dose of insulin (**TDD**); and
- current and predicted blood glucose values.

The equation implemented is: ISF = 1800 / (TDD * Ln (( glucose / insulin divisor) +1 ))
**Dynamic ISF** uses Chris Wilson’s model to determine **ISF** instead of a user's static **Profile's** settings for **ISF**.

The implementation uses the equation to calculate current ISF and in the oref1 predictions for IOB, ZT and UAM. It is not used for COB.
The **Dynamic ISF** equation implemented is: ISF = 1800 / (TDD * Ln (( glucose / insulin divisor) +1 ))

### CDD
This uses a combination of the 7 day average TDD, the previous day’s TDD and a weighted average of the last eight hours of insulin use extrapolated out for 24 hours. The total daily dose used in the above equation is weighted one third to each of the above values.
![Screenshot 2024-10-19 145120](https://github.com/user-attachments/assets/472627ef-047f-438d-ba30-eba75eeaff97)





The implementation uses the aobve equation to calculate current **ISF** and in the oref1 predictions for **IOB**, **ZT** and **UAM**. It is not used for **COB**. Further discussion can be found here: https://www.youtube.com/watch?v=oL49FhOts3c.

### TDD (Total Daily Dose)
TDD will use a combination of the following values:
1. 7 day average **TDD**;
2. the previous day’s **TDD**; and
3. a weighted average of the last eight (8) hours of insulin use extrapolated out for 24 hours.

The **TDD** used in the above equation is weighted one third to each of the above values.

### Insulin Divisor
The insulin divisor depends on the peak of the insulin used and is inversely proportional to the peak time. For Lyumjev this value is 75, for Fiasp, 65 and regular rapid insulin, 55.

### Dynamic ISF Adjustment Factor
The adjustment factor allows the user to specify a value between 1% and 300%. This acts as a multiplier on the TDD value and results in the ISF values becoming smaller (ie more insulin required to move glucose levels a small amount) as the value is increased above 100% and larger (i.e. less insulin required to move glucose levels a small amount) as the value is decreased below 100%.
The Adjustment Factor allows the user to specify a value between 1% and 300%. This acts as a multiplier on the **TDD** value and results in the **ISF** values becoming *smaller* (i.e. more insulin required to move glucose levels a small amount) as the value is increased above 100% and *larger* (i.e. less insulin required to move glucose levels a small amount) as the value is decreased below 100%.

The Adjustment Factor can be located in ‘Preferences’ > **AAPS**:

![Screenshot 2024-10-19 134558](https://github.com/user-attachments/assets/4b563c64-a924-49d3-904b-4e6fdb4dcc67)


### Future ISF

Future ISF is used in the dosing decisions that oref1 makes. Future ISF uses the same TDD value as generated above, taking the adjustment factor into account. It then uses different glucose values dependent on the case:
Future **ISF** is used in the dosing decisions that oref1 makes. Future **ISF** uses the same **TDD** value as generated above, taking the Adjustment Factor (discussed above) into account. It then uses different glucose values dependent on the case:

* If levels are flat, within +/- 3 mg/dl, and predicted BG is above target, a combination of 50% minimum predicted BG and 50% current BG is used.
* If levels are flat, within +/- 3 mg/dl, and predicted **BG** is above target, a combination of 50% minimum predicted **BG** and 50% current **BG** is used.

* If eventual BG is above target and glucose levels are increasing, or eventual BG is above current BG, current BG is used.
* If eventual **BG** is above target and glucose levels are increasing, or eventual **BG** is above current **BG**, current **BG** is used.

Otherwise, minimum predicted BG is used.
Otherwise, minimum predicted **BG** is used.

### Povolit, aby citlivost založená na CDD mohla upravovat bazál a cílovou glykémii

This setting replaces Autosens, and uses the last 24h TDD/7D TDD as the basis for increasing and decreasing basal rate, in the same way that standard Autosens does. This calculated value is also used to adjust target, if the options to adjust target with sensitivity are enabled. Unlike Autosens, this option does not adjust ISF values.
This setting replaces Autosens, and uses the last 24h **TDD**/7D **TDD** as the basis for increasing and decreasing basal rate, in the same way that standard Autosens does. This calculated value is also used to adjust target, if the options to adjust target with sensitivity are enabled. Unlike Autosens, this option does not adjust **ISF** values.

### CAUTION - Automations or Profile Percentage Increase
**Automations** should always be used with care. This is particularly so with **Dynamic ISF**.

If **Dynamic ISF** is in operation, users should reconsider enabling any temporary **Profile** increase as an **Automation** rule or similarly activating a **Profile Percentage** which may create **Dynamic ISF** to be overly aggressive in correction bolusing and could cause hypoglycemia.
52 changes: 38 additions & 14 deletions docs/CROWDIN/de/Usage/DynamicISF.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,60 @@
(Open-APS-features-DynamicISF)=
## Dynamischer ISF (DynISF)
Dynamischer ISF ist seit der AAPS-Version 3.2 als Funktion verfügbar. Um es nutzen zu können, muss das Ziel (Objective) 11 bestanden und erreicht sein. Tippe in der KONFIGURATION > APS auf 'Dynamischer ISF', um es einzuschalten. Diese Funktion wird nur erfahrenen Nutzenden empfohlen, die sicher im Umgang mit AAPS sind und das System sehr genau beobachten.
**Dynamic ISF** was added in **AAPS** version 3.2 and requires Objective 11 to be started before **Dynamic ISF** can be activated. Select **Dynamic ISF** in the Config Builder > **AAPS** to activate. **Dynamic ISF** is recommended only for advanced users that have a good handle on their **AAPS'** controls and monitoring.

Um den dynamischen ISF sinnvoll nutzen zu können, sollten mindestens 5 Tage historischer Daten in der AAPS-Datenbank vorliegen.
To use **Dynamic ISF** effectively, **AAPS'** database requires a minimum of five (5) days of the user's **AAPS** data.

Die Funktion "dynamischer ISF" passt den Insulinempfindlichkeitsfaktor (ISF) auf Basis der täglichen Gesamtinsulinmenge (TDD), dem aktuellen und dem erwarteten Glukosewerten dynamisch an.
**Dynamic ISF** adapts the user's insulin sensitivity factor (**ISF**) dynamically based on the user's:

Der Dynamische ISF verwendet das Modell von Chris Wilson anstelle statischer Profileinstellungen, um den ISF zu ermitteln.
- Total Daily Dose of insulin (**TDD**); and
- current and predicted blood glucose values.

Die Berechnungsformel ist: ISF = 1800 / (TDD * Ln (( Glukose / Insulindivisor) +1 ))
**Dynamic ISF** uses Chris Wilson’s model to determine **ISF** instead of a user's static **Profile's** settings for **ISF**.

Die Implementierung verwendet die Formel zur Berechnung des aktuellen ISF und in den oref1-Vorhersagen für IOB, ZT und UAM. Er wird nicht für die COB verwendet.
The **Dynamic ISF** equation implemented is: ISF = 1800 / (TDD * Ln (( glucose / insulin divisor) +1 ))

### TDD
Dies verwendet eine Kombination aus dem TDD-Durchschnitt der letzten 7 Tage, dem -TDD des vorangegangenen Tages und einem gewichteten Durchschnitt des Insulinbedarfs der letzten acht Stunden, extrapoliert auf 24 Stunden. Die in der obigen Gleichung verwendete Gesamtdosis wird mit einem Drittel gegenüber den übrigen Werten berücksichtigt.
![Screenshot 2024-10-19 145120](https://github.com/user-attachments/assets/472627ef-047f-438d-ba30-eba75eeaff97)





The implementation uses the aobve equation to calculate current **ISF** and in the oref1 predictions for **IOB**, **ZT** and **UAM**. It is not used for **COB**. Further discussion can be found here: https://www.youtube.com/watch?v=oL49FhOts3c.

### TDD (Total Daily Dose)
TDD will use a combination of the following values:
1. 7 day average **TDD**;
2. the previous day’s **TDD**; and
3. a weighted average of the last eight (8) hours of insulin use extrapolated out for 24 hours.

The **TDD** used in the above equation is weighted one third to each of the above values.

### Insulindivisor
Der Insulindivisor ist vom Wirkmaximum des genutzten Insulins abhängig und ist umgekehrt proportional zum Wirkmaximum. Für Lyumjev ist dieser Wert 75, für Fiasp 65, und übliches schnell wirkendes Insulin 55.

### Dynamischer ISF Anpassungsfaktor
Der Anpassungsfaktor kann zwischen 1% und 300% eingestellt werden. Dieser Anpassungfaktor ist ein Multiplikator auf den TDD-Wert und führt dazu, dass die ISF-Werte kleiner werden (d.h. es ist mehr Insulin erforderlich, um den Glukosespiegel zu verändern), wenn der Wert über 100% angehoben wird und die ISF-Werte größer werden (weniger Insulin erforderlich, um den Glukosespiegel zu verändern), wenn der Wert unter 100% abgesenkt wird.
The Adjustment Factor allows the user to specify a value between 1% and 300%. This acts as a multiplier on the **TDD** value and results in the **ISF** values becoming *smaller* (i.e. more insulin required to move glucose levels a small amount) as the value is increased above 100% and *larger* (i.e. less insulin required to move glucose levels a small amount) as the value is decreased below 100%.

The Adjustment Factor can be located in ‘Preferences’ > **AAPS**:

![Screenshot 2024-10-19 134558](https://github.com/user-attachments/assets/4b563c64-a924-49d3-904b-4e6fdb4dcc67)


### Zukünftiger ISF

Zukünftiger ISF wird bei den Dosierentscheidungen von oref1 eingesetzt. Der zukünftige ISF verwendet den gleichen TDD-Wert unter Berücksichtigung des Anpassungsfaktors wie er oben berechnet wurde. Er verwendet dann, abhängig von der jeweiligen Situation, unterschiedliche Glukosewerte:
Future **ISF** is used in the dosing decisions that oref1 makes. Future **ISF** uses the same **TDD** value as generated above, taking the Adjustment Factor (discussed above) into account. Er verwendet dann, abhängig von der jeweiligen Situation, unterschiedliche Glukosewerte:

* Wenn der Glukosespiegel stabil (+/- 3mg/dl) ist, und der vorhergesagte Glukosewert über dem Zielwert liegt, wird eine Kombination aus des unteren vorhergesagten Glukosewertes und des aktuellen Glukosewertes (jeweils 50%) verwendet.
* If levels are flat, within +/- 3 mg/dl, and predicted **BG** is above target, a combination of 50% minimum predicted **BG** and 50% current **BG** is used.

* Wenn der erwartete Glukosewert über dem Zielwert liegt und die Glukosewerte steigen oder der erwartete Glukosewert liegt über dem aktuellen Wert, dann wird der aktuelle Glukosewert in der Berechnung genutzt.
* If eventual **BG** is above target and glucose levels are increasing, or eventual **BG** is above current **BG**, current **BG** is used.

In allen anderen Fällen wird der untere vorhergesagte Glukosewert verwendet.
Otherwise, minimum predicted **BG** is used.

### Aktivieren des TDD-basierten Empfindlichkeitsverhältnises für Basal und Glukose-Zielwertanpassungen (Empfindlichkeit und BZ anpassen)

Diese Einstellung ersetzt Autosens, und nutzt die letzten 24h TDD/7D TDD als Basis für die Erhöhung und Verringerung der Basalrate auf die gleiche Weise wie Standard Autosens es tut. Dieser berechnete Wert wird auch verwendet, um das Ziel anzupassen, wenn die Optionen "Empfindlichkeit und Glukosewert anpassen" aktiviert ist. Im Gegensatz zu Autosens wird durch diese Option der ISF-Werte nicht angepasst.
This setting replaces Autosens, and uses the last 24h **TDD**/7D **TDD** as the basis for increasing and decreasing basal rate, in the same way that standard Autosens does. Dieser berechnete Wert wird auch verwendet, um das Ziel anzupassen, wenn die Optionen "Empfindlichkeit und Glukosewert anpassen" aktiviert ist. Unlike Autosens, this option does not adjust **ISF** values.

### CAUTION - Automations or Profile Percentage Increase
**Automations** should always be used with care. This is particularly so with **Dynamic ISF**.

If **Dynamic ISF** is in operation, users should reconsider enabling any temporary **Profile** increase as an **Automation** rule or similarly activating a **Profile Percentage** which may create **Dynamic ISF** to be overly aggressive in correction bolusing and could cause hypoglycemia.
52 changes: 38 additions & 14 deletions docs/CROWDIN/el/Usage/DynamicISF.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,60 @@
(Open-APS-features-DynamicISF)=
## DynamicISF (DynISF)
DynamicISF was added in AAPS version 3.2 and requires you to start Objective 11 to use. Select DynamicISF in the config builder > APS to activate. It is recommended only for advanced users that have a good handle on AAPS controls and monitoring.
**Dynamic ISF** was added in **AAPS** version 3.2 and requires Objective 11 to be started before **Dynamic ISF** can be activated. Select **Dynamic ISF** in the Config Builder > **AAPS** to activate. **Dynamic ISF** is recommended only for advanced users that have a good handle on their **AAPS'** controls and monitoring.

Please note that to use Dynamic ISF effectively, the AndroidAPS database needs a minimum of five days of data.
To use **Dynamic ISF** effectively, **AAPS'** database requires a minimum of five (5) days of the user's **AAPS** data.

DynamicISF adapts the insulin sensitivity factor dynamically based on total daily dose of insulin (TDD) and current and predicted blood glucose values.
**Dynamic ISF** adapts the user's insulin sensitivity factor (**ISF**) dynamically based on the user's:

Dynamic ISF uses Chris Wilson’s model to determine ISF instead of a static profile settings.
- Total Daily Dose of insulin (**TDD**); and
- current and predicted blood glucose values.

The equation implemented is: ISF = 1800 / (TDD * Ln (( glucose / insulin divisor) +1 ))
**Dynamic ISF** uses Chris Wilson’s model to determine **ISF** instead of a user's static **Profile's** settings for **ISF**.

The implementation uses the equation to calculate current ISF and in the oref1 predictions for IOB, ZT and UAM. It is not used for COB.
The **Dynamic ISF** equation implemented is: ISF = 1800 / (TDD * Ln (( glucose / insulin divisor) +1 ))

### TDD
This uses a combination of the 7 day average TDD, the previous day’s TDD and a weighted average of the last eight hours of insulin use extrapolated out for 24 hours. The total daily dose used in the above equation is weighted one third to each of the above values.
![Screenshot 2024-10-19 145120](https://github.com/user-attachments/assets/472627ef-047f-438d-ba30-eba75eeaff97)





The implementation uses the aobve equation to calculate current **ISF** and in the oref1 predictions for **IOB**, **ZT** and **UAM**. It is not used for **COB**. Further discussion can be found here: https://www.youtube.com/watch?v=oL49FhOts3c.

### TDD (Total Daily Dose)
TDD will use a combination of the following values:
1. 7 day average **TDD**;
2. the previous day’s **TDD**; and
3. a weighted average of the last eight (8) hours of insulin use extrapolated out for 24 hours.

The **TDD** used in the above equation is weighted one third to each of the above values.

### Insulin Divisor
The insulin divisor depends on the peak of the insulin used and is inversely proportional to the peak time. For Lyumjev this value is 75, for Fiasp, 65 and regular rapid insulin, 55.

### Dynamic ISF Adjustment Factor
The adjustment factor allows the user to specify a value between 1% and 300%. This acts as a multiplier on the TDD value and results in the ISF values becoming smaller (ie more insulin required to move glucose levels a small amount) as the value is increased above 100% and larger (i.e. less insulin required to move glucose levels a small amount) as the value is decreased below 100%.
The Adjustment Factor allows the user to specify a value between 1% and 300%. This acts as a multiplier on the **TDD** value and results in the **ISF** values becoming *smaller* (i.e. more insulin required to move glucose levels a small amount) as the value is increased above 100% and *larger* (i.e. less insulin required to move glucose levels a small amount) as the value is decreased below 100%.

The Adjustment Factor can be located in ‘Preferences’ > **AAPS**:

![Screenshot 2024-10-19 134558](https://github.com/user-attachments/assets/4b563c64-a924-49d3-904b-4e6fdb4dcc67)


### Future ISF

Future ISF is used in the dosing decisions that oref1 makes. Future ISF uses the same TDD value as generated above, taking the adjustment factor into account. It then uses different glucose values dependent on the case:
Future **ISF** is used in the dosing decisions that oref1 makes. Future **ISF** uses the same **TDD** value as generated above, taking the Adjustment Factor (discussed above) into account. It then uses different glucose values dependent on the case:

* If levels are flat, within +/- 3 mg/dl, and predicted BG is above target, a combination of 50% minimum predicted BG and 50% current BG is used.
* If levels are flat, within +/- 3 mg/dl, and predicted **BG** is above target, a combination of 50% minimum predicted **BG** and 50% current **BG** is used.

* If eventual BG is above target and glucose levels are increasing, or eventual BG is above current BG, current BG is used.
* If eventual **BG** is above target and glucose levels are increasing, or eventual **BG** is above current **BG**, current **BG** is used.

Otherwise, minimum predicted BG is used.
Otherwise, minimum predicted **BG** is used.

### Enable TDD based sensitivity ratio for basal and glucose target modification

This setting replaces Autosens, and uses the last 24h TDD/7D TDD as the basis for increasing and decreasing basal rate, in the same way that standard Autosens does. This calculated value is also used to adjust target, if the options to adjust target with sensitivity are enabled. Unlike Autosens, this option does not adjust ISF values.
This setting replaces Autosens, and uses the last 24h **TDD**/7D **TDD** as the basis for increasing and decreasing basal rate, in the same way that standard Autosens does. This calculated value is also used to adjust target, if the options to adjust target with sensitivity are enabled. Unlike Autosens, this option does not adjust **ISF** values.

### CAUTION - Automations or Profile Percentage Increase
**Automations** should always be used with care. This is particularly so with **Dynamic ISF**.

If **Dynamic ISF** is in operation, users should reconsider enabling any temporary **Profile** increase as an **Automation** rule or similarly activating a **Profile Percentage** which may create **Dynamic ISF** to be overly aggressive in correction bolusing and could cause hypoglycemia.
Loading