tx_vl_eligible: Subset Clients who are Eligible for Viral Load

In tidyndr: Analysis of the Nigeria National Data Repository (NDR)

Subset Clients who are Eligible for Viral Load

Description

Generates the line-list of clients who have been (or would have been) on ARV medications for at least 6 months from the reference date. The default reference date is the date of analysis.

Usage

tx_vl_eligible(
  data,
  ref = NULL,
  states = NULL,
  facilities = NULL,
  status = "default",
  sample = FALSE,
  use_six_months = TRUE,
  remove_duplicates = FALSE
)

Arguments

data	An NDR dataframe imported using the 'read_ndr().
ref	Date provided in ISO8601 format ("yyyy-mm-dd"). Used to determine clients who are eligible for viral load and should have a documented result. The default is the date of analysis.
states	The name(s) of the State(s) of interest. The default utilizes all the states in the dataframe. If specifying more than one state, combine the states using the c() e.g. c("State 1", "State 2").
facilities	The name(s) of the facilit(ies) of interest. Default is to utilize all the facilities contained in the dataframe. If specifying more than one facility, combine the facilities using the c() e.g. c("Facility 1", "Facility 2").
status	Determines how the number of active clients is calculated. The options are to either to use the NDR current_status_28_days column or the derived current_status column ("calculated").
sample	Logical (TRUE or FALSE) indicating whether all clients eligible for viral load test should be filtered irrespective of their eligibility for sample collection or only those due for sample collection.
use_six_months	TRUE of FALSE. To determine if six months eligibility should be used for pediatrics and adolescents repeat viral load or the standard annual repeat.
remove_duplicates	Boolean argument. It specifies if duplicate patient entries in the facilities should be removed or kept

Value

tx_vl_eligible

Examples

tx_vl_eligible(ndr_example, ref = "2021-09-30")

# Determine clients who are going to be eligible for VL by the end of Q1 of FY22
tx_vl_eligible(ndr_example,
  ref = "2021-12-31"
)

# Subset clients from "Arewa" and "Okun" who are due for viral load in Q1 of FY22
tx_vl_eligible(ndr_example,
  ref = "2021-12-31",
  states = c("Arewa", "Okun"),
  sample = TRUE
)

tidyndr documentation built on April 8, 2022, 9:06 a.m.