| Title: | Reproducible Data Retrieval from the GESIS Data Archive |
|---|---|
| Description: | Reproducible, programmatic retrieval of datasets from the GESIS Data Archive. The GESIS Data Archive <https://search.gesis.org> makes available thousands of invaluable datasets, but researchers using these datasets are caught in a bind. The archive's terms and conditions bar dissemination of downloaded datasets to third parties, but to ensure that one's work can be reproduced, assessed, and built upon by others, one must provide access to the raw data one has employed. The 'gesisdata' package cuts this knot by providing registered users with programmatic, reproducible access to GESIS datasets from within 'R'. |
| Authors: | Frederick Solt [aut, cre, cph], Dave Peterson [ctb] |
| Maintainer: | Frederick Solt <[email protected]> |
| License: | MIT + file LICENSE |
| Version: | 0.1.2 |
| Built: | 2025-01-23 03:09:59 UTC |
| Source: | https://github.com/fsolt/gesisdata |
gesis_download provides a programmatic and reproducible means to download datasets
from the GESIS data archive
gesis_download( file_id, email = getOption("gesis_email"), password = getOption("gesis_password"), use = getOption("gesis_use"), reset = FALSE, download_dir = "gesis_data", msg = TRUE, convert = TRUE, delay = 5 )gesis_download( file_id, email = getOption("gesis_email"), password = getOption("gesis_password"), use = getOption("gesis_use"), reset = FALSE, download_dir = "gesis_data", msg = TRUE, convert = TRUE, delay = 5 )
file_id |
The unique identifier (or optionally a vector of these identifiers). for the dataset(s) to be downloaded (see details). |
email, password
|
Your GESIS email and password (see details). |
use |
The number of a 'use of data' (see details). |
reset |
If TRUE, you will be asked to re-enter your username, password, and use. |
download_dir |
The directory (relative to your working directory) to which files from the GESIS data archive will be downloaded. |
msg |
If TRUE, outputs a message showing which data set is being downloaded. |
convert |
If TRUE, converts downloaded file(s) to .RData format. |
delay |
If the speed of your connection to the GESIS data archive is particularly slow,
|
To avoid requiring others to edit your scripts to insert their own email,
password, and use or to force them to do so interactively, the default is set to fetch
this information from the user's .Rprofile. Before running gesis_download,
then, you should be sure to add these options to your .Rprofile substituting your
info for the example below:
options("gesis_email" = "[email protected]",
"gesis_password" = "password123!",
"gesis_use" = 5)
In addition to accepting the terms of use, you need to input a purpose for
downloading a data set. The options are as follows:
1. for final thesis of the study programme (e.g. Bachelor/Master thesis) 2. for reserach with a commercial mission 3. for non-scientific purposes 4. for further education and qualification 5. for scientific research (incl. doctorate) 6. in the course of my studies 7. in a course as lecturer
The function returns downloaded files.
## Not run: gesis_download(file_id = c("ZA6644", "ZA6900"), download_dir = tempdir()) # remember to specify a directory for your download ## End(Not run)## Not run: gesis_download(file_id = c("ZA6644", "ZA6900"), download_dir = tempdir()) # remember to specify a directory for your download ## End(Not run)