Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Summary

This method returns the average of multiple collected item values. A common use case is ECG triplicate readings, but it will apply to any similar use case. It also can be used to average an arbitrary number of values as long as the FormData conforms to the conventions used by this method.

Form Setup

This method expects that 3 forms contain data collected using the same study event. It will look for Complete and uncanceled FormData. In each form, the method will find the first occurrence of the Item matching the name specified in the method configuration.

Formal Expression

Variables:

  • INCLUDE_NONCONFORMANT_DATA: If true, data looked up which is nonconformant can be used in the calculation. If false, then only Complete forms will be considered

  • REQUIRE_VALUE_FOR_EACH_FORM: if false, then the average of 2 data items will be returned. If true, the method will only return a value if a value is found for every form specified.

  • STUDY_EVENT_NAME: Name of the study event used in collection of the desired ECG data. This can be hardcoded OR dynamically retrieved if you’re looking for the same study event of the item that the method is attached to.

  • TIMEPOINT: Timepoint of the forms. If not present, by default the timepoint of the itemData to which this method is attached will be dynamically retrieved and used.

  • ITEM_NAME_TO_AVERAGE: Name of the Item containing data to be averaged. This can be hard coded OR dynamically calculated using a naming convention for the method that this is attached to.

  • BASELINE_FORM_NAMES = the names of the forms containing the data to be averaged.

...