add_index: Add follow-up time and arm indices to a dataset

View source: R/prepare.functions.R

add_indexR Documentation

Add follow-up time and arm indices to a dataset

Description

Adds follow-up time (fups, fupcount) and arm (arms, narms) indices to a dataset.

Usage

add_index(data.ab, reference = 1)

Arguments

data.ab

A data frame of arm-level data in "long" format containing the columns:

  • studyID Study identifiers

  • time Numeric data indicating follow-up times

  • treatment Treatment identifiers (can be numeric, factor or character)

  • class An optional column indicating a particular class code. Treatments with the same identifier must also have the same class code.

reference

A number or character (depending on the format of treatment within data.ab) indicating the reference treatment in the network (i.e. those for which estimated relative treatment effects estimated by the model will be compared to).

Value

A data frame similar to data.ab but with additional columns:

  • arm Arm identifiers coded for each study

  • fupcount Follow-up identifiers coded for each study

  • fups The total number of follow-up measurements in each study

  • narm The total number of arms in each study

If treatment or class are non-numeric or non-sequential (i.e. with missing numeric codes), treatments/classes in the returned data frame will be numbered and recoded to enforce sequential numbering (a warning will be shown stating this).

Examples

# Add indices to osteoarthritis pain dataset
data.ab <- add_index(osteopain)

# Add indices to dataset using different network reference treatment
data.ab <- add_index(osteopain, reference=3)

MBNMAtime documentation built on Oct. 14, 2023, 5:08 p.m.