17 |
18 | [](https://cran.r-project.org/package=essurvey)
19 | [](https://github.com/ropensci/essurvey/actions)
20 | [](https://codecov.io/github/ropensci/essurvey?branch=master)
21 | [](https://github.com/ropensci/software-review/issues/201)
22 |
23 |
24 | ## Description
25 |
26 | The 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/).
27 |
28 | Note: 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.
29 |
30 | The `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.
31 |
32 | ## Installation
33 |
34 | You can install and load the development version with these commands:
35 |
36 | ```{r}
37 | # install.packages("devtools") in case you don't have it
38 | devtools::install_github("ropensci/essurvey")
39 | ```
40 |
41 | or the stable version with:
42 |
43 | ```{r}
44 | install.packages("essurvey")
45 | ```
46 |
47 | ## Usage
48 |
49 | First, 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.
50 |
51 | Set your valid email as en environment variable.
52 |
53 | ```{r}
54 | set_email("your@email.com")
55 | ```
56 |
57 | To explore which rounds/countries are present in the ESS use the `show_*()` family of functions.
58 |
59 | ```{r, eval = TRUE}
60 | library(essurvey)
61 | show_countries()
62 | ```
63 |
64 | To download the first round to use in R:
65 |
66 | ```{r}
67 | one_round <- import_rounds(1)
68 | ```
69 |
70 | This 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).
71 |
72 | Use `recode_missings` to recode all values automatically.
73 |
74 | ```{r}
75 | library(tidyverse)
76 |
77 | one_round <-
78 | import_rounds(1) %>%
79 | recode_missings()
80 | ```
81 |
82 | See 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.
83 |
84 | ```{r}
85 | five_rounds <- import_rounds(1:5)
86 | ```
87 |
88 | This 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.
89 |
90 | You can check the available rounds with `show_rounds()` because if you supply a non existent round, the function will return an error.
91 |
92 | ```{r}
93 | two_rounds <- import_rounds(c(1, 22))
94 | #> Error in round_url(rounds) :
95 | #> ESS round 22 is not a available. Check show_rounds()
96 | ```
97 |
98 | Alternatively, you can download all available rounds with `import_all_rounds()`.
99 |
100 | You can also download rounds by country:
101 |
102 | ```{r}
103 | dk_two <- import_country("Denmark", 1:2)
104 | ```
105 |
106 | Use `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.
107 |
108 | You 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).
109 |
110 | ## Stata, SPSS and SAS users
111 |
112 | I'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.
113 | ```{r}
114 | download_rounds(c(1, 2),
115 | output_dir = "my/new/directory",
116 | format = 'spss')
117 | ```
118 |
119 | This 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.
120 |
121 | ---
122 |
123 | Please 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.
124 |
125 | [](https://ropensci.org)
126 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 |
2 | ## essurvey
3 |
4 | [](https://cran.r-project.org/package=essurvey)
5 | [](https://github.com/ropensci/essurvey/actions)
7 | [](https://codecov.io/github/ropensci/essurvey?branch=master)
9 | [](https://github.com/ropensci/software-review/issues/201)
10 |
11 | ## Description
12 |
13 | The European Social Survey (ESS) is an academically driven
14 | cross-national survey that has been conducted across Europe since its
15 | establishment in 2001. Every two years, face-to-face interviews are
16 | conducted with newly selected, cross-sectional samples. The survey
17 | measures the attitudes, beliefs and behavior patterns of diverse
18 | populations in more than thirty nations. Taken from the [ESS
19 | website](http://www.europeansocialsurvey.org/about/).
20 |
21 | Note: The `essurvey` package was originally called `ess`. Since
22 | `essurvey 1.0.0` all `ess_*` functions have been deprecated in favor of
23 | the `import_*` and `download_*` functions. Also, versions less than and
24 | including `essurvey 1.0.1` returned wrong countries. Please install the
25 | latest CRAN/Github version.
26 |
27 | The `essurvey` package is designed to download the ESS data as easily as
28 | possible. It has a few helper functions to download rounds (a term
29 | synonym to waves to denote the same survey in different time points),
30 | rounds for a selected country and to show which rounds/countries are
31 | available. Check out the vignette and other documentation in the
32 | [package’s website](https://docs.ropensci.org/essurvey/) for more
33 | detailed examples of the `essurvey` package.
34 |
35 | ## Installation
36 |
37 | You can install and load the development version with these commands:
38 |
39 | ``` r
40 | # install.packages("devtools") in case you don't have it
41 | devtools::install_github("ropensci/essurvey")
42 | ```
43 |
44 | or the stable version with:
45 |
46 | ``` r
47 | install.packages("essurvey")
48 | ```
49 |
50 | ## Usage
51 |
52 | First, you need to register at the ESS website, in case you haven’t.
53 | Please visit the
54 | [register](http://www.europeansocialsurvey.org/user/new) section from
55 | the ESS website. If your email is not registered at their website, an
56 | error will be raised prompting you to go register.
57 |
58 | Set your valid email as en environment variable.
59 |
60 | ``` r
61 | set_email("your@email.com")
62 | ```
63 |
64 | To explore which rounds/countries are present in the ESS use the
65 | `show_*()` family of functions.
66 |
67 | ``` r
68 | library(essurvey)
69 | show_countries()
70 | #> [1] "Albania" "Austria" "Belgium"
71 | #> [4] "Bulgaria" "Croatia" "Cyprus"
72 | #> [7] "Czechia" "Denmark" "Estonia"
73 | #> [10] "Finland" "France" "Germany"
74 | #> [13] "Greece" "Hungary" "Iceland"
75 | #> [16] "Ireland" "Israel" "Italy"
76 | #> [19] "Kosovo" "Latvia" "Lithuania"
77 | #> [22] "Luxembourg" "Montenegro" "Netherlands"
78 | #> [25] "Norway" "Poland" "Portugal"
79 | #> [28] "Romania" "Russian Federation" "Serbia"
80 | #> [31] "Slovakia" "Slovenia" "Spain"
81 | #> [34] "Sweden" "Switzerland" "Turkey"
82 | #> [37] "Ukraine" "United Kingdom"
83 | ```
84 |
85 | To download the first round to use in R:
86 |
87 | ``` r
88 | one_round <- import_rounds(1)
89 | ```
90 |
91 | This will return a data frame containing the first round. Typically, the
92 | European Social Survey data files comes with a script that recodes
93 | missing values to `NA` for different programs (Stata, SPSS, SAS).
94 |
95 | Use `recode_missings` to recode all values automatically.
96 |
97 | ``` r
98 | library(tidyverse)
99 |
100 | one_round <-
101 | import_rounds(1) %>%
102 | recode_missings()
103 | ```
104 |
105 | See the package vignette for greater detail or see the help page with
106 | `?recode_missings`. You can also download several rounds by supplying
107 | the number of rounds.
108 |
109 | ``` r
110 | five_rounds <- import_rounds(1:5)
111 | ```
112 |
113 | This will download all latest versions of rounds 1 through 5 and return
114 | a list of length 5 with each round as a data frame inside the list.
115 |
116 | You can check the available rounds with `show_rounds()` because if you
117 | supply a non existent round, the function will return an error.
118 |
119 | ``` r
120 | two_rounds <- import_rounds(c(1, 22))
121 | #> Error in round_url(rounds) :
122 | #> ESS round 22 is not a available. Check show_rounds()
123 | ```
124 |
125 | Alternatively, you can download all available rounds with
126 | `import_all_rounds()`.
127 |
128 | You can also download rounds by country:
129 |
130 | ``` r
131 | dk_two <- import_country("Denmark", 1:2)
132 | ```
133 |
134 | Use `show_countries()` to see available countries and
135 | `show_country_rounds("Denmark")` to see available rounds for chosen
136 | country. Alternatively, use `import_all_cntrounds()` to download all
137 | available rounds of a country.
138 |
139 | You should be be aware that data from the ESS survey should by analyzed
140 | by taking into consideration the sampling and weights of the survey. A
141 | useful example comes from the work of Anthony Damico and Daniel Oberski
142 | [here](http://asdfree.com/european-social-survey-ess.html).
143 |
144 | ## Stata, SPSS and SAS users
145 |
146 | I’m quite aware that most ESS users don’t know R, that is why the
147 | package also allows to download the data in Stata, SPSS or SAS format
148 | with just one line of code. Instead of the `import_*` functions, use the
149 | `download_*` functions.
150 |
151 | ``` r
152 | download_rounds(c(1, 2),
153 | output_dir = "my/new/directory",
154 | format = 'spss')
155 | ```
156 |
157 | This will save the ESS rounds into separate folders and unzip them in
158 | the specified directory (if you want to know your current directory,
159 | type `getwd()`). This works the same way for `download_country()`. Be
160 | aware that if you download the files manually you should read them into
161 | R with the `haven` package for all `essurvey` related functions to work.
162 |
163 | -----
164 |
165 | Please note that this project is released with a [Contributor Code of
166 | Conduct](https://docs.ropensci.org/essurvey/CONDUCT.html). By
167 | participating in this project you agree to abide by its terms.
168 |
169 | [](https://ropensci.org)
170 |
--------------------------------------------------------------------------------
/appveyor.yml:
--------------------------------------------------------------------------------
1 | # DO NOT CHANGE the "init" and "install" sections below
2 |
3 | # Download script file from GitHub
4 | init:
5 | ps: |
6 | $ErrorActionPreference = "Stop"
7 | Invoke-WebRequest http://raw.github.com/krlmlr/r-appveyor/master/scripts/appveyor-tool.ps1 -OutFile "..\appveyor-tool.ps1"
8 | Import-Module '..\appveyor-tool.ps1'
9 |
10 | install:
11 | ps: Bootstrap
12 |
13 | cache:
14 | - C:\RLibrary
15 |
16 | # Adapt as necessary starting from here
17 |
18 | environment:
19 | PKGTYPE: win.binary
20 | NOT_CRAN: true
21 |
22 | build_script:
23 | - travis-tool.sh install_deps
24 |
25 | test_script:
26 | - travis-tool.sh run_tests
27 |
28 | on_failure:
29 | - 7z a failure.zip *.Rcheck\*
30 | - appveyor PushArtifact failure.zip
31 |
32 | artifacts:
33 | - path: '*.Rcheck\**\*.log'
34 | name: Logs
35 |
36 | - path: '*.Rcheck\**\*.out'
37 | name: Logs
38 |
39 | - path: '*.Rcheck\**\*.fail'
40 | name: Logs
41 |
42 | - path: '*.Rcheck\**\*.Rout'
43 | name: Logs
44 |
45 | - path: '\*_*.tar.gz'
46 | name: Bits
47 |
48 | - path: '\*_*.zip'
49 | name: Bits
50 |
--------------------------------------------------------------------------------
/codecov.yml:
--------------------------------------------------------------------------------
1 | comment: false
2 |
3 | coverage:
4 | status:
5 | project:
6 | default:
7 | target: auto
8 | threshold: 1%
9 | patch:
10 | default:
11 | target: auto
12 | threshold: 1%
13 |
--------------------------------------------------------------------------------
/cran-comments.md:
--------------------------------------------------------------------------------
1 | ## Test environments
2 | - local Ubuntu 20.0.0 LTS, 4.0.3
3 | - Windows Server 2019 (r-release)
4 | - Mac OS X (r-release)
5 | - Ubuntu 20.04.2 (r-release)
6 | - Ubuntu 20.04.2 (r-devel)
7 |
8 |
9 | ## R CMD check results
10 |
11 | - - 0 errors ✔ | 0 warnings ✔ | 0 notes ✔
12 |
13 | ## Reverse dependencies
14 |
15 | There are currently no downstream dependencies for this package.
16 |
17 | ---
18 |
19 | Fixed bugs from the library. Standard patch release.
20 |
21 | - All tests are run weekly on Github Actions, which are available at https://github.com/ropensci/essurvey/action
22 |
--------------------------------------------------------------------------------
/docs/404.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
24 |
73 |
74 |
75 |
76 |
77 |
108 |
109 |
110 |
111 |
112 |
113 |
114 |
115 |
116 |
--------------------------------------------------------------------------------
/docs/CONDUCT.html:
--------------------------------------------------------------------------------
1 |
2 |
78 |
93 |
94 |
95 |
96 |
107 |
79 |
86 |
87 |
91 |
92 |
80 |
82 |
83 | Content not found. Please use links in the navbar.
84 |
85 | Page not found (404)
81 |
9 |
50 |
51 |
52 |
53 |
88 |
89 |
90 |
91 |
92 |
93 |
94 |
95 |
96 |
--------------------------------------------------------------------------------
/docs/LICENSE-text.html:
--------------------------------------------------------------------------------
1 |
2 |
54 |
76 |
77 |
78 |
79 |
55 |
70 |
71 |
74 |
75 |
56 |
58 |
59 | Contributor Code of Conduct
57 |
60 |
61 |
68 |
69 | As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
62 |We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.
63 |Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
64 |Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
65 |Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
66 |This Code of Conduct is adapted from the Contributor Covenant (http:contributor-covenant.org), version 1.0.0, available at http://contributor-covenant.org/version/1/0/0/
67 |
9 |
50 |
51 |
52 |
53 |
82 |
83 |
84 |
85 |
86 |
87 |
88 |
89 |
90 |
--------------------------------------------------------------------------------
/docs/LICENSE.html:
--------------------------------------------------------------------------------
1 |
2 |
54 |
70 |
71 |
72 |
73 |
55 |
64 |
65 |
68 |
69 |
56 |
58 |
59 | License
57 |YEAR: 2018 60 | COPYRIGHT HOLDER: Jorge Cimentada 61 |62 | 63 |
9 |
50 |
51 |
52 |
53 |
86 |
87 |
88 |
89 |
90 |
91 |
92 |
93 |
94 |
--------------------------------------------------------------------------------
/docs/articles/index.html:
--------------------------------------------------------------------------------
1 |
2 |
54 |
74 |
75 |
76 |
77 |
55 |
68 |
69 |
72 |
73 |
56 |
58 |
59 | MIT License
57 |
60 |
61 |
66 |
67 | Copyright (c) 2018 Jorge Cimentada
62 |Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
63 |The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
64 |THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
65 |
9 |
50 |
51 |
52 |
53 |
79 |
80 |
81 |
82 |
83 |
84 |
85 |
86 |
87 |
--------------------------------------------------------------------------------
/docs/authors.html:
--------------------------------------------------------------------------------
1 |
2 |
54 |
68 |
69 |
70 |
55 |
67 |
56 |
58 |
59 | Articles
57 |
60 |
66 | All vignettes
61 | 62 | 63 |- Introduction to the essurvey package 64 |
- 65 |
`, then ``, etc.) that has more than one element. Defaults to 1 (for ``).
76 | getTopLevel: function($scope) {
77 | for (var i = 1; i <= 6; i++) {
78 | var $headings = this.findOrFilter($scope, 'h' + i);
79 | if ($headings.length > 1) {
80 | return i;
81 | }
82 | }
83 |
84 | return 1;
85 | },
86 |
87 | // returns the elements for the top level, and the next below it
88 | getHeadings: function($scope, topLevel) {
89 | var topSelector = 'h' + topLevel;
90 |
91 | var secondaryLevel = topLevel + 1;
92 | var secondarySelector = 'h' + secondaryLevel;
93 |
94 | return this.findOrFilter($scope, topSelector + ',' + secondarySelector);
95 | },
96 |
97 | getNavLevel: function(el) {
98 | return parseInt(el.tagName.charAt(1), 10);
99 | },
100 |
101 | populateNav: function($topContext, topLevel, $headings) {
102 | var $context = $topContext;
103 | var $prevNav;
104 |
105 | var helpers = this;
106 | $headings.each(function(i, el) {
107 | var $newNav = helpers.generateNavItem(el);
108 | var navLevel = helpers.getNavLevel(el);
109 |
110 | // determine the proper $context
111 | if (navLevel === topLevel) {
112 | // use top level
113 | $context = $topContext;
114 | } else if ($prevNav && $context === $topContext) {
115 | // create a new level of the tree and switch to it
116 | $context = helpers.createChildNavList($prevNav);
117 | } // else use the current $context
118 |
119 | $context.append($newNav);
120 |
121 | $prevNav = $newNav;
122 | });
123 | },
124 |
125 | parseOps: function(arg) {
126 | var opts;
127 | if (arg.jquery) {
128 | opts = {
129 | $nav: arg
130 | };
131 | } else {
132 | opts = arg;
133 | }
134 | opts.$scope = opts.$scope || $(document.body);
135 | return opts;
136 | }
137 | },
138 |
139 | // accepts a jQuery object, or an options object
140 | init: function(opts) {
141 | opts = this.helpers.parseOps(opts);
142 |
143 | // ensure that the data attribute is in place for styling
144 | opts.$nav.attr('data-toggle', 'toc');
145 |
146 | var $topContext = this.helpers.createChildNavList(opts.$nav);
147 | var topLevel = this.helpers.getTopLevel(opts.$scope);
148 | var $headings = this.helpers.getHeadings(opts.$scope, topLevel);
149 | this.helpers.populateNav($topContext, topLevel, $headings);
150 | }
151 | };
152 |
153 | $(function() {
154 | $('nav[data-toggle="toc"]').each(function(i, el) {
155 | var $nav = $(el);
156 | Toc.init($nav);
157 | });
158 | });
159 | })();
160 |
--------------------------------------------------------------------------------
/docs/cran-comments.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 | cran-comments.md • ess
10 |
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
23 |
24 |
25 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
38 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
94 |
95 |
96 |
97 |
98 |
99 |
100 |
101 | cran-comments.md
102 |
103 |
104 |
105 |
106 |
107 | Test environments
108 |
109 | - local macOS High Sierra 10.13.3, R-3.4.3
110 | - Ubuntu 14.04.5 LTS (on travis-ci), R-3.4.3
111 | - win-builder
112 |
113 |
114 |
115 |
116 | R CMD check results
117 | 0 errors | 0 warnings | 0 notes
118 | For win-builder:
119 | Status: 1 NOTE R Under development (unstable) (2018-02-19 r74276)
120 |
121 |
122 |
123 | Reverse dependencies
124 | There are currently no downstream dependencies for this package.
125 |
126 |
127 | -
128 | Most examples are wrapped in \dontrun{} because they cannot be run in < 5 seconds. No smaller toy examples can be created. Functions which can be executed in < 5 are allow to run.
129 |
130 | Also, most functions use personal emails to actually run. Even if using \dontshow{} I wouldn’t want to reveal any information (either on Github or somewhere on the CRAN repo) of personal use.
131 |
132 | - The tests are wrapped skip_on_cran() since they absolutely require using a private email. Full tests are run on Travis (weekly) with results available for review: https://travis-ci.org/cimentadaj/ess
133 |
134 |
135 | The Travis tests have an environment variable containing the email. This allows the tests to run smoothly.
136 |
137 |
138 |
139 |
140 |
141 |
142 |
143 |
144 |
154 |
155 |
156 |
157 |
158 |
--------------------------------------------------------------------------------
/docs/docsearch.js:
--------------------------------------------------------------------------------
1 | $(function() {
2 |
3 | // register a handler to move the focus to the search bar
4 | // upon pressing shift + "/" (i.e. "?")
5 | $(document).on('keydown', function(e) {
6 | if (e.shiftKey && e.keyCode == 191) {
7 | e.preventDefault();
8 | $("#search-input").focus();
9 | }
10 | });
11 |
12 | $(document).ready(function() {
13 | // do keyword highlighting
14 | /* modified from https://jsfiddle.net/julmot/bL6bb5oo/ */
15 | var mark = function() {
16 |
17 | var referrer = document.URL ;
18 | var paramKey = "q" ;
19 |
20 | if (referrer.indexOf("?") !== -1) {
21 | var qs = referrer.substr(referrer.indexOf('?') + 1);
22 | var qs_noanchor = qs.split('#')[0];
23 | var qsa = qs_noanchor.split('&');
24 | var keyword = "";
25 |
26 | for (var i = 0; i < qsa.length; i++) {
27 | var currentParam = qsa[i].split('=');
28 |
29 | if (currentParam.length !== 2) {
30 | continue;
31 | }
32 |
33 | if (currentParam[0] == paramKey) {
34 | keyword = decodeURIComponent(currentParam[1].replace(/\+/g, "%20"));
35 | }
36 | }
37 |
38 | if (keyword !== "") {
39 | $(".contents").unmark({
40 | done: function() {
41 | $(".contents").mark(keyword);
42 | }
43 | });
44 | }
45 | }
46 | };
47 |
48 | mark();
49 | });
50 | });
51 |
52 | /* Search term highlighting ------------------------------*/
53 |
54 | function matchedWords(hit) {
55 | var words = [];
56 |
57 | var hierarchy = hit._highlightResult.hierarchy;
58 | // loop to fetch from lvl0, lvl1, etc.
59 | for (var idx in hierarchy) {
60 | words = words.concat(hierarchy[idx].matchedWords);
61 | }
62 |
63 | var content = hit._highlightResult.content;
64 | if (content) {
65 | words = words.concat(content.matchedWords);
66 | }
67 |
68 | // return unique words
69 | var words_uniq = [...new Set(words)];
70 | return words_uniq;
71 | }
72 |
73 | function updateHitURL(hit) {
74 |
75 | var words = matchedWords(hit);
76 | var url = "";
77 |
78 | if (hit.anchor) {
79 | url = hit.url_without_anchor + '?q=' + escape(words.join(" ")) + '#' + hit.anchor;
80 | } else {
81 | url = hit.url + '?q=' + escape(words.join(" "));
82 | }
83 |
84 | return url;
85 | }
86 |
--------------------------------------------------------------------------------
/docs/issue_template.html:
--------------------------------------------------------------------------------
1 |
2 | NA • essurvey
6 |
7 |
8 |
9 |
50 |
51 |
52 |
53 |
54 |
55 |
56 | NA
57 |
58 |
59 |
60 |
65 |
70 |
79 |
84 |
89 |
93 |
94 |
95 |
96 |
97 |
100 |
101 |
102 |
103 |
104 |
105 |
114 |
115 |
116 |
117 |
118 |
119 |
120 |
121 |
122 |
--------------------------------------------------------------------------------
/docs/jquery.sticky-kit.min.js:
--------------------------------------------------------------------------------
1 | /*
2 | Sticky-kit v1.1.2 | WTFPL | Leaf Corcoran 2015 | http://leafo.net
3 | */
4 | (function(){var b,f;b=this.jQuery||window.jQuery;f=b(window);b.fn.stick_in_parent=function(d){var A,w,J,n,B,K,p,q,k,E,t;null==d&&(d={});t=d.sticky_class;B=d.inner_scrolling;E=d.recalc_every;k=d.parent;q=d.offset_top;p=d.spacer;w=d.bottoming;null==q&&(q=0);null==k&&(k=void 0);null==B&&(B=!0);null==t&&(t="is_stuck");A=b(document);null==w&&(w=!0);J=function(a,d,n,C,F,u,r,G){var v,H,m,D,I,c,g,x,y,z,h,l;if(!a.data("sticky_kit")){a.data("sticky_kit",!0);I=A.height();g=a.parent();null!=k&&(g=g.closest(k));
5 | if(!g.length)throw"failed to find stick parent";v=m=!1;(h=null!=p?p&&a.closest(p):b(""))&&h.css("position",a.css("position"));x=function(){var c,f,e;if(!G&&(I=A.height(),c=parseInt(g.css("border-top-width"),10),f=parseInt(g.css("padding-top"),10),d=parseInt(g.css("padding-bottom"),10),n=g.offset().top+c+f,C=g.height(),m&&(v=m=!1,null==p&&(a.insertAfter(h),h.detach()),a.css({position:"",top:"",width:"",bottom:""}).removeClass(t),e=!0),F=a.offset().top-(parseInt(a.css("margin-top"),10)||0)-q,
6 | u=a.outerHeight(!0),r=a.css("float"),h&&h.css({width:a.outerWidth(!0),height:u,display:a.css("display"),"vertical-align":a.css("vertical-align"),"float":r}),e))return l()};x();if(u!==C)return D=void 0,c=q,z=E,l=function(){var b,l,e,k;if(!G&&(e=!1,null!=z&&(--z,0>=z&&(z=E,x(),e=!0)),e||A.height()===I||x(),e=f.scrollTop(),null!=D&&(l=e-D),D=e,m?(w&&(k=e+u+c>C+n,v&&!k&&(v=!1,a.css({position:"fixed",bottom:"",top:c}).trigger("sticky_kit:unbottom"))),eb&&!v&&(c-=l,c=Math.max(b-u,c),c=Math.min(q,c),m&&a.css({top:c+"px"})))):e>F&&(m=!0,b={position:"fixed",top:c},b.width="border-box"===a.css("box-sizing")?a.outerWidth()+"px":a.width()+"px",a.css(b).addClass(t),null==p&&(a.after(h),"left"!==r&&"right"!==r||h.append(a)),a.trigger("sticky_kit:stick")),m&&w&&(null==k&&(k=e+u+c>C+n),!v&&k)))return v=!0,"static"===g.css("position")&&g.css({position:"relative"}),
8 | a.css({position:"absolute",bottom:d,top:"auto"}).trigger("sticky_kit:bottom")},y=function(){x();return l()},H=function(){G=!0;f.off("touchmove",l);f.off("scroll",l);f.off("resize",y);b(document.body).off("sticky_kit:recalc",y);a.off("sticky_kit:detach",H);a.removeData("sticky_kit");a.css({position:"",bottom:"",top:"",width:""});g.position("position","");if(m)return null==p&&("left"!==r&&"right"!==r||a.insertAfter(h),h.remove()),a.removeClass(t)},f.on("touchmove",l),f.on("scroll",l),f.on("resize",
9 | y),b(document.body).on("sticky_kit:recalc",y),a.on("sticky_kit:detach",H),setTimeout(l,0)}};n=0;for(K=this.length;n
2 |
3 |
13 |
--------------------------------------------------------------------------------
/docs/man/figures/ess_logo.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/ropensci/essurvey/b2d05a3a89120e15c0a0bea635ec1884adacb17d/docs/man/figures/ess_logo.png
--------------------------------------------------------------------------------
/docs/pkgdown.js:
--------------------------------------------------------------------------------
1 | /* http://gregfranko.com/blog/jquery-best-practices/ */
2 | (function($) {
3 | $(function() {
4 |
5 | $('.navbar-fixed-top').headroom();
6 |
7 | $('body').css('padding-top', $('.navbar').height() + 10);
8 | $(window).resize(function(){
9 | $('body').css('padding-top', $('.navbar').height() + 10);
10 | });
11 |
12 | $('[data-toggle="tooltip"]').tooltip();
13 |
14 | var cur_path = paths(location.pathname);
15 | var links = $("#navbar ul li a");
16 | var max_length = -1;
17 | var pos = -1;
18 | for (var i = 0; i < links.length; i++) {
19 | if (links[i].getAttribute("href") === "#")
20 | continue;
21 | // Ignore external links
22 | if (links[i].host !== location.host)
23 | continue;
24 |
25 | var nav_path = paths(links[i].pathname);
26 |
27 | var length = prefix_length(nav_path, cur_path);
28 | if (length > max_length) {
29 | max_length = length;
30 | pos = i;
31 | }
32 | }
33 |
34 | // Add class to parent , and enclosing if in dropdown
35 | if (pos >= 0) {
36 | var menu_anchor = $(links[pos]);
37 | menu_anchor.parent().addClass("active");
38 | menu_anchor.closest("li.dropdown").addClass("active");
39 | }
40 | });
41 |
42 | function paths(pathname) {
43 | var pieces = pathname.split("/");
44 | pieces.shift(); // always starts with /
45 |
46 | var end = pieces[pieces.length - 1];
47 | if (end === "index.html" || end === "")
48 | pieces.pop();
49 | return(pieces);
50 | }
51 |
52 | // Returns -1 if not found
53 | function prefix_length(needle, haystack) {
54 | if (needle.length > haystack.length)
55 | return(-1);
56 |
57 | // Special case for length-0 haystack, since for loop won't run
58 | if (haystack.length === 0) {
59 | return(needle.length === 0 ? 0 : -1);
60 | }
61 |
62 | for (var i = 0; i < haystack.length; i++) {
63 | if (needle[i] != haystack[i])
64 | return(i);
65 | }
66 |
67 | return(haystack.length);
68 | }
69 |
70 | /* Clipboard --------------------------*/
71 |
72 | function changeTooltipMessage(element, msg) {
73 | var tooltipOriginalTitle=element.getAttribute('data-original-title');
74 | element.setAttribute('data-original-title', msg);
75 | $(element).tooltip('show');
76 | element.setAttribute('data-original-title', tooltipOriginalTitle);
77 | }
78 |
79 | if(ClipboardJS.isSupported()) {
80 | $(document).ready(function() {
81 | var copyButton = "";
82 |
83 | $("div.sourceCode").addClass("hasCopyButton");
84 |
85 | // Insert copy buttons:
86 | $(copyButton).prependTo(".hasCopyButton");
87 |
88 | // Initialize tooltips:
89 | $('.btn-copy-ex').tooltip({container: 'body'});
90 |
91 | // Initialize clipboard:
92 | var clipboardBtnCopies = new ClipboardJS('[data-clipboard-copy]', {
93 | text: function(trigger) {
94 | return trigger.parentNode.textContent.replace(/\n#>[^\n]*/g, "");
95 | }
96 | });
97 |
98 | clipboardBtnCopies.on('success', function(e) {
99 | changeTooltipMessage(e.trigger, 'Copied!');
100 | e.clearSelection();
101 | });
102 |
103 | clipboardBtnCopies.on('error', function() {
104 | changeTooltipMessage(e.trigger,'Press Ctrl+C or Command+C to copy');
105 | });
106 | });
107 | }
108 | })(window.jQuery || window.$)
109 |
--------------------------------------------------------------------------------
/docs/pkgdown.yml:
--------------------------------------------------------------------------------
1 | pandoc: 2.16.2
2 | pkgdown: 2.0.1
3 | pkgdown_sha: ~
4 | articles:
5 | intro_ess: intro_ess.html
6 | last_built: 2022-01-09T08:01Z
7 |
8 |
--------------------------------------------------------------------------------
/docs/pull_request_template.html:
--------------------------------------------------------------------------------
1 |
2 | NA • essurvey
6 |
7 |
8 |
9 |
50 |
51 |
52 |
53 |
54 |
55 |
56 | NA
57 |
58 |
59 |
60 |
64 |
70 |
75 |
81 |
82 |
83 |
84 |
85 |
88 |
89 |
90 |
91 |
92 |
93 |
102 |
103 |
104 |
105 |
106 |
107 |
108 |
109 |
110 |
--------------------------------------------------------------------------------
/docs/reference/Rplot001.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/ropensci/essurvey/b2d05a3a89120e15c0a0bea635ec1884adacb17d/docs/reference/Rplot001.png
--------------------------------------------------------------------------------
/docs/reference/ess-package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 | ess: Download Data from the European Social Survey on the Fly — ess-package • ess
10 |
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
23 |
24 |
25 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
35 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
46 |
95 |
96 |
97 |
98 |
99 |
100 |
101 |
102 | ess: Download Data from the European Social Survey on the Fly
103 | Source: R/ess-package.R
104 |
105 |
106 |
107 | Download data from the European Social Survey directly from their website <http://www.europeansocialsurvey.org/>. There are two family of functions that allow you to download and interactively check all countries and rounds available.
108 |
109 |
110 |
111 | Details
112 |
113 | Note that this package is for downloading data from the ESS survey.
114 | For analyzing the data, the user should consider the weights and sampling
115 | design of each country/round combination as well as sampling between round.
116 | For some examples, check out the work of Anthony Damico and Daniel Oberski
117 | here. For detailed
118 | examples on how to explore/download data using package, visit the package website
119 | at https://cimentadaj.github.io/ess/
120 |
121 | See also
122 |
123 | Useful links:
124 | Report bugs at https://github.com/cimentadaj/ess/issues
127 |
128 |
129 |
130 |
145 |
146 |
147 |
157 |
158 |
159 |
160 |
161 |
162 |
--------------------------------------------------------------------------------
/docs/reference/figures/ess_logo.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/ropensci/essurvey/b2d05a3a89120e15c0a0bea635ec1884adacb17d/docs/reference/figures/ess_logo.png
--------------------------------------------------------------------------------
/docs/reference/show_countries.html:
--------------------------------------------------------------------------------
1 |
2 | Return available countries in the European Social Survey — show_countries • essurvey
6 |
7 |
8 |
9 |
50 |
51 |
52 |
53 |
54 |
55 |
56 | Return available countries in the European Social Survey
57 | Source: R/show_funs.R
58 | show_countries.Rd
59 |
60 |
61 |
62 | Return available countries in the European Social Survey
63 |
64 |
65 |
66 | show_countries()
67 |
68 |
69 |
70 | Value
71 | character vector with available countries
72 |
73 |
74 |
75 | Examples
76 |
77 | if (FALSE) {
78 | show_countries()
79 | }
80 |
81 |
82 |
83 |
84 |
85 |
88 |
89 |
90 |
91 |
100 |
101 |
102 |
103 |
104 |
105 |
106 |
107 |
108 |
--------------------------------------------------------------------------------
/docs/reference/show_rounds.html:
--------------------------------------------------------------------------------
1 |
2 | Return available rounds in the European Social Survey — show_rounds • essurvey
6 |
7 |
8 |
9 |
50 |
51 |
52 |
53 |
54 |
55 |
56 | Return available rounds in the European Social Survey
57 | Source: R/show_funs.R
58 | show_rounds.Rd
59 |
60 |
61 |
62 | Return available rounds in the European Social Survey
63 |
64 |
65 |
66 | show_rounds()
67 |
68 |
69 |
70 | Value
71 | numeric vector with available rounds
72 |
73 |
74 |
75 | Examples
76 |
77 | if (FALSE) {
78 | show_rounds()
79 | }
80 |
81 |
82 |
83 |
84 |
85 |
88 |
89 |
90 |
91 |
100 |
101 |
102 |
103 |
104 |
105 |
106 |
107 |
108 |
--------------------------------------------------------------------------------
/docs/sitemap.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | /404.html
5 |
6 |
7 | /CONDUCT.html
8 |
9 |
10 | /CONTRIBUTING.html
11 |
12 |
13 | /LICENSE-text.html
14 |
15 |
16 | /LICENSE.html
17 |
18 |
19 | /NEWS.html
20 |
21 |
22 | /articles/index.html
23 |
24 |
25 | /articles/intro_ess.html
26 |
27 |
28 | /authors.html
29 |
30 |
31 | /cran-comments.html
32 |
33 |
34 | /index.html
35 |
36 |
37 | /issue_template.html
38 |
39 |
40 | /news/index.html
41 |
42 |
43 | /pull_request_template.html
44 |
45 |
46 | /reference/ess-package.html
47 |
48 |
49 | /reference/ess_all_cntrounds.html
50 |
51 |
52 | /reference/ess_all_rounds.html
53 |
54 |
55 | /reference/ess_country.html
56 |
57 |
58 | /reference/ess_rounds.html
59 |
60 |
61 | /reference/essurvey-package.html
62 |
63 |
64 | /reference/import_country.html
65 |
66 |
67 | /reference/import_rounds.html
68 |
69 |
70 | /reference/import_sddf_country.html
71 |
72 |
73 | /reference/index.html
74 |
75 |
76 | /reference/recode_missings.html
77 |
78 |
79 | /reference/set_email.html
80 |
81 |
82 | /reference/show_countries.html
83 |
84 |
85 | /reference/show_country_rounds.html
86 |
87 |
88 | /reference/show_rounds.html
89 |
90 |
91 | /reference/show_rounds_country.html
92 |
93 |
94 | /reference/show_sddf_cntrounds.html
95 |
96 |
97 | /reference/show_theme_rounds.html
98 |
99 |
100 | /reference/show_themes.html
101 |
102 |
103 |
--------------------------------------------------------------------------------
/essurvey.Rproj:
--------------------------------------------------------------------------------
1 | Version: 1.0
2 |
3 | RestoreWorkspace: Default
4 | SaveWorkspace: Default
5 | AlwaysSaveHistory: Default
6 |
7 | EnableCodeIndexing: Yes
8 | UseSpacesForTab: Yes
9 | NumSpacesForTab: 2
10 | Encoding: UTF-8
11 |
12 | RnwWeave: knitr
13 | LaTeX: pdfLaTeX
14 |
15 | BuildType: Package
16 | PackageUseDevtools: Yes
17 | PackageInstallArgs: --no-multiarch --with-keep.source
18 |
--------------------------------------------------------------------------------
/inst/CITATION:
--------------------------------------------------------------------------------
1 | citHeader('To cite essurvey in publications use:')
2 |
3 | citEntry(
4 | entry = 'Manual',
5 | title = 'Download Data from the European Social Survey on the Fly',
6 | author = 'Jorge Cimentada ',
7 | year = '2019',
8 | note = 'R package version 1.0.3',
9 | url = 'https://docs.ropensci.org/essurvey/',
10 | textVersion = 'Cimentada, Jorge (2019). Download Data from the European Social Survey on the Fly R package version 1.0.3'
11 | )
12 |
--------------------------------------------------------------------------------
/man/essurvey-package.Rd:
--------------------------------------------------------------------------------
1 | % Generated by roxygen2: do not edit by hand
2 | % Please edit documentation in R/essurvey-package.R
3 | \docType{package}
4 | \name{essurvey-package}
5 | \alias{essurvey}
6 | \alias{essurvey-package}
7 | \title{essurvey: Download Data from the European Social Survey on the Fly}
8 | \description{
9 | Download data from the European Social Survey directly from their website
`).
76 | getTopLevel: function($scope) {
77 | for (var i = 1; i <= 6; i++) {
78 | var $headings = this.findOrFilter($scope, 'h' + i);
79 | if ($headings.length > 1) {
80 | return i;
81 | }
82 | }
83 |
84 | return 1;
85 | },
86 |
87 | // returns the elements for the top level, and the next below it
88 | getHeadings: function($scope, topLevel) {
89 | var topSelector = 'h' + topLevel;
90 |
91 | var secondaryLevel = topLevel + 1;
92 | var secondarySelector = 'h' + secondaryLevel;
93 |
94 | return this.findOrFilter($scope, topSelector + ',' + secondarySelector);
95 | },
96 |
97 | getNavLevel: function(el) {
98 | return parseInt(el.tagName.charAt(1), 10);
99 | },
100 |
101 | populateNav: function($topContext, topLevel, $headings) {
102 | var $context = $topContext;
103 | var $prevNav;
104 |
105 | var helpers = this;
106 | $headings.each(function(i, el) {
107 | var $newNav = helpers.generateNavItem(el);
108 | var navLevel = helpers.getNavLevel(el);
109 |
110 | // determine the proper $context
111 | if (navLevel === topLevel) {
112 | // use top level
113 | $context = $topContext;
114 | } else if ($prevNav && $context === $topContext) {
115 | // create a new level of the tree and switch to it
116 | $context = helpers.createChildNavList($prevNav);
117 | } // else use the current $context
118 |
119 | $context.append($newNav);
120 |
121 | $prevNav = $newNav;
122 | });
123 | },
124 |
125 | parseOps: function(arg) {
126 | var opts;
127 | if (arg.jquery) {
128 | opts = {
129 | $nav: arg
130 | };
131 | } else {
132 | opts = arg;
133 | }
134 | opts.$scope = opts.$scope || $(document.body);
135 | return opts;
136 | }
137 | },
138 |
139 | // accepts a jQuery object, or an options object
140 | init: function(opts) {
141 | opts = this.helpers.parseOps(opts);
142 |
143 | // ensure that the data attribute is in place for styling
144 | opts.$nav.attr('data-toggle', 'toc');
145 |
146 | var $topContext = this.helpers.createChildNavList(opts.$nav);
147 | var topLevel = this.helpers.getTopLevel(opts.$scope);
148 | var $headings = this.helpers.getHeadings(opts.$scope, topLevel);
149 | this.helpers.populateNav($topContext, topLevel, $headings);
150 | }
151 | };
152 |
153 | $(function() {
154 | $('nav[data-toggle="toc"]').each(function(i, el) {
155 | var $nav = $(el);
156 | Toc.init($nav);
157 | });
158 | });
159 | })();
160 |
--------------------------------------------------------------------------------
/docs/cran-comments.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 | cran-comments.md • ess
10 |
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
23 |
24 |
25 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
38 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
94 |
95 |
96 |
97 |
98 |
99 |
100 |
101 | cran-comments.md
102 |
103 |
104 |
105 |
106 |
107 | Test environments
108 |
109 | - local macOS High Sierra 10.13.3, R-3.4.3
110 | - Ubuntu 14.04.5 LTS (on travis-ci), R-3.4.3
111 | - win-builder
112 |
113 |
114 |
115 |
116 | R CMD check results
117 | 0 errors | 0 warnings | 0 notes
118 | For win-builder:
119 | Status: 1 NOTE R Under development (unstable) (2018-02-19 r74276)
120 |
121 |
122 |
123 | Reverse dependencies
124 | There are currently no downstream dependencies for this package.
125 |
126 |
127 | -
128 | Most examples are wrapped in \dontrun{} because they cannot be run in < 5 seconds. No smaller toy examples can be created. Functions which can be executed in < 5 are allow to run.
129 |
130 | Also, most functions use personal emails to actually run. Even if using \dontshow{} I wouldn’t want to reveal any information (either on Github or somewhere on the CRAN repo) of personal use.
131 |
132 | - The tests are wrapped skip_on_cran() since they absolutely require using a private email. Full tests are run on Travis (weekly) with results available for review: https://travis-ci.org/cimentadaj/ess
133 |
134 |
135 | The Travis tests have an environment variable containing the email. This allows the tests to run smoothly.
136 |
137 |
138 |
139 |
140 |
141 |
142 |
143 |
144 |
154 |
155 |
156 |
157 |
158 |
--------------------------------------------------------------------------------
/docs/docsearch.js:
--------------------------------------------------------------------------------
1 | $(function() {
2 |
3 | // register a handler to move the focus to the search bar
4 | // upon pressing shift + "/" (i.e. "?")
5 | $(document).on('keydown', function(e) {
6 | if (e.shiftKey && e.keyCode == 191) {
7 | e.preventDefault();
8 | $("#search-input").focus();
9 | }
10 | });
11 |
12 | $(document).ready(function() {
13 | // do keyword highlighting
14 | /* modified from https://jsfiddle.net/julmot/bL6bb5oo/ */
15 | var mark = function() {
16 |
17 | var referrer = document.URL ;
18 | var paramKey = "q" ;
19 |
20 | if (referrer.indexOf("?") !== -1) {
21 | var qs = referrer.substr(referrer.indexOf('?') + 1);
22 | var qs_noanchor = qs.split('#')[0];
23 | var qsa = qs_noanchor.split('&');
24 | var keyword = "";
25 |
26 | for (var i = 0; i < qsa.length; i++) {
27 | var currentParam = qsa[i].split('=');
28 |
29 | if (currentParam.length !== 2) {
30 | continue;
31 | }
32 |
33 | if (currentParam[0] == paramKey) {
34 | keyword = decodeURIComponent(currentParam[1].replace(/\+/g, "%20"));
35 | }
36 | }
37 |
38 | if (keyword !== "") {
39 | $(".contents").unmark({
40 | done: function() {
41 | $(".contents").mark(keyword);
42 | }
43 | });
44 | }
45 | }
46 | };
47 |
48 | mark();
49 | });
50 | });
51 |
52 | /* Search term highlighting ------------------------------*/
53 |
54 | function matchedWords(hit) {
55 | var words = [];
56 |
57 | var hierarchy = hit._highlightResult.hierarchy;
58 | // loop to fetch from lvl0, lvl1, etc.
59 | for (var idx in hierarchy) {
60 | words = words.concat(hierarchy[idx].matchedWords);
61 | }
62 |
63 | var content = hit._highlightResult.content;
64 | if (content) {
65 | words = words.concat(content.matchedWords);
66 | }
67 |
68 | // return unique words
69 | var words_uniq = [...new Set(words)];
70 | return words_uniq;
71 | }
72 |
73 | function updateHitURL(hit) {
74 |
75 | var words = matchedWords(hit);
76 | var url = "";
77 |
78 | if (hit.anchor) {
79 | url = hit.url_without_anchor + '?q=' + escape(words.join(" ")) + '#' + hit.anchor;
80 | } else {
81 | url = hit.url + '?q=' + escape(words.join(" "));
82 | }
83 |
84 | return url;
85 | }
86 |
--------------------------------------------------------------------------------
/docs/issue_template.html:
--------------------------------------------------------------------------------
1 |
2 | NA • essurvey
6 |
7 |
8 |
9 |
50 |
51 |
52 |
53 |
54 |
55 |
56 | NA
57 |
58 |
59 |
60 |
65 |
70 |
79 |
84 |
89 |
93 |
94 |
95 |
96 |
97 |
100 |
101 |
102 |
103 |
104 |
105 |
114 |
115 |
116 |
117 |
118 |
119 |
120 |
121 |
122 |
--------------------------------------------------------------------------------
/docs/jquery.sticky-kit.min.js:
--------------------------------------------------------------------------------
1 | /*
2 | Sticky-kit v1.1.2 | WTFPL | Leaf Corcoran 2015 | http://leafo.net
3 | */
4 | (function(){var b,f;b=this.jQuery||window.jQuery;f=b(window);b.fn.stick_in_parent=function(d){var A,w,J,n,B,K,p,q,k,E,t;null==d&&(d={});t=d.sticky_class;B=d.inner_scrolling;E=d.recalc_every;k=d.parent;q=d.offset_top;p=d.spacer;w=d.bottoming;null==q&&(q=0);null==k&&(k=void 0);null==B&&(B=!0);null==t&&(t="is_stuck");A=b(document);null==w&&(w=!0);J=function(a,d,n,C,F,u,r,G){var v,H,m,D,I,c,g,x,y,z,h,l;if(!a.data("sticky_kit")){a.data("sticky_kit",!0);I=A.height();g=a.parent();null!=k&&(g=g.closest(k));
5 | if(!g.length)throw"failed to find stick parent";v=m=!1;(h=null!=p?p&&a.closest(p):b(""))&&h.css("position",a.css("position"));x=function(){var c,f,e;if(!G&&(I=A.height(),c=parseInt(g.css("border-top-width"),10),f=parseInt(g.css("padding-top"),10),d=parseInt(g.css("padding-bottom"),10),n=g.offset().top+c+f,C=g.height(),m&&(v=m=!1,null==p&&(a.insertAfter(h),h.detach()),a.css({position:"",top:"",width:"",bottom:""}).removeClass(t),e=!0),F=a.offset().top-(parseInt(a.css("margin-top"),10)||0)-q,
6 | u=a.outerHeight(!0),r=a.css("float"),h&&h.css({width:a.outerWidth(!0),height:u,display:a.css("display"),"vertical-align":a.css("vertical-align"),"float":r}),e))return l()};x();if(u!==C)return D=void 0,c=q,z=E,l=function(){var b,l,e,k;if(!G&&(e=!1,null!=z&&(--z,0>=z&&(z=E,x(),e=!0)),e||A.height()===I||x(),e=f.scrollTop(),null!=D&&(l=e-D),D=e,m?(w&&(k=e+u+c>C+n,v&&!k&&(v=!1,a.css({position:"fixed",bottom:"",top:c}).trigger("sticky_kit:unbottom"))),eb&&!v&&(c-=l,c=Math.max(b-u,c),c=Math.min(q,c),m&&a.css({top:c+"px"})))):e>F&&(m=!0,b={position:"fixed",top:c},b.width="border-box"===a.css("box-sizing")?a.outerWidth()+"px":a.width()+"px",a.css(b).addClass(t),null==p&&(a.after(h),"left"!==r&&"right"!==r||h.append(a)),a.trigger("sticky_kit:stick")),m&&w&&(null==k&&(k=e+u+c>C+n),!v&&k)))return v=!0,"static"===g.css("position")&&g.css({position:"relative"}),
8 | a.css({position:"absolute",bottom:d,top:"auto"}).trigger("sticky_kit:bottom")},y=function(){x();return l()},H=function(){G=!0;f.off("touchmove",l);f.off("scroll",l);f.off("resize",y);b(document.body).off("sticky_kit:recalc",y);a.off("sticky_kit:detach",H);a.removeData("sticky_kit");a.css({position:"",bottom:"",top:"",width:""});g.position("position","");if(m)return null==p&&("left"!==r&&"right"!==r||a.insertAfter(h),h.remove()),a.removeClass(t)},f.on("touchmove",l),f.on("scroll",l),f.on("resize",
9 | y),b(document.body).on("sticky_kit:recalc",y),a.on("sticky_kit:detach",H),setTimeout(l,0)}};n=0;for(K=this.length;n
2 |
3 |
13 |
--------------------------------------------------------------------------------
/docs/man/figures/ess_logo.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/ropensci/essurvey/b2d05a3a89120e15c0a0bea635ec1884adacb17d/docs/man/figures/ess_logo.png
--------------------------------------------------------------------------------
/docs/pkgdown.js:
--------------------------------------------------------------------------------
1 | /* http://gregfranko.com/blog/jquery-best-practices/ */
2 | (function($) {
3 | $(function() {
4 |
5 | $('.navbar-fixed-top').headroom();
6 |
7 | $('body').css('padding-top', $('.navbar').height() + 10);
8 | $(window).resize(function(){
9 | $('body').css('padding-top', $('.navbar').height() + 10);
10 | });
11 |
12 | $('[data-toggle="tooltip"]').tooltip();
13 |
14 | var cur_path = paths(location.pathname);
15 | var links = $("#navbar ul li a");
16 | var max_length = -1;
17 | var pos = -1;
18 | for (var i = 0; i < links.length; i++) {
19 | if (links[i].getAttribute("href") === "#")
20 | continue;
21 | // Ignore external links
22 | if (links[i].host !== location.host)
23 | continue;
24 |
25 | var nav_path = paths(links[i].pathname);
26 |
27 | var length = prefix_length(nav_path, cur_path);
28 | if (length > max_length) {
29 | max_length = length;
30 | pos = i;
31 | }
32 | }
33 |
34 | // Add class to parent , and enclosing if in dropdown
35 | if (pos >= 0) {
36 | var menu_anchor = $(links[pos]);
37 | menu_anchor.parent().addClass("active");
38 | menu_anchor.closest("li.dropdown").addClass("active");
39 | }
40 | });
41 |
42 | function paths(pathname) {
43 | var pieces = pathname.split("/");
44 | pieces.shift(); // always starts with /
45 |
46 | var end = pieces[pieces.length - 1];
47 | if (end === "index.html" || end === "")
48 | pieces.pop();
49 | return(pieces);
50 | }
51 |
52 | // Returns -1 if not found
53 | function prefix_length(needle, haystack) {
54 | if (needle.length > haystack.length)
55 | return(-1);
56 |
57 | // Special case for length-0 haystack, since for loop won't run
58 | if (haystack.length === 0) {
59 | return(needle.length === 0 ? 0 : -1);
60 | }
61 |
62 | for (var i = 0; i < haystack.length; i++) {
63 | if (needle[i] != haystack[i])
64 | return(i);
65 | }
66 |
67 | return(haystack.length);
68 | }
69 |
70 | /* Clipboard --------------------------*/
71 |
72 | function changeTooltipMessage(element, msg) {
73 | var tooltipOriginalTitle=element.getAttribute('data-original-title');
74 | element.setAttribute('data-original-title', msg);
75 | $(element).tooltip('show');
76 | element.setAttribute('data-original-title', tooltipOriginalTitle);
77 | }
78 |
79 | if(ClipboardJS.isSupported()) {
80 | $(document).ready(function() {
81 | var copyButton = "";
82 |
83 | $("div.sourceCode").addClass("hasCopyButton");
84 |
85 | // Insert copy buttons:
86 | $(copyButton).prependTo(".hasCopyButton");
87 |
88 | // Initialize tooltips:
89 | $('.btn-copy-ex').tooltip({container: 'body'});
90 |
91 | // Initialize clipboard:
92 | var clipboardBtnCopies = new ClipboardJS('[data-clipboard-copy]', {
93 | text: function(trigger) {
94 | return trigger.parentNode.textContent.replace(/\n#>[^\n]*/g, "");
95 | }
96 | });
97 |
98 | clipboardBtnCopies.on('success', function(e) {
99 | changeTooltipMessage(e.trigger, 'Copied!');
100 | e.clearSelection();
101 | });
102 |
103 | clipboardBtnCopies.on('error', function() {
104 | changeTooltipMessage(e.trigger,'Press Ctrl+C or Command+C to copy');
105 | });
106 | });
107 | }
108 | })(window.jQuery || window.$)
109 |
--------------------------------------------------------------------------------
/docs/pkgdown.yml:
--------------------------------------------------------------------------------
1 | pandoc: 2.16.2
2 | pkgdown: 2.0.1
3 | pkgdown_sha: ~
4 | articles:
5 | intro_ess: intro_ess.html
6 | last_built: 2022-01-09T08:01Z
7 |
8 |
--------------------------------------------------------------------------------
/docs/pull_request_template.html:
--------------------------------------------------------------------------------
1 |
2 | NA • essurvey
6 |
7 |
8 |
9 |
50 |
51 |
52 |
53 |
54 |
55 |
56 | NA
57 |
58 |
59 |
60 |
64 |
70 |
75 |
81 |
82 |
83 |
84 |
85 |
88 |
89 |
90 |
91 |
92 |
93 |
102 |
103 |
104 |
105 |
106 |
107 |
108 |
109 |
110 |
--------------------------------------------------------------------------------
/docs/reference/Rplot001.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/ropensci/essurvey/b2d05a3a89120e15c0a0bea635ec1884adacb17d/docs/reference/Rplot001.png
--------------------------------------------------------------------------------
/docs/reference/ess-package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 | ess: Download Data from the European Social Survey on the Fly — ess-package • ess
10 |
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
22 |
23 |
24 |
25 |
26 |
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
35 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
46 |
95 |
96 |
97 |
98 |
99 |
100 |
101 |
102 | ess: Download Data from the European Social Survey on the Fly
103 | Source: R/ess-package.R
104 |
105 |
106 |
107 | Download data from the European Social Survey directly from their website <http://www.europeansocialsurvey.org/>. There are two family of functions that allow you to download and interactively check all countries and rounds available.
108 |
109 |
110 |
111 | Details
112 |
113 | Note that this package is for downloading data from the ESS survey.
114 | For analyzing the data, the user should consider the weights and sampling
115 | design of each country/round combination as well as sampling between round.
116 | For some examples, check out the work of Anthony Damico and Daniel Oberski
117 | here. For detailed
118 | examples on how to explore/download data using package, visit the package website
119 | at https://cimentadaj.github.io/ess/
120 |
121 | See also
122 |
123 | Useful links:
124 | Report bugs at https://github.com/cimentadaj/ess/issues
127 |
128 |
129 |
130 |
145 |
146 |
147 |
157 |
158 |
159 |
160 |
161 |
162 |
--------------------------------------------------------------------------------
/docs/reference/figures/ess_logo.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/ropensci/essurvey/b2d05a3a89120e15c0a0bea635ec1884adacb17d/docs/reference/figures/ess_logo.png
--------------------------------------------------------------------------------
/docs/reference/show_countries.html:
--------------------------------------------------------------------------------
1 |
2 | Return available countries in the European Social Survey — show_countries • essurvey
6 |
7 |
8 |
9 |
50 |
51 |
52 |
53 |
54 |
55 |
56 | Return available countries in the European Social Survey
57 | Source: R/show_funs.R
58 | show_countries.Rd
59 |
60 |
61 |
62 | Return available countries in the European Social Survey
63 |
64 |
65 |
66 | show_countries()
67 |
68 |
69 |
70 | Value
71 | character vector with available countries
72 |
73 |
74 |
75 | Examples
76 |
77 | if (FALSE) {
78 | show_countries()
79 | }
80 |
81 |
82 |
83 |
84 |
85 |
88 |
89 |
90 |
91 |
100 |
101 |
102 |
103 |
104 |
105 |
106 |
107 |
108 |
--------------------------------------------------------------------------------
/docs/reference/show_rounds.html:
--------------------------------------------------------------------------------
1 |
2 | Return available rounds in the European Social Survey — show_rounds • essurvey
6 |
7 |
8 |
9 |
50 |
51 |
52 |
53 |
54 |
55 |
56 | Return available rounds in the European Social Survey
57 | Source: R/show_funs.R
58 | show_rounds.Rd
59 |
60 |
61 |
62 | Return available rounds in the European Social Survey
63 |
64 |
65 |
66 | show_rounds()
67 |
68 |
69 |
70 | Value
71 | numeric vector with available rounds
72 |
73 |
74 |
75 | Examples
76 |
77 | if (FALSE) {
78 | show_rounds()
79 | }
80 |
81 |
82 |
83 |
84 |
85 |
88 |
89 |
90 |
91 |
100 |
101 |
102 |
103 |
104 |
105 |
106 |
107 |
108 |
--------------------------------------------------------------------------------
/docs/sitemap.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | /404.html
5 |
6 |
7 | /CONDUCT.html
8 |
9 |
10 | /CONTRIBUTING.html
11 |
12 |
13 | /LICENSE-text.html
14 |
15 |
16 | /LICENSE.html
17 |
18 |
19 | /NEWS.html
20 |
21 |
22 | /articles/index.html
23 |
24 |
25 | /articles/intro_ess.html
26 |
27 |
28 | /authors.html
29 |
30 |
31 | /cran-comments.html
32 |
33 |
34 | /index.html
35 |
36 |
37 | /issue_template.html
38 |
39 |
40 | /news/index.html
41 |
42 |
43 | /pull_request_template.html
44 |
45 |
46 | /reference/ess-package.html
47 |
48 |
49 | /reference/ess_all_cntrounds.html
50 |
51 |
52 | /reference/ess_all_rounds.html
53 |
54 |
55 | /reference/ess_country.html
56 |
57 |
58 | /reference/ess_rounds.html
59 |
60 |
61 | /reference/essurvey-package.html
62 |
63 |
64 | /reference/import_country.html
65 |
66 |
67 | /reference/import_rounds.html
68 |
69 |
70 | /reference/import_sddf_country.html
71 |
72 |
73 | /reference/index.html
74 |
75 |
76 | /reference/recode_missings.html
77 |
78 |
79 | /reference/set_email.html
80 |
81 |
82 | /reference/show_countries.html
83 |
84 |
85 | /reference/show_country_rounds.html
86 |
87 |
88 | /reference/show_rounds.html
89 |
90 |
91 | /reference/show_rounds_country.html
92 |
93 |
94 | /reference/show_sddf_cntrounds.html
95 |
96 |
97 | /reference/show_theme_rounds.html
98 |
99 |
100 | /reference/show_themes.html
101 |
102 |
103 |
--------------------------------------------------------------------------------
/essurvey.Rproj:
--------------------------------------------------------------------------------
1 | Version: 1.0
2 |
3 | RestoreWorkspace: Default
4 | SaveWorkspace: Default
5 | AlwaysSaveHistory: Default
6 |
7 | EnableCodeIndexing: Yes
8 | UseSpacesForTab: Yes
9 | NumSpacesForTab: 2
10 | Encoding: UTF-8
11 |
12 | RnwWeave: knitr
13 | LaTeX: pdfLaTeX
14 |
15 | BuildType: Package
16 | PackageUseDevtools: Yes
17 | PackageInstallArgs: --no-multiarch --with-keep.source
18 |
--------------------------------------------------------------------------------
/inst/CITATION:
--------------------------------------------------------------------------------
1 | citHeader('To cite essurvey in publications use:')
2 |
3 | citEntry(
4 | entry = 'Manual',
5 | title = 'Download Data from the European Social Survey on the Fly',
6 | author = 'Jorge Cimentada ',
7 | year = '2019',
8 | note = 'R package version 1.0.3',
9 | url = 'https://docs.ropensci.org/essurvey/',
10 | textVersion = 'Cimentada, Jorge (2019). Download Data from the European Social Survey on the Fly R package version 1.0.3'
11 | )
12 |
--------------------------------------------------------------------------------
/man/essurvey-package.Rd:
--------------------------------------------------------------------------------
1 | % Generated by roxygen2: do not edit by hand
2 | % Please edit documentation in R/essurvey-package.R
3 | \docType{package}
4 | \name{essurvey-package}
5 | \alias{essurvey}
6 | \alias{essurvey-package}
7 | \title{essurvey: Download Data from the European Social Survey on the Fly}
8 | \description{
9 | Download data from the European Social Survey directly from their website
99 |
142 |
143 |
144 |
154 |
100 |
140 |
141 |
101 |
103 |
104 |
105 | cran-comments.md
102 |
106 |
114 | 107 | Test environments
108 |-
109 |
- local macOS High Sierra 10.13.3, R-3.4.3 110 |
- Ubuntu 14.04.5 LTS (on travis-ci), R-3.4.3 111 |
- win-builder 112 |
115 |
121 | 116 | R CMD check results
117 |0 errors | 0 warnings | 0 notes
118 |For win-builder:
119 |Status: 1 NOTE R Under development (unstable) (2018-02-19 r74276)
120 |
122 |
126 |
137 |
138 |
139 | 123 | Reverse dependencies
124 |There are currently no downstream dependencies for this package.
125 |126 |
-
127 |
- 128 | Most examples are wrapped in \dontrun{} because they cannot be run in < 5 seconds. No smaller toy examples can be created. Functions which can be executed in < 5 are allow to run. 129 |
Also, most functions use personal emails to actually run. Even if using \dontshow{} I wouldn’t want to reveal any information (either on Github or somewhere on the CRAN repo) of personal use.
131 |-
132 |
- The tests are wrapped skip_on_cran() since they absolutely require using a private email. Full tests are run on Travis (weekly) with results available for review: https://travis-ci.org/cimentadaj/ess 133 | 134 |
The Travis tests have an environment variable containing the email. This allows the tests to run smoothly.
136 |
54 |
102 |
103 |
104 |
105 |
55 |
96 |
97 |
100 |
101 |
56 |
58 |
59 |
60 |
65 |
70 |
79 |
84 |
89 |
93 |
94 |
95 | NA
57 |
9 |
50 |
51 |
52 |
53 |
102 |
103 |
104 |
105 |
106 |
107 |
108 |
109 |
110 |
--------------------------------------------------------------------------------
/docs/reference/Rplot001.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/ropensci/essurvey/b2d05a3a89120e15c0a0bea635ec1884adacb17d/docs/reference/Rplot001.png
--------------------------------------------------------------------------------
/docs/reference/ess-package.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
54 |
90 |
91 |
92 |
93 |
55 |
84 |
85 |
88 |
89 |
56 |
58 |
59 |
60 |
64 |
70 |
75 |
81 |
82 |
83 | NA
57 |
45 |
46 |
95 |
96 |
97 |
98 |
99 |
158 |
159 |
160 |
161 |
162 |
--------------------------------------------------------------------------------
/docs/reference/figures/ess_logo.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/ropensci/essurvey/b2d05a3a89120e15c0a0bea635ec1884adacb17d/docs/reference/figures/ess_logo.png
--------------------------------------------------------------------------------
/docs/reference/show_countries.html:
--------------------------------------------------------------------------------
1 |
2 |
100 |
146 |
147 |
157 |
101 |
130 |
145 |
102 |
105 |
106 |
107 | ess: Download Data from the European Social Survey on the Fly
103 | Source:R/ess-package.R
104 | Download data from the European Social Survey directly from their website <http://www.europeansocialsurvey.org/>. There are two family of functions that allow you to download and interactively check all countries and rounds available.
108 | 109 | 110 | 111 |Details
112 | 113 |Note that this package is for downloading data from the ESS survey. 114 | For analyzing the data, the user should consider the weights and sampling 115 | design of each country/round combination as well as sampling between round. 116 | For some examples, check out the work of Anthony Damico and Daniel Oberski 117 | here. For detailed 118 | examples on how to explore/download data using package, visit the package website 119 | at https://cimentadaj.github.io/ess/
120 | 121 |See also
122 | 123 |Useful links:
-
124 |
- 125 |
Report bugs at https://github.com/cimentadaj/ess/issues
126 |
9 |
50 |
51 |
52 |
53 |
100 |
101 |
102 |
103 |
104 |
105 |
106 |
107 |
108 |
--------------------------------------------------------------------------------
/docs/reference/show_rounds.html:
--------------------------------------------------------------------------------
1 |
2 |
54 |
89 |
90 |
91 |
55 |
85 |
88 |
56 |
59 |
60 |
61 | Return available countries in the European Social Survey
57 | Source:R/show_funs.R
58 | show_countries.Rd
62 |
64 |
65 | Return available countries in the European Social Survey
63 |
66 |
67 |
68 |
69 | show_countries()
70 |
73 |
74 | Value
71 |character vector with available countries
72 |
75 |
83 |
84 | Examples
76 |
77 | if (FALSE) {
78 | show_countries()
79 | }
80 |
81 |
82 |
9 |
50 |
51 |
52 |
53 |
100 |
101 |
102 |
103 |
104 |
105 |
106 |
107 |
108 |
--------------------------------------------------------------------------------
/docs/sitemap.xml:
--------------------------------------------------------------------------------
1 |
2 |
54 |
89 |
90 |
91 |
55 |
85 |
88 |
56 |
59 |
60 |
61 | Return available rounds in the European Social Survey
57 | Source:R/show_funs.R
58 | show_rounds.Rd
62 |
64 |
65 | Return available rounds in the European Social Survey
63 |
66 |
67 |
68 |
69 | show_rounds()
70 |
73 |
74 | Value
71 |numeric vector with available rounds
72 |
75 |
83 |
84 | Examples
76 |
77 | if (FALSE) {
78 | show_rounds()
79 | }
80 |
81 |
82 |