# Estimate period prevalence

`estimatePeriodPrevalence.Rd`

Estimate period prevalence

## Usage

```
estimatePeriodPrevalence(
cdm,
denominatorTable,
outcomeTable,
denominatorCohortId = NULL,
outcomeCohortId = NULL,
interval = "years",
completeDatabaseIntervals = TRUE,
fullContribution = FALSE,
strata = list(),
includeOverallStrata = TRUE,
minCellCount = 5
)
```

## Arguments

- cdm
A CDM reference object

- denominatorTable
A cohort table with a set of denominator cohorts (for example, created using the

`generateDenominatorCohortSet()`

function).- outcomeTable
A cohort table in the cdm reference containing a set of outcome cohorts.

- denominatorCohortId
The cohort definition ids of the denominator cohorts of interest. If NULL all cohorts will be considered in the analysis.

- outcomeCohortId
The cohort definition ids of the outcome cohorts of interest. If NULL all cohorts will be considered in the analysis.

- interval
Time intervals over which period prevalence is estimated. This can be "weeks", "months", "quarters", "years", or "overall". ISO weeks will be used for weeks. Calendar months, quarters, or years can be used as the period. If more than one option is chosen then results will be estimated for each chosen interval.

- completeDatabaseIntervals
TRUE/ FALSE. Where TRUE, prevalence will only be estimated for those intervals where the database captures all the interval (based on the earliest and latest observation period start dates, respectively).

- fullContribution
TRUE/ FALSE. Where TRUE, individuals will only be included if they in the database for the entire interval of interest. If FALSE they are only required to present for one day of the interval in order to contribute.

- strata
Variables added to the denominator cohort table for which to stratify estimates.

- includeOverallStrata
Whether to include an overall result as well as strata specific results (when strata has been specified).

- minCellCount
Minimum number of events to report- results lower than this will be obscured. If NULL all results will be reported.

## Examples

```
# \donttest{
cdm <- mockIncidencePrevalenceRef(sampleSize = 1000)
cdm <- generateDenominatorCohortSet(
cdm = cdm, name = "denominator",
cohortDateRange = c(as.Date("2008-01-01"), as.Date("2018-01-01"))
)
#> ℹ Creating denominator cohorts
#> ✔ Cohorts created in 0 min and 2 sec
estimatePeriodPrevalence(
cdm = cdm,
denominatorTable = "denominator",
outcomeTable = "outcome",
interval = "months"
)
#> Getting prevalence for analysis 1 of 1
#> Time taken: 0 mins and 1 secs
#> # A tibble: 644 × 13
#> result_id cdm_name group_name group_level strata_name strata_level
#> <int> <chr> <chr> <chr> <chr> <chr>
#> 1 1 mock denominator_cohort_n… denominato… overall overall
#> 2 1 mock denominator_cohort_n… denominato… overall overall
#> 3 1 mock denominator_cohort_n… denominato… overall overall
#> 4 1 mock denominator_cohort_n… denominato… overall overall
#> 5 1 mock denominator_cohort_n… denominato… overall overall
#> 6 1 mock denominator_cohort_n… denominato… overall overall
#> 7 1 mock denominator_cohort_n… denominato… overall overall
#> 8 1 mock denominator_cohort_n… denominato… overall overall
#> 9 1 mock denominator_cohort_n… denominato… overall overall
#> 10 1 mock denominator_cohort_n… denominato… overall overall
#> # ℹ 634 more rows
#> # ℹ 7 more variables: variable_name <chr>, variable_level <chr>,
#> # estimate_name <chr>, estimate_type <chr>, estimate_value <chr>,
#> # additional_name <chr>, additional_level <chr>
# }
```