get.dataset {tracenma}R Documentation

Get the selected dataset

Description

Retrieving a dataset with study-level aggregate clinical and methodological characteristics (that may act as effect modifiers) extracted from the selected systematic review of the database.

Usage

get.dataset(pmid, show.index = FALSE, show.type = FALSE)

Arguments

pmid

A scalar with the PMID number of the systematic review found in the database.

show.index

Logical to indicate whether to return a data-frame with the full name of the abbreviated characteristics. The default is FALSE (do not report).

show.type

Logical to indicate whether to return a data-frame with the type (Demographic, Clinical, Methodological) and subtype (Age, Ethnicity, Intervention, Outcome, Participant, Risk of bias, Sex, Study design, Study setting, Withdrawals) of the characteristics. The default is FALSE (do not report).

Details

The selected dataset refers to a connected network for a specific outcome studied in the corresponding systematic review. The R package nmadb was used to retrieve the corresponding dataset. Specifically, the function readByID was employed to download the dataset in the long format. Then, the function pairwise of the R package netmeta was implemented to convert the dataset into wide format with each row repeated as many times as the number of possible comparisons made in the corresponding study. The study names (or references) and treatment comparisons, as returned by readByID, were used to locate the studies in the corresponding report of the systematic review (and Appendix, if available) and extract the characteristics available in the relevant table(s). Each characteristic occupies one column in the dataset. Characteristics pertaining to intervention features occupied one column for the experimental and another for the control treatment in the corresponding comparison.

Value

get.dataset returns the following:

Dataset

A data-frame (tibble style) with rows referring to the studies and columns to the study-level aggregate characteristics as extracted from the report of the corresponding systematic review.

Characteristics_index

A data-frame (tibble style) with the rows referring to the extracted characteristics (abbreviated name) and columns to the their full name (if show.index = TRUE), their type and subtype (if show.type = TRUE).

Author(s)

Loukia M. Spineli

See Also

pairwise, readByID

Examples

get.dataset(pmid = 25626481)


[Package tracenma version 0.1.0 Index]