Searches across datasets specified for requested survey variables. This function (or search_variable_labels) should be used to provide the `questions` argument for extract_dhs.

search_variables(dataset_filenames, variables, essential_variables = NULL, ...)

Arguments

dataset_filenames

The desired filenames to be downloaded. These can be found as one of the returned fields from dhs_datasets.

variables

Character vector of survey variables to be looked up

essential_variables

Character vector of variables that need to present. If any of the codes are not present in that survey, the survey will not be returned by this function. Default = `NULL`.

...

Any other arguments to be passed to download_datasets

Value

A data.frame of the surveys where matches were found and then all the resultant codes and descriptions.

Details

Use this function after get_datasets to look up all the survey variables that have the required variable.

Examples

if (FALSE) { # get the model datasets included with the package model_datasets <- model_datasets # download two of them g <- get_datasets(dataset_filenames = model_datasets$FileName[1:2]) # and now seearch within these for survey variables search_variables( dataset_filenames = names(g), variables = c("v002","v102","ml13"), ) # if we specify an essential variable then that dataset has to have that # variable or else no variables will be returned for that datasets search_variables( dataset_filenames = names(g), variables = c("v002","v102","ml13"), essential_variables = "ml13" ) }