Requirements - Data Group 3b

   

Data Points

The following data points are covered in data group 3b  

Note: If all the columns of the table are not visible, please reduce the zoom % of the browser

mySugr Data Point mySugr Unit mySugr Description FHIR Resource & Element Integrated with RDCP FHIR Sample
recommended_total_bolus IU The total amount of bolus recommended by the bolus calculator. This is the sum of meal and correction components of recommended bolus MedicationRequest extension advice-total-component-recommended (sent only when bolus calculator was used) Yes Recommended bolus
recommended_meal_bolus IU The meal component of bolus recommended by the bolus calculator MedicationRequest extension advice-meal-component-recommended (sent only when bolus calculator was used) Yes Recommended bolus
recommended_correction_bolus IU The correction component of bolus recommended by the bolus calculator MedicationRequest extension advice-bg-component-recommended (sent only when bolus calculator was used) Yes Recommended bolus
selected_total_bolus IU The total amount of bolus selected by the user. This is the sum of meal and correction components of selected bolus MedicationRequest extension advice-total-component-selected (if Bolus calculator was used) Yes Selected bolus
selected_meal_bolus IU The meal component of bolus selected by the user. MedicationRequest extension advice-meal-component-selected (if Bolus calculator was used) Yes Selected bolus
selected_correction_bolus IU The correction component of bolus selected by the user. MedicationRequest extension advice-bg-component-selected (if Bolus calculator was used) Yes Selected bolus
confirmed_total_bolus IU The total amount of bolus already delivered and confirmed by a pump. This is the sum of meal and correction bolus MedicationRequest extension advice-total-component-confirmed (if Bolus calculator was used) +
MedicationRequest.dosageInstruction (if Bolus calculator was used)
+
MedicationAdministration.dose (medicationCodeableConcept.code = 411531001)
Yes Confirmed bolus
confirmed_meal_bolus IU The amount of meal bolus already delivered and confirmed by a pump MedicationRequest extension advice-meal-component-confirmed (if Bolus calculator was used)
+
MedicationAdministration.extension bolus-food-insulin-units (medicationCodeableConcept.code = 411531001)
Yes Confirmed bolus
confirmed_correction_bolus IU The amount of correction bolus already delivered and confirmed by a pump MedicationRequest extension advice-bg-component-confirmed (if Bolus calculator was used)
+
MedicationAdministration.extension bolus-correction-insulin-units (medicationCodeableConcept.code = 411531001)
Yes Confirmed bolus
bolus_delivery_type enum on client [PUMP_STANDARD(0), PUMP_EXTENDED(1), PUMP_MULTIWAVE(2), int on backend The way of the bolus delivery MedicationRequest extension advicedBolusType (if Bolus calculator was used)
+
MedicationAdministration.extension admin-type (medicationCodeableConcept.code = 411531001) (if bolus is confirmed by the pump)
Yes Bolus delivery type
immediate_insulin 1 insulin unit on backend (decimal (10,2)) The amount of insulin to be delivered as early and as quick as the device allows MedicationRequest extension immediate-bolus-insulin-amount (if Bolus calculator was used)
+
MedicationAdministration.extension immediate-bolus-insulin-amount (medicationCodeableConcept.code = 411531001) (if bolus is confirmed by the pump)
Yes Immediate insulin
delayed_insulin 1 insulin unit on backend (decimal (10,2)) The amount of insulin set to be delivered over a long period of time MedicationRequest extension extended-bolus-insulin-amount (if Bolus calculator was used)
+
MedicationAdministration.extension extended-bolus-insulin-amount (medicationCodeableConcept.code = 411531001) (if bolus is confirmed by the pump)
Yes Delayed insulin
delayed_duration millisecond The amount of time in which the delayed insulin amount is to be delivered MedicationRequest extension extended-bolus-duration (if Bolus calculator was used)
+
MedicationAdministration.extension extended-bolus-duration (medicationCodeableConcept.code = 411531001) (if bolus is confirmed by the pump)
Yes Delayed duration
bolus_id string The delivery-device-specific identifier of a bolus delivery MedicationRequest.identifier.value (if Bolus calculator was used)
+
MedicationAdministration.identifier.value
(not to be used directly as value, needs to be built. Details in the sample)
Yes Samples
bolus_activation_type enum on client,
[MANUAL_BOLUS(0),
MANUALLY_CHANGED_RECOMMENDED_BOLUS(1),
RECOMMENDED_BOLUS(2),
COMMANDED_BOLUS(3), BLIND_BOLUS(4)];
The cause of the bolus delivery MedicationRequest extension bolus-activation-type (if Bolus calculator was used)
+
MedicationAdministration.extension bolus-activation-type(medicationCodeableConcept.code = 411531001) (if bolus is confirmed by the pump)
Yes (partially. not all the codes are available in ACSPIX) Bolus activation type
therapy setting - mysugr.therapy.insulin.activeduration seconds Insulin active duration extension careplan-therapy-insulin-active-duration on CarePlan (category = 81334-5) No Therapy settings
therapy setting - mysugr.therapy.insulinpump.type string Name of the insulin pump extension careplan-therapy-insulin-pump-type on CarePlan (category = 81334-5) No Therapy settings
therapy setting -mysugr.boluscalculator.calculationcount integer Number of times boluscalculator was used extension careplan-therapy-bolus-calculator-count on CarePlan (category = 81334-5) No Therapy settings
therapy setting - mysugr.boluscalculator.enabled boolean boluscalculator status is enabled/disabled by the user extension device-component-bolus-advice-enabled on CarePlan (category = 81334-5) No Therapy settings

Important details:

  • lagDuration or lag is not considered for modelling because bolus should be sent with the exact time of delivery after considering the lag)
  • Delivery from pump will always be standard, extended, or multiwave bolus. Manual value present in the shared values will be replaced with the standard bolus.
  • Pump extended and multiwave are composed of other fields -> see below:
    • Standard Bolus:
      • immediateInsulin
      • lagDuration (not relevant for FHIR as the bolus should be sent with the exact time of delivery after considering the lag)
    • Extended Bolus:
      • extendedInsulin
      • extendedDuration
    • Multiwave (Combination of standard + extended):
      • immediateInsulin
      • lagDuration (not relevant for FHIR as the bolus should be sent with the exact time of delivery after considering the lag)
      • extendedInsulin
      • extendedDuration
  • recommended_bolus fields (meal, correction and total) are sent only when a user uses the Bolus Calculator to get a bolus recommendation
  • Since editing is possible the identifier of resources plays a very important role. The identifier for MedicationRequest and MedicationAdministration should be built such that they are unique. Meaning, BOLUS ID alone cannot be used as identifier for both resources. We may have to consider building the identifier like for instance MedicationRequest/[BOLUS ID] and MedicationAdmiistration/[BOLUS ID]
  • Since editing is possible the extension registeredTimestamp should also be sent with all resources
  • Some previously modelled data points BG (DG01), Carb (DG01), pen_bolus_injection_units (DG01), bolus_correction_insulin_units (DG03) and bolus_food_insulin_units (DG03) apply again here (in some cases with additional details to be sent). Please see the section Secnarios in detail.