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 )
| 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,
|
The function returns downloaded files.
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