Description Usage Arguments Details Value Examples
View source: R/import_sddf_country.R
Download SDDF data by round for countries from the European Social Survey
1 2 3 4 5 6 7 8 9 10 11 | import_sddf_country(country, rounds, ess_email = NULL, format = NULL)
import_all_sddf_cntrounds(country, ess_email = NULL, format = NULL)
download_sddf_country(
country,
rounds,
ess_email = NULL,
output_dir = getwd(),
format = "stata"
)
|
country |
a character of length 1 with the full name of the country.
Use |
rounds |
a numeric vector with the rounds to download. See |
ess_email |
a character vector with your email, such as "your_email@email.com".
If you haven't registered in the ESS website, create an account at
http://www.europeansocialsurvey.org/user/new. A preferred method is to login
through |
format |
the format from which to download the data. By default it is NULL for |
output_dir |
a character vector with the output directory in case you want to
only download the files using |
SDDF data (Sample Design Data Files) are data sets that contain additional columns with the sample design and weights for a given country in a given round. These additional columns are required to perform any complex weighted analysis of the ESS data. Users interested in using this data should read the description of SDDF files here and should read here for the sampling design of the country of analysis for that specific round.
Use import_sddf_country
to download the SDDF data by country into R.
import_all_sddf_cntrounds
will download all available SDDF data for a given country by
default and download_sddf_country
will download SDDF data and save them in a specified
format
in the supplied directory.
The format
argument from import_country
should not matter to the user
because the data is read into R either way. However, different formats might have
different handling of the encoding of some questions. This option was preserved
so that the user can switch between formats if any encoding errors are found in the data. For more
details see the discussion here.
Additionally, given that the SDDF data is not very complete, some countries do not have SDDF data
in Stata or SPSS formats. For that reason, the format
argument is not used in import_sddf_country
.
Internally, Stata
is chosen over SPSS
and SPSS
over SAS
in that
order of preference.
For this particular argument, 'sas' is not supported because the data formats have changed between ESS waves and separate formats require different functions to be read. To preserve parsimony and format errors between waves, the user should use 'stata' or 'spss'.
Starting from round 7 (including), the ESS switched the layout of SDDF data.
Before the rounds, SDDF data was published separately by wave-country
combination. From round 7 onwards, all SDDF data is released as a single
integrated file with all countries combined for that given round. import_sddf_country
takes care of this nuance by reading the data and filtering the chosen
country automatically. download_sddf_country
downloads the raw file but also
reads the data into memory to subset the specific country requested. This
process should be transparent to the user but beware that reading/writing the data might delete
some of it's properties such as dropping the labels or label attribute.
for import_sddf_country
if length(rounds)
is 1, it returns a tibble with
the latest version of that round. Otherwise it returns a list of length(rounds)
containing the latest version of each round. For download_sddf_country
, if
output_dir
is a valid directory, it returns the saved directories invisibly and saves
all the rounds in the chosen format
in output_dir
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 | ## Not run:
set_email("your_email@email.com")
sp_three <- import_sddf_country("Spain", 5:6)
show_sddf_cntrounds("Spain")
# Only download the files, this will return nothing
temp_dir <- tempdir()
download_sddf_country(
"Spain",
rounds = 5:6,
output_dir = temp_dir
)
# By default, download_sddf_country downloads 'stata' files but
# you can also download 'spss' or 'sas' files.
download_sddf_country(
"Spain",
rounds = 1:8,
output_dir = temp_dir,
format = 'spss'
)
## End(Not run)
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.