From 798226ec5013ce9148da4f23dc373404ea7aa591 Mon Sep 17 00:00:00 2001
From: nsjohnsen <nosj@novonordisk.com>
Date: Tue, 16 Apr 2024 16:07:51 +0200
Subject: [PATCH] Updating ep spec overview article with
 only_strata_with_events

---
 vignettes/ep_overview.Rmd             |  4 +++-
 vignettes/ep_spec_strata_w_events.Rmd | 20 ++++++++++++++++++++
 2 files changed, 23 insertions(+), 1 deletion(-)
 create mode 100644 vignettes/ep_spec_strata_w_events.Rmd

diff --git a/vignettes/ep_overview.Rmd b/vignettes/ep_overview.Rmd
index bd196f4..90b6b37 100644
--- a/vignettes/ep_overview.Rmd
+++ b/vignettes/ep_overview.Rmd
@@ -45,7 +45,7 @@ For more details on the internal steps of {chef} see [Getting Started with Pipel
 The parameters of each endpoint specification can be grouped in to the sets below, which are explained in their respective sections:
 ```{r, echo=FALSE}
 dt <- data.table::data.table(
-  Type = c(rep("Population and outcome", 13), rep("Methods", 6)),
+  Type = c(rep("Population and outcome", 14), rep("Methods", 6)),
   Section = c(
     rep(
       "[ADaM data](ep_spec_adam_data.html). What data to use and how to consolidate it into a single data table for the endpoint that is used to calculate statistics.",
@@ -61,6 +61,7 @@ dt <- data.table::data.table(
       4),
     "[Strata](ep_spec_strata_def.html). How to slice the data within the endpoint.",
     "[Endpoint label](ep_spec_label.html). What events the endpoint describes.",
+    "[Processing of strata without events](ep_spec_strata_w_events.html). Specification of whether only strata levels with events are to be incorporated in the endpoint.",
     rep(
       "[Criteria methods](methods_criteria.html). Requirements that must be met to include different types of statistics in the endpoint results.",
       3),
@@ -82,6 +83,7 @@ dt <- data.table::data.table(
     "`group_by`",
     "`stratify_by`",
     "`endpoint_label`",
+    "`only_strata_with_events`",
     "`crit_endpoint`",
     "`crit_by_strata_by_trt`",
     "`crit_by_strata_across_trt`",
diff --git a/vignettes/ep_spec_strata_w_events.Rmd b/vignettes/ep_spec_strata_w_events.Rmd
new file mode 100644
index 0000000..6ac40f7
--- /dev/null
+++ b/vignettes/ep_spec_strata_w_events.Rmd
@@ -0,0 +1,20 @@
+---
+title: "Processing of strata without events"
+output: rmarkdown::html_vignette
+vignette: >
+  %\VignetteIndexEntry{Processing of strata without events}
+  %\VignetteEngine{knitr::rmarkdown}
+  %\VignetteEncoding{UTF-8}
+---
+
+```{r, include = FALSE}
+knitr::opts_chunk$set(
+  collapse = TRUE,
+  comment = "#>"
+)
+```
+
+# Overview
+
+The `only_strata_with_events` endpoint parameter specifies whether the endpoint upon completion in the {chef} framework will include all strata levels or only those levels that contain events. By default, all levels will be included in the endpoint.
+