Closes #1960 enhance derive_extreme_event()

NAMESPACE

@@ -125,6 +125,7 @@ export(desc)
 export(dose_freq_lookup)
 export(dthcaus_source)
 export(event)
+export(event_joined)
 export(event_source)
 export(exprs)
 export(extend_source_datasets)

NEWS.md

@@ -21,6 +21,29 @@
 - Templates, vignettes, and other uses of `{admiral.test}` SDTM data are updated to use `{pharmaversesdtm}` instead. (#2040)
 
 
+- `derive_extreme_event()` was enhanced (#1960):
+
+    - `event_joined()` events can be specified for the `events` argument. This
+    allows to define events based on more than one observation, e.g., events
+    which need to be confirmed by a second assessment.
+
+    - The `source_datasets` argument was added to the function and the
+    `dataset_name` field to `event()`. It can be used to define events based on
+    a different dataset than the input dataset.
+
+    - The `keep_source_vars` argument was added to the function and the
+    `keep_source_vars` field to `event()`. It allows to select which variables
+    should be kept for the selected observations.
+
+    - The `mode` and `order` field were added to `event()`. They allow to select
+    the first or last observation per by group if there are multiple observation
+    fulfilling the event condition.
+
+    - The `ignore_event_order` argument was added.
+
+    - The `description` field was added to `event()`. It can be used to provide
+    a description of the event in plain language.
+
 ## Breaking Changes
 - The following functions, which were deprecated in previous `{admiral}` versions, have been removed: (#1950)