To add a new column with the initial quantity. To add multiple columns use addDrugUtilisation() for efficiency.

To add a new column with the initial quantity. To add multiple columns use addDrugUtilisation() for efficiency.

Usage

addInitialQuantity(
  cohort,
  conceptSet,
  indexDate = "cohort_start_date",
  censorDate = "cohort_end_date",
  restrictIncident = TRUE,
  nameStyle = "initial_quantity_{concept_name}",
  name = NULL
)

Arguments

cohort: A cohort_table object.
conceptSet: List of concepts to be included.
indexDate: Name of a column that indicates the date to start the analysis.
censorDate: Name of a column that indicates the date to stop the analysis, if NULL end of individuals observation is used.
restrictIncident: Whether to include only incident prescriptions in the analysis. If FALSE all prescriptions that overlap with the study period will be included.
nameStyle: Character string to specify the nameStyle of the new columns.
name: Name of the new computed cohort table, if NULL a temporary table will be created.

Value

The same cohort with the added column.

Examples

# \donttest{
library(DrugUtilisation)
library(CodelistGenerator)
library(dplyr, warn.conflicts = FALSE)

cdm <- mockDrugUtilisation()
codelist <- getDrugIngredientCodes(cdm = cdm, name = "acetaminophen")
cdm <- generateDrugUtilisationCohortSet(cdm = cdm,
                                        name = "dus_cohort",
                                        conceptSet = codelist)
#> ℹ Subsetting drug_exposure table
#> ℹ Checking whether any record needs to be dropped.
#> ℹ Collapsing overlaping records.
#> ℹ Collapsing records with gapEra = 1 days.

cdm$dus_cohort |>
  addInitialQuantity(conceptSet = codelist) |>
  glimpse()
#> Rows: ??
#> Columns: 5
#> Database: DuckDB v1.3.0 [unknown@Linux 6.11.0-1015-azure:R 4.5.1/:memory:]
#> $ cohort_definition_id               <int> 1, 1, 1, 1, 1, 1, 1, 1, 1
#> $ subject_id                         <int> 10, 3, 3, 5, 5, 5, 2, 8, 4
#> $ cohort_start_date                  <date> 2015-03-13, 2003-09-27, 2007-02-11,…
#> $ cohort_end_date                    <date> 2017-07-19, 2005-07-29, 2007-05-12,…
#> $ initial_quantity_161_acetaminophen <dbl> 25, 70, 40, 20, 50, 5, 1, 70, 45
# }