{"id":32203833,"url":"https://github.com/ropensci/essurvey","last_synced_at":"2026-02-24T04:03:47.687Z","repository":{"id":44886274,"uuid":"107533645","full_name":"ropensci/essurvey","owner":"ropensci","description":"Download data from the European Social Survey","archived":false,"fork":false,"pushed_at":"2022-01-10T11:15:48.000Z","size":37189,"stargazers_count":51,"open_issues_count":16,"forks_count":9,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-12-09T18:28:21.758Z","etag":null,"topics":["ess","r","r-package","rstats"],"latest_commit_sha":null,"homepage":"https://docs.ropensci.org/essurvey","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ropensci.png","metadata":{"files":{"readme":"README.Rmd","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-10-19T10:45:28.000Z","updated_at":"2025-12-08T16:30:33.000Z","dependencies_parsed_at":"2022-09-11T02:20:31.346Z","dependency_job_id":null,"html_url":"https://github.com/ropensci/essurvey","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/ropensci/essurvey","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Fessurvey","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Fessurvey/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Fessurvey/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Fessurvey/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ropensci","download_url":"https://codeload.github.com/ropensci/essurvey/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Fessurvey/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29771057,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-24T04:01:02.180Z","status":"ssl_error","status_checked_at":"2026-02-24T03:59:49.901Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ess","r","r-package","rstats"],"created_at":"2025-10-22T04:46:25.829Z","updated_at":"2026-02-24T04:03:47.682Z","avatar_url":"https://github.com/ropensci.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\r\noutput:\r\n  github_document:\r\n    html_preview: false\r\n---\r\n```{r, echo = FALSE}\r\nknitr::opts_chunk$set(\r\n  collapse = TRUE,\r\n  comment = \"#\u003e\",\r\n  fig.path = \"README-\",\r\n  eval = FALSE\r\n)\r\noptions(tibble.print_min = 5, tibble.print_max = 5)\r\n```\r\n\r\n## essurvey \u003cimg src=\"man/figures/ess_logo.png\" align=\"right\" /\u003e\r\n\r\n[![CRAN_Status_Badge](http://www.r-pkg.org/badges/version/essurvey)](https://cran.r-project.org/package=essurvey)\r\n[![R build status](https://github.com/ropensci/essurvey/workflows/R-CMD-check/badge.svg)](https://github.com/ropensci/essurvey/actions)\r\n[![Coverage status](https://codecov.io/gh/ropensci/essurvey/branch/master/graph/badge.svg)](https://codecov.io/github/ropensci/essurvey?branch=master)\r\n[![rOpensci_Badge](https://badges.ropensci.org/201_status.svg)](https://github.com/ropensci/software-review/issues/201)\r\n\r\n\r\n## Description\r\n\r\nThe European Social Survey (ESS) is an academically driven cross-national survey that has been conducted across Europe since its establishment in 2001. Every two years, face-to-face interviews are conducted with newly selected, cross-sectional samples. The survey measures the attitudes, beliefs and behavior patterns of diverse populations in more than thirty nations. Taken from the [ESS website](http://www.europeansocialsurvey.org/about/).\r\n\r\nNote: The `essurvey` package was originally called `ess`. Since `essurvey 1.0.0` all `ess_*` functions have been deprecated in favor of the `import_*` and `download_*` functions. Also, versions less than and including `essurvey 1.0.1` returned wrong countries. Please install the latest CRAN/Github version.\r\n\r\nThe `essurvey` package is designed to download the ESS data as easily as possible. It has a few helper functions to download rounds (a term synonym to waves to denote the same survey in different time points), rounds for a selected country and to show which rounds/countries are available. Check out the vignette and other documentation in the [package's website](https://docs.ropensci.org/essurvey/) for more detailed examples of the `essurvey` package.\r\n\r\n## Installation\r\n\r\nYou can install and load the development version with these commands:\r\n\r\n```{r}\r\n# install.packages(\"devtools\") in case you don't have it\r\ndevtools::install_github(\"ropensci/essurvey\")\r\n```\r\n\r\nor the stable version with:\r\n\r\n```{r}\r\ninstall.packages(\"essurvey\")\r\n```\r\n\r\n## Usage\r\n\r\nFirst, you need to register at the ESS website, in case you haven't. Please visit the [register](http://www.europeansocialsurvey.org/user/new) section from the ESS website. If your email is not registered at their website, an error will be raised prompting you to go register.\r\n\r\nSet your valid email as en environment variable.\r\n\r\n```{r}\r\nset_email(\"your@email.com\")\r\n```\r\n\r\nTo explore which rounds/countries are present in the ESS use the `show_*()` family of functions.\r\n\r\n```{r, eval = TRUE}\r\nlibrary(essurvey)\r\nshow_countries()\r\n```\r\n\r\nTo download the first round to use in R:\r\n\r\n```{r}\r\none_round \u003c- import_rounds(1)\r\n```\r\n\r\nThis will return a data frame containing the first round. Typically, the European Social Survey data files comes with a script that recodes missing values to `NA` for different programs (Stata, SPSS, SAS).\r\n\r\nUse `recode_missings` to recode all values automatically.\r\n\r\n```{r}\r\nlibrary(tidyverse)\r\n\r\none_round \u003c-\r\n  import_rounds(1) %\u003e%\r\n  recode_missings()\r\n```\r\n\r\nSee the package vignette for greater detail or see the help page with `?recode_missings`. You can also download several rounds by supplying the number of rounds.\r\n\r\n```{r}\r\nfive_rounds \u003c- import_rounds(1:5)\r\n```\r\n\r\nThis will download all latest versions of rounds 1 through 5 and return a list of length 5 with each round as a data frame inside the list. \r\n\r\nYou can check the available rounds with `show_rounds()` because if you supply a non existent round, the function will return an error.\r\n\r\n```{r}\r\ntwo_rounds \u003c- import_rounds(c(1, 22))\r\n#\u003e Error in round_url(rounds) : \r\n#\u003e ESS round 22 is not a available. Check show_rounds() \r\n```\r\n\r\nAlternatively, you can download all available rounds with `import_all_rounds()`.\r\n\r\nYou can also download rounds by country:\r\n\r\n```{r}\r\ndk_two \u003c- import_country(\"Denmark\", 1:2)\r\n```\r\n\r\nUse `show_countries()` to see available countries and `show_country_rounds(\"Denmark\")` to see available rounds for chosen country. Alternatively, use `import_all_cntrounds()` to download all available rounds of a country.\r\n\r\nYou should be be aware that data from the ESS survey should by analyzed by taking into consideration the sampling and weights of the survey. A useful example comes from the work of Anthony Damico and Daniel Oberski [here](http://asdfree.com/european-social-survey-ess.html).\r\n\r\n## Stata, SPSS and SAS users\r\n\r\nI'm quite aware that most ESS users don't know R, that is why the package also allows to download the data in Stata, SPSS or SAS format with just one line of code. Instead of the `import_*` functions, use the `download_*` functions.\r\n```{r}\r\ndownload_rounds(c(1, 2),\r\n                output_dir = \"my/new/directory\",\r\n                format = 'spss')\r\n```\r\n\r\nThis will save the ESS rounds into separate folders and unzip them in the specified directory (if you want to know your current directory, type `getwd()`). This works the same way for `download_country()`. Be aware that if you download the files manually you should read them into R with the `haven` package for all `essurvey` related functions to work.\r\n\r\n---\r\n\r\nPlease note that this project is released with a [Contributor Code of Conduct](https://docs.ropensci.org/essurvey/CONDUCT.html). By participating in this project you agree to abide by its terms.\r\n\r\n[![ropensci_footer](https://ropensci.org/public_images/ropensci_footer.png)](https://ropensci.org)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fropensci%2Fessurvey","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fropensci%2Fessurvey","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fropensci%2Fessurvey/lists"}