gdcdata: Download GDC files
In GenomicDataCommons: NIH / NCI Genomic Data Commons Access

Description Usage Arguments Details Value See Also Examples

Download one or more files from GDC. Files are downloaded using the UUID and renamed to the file name on the remote system. By default, neither the uuid nor the file name on the remote system can exist.

1 2	gdcdata(uuids, use_cached = TRUE, progress = interactive(), token = NULL, access_method = "api", transfer_args = character())

`uuids`	character() of GDC file UUIDs.
`use_cached`	logical(1) default TRUE indicating that, if found in the cache, the file will not be downloaded again. If FALSE, all supplied uuids will be re-downloaded.
`progress`	logical(1) default TRUE in interactive sessions, FALSE otherwise indicating whether a progress par should be produced for each file download.
`token`	(optional) character(1) security token allowing access to restricted data. See https://gdc-docs.nci.nih.gov/API/Users_Guide/Authentication_and_Authorization/.
`access_method`	character(1), either 'api' or 'client'. See details.
`transfer_args`	character(1), additional arguments to pass to the gdc-client command line. See `gdc_client` and `transfer_help` for details.

This function is appropriate for one or several files; for large downloads use manifest to create a manifest for and the GDC Data Transfer Tool.

When access_method is "api", the GDC "data" endpoint is the transfer mechanism used. The alternative access_method, "client", will utilize the gdc-client transfer tool, which must be downloaded separately and available. See gdc_client for details on specifying the location of the gdc-client executable.

a named vector with file uuids as the names and paths as the value

manifest for downloading large data.

# get some example file uuids
uuids <- files() %>%
    filter(~ access == 'open' & file_size < 100000) %>%
    results(size = 3) %>%
    ids()

# and get the data, placing it into the gdc_cache() directory
fpaths <- gdcdata(uuids, use_cached=TRUE)

fpaths