R/fn_get.R

In ready4-dev/map2aqol: Transform Youth Outcomes to Health Utility Predictions

#' Get dataverse dataset publication
#' @description get_dv_ds_publication() is a Get function that extracts data from an object. Specifically, this function implements an algorithm to get dataverse dataset publication. The function returns Digital object identifier url (a character vector of length one).
#' @param ds_url_1L_chr Dataset url (a character vector of length one)
#' @param server_1L_chr Server (a character vector of length one), Default: 'dataverse.harvard.edu'
#' @param key_1L_chr Key (a character vector of length one), Default: NULL
#' @return Digital object identifier url (a character vector of length one)
#' @rdname get_dv_ds_publication
#' @export 
#' @importFrom dataverse dataset_metadata
#' @importFrom dplyr filter pull
#' @importFrom purrr pluck
#' @keywords internal
get_dv_ds_publication <- function (ds_url_1L_chr, server_1L_chr = "dataverse.harvard.edu", 
    key_1L_chr = NULL) 
{
    ds_md_ls <- dataverse::dataset_metadata(ds_url_1L_chr, key = key_1L_chr, 
        server = server_1L_chr)
    doi_url_1L_chr <- ds_md_ls$fields %>% dplyr::filter(typeName == 
        "publication") %>% dplyr::pull(value) %>% purrr::pluck(1)
    doi_url_1L_chr <- ifelse(!is.null(doi_url_1L_chr), doi_url_1L_chr %>% 
        dplyr::pull(publicationURL) %>% dplyr::pull(value), "")
    return(doi_url_1L_chr)
}
#' Get dataverse datasets model summarys
#' @description get_dv_dss_mdl_smrys() is a Get function that extracts data from an object. Specifically, this function implements an algorithm to get dataverse datasets model summarys. The function returns Dataverse datasets model summarys (a list).
#' @param ids_chr Identities (a character vector)
#' @param server_1L_chr Server (a character vector of length one), Default: 'dataverse.harvard.edu'
#' @param key_1L_chr Key (a character vector of length one), Default: NULL
#' @return Dataverse datasets model summarys (a list)
#' @rdname get_dv_dss_mdl_smrys
#' @export 
#' @importFrom purrr map
#' @importFrom stats setNames
#' @keywords internal
get_dv_dss_mdl_smrys <- function (ids_chr, server_1L_chr = "dataverse.harvard.edu", key_1L_chr = NULL) 
{
    dv_dss_mdl_smrys_ls <- ids_chr %>% purrr::map(~get_mdl_from_dv("mdl_ingredients", 
        dv_ds_nm_1L_chr = .x, server_1L_chr = server_1L_chr, 
        key_1L_chr = key_1L_chr)) %>% stats::setNames(ids_chr)
    return(dv_dss_mdl_smrys_ls)
}
#' Get dataverse model summarys
#' @description get_dv_mdl_smrys() is a Get function that extracts data from an object. Specifically, this function implements an algorithm to get dataverse model summarys. The function is called for its side effects and does not return a value.
#' @param mdls_lup Models (a lookup table)
#' @param mdl_nms_chr Model names (a character vector), Default: NULL
#' @return Dataverse model (summarys)
#' @rdname get_dv_mdl_smrys
#' @export 
#' @importFrom purrr map2 flatten
#' @importFrom dplyr filter pull
#' @keywords internal
get_dv_mdl_smrys <- function (mdls_lup, mdl_nms_chr = NULL) 
{
    ds_urls_chr <- mdls_lup$ds_url %>% unique()
    dss_mdl_smrys_ls <- get_dv_dss_mdl_smrys(ds_urls_chr)
    dv_mdl_smrys <- dss_mdl_smrys_ls %>% purrr::map2(ds_urls_chr, 
        ~get_mdl_smrys(.x, mdl_nms_chr = mdls_lup %>% dplyr::filter(ds_url == 
            .y) %>% dplyr::pull(mdl_nms_chr))) %>% purrr::flatten()
    if (!is.null(mdl_nms_chr)) {
        dv_mdl_smrys <- dv_mdl_smrys[names(dv_mdl_smrys) %in% 
            mdl_nms_chr]
    }
    return(dv_mdl_smrys)
}
#' Get filtered transfer to utility algorithm datasets
#' @description get_filtered_ttu_dss() is a Get function that extracts data from an object. Specifically, this function implements an algorithm to get filtered transfer to utility algorithm datasets. The function returns Transfer to utility algorithm dataverse datasets (a tibble).
#' @param ttu_dv_dss_tb Transfer to utility algorithm dataverse datasets (a tibble), Default: NULL
#' @param mdl_predrs_in_ds_chr Model predictors in dataset (a character vector), Default: NULL
#' @param utility_type_chr Utility type (a character vector), Default: NULL
#' @param ttu_dv_nms_chr Transfer to utility algorithm dataverse names (a character vector), Default: 'TTU'
#' @param server_1L_chr Server (a character vector of length one), Default: 'dataverse.harvard.edu'
#' @param key_1L_chr Key (a character vector of length one), Default: NULL
#' @return Transfer to utility algorithm dataverse datasets (a tibble)
#' @rdname get_filtered_ttu_dss
#' @export 
#' @importFrom dplyr filter
#' @importFrom purrr map_lgl
#' @keywords internal
get_filtered_ttu_dss <- function (ttu_dv_dss_tb = NULL, mdl_predrs_in_ds_chr = NULL, 
    utility_type_chr = NULL, ttu_dv_nms_chr = "TTU", server_1L_chr = "dataverse.harvard.edu", 
    key_1L_chr = NULL) 
{
    if (is.null(ttu_dv_dss_tb)) 
        ttu_dv_dss_tb <- get_ttu_dv_dss(ttu_dv_nms_chr = ttu_dv_nms_chr, 
            server_1L_chr = server_1L_chr, key_1L_chr = NULL)
    if (is.null(ttu_dv_dss_tb)) {
        if (is.null(mdl_predrs_in_ds_chr)) 
            mdl_predrs_in_ds_chr <- get_ttu_dv_predrs(ttu_dv_dss_tb)
        ttu_dv_dss_tb <- ttu_dv_dss_tb %>% dplyr::filter(predrs_ls %>% 
            purrr::map_lgl(~!identical(intersect(.x, mdl_predrs_in_ds_chr), 
                character(0))))
        if (!is.null(utility_type_chr)) 
            ttu_dv_dss_tb <- ttu_dv_dss_tb %>% dplyr::filter(utility %in% 
                utility_type_chr)
    }
    return(ttu_dv_dss_tb)
}
#' Get model catalogue url
#' @description get_mdl_ctlg_url() is a Get function that extracts data from an object. Specifically, this function implements an algorithm to get model catalogue url. The function is called for its side effects and does not return a value.
#' @param mdls_lup Models (a lookup table)
#' @param mdl_nm_1L_chr Model name (a character vector of length one)
#' @param server_1L_chr Server (a character vector of length one), Default: 'dataverse.harvard.edu'
#' @param key_1L_chr Key (a character vector of length one), Default: NULL
#' @return ctlg_url (An object)
#' @rdname get_mdl_ctlg_url
#' @export 
#' @importFrom dataverse dataset_files
#' @importFrom purrr map_chr map_lgl
#' @importFrom stringr str_detect
#' @importFrom ready4 get_from_lup_obj
#' @keywords internal
get_mdl_ctlg_url <- function (mdls_lup, mdl_nm_1L_chr, server_1L_chr = "dataverse.harvard.edu", 
    key_1L_chr = NULL) 
{
    dv_ds_nm_1L_chr <- get_mdl_ds_url(mdls_lup, mdl_nm_1L_chr = mdl_nm_1L_chr)
    ds_ls <- dataverse::dataset_files(dv_ds_nm_1L_chr, server = server_1L_chr, 
        key = key_1L_chr)
    all_lbls_chr <- purrr::map_chr(ds_ls, ~.x$label)
    include_lgl <- all_lbls_chr %>% purrr::map_lgl(~startsWith(.x, 
        "AAA_TTU_MDL_CTG"))
    all_descs_chr <- purrr::map_chr(ds_ls, ~.x$description)
    include_lgl <- include_lgl & (all_descs_chr %>% purrr::map_lgl(~stringr::str_detect(.x, 
        ready4::get_from_lup_obj(mdls_lup, match_value_xx = mdl_nm_1L_chr, 
            match_var_nm_1L_chr = "mdl_nms_chr", target_var_nm_1L_chr = "source_chr", 
            evaluate_1L_lgl = F))))
    idx_1L_int <- which(include_lgl)
    if (identical(idx_1L_int, integer(0))) {
        ctlg_url <- NULL
    }
    else {
        ctlg_url <- paste0("https://dataverse.harvard.edu/api/access/datafile/", 
            ds_ls[[idx_1L_int]]$dataFile$id)
    }
    return(ctlg_url)
}
#' Get model dataset url
#' @description get_mdl_ds_url() is a Get function that extracts data from an object. Specifically, this function implements an algorithm to get model dataset url. The function is called for its side effects and does not return a value.
#' @param mdls_lup Models (a lookup table)
#' @param mdl_nm_1L_chr Model name (a character vector of length one)
#' @return mdl_ds_url (An object)
#' @rdname get_mdl_ds_url
#' @export 
#' @importFrom ready4 get_from_lup_obj
#' @keywords internal
get_mdl_ds_url <- function (mdls_lup, mdl_nm_1L_chr) 
{
    mdl_ds_url <- ready4::get_from_lup_obj(mdls_lup, match_value_xx = mdl_nm_1L_chr, 
        match_var_nm_1L_chr = "mdl_nms_chr", target_var_nm_1L_chr = "ds_url", 
        evaluate_1L_lgl = F)
    return(mdl_ds_url)
}
#' Get model from dataverse
#' @description get_mdl_from_dv() is a Get function that extracts data from an object. Specifically, this function implements an algorithm to get model from dataverse. The function returns Model (a model).
#' @param mdl_nm_1L_chr Model name (a character vector of length one)
#' @param dv_ds_nm_1L_chr Dataverse dataset name (a character vector of length one), Default: 'https://doi.org/10.7910/DVN/JC6PTV'
#' @param dv_nm_1L_chr Dataverse name (a character vector of length one), Default: 'TTU'
#' @param server_1L_chr Server (a character vector of length one), Default: 'dataverse.harvard.edu'
#' @param key_1L_chr Key (a character vector of length one), Default: NULL
#' @return Model (a model)
#' @rdname get_mdl_from_dv
#' @export 
#' @importFrom ready4use Ready4useRepos
#' @importFrom ready4 ingest
#' @importFrom purrr pluck
get_mdl_from_dv <- function (mdl_nm_1L_chr, dv_ds_nm_1L_chr = "https://doi.org/10.7910/DVN/JC6PTV", 
    dv_nm_1L_chr = "TTU", server_1L_chr = "dataverse.harvard.edu", 
    key_1L_chr = NULL) 
{
    X <- ready4use::Ready4useRepos(dv_nm_1L_chr = dv_nm_1L_chr, 
        dv_server_1L_chr = server_1L_chr, dv_ds_nm_1L_chr = dv_ds_nm_1L_chr)
    contents_ls <- ready4::ingest(X, metadata_1L_lgl = F)
    idx_1L_int <- which(names(contents_ls) == mdl_nm_1L_chr)
    if (identical(idx_1L_int, integer(0))) {
        model_mdl <- NULL
    }
    else {
        model_mdl <- contents_ls %>% purrr::pluck(idx_1L_int)
    }
    return(model_mdl)
}
#' Get model metadata
#' @description get_mdl_metadata() is a Get function that extracts data from an object. Specifically, this function implements an algorithm to get model metadata. The function returns Ingredients (a list).
#' @param mdls_lup Models (a lookup table)
#' @param mdl_nm_1L_chr Model name (a character vector of length one)
#' @param server_1L_chr Server (a character vector of length one), Default: 'dataverse.harvard.edu'
#' @param key_1L_chr Key (a character vector of length one), Default: NULL
#' @return Ingredients (a list)
#' @rdname get_mdl_metadata
#' @export 
#' @keywords internal
get_mdl_metadata <- function (mdls_lup, mdl_nm_1L_chr, server_1L_chr = "dataverse.harvard.edu", 
    key_1L_chr = NULL) 
{
    dv_ds_nm_1L_chr <- get_mdl_ds_url(mdls_lup, mdl_nm_1L_chr = mdl_nm_1L_chr)
    ingredients_ls <- get_mdl_from_dv("mdl_ingredients", dv_ds_nm_1L_chr = dv_ds_nm_1L_chr, 
        server_1L_chr = server_1L_chr, key_1L_chr = key_1L_chr)
    return(ingredients_ls)
}
#' Get model summarys
#' @description get_mdl_smrys() is a Get function that extracts data from an object. Specifically, this function implements an algorithm to get model summarys. The function returns Models summary (a list).
#' @param ingredients_ls Ingredients (a list)
#' @param mdl_nms_chr Model names (a character vector), Default: NULL
#' @return Models summary (a list)
#' @rdname get_mdl_smrys
#' @export 
#' @importFrom purrr map
#' @importFrom dplyr filter select
#' @importFrom stats setNames
#' @keywords internal
get_mdl_smrys <- function (ingredients_ls, mdl_nms_chr = NULL) 
{
    if (is.null(mdl_nms_chr)) 
        mdl_nms_chr <- ingredients_ls$mdls_smry_tb$Model %>% 
            unique()
    mdls_smry_ls <- mdl_nms_chr %>% purrr::map(~{
        df <- ingredients_ls$mdls_smry_tb %>% dplyr::filter(Model == 
            .x) %>% dplyr::select(-Model)
        rownames(df) <- NULL
        df
    }) %>% stats::setNames(mdl_nms_chr)
    return(mdls_smry_ls)
}
#' Get models lookup table
#' @description get_mdls_lup() is a Get function that extracts data from an object. Specifically, this function implements an algorithm to get models lookup table. The function returns Models (a lookup table).
#' @param ttu_dv_dss_tb Transfer to utility algorithm dataverse datasets (a tibble), Default: NULL
#' @param mdl_predrs_in_ds_chr Model predictors in dataset (a character vector), Default: NULL
#' @param utility_type_chr Utility type (a character vector), Default: NULL
#' @param ttu_dv_nms_chr Transfer to utility algorithm dataverse names (a character vector), Default: 'TTU'
#' @param server_1L_chr Server (a character vector of length one), Default: 'dataverse.harvard.edu'
#' @param key_1L_chr Key (a character vector of length one), Default: NULL
#' @return Models (a lookup table)
#' @rdname get_mdls_lup
#' @export 
#' @importFrom purrr map2_dfr map_chr map_lgl
#' @importFrom ready4 get_from_lup_obj
#' @importFrom dplyr filter mutate case_when
#' @keywords internal
get_mdls_lup <- function (ttu_dv_dss_tb = NULL, mdl_predrs_in_ds_chr = NULL, 
    utility_type_chr = NULL, ttu_dv_nms_chr = "TTU", server_1L_chr = "dataverse.harvard.edu", 
    key_1L_chr = NULL) 
{
    if (is.null(ttu_dv_dss_tb)) 
        ttu_dv_dss_tb <- get_ttu_dv_dss(ttu_dv_nms_chr = ttu_dv_nms_chr, 
            server_1L_chr = server_1L_chr, key_1L_chr = NULL)
    if (!is.null(ttu_dv_dss_tb)) {
        if (is.null(mdl_predrs_in_ds_chr)) 
            mdl_predrs_in_ds_chr <- get_ttu_dv_predrs(ttu_dv_dss_tb)
        ttu_dv_dss_tb <- get_filtered_ttu_dss(ttu_dv_dss_tb, 
            mdl_predrs_in_ds_chr = mdl_predrs_in_ds_chr, utility_type_chr = utility_type_chr)
    }
    if (!is.null(ttu_dv_dss_tb)) {
        ds_smrys_ls <- get_ttu_ds_smrys("TTU", reference_int = ttu_dv_dss_tb$reference_int)
        mdls_lup <- ds_smrys_ls %>% purrr::map2_dfr(names(ds_smrys_ls), 
            ~{
                predictors_lup <- .x$predictors_lup
                urls_chr <- .y
                predrs_short_nms_chr <- mdl_predrs_in_ds_chr %>% 
                  purrr::map_chr(~ready4::get_from_lup_obj(predictors_lup, 
                    match_value_xx = .x, match_var_nm_1L_chr = "long_name_chr", 
                    target_var_nm_1L_chr = "short_name_chr", 
                    evaluate_1L_lgl = F))
                .x$mdls_lup %>% dplyr::filter(predrs_ls %>% purrr::map_lgl(~{
                  !identical(intersect(.x, predrs_short_nms_chr), 
                    character(0))
                })) %>% dplyr::mutate(ds_url = urls_chr)
            })
        mdls_lup <- mdls_lup %>% dplyr::mutate(source_chr = dplyr::case_when(is.na(source_chr) ~ 
            "Primary Analysis", T ~ source_chr))
    }
    else {
        mdls_lup <- NULL
    }
    return(mdls_lup)
}
#' Get model
#' @description get_model() is a Get function that extracts data from an object. Specifically, this function implements an algorithm to get model. The function returns Model (a model).
#' @param mdls_lup Models (a lookup table)
#' @param mdl_nm_1L_chr Model name (a character vector of length one)
#' @param make_from_tbl_1L_lgl Make from table (a logical vector of length one), Default: T
#' @param mdl_meta_data_ls Model meta data (a list), Default: NULL
#' @param server_1L_chr Server (a character vector of length one), Default: 'dataverse.harvard.edu'
#' @param key_1L_chr Key (a character vector of length one), Default: NULL
#' @return Model (a model)
#' @rdname get_model
#' @export 
#' @importFrom ready4 get_from_lup_obj
#' @importFrom specific get_table_predn_mdl
#' @keywords internal
get_model <- function (mdls_lup, mdl_nm_1L_chr, make_from_tbl_1L_lgl = T, 
    mdl_meta_data_ls = NULL, server_1L_chr = "dataverse.harvard.edu", 
    key_1L_chr = NULL) 
{
    if (make_from_tbl_1L_lgl) {
        if (is.null(mdl_meta_data_ls)) {
            mdl_meta_data_ls <- get_mdl_metadata(mdls_lup, mdl_nm_1L_chr = mdl_nm_1L_chr, 
                server_1L_chr = server_1L_chr, key_1L_chr = key_1L_chr)
        }
        analysis_1L_chr <- ready4::get_from_lup_obj(mdls_lup, 
            match_value_xx = mdl_nm_1L_chr, match_var_nm_1L_chr = "mdl_nms_chr", 
            target_var_nm_1L_chr = "source_chr", evaluate_1L_lgl = F)
        if (analysis_1L_chr == "Primary Analysis") 
            analysis_1L_chr <- NULL
        model_mdl <- specific::get_table_predn_mdl(mdl_nm_1L_chr, 
            ingredients_ls = mdl_meta_data_ls, analysis_1L_chr = analysis_1L_chr)
    }
    else {
        model_mdl <- get_mdl_from_dv(mdl_nm_1L_chr, dv_ds_nm_1L_chr = get_mdl_ds_url(mdls_lup, 
            mdl_nm_1L_chr = mdl_nm_1L_chr), server_1L_chr = server_1L_chr, 
            key_1L_chr = key_1L_chr)
    }
    return(model_mdl)
}
#' Get predictors lookup table
#' @description get_predictors_lup() is a Get function that extracts data from an object. Specifically, this function implements an algorithm to get predictors lookup table. The function returns Predictors (a tibble).
#' @param mdl_meta_data_ls Model meta data (a list), Default: NULL
#' @param mdls_lup Models (a lookup table), Default: NULL
#' @param mdl_nm_1L_chr Model name (a character vector of length one), Default: NULL
#' @param outp_is_abbrs_tb Output is abbreviations (a tibble), Default: F
#' @param server_1L_chr Server (a character vector of length one), Default: 'dataverse.harvard.edu'
#' @param key_1L_chr Key (a character vector of length one), Default: NULL
#' @return Predictors (a tibble)
#' @rdname get_predictors_lup
#' @export 
#' @importFrom dplyr filter select rename
#' @importFrom ready4 get_from_lup_obj
#' @importFrom purrr flatten_chr
#' @keywords internal
get_predictors_lup <- function (mdl_meta_data_ls = NULL, mdls_lup = NULL, mdl_nm_1L_chr = NULL, 
    outp_is_abbrs_tb = F, server_1L_chr = "dataverse.harvard.edu", 
    key_1L_chr = NULL) 
{
    if (is.null(mdl_meta_data_ls)) 
        mdl_meta_data_ls <- get_mdl_metadata(mdls_lup = mdls_lup, 
            mdl_nm_1L_chr = mdl_nm_1L_chr, server_1L_chr = server_1L_chr, 
            key_1L_chr = key_1L_chr)
    predictors_tb <- mdl_meta_data_ls$predictors_lup
    if (!is.null(mdl_nm_1L_chr)) {
        predictors_tb <- predictors_tb %>% dplyr::filter(short_name_chr %in% 
            (ready4::get_from_lup_obj(mdls_lup, match_value_xx = mdl_nm_1L_chr, 
                match_var_nm_1L_chr = "mdl_nms_chr", target_var_nm_1L_chr = "predrs_ls", 
                evaluate_1L_lgl = F) %>% purrr::flatten_chr()))
    }
    if (outp_is_abbrs_tb) {
        predictors_tb <- predictors_tb %>% dplyr::select(short_name_chr, 
            long_name_chr) %>% dplyr::rename(Variable = short_name_chr, 
            Description = long_name_chr)
    }
    return(predictors_tb)
}
#' Get transformation from lookup table
#' @description get_tfmn_from_lup() is a Get function that extracts data from an object. Specifically, this function implements an algorithm to get transformation from lookup table. The function returns Transformation (a character vector of length one).
#' @param mdl_nm_1L_chr Model name (a character vector of length one)
#' @param mdls_lup Models (a lookup table), Default: NULL
#' @return Transformation (a character vector of length one)
#' @rdname get_tfmn_from_lup
#' @export 
#' @importFrom utils data
#' @importFrom ready4 get_from_lup_obj
get_tfmn_from_lup <- function (mdl_nm_1L_chr, mdls_lup = NULL) 
{
    if (is.null(mdls_lup)) 
        utils::data("mdls_lup", envir = environment())
    tfmn_1L_chr <- ready4::get_from_lup_obj(mdls_lup, target_var_nm_1L_chr = "tfmn_chr", 
        match_value_xx = mdl_nm_1L_chr, match_var_nm_1L_chr = "mdl_nms_chr", 
        evaluate_1L_lgl = F)
    return(tfmn_1L_chr)
}
#' Get transfer to utility algorithm dataset summarys
#' @description get_ttu_ds_smrys() is a Get function that extracts data from an object. Specifically, this function implements an algorithm to get transfer to utility algorithm dataset summarys. The function returns Dataverse datasets model summarys (a list).
#' @param ttu_dv_nm_1L_chr Transfer to utility algorithm dataverse name (a character vector of length one), Default: 'TTU'
#' @param server_1L_chr Server (a character vector of length one), Default: 'dataverse.harvard.edu'
#' @param key_1L_chr Key (a character vector of length one), Default: NULL
#' @param reference_int Reference (an integer vector), Default: NULL
#' @return Dataverse datasets model summarys (a list)
#' @rdname get_ttu_ds_smrys
#' @export 
#' @importFrom dataverse dataverse_contents
#' @importFrom purrr map_chr compact map pluck
#' @importFrom stats setNames
#' @keywords internal
get_ttu_ds_smrys <- function (ttu_dv_nm_1L_chr = "TTU", server_1L_chr = "dataverse.harvard.edu", 
    key_1L_chr = NULL, reference_int = NULL) 
{
    ds_ls <- dataverse::dataverse_contents(ttu_dv_nm_1L_chr, 
        key = key_1L_chr, server = server_1L_chr)
    ids_chr <- ds_ls %>% purrr::map_chr(~.x$persistentUrl)
    dv_dss_mdl_smrys_ls <- get_dv_dss_mdl_smrys(ids_chr, server_1L_chr = server_1L_chr, 
        key_1L_chr = key_1L_chr)
    dv_dss_mdl_smrys_ls <- dv_dss_mdl_smrys_ls %>% purrr::compact()
    if (!is.null(reference_int) & length(dv_dss_mdl_smrys_ls) > 
        0) 
        dv_dss_mdl_smrys_ls <- reference_int %>% purrr::map(~dv_dss_mdl_smrys_ls %>% 
            purrr::pluck(.x)) %>% stats::setNames(names(dv_dss_mdl_smrys_ls)[reference_int])
    return(dv_dss_mdl_smrys_ls)
}
#' Get transfer to utility algorithm dataverse datasets
#' @description get_ttu_dv_dss() is a Get function that extracts data from an object. Specifically, this function implements an algorithm to get transfer to utility algorithm dataverse datasets. The function returns Transfer to utility algorithm dataverse datasets (a tibble).
#' @param ttu_dv_nms_chr Transfer to utility algorithm dataverse names (a character vector), Default: 'TTU'
#' @param server_1L_chr Server (a character vector of length one), Default: 'dataverse.harvard.edu'
#' @param key_1L_chr Key (a character vector of length one), Default: NULL
#' @return Transfer to utility algorithm dataverse datasets (a tibble)
#' @rdname get_ttu_dv_dss
#' @export 
#' @importFrom purrr map flatten map_dfr pluck map_chr
#' @importFrom dataverse get_dataset
#' @importFrom stats setNames
#' @importFrom tibble tibble
#' @importFrom dplyr pull mutate
#' @importFrom ready4use add_labels_from_dictionary
#' @keywords internal
get_ttu_dv_dss <- function (ttu_dv_nms_chr = "TTU", server_1L_chr = "dataverse.harvard.edu", 
    key_1L_chr = NULL) 
{
    dv_dss_mdl_smrys_ls <- ttu_dv_nms_chr %>% purrr::map(~get_ttu_ds_smrys(.x, 
        server_1L_chr = server_1L_chr, key_1L_chr = key_1L_chr)) %>% 
        purrr::flatten()
    if (length(dv_dss_mdl_smrys_ls) > 0) {
        ttu_dss_ls <- names(dv_dss_mdl_smrys_ls) %>% purrr::map(~dataverse::get_dataset(.x, 
            key = key_1L_chr, server = server_1L_chr)) %>% stats::setNames(names(dv_dss_mdl_smrys_ls))
        ttu_dv_dss_tb <- purrr::map_dfr(1:length(ttu_dss_ls), 
            ~tibble::tibble(reference_int = .x, utility_chr = ifelse((dv_dss_mdl_smrys_ls %>% 
                purrr::pluck(.x))$depnt_var_nm_1L_chr == "EQ5D_total_dbl", 
                "EQ-5D", ifelse((dv_dss_mdl_smrys_ls %>% purrr::pluck(.x))$depnt_var_nm_1L_chr == 
                  "aqol6d_total_w", "AQoL-6D", (dv_dss_mdl_smrys_ls %>% 
                  purrr::pluck(.x))$depnt_var_nm_1L_chr)), predrs_ls = list(get_predictors_lup(dv_dss_mdl_smrys_ls %>% 
                purrr::pluck(.x)) %>% dplyr::pull(long_name_chr)), 
                ds_url = names(ttu_dss_ls)[.x])) %>% dplyr::mutate(publication_url = purrr::map_chr(ds_url, 
            ~get_dv_ds_publication(.x, key_1L_chr = key_1L_chr, 
                server_1L_chr = server_1L_chr)))
        ttu_dv_dss_tb <- ready4use::add_labels_from_dictionary(ttu_dv_dss_tb, 
            dictionary_tb = tibble::tibble(var_nm_chr = names(ttu_dv_dss_tb), 
                var_desc_chr = c("ID", "Utility", "Predictors", 
                  "Dataset", "Article")))
    }
    else {
        ttu_dv_dss_tb <- NULL
    }
    return(ttu_dv_dss_tb)
}
#' Get transfer to utility algorithm dataverse predictors
#' @description get_ttu_dv_predrs() is a Get function that extracts data from an object. Specifically, this function implements an algorithm to get transfer to utility algorithm dataverse predictors. The function returns Predictors (a character vector).
#' @param ttu_dv_dss_tb Transfer to utility algorithm dataverse datasets (a tibble), Default: NULL
#' @param ttu_dv_nms_chr Transfer to utility algorithm dataverse names (a character vector), Default: 'TTU'
#' @param server_1L_chr Server (a character vector of length one), Default: 'dataverse.harvard.edu'
#' @param key_1L_chr Key (a character vector of length one), Default: NULL
#' @return Predictors (a character vector)
#' @rdname get_ttu_dv_predrs
#' @export 
#' @importFrom purrr flatten_chr
#' @keywords internal
get_ttu_dv_predrs <- function (ttu_dv_dss_tb = NULL, ttu_dv_nms_chr = "TTU", server_1L_chr = "dataverse.harvard.edu", 
    key_1L_chr = NULL) 
{
    if (is.null(ttu_dv_dss_tb)) 
        ttu_dv_dss_tb <- get_ttu_dv_dss(ttu_dv_nms_chr = ttu_dv_nms_chr, 
            server_1L_chr = server_1L_chr, key_1L_chr = NULL)
    predrs_chr <- ttu_dv_dss_tb$predrs_ls %>% purrr::flatten_chr() %>% 
        unique() %>% sort()
    return(predrs_chr)
}