hiv_prv_cov: Calculate HIV prevalence and HIV testing coverage

In brittanyblouin/ANCRTAdjust: Adjusting HIV prevalence from ANC-RT data for common biases

Description

Calculates HIV prevalence and HIV testing coverage stratified by snu1, year and/or reporting period.

Usage

hiv_prv_cov(data, by_period = FALSE, by_snu1 = FALSE,
  by_year = FALSE)

Arguments

data	The ANC-RT dataset. The functions check_data, data_clean and mt_adjust should have been run on the data to properly prepare the data for use here. The dataset must have the following variables: n_clients: The number of women from the specified facility, during the specified time period, that attended their first ANC visit. totpos_c: Cleaned totpos (generated using the data_clean and mt_adjust functions). n_status_c: Cleaned n_status (generated using the data_clean and mt_adjust functions). snu1: The subnational unit 1 (only required if results are to be stratified by snu1). time: The time period over which the data was collected (only required if results are to be stratified by the reporting time period). year: The year that the data was collected (only required if results are to be stratified by year).
by_period	TRUE indicates that the results be stratified by reporting period. FALSE" indicates that the results not be stratified.
by_snu1	TRUE indicates that the results be stratified by snu1. FALSE" indicates that the results not be stratified.
by_year	TRUE indicates that the results be stratified by year. FALSE" indicates that the results not be stratified.

Details

This function has been developed to calculate HIV prevalence and HIV testing coverage from ANC-RT data. The HIV prevalence and testing coverage can be reported stratified by reporting period, year and/or subnational unit 1, according to user inputs.

Value

A table (in dataframe format) indicating the results, stratified according to user inputs. The results table includes the following columns:

• snu1 (only if results were stratified by snu1): The subnational unit 1.

• time (only if results were stratified by time period and/or year): The time frame. When results are stratified by year and reporting period, the digits "99" are suffixed to the year (i.e. "201599" refers to the yearly result for 2015).

• hiv_raw: The raw HIV prevalence (i.e. with no previous adjustments).

• hiv_prv: The HIV prevalence adjusted for all previous adjustments (i.e. data cleaning and adjustment for multiple testing, if performed).

• hiv_cov: The HIV testing coverage adjusted for all previous adjustments (i.e. data cleaning and adjustment for multiple testing, if performed).

Author(s)

Mathieu Maheu-Giroux

Brittany Blouin

brittanyblouin/ANCRTAdjust documentation built on Oct. 28, 2019, 4:53 a.m.