cto_dataset_download: Download SurveyCTO Server Datasets

In ctoclient: A Modern and Flexible Data Pipeline for 'SurveyCTO'

Download SurveyCTO Server Datasets

Description

Downloads one or more datasets from a SurveyCTO server to a local directory as CSV files.

Usage

cto_dataset_download(id = NULL, dir = getwd(), overwrite = FALSE)

Arguments

id	A character vector of dataset IDs to download. If NULL (the default), the function queries the server for a list of all available datasets and downloads them all.
dir	A string specifying the directory where CSV files will be saved. Defaults to the current working directory.
overwrite	Logical. If TRUE, existing files in dir will be overwritten. If FALSE (the default), existing files are skipped to conserve bandwidth.

Details

• Smart Downloading: If overwrite = FALSE, the function checks if the target file already exists in dir and skips the download.

• Error Handling: If a specific dataset fails to download, a warning is printed with the dataset name, but the function continues processing the remaining list.

Value

(Invisibly) A character vector of file paths to the successfully downloaded CSVs. Returns NULL if no datasets were found.

See Also

Other Dataset Management Functions: cto_dataset_create(), cto_dataset_delete(), cto_dataset_info(), cto_dataset_list()

Examples

## Not run: 
# --- Example 1: Download a specific dataset ---
paths <- cto_dataset_download(id = "household_data", dir = tempdir())
df <- read.csv(paths[1])

# --- Example 2: Download all datasets, skip existing files ---
paths <- cto_dataset_download(dir = "my_data_folder", overwrite = FALSE)

## End(Not run)

ctoclient documentation built on March 28, 2026, 5:07 p.m.