From 47d85a5161bbdb6a62d4ef70836aa122c0c81cbc Mon Sep 17 00:00:00 2001 From: dieghernan Date: Thu, 28 Oct 2021 10:22:09 +0000 Subject: [PATCH] Add rogtemplate features --- .Rbuildignore | 1 + .github/.gitignore | 2 + .github/workflows/rogtemplate-gh-pages.yaml | 52 +++++++++++ DESCRIPTION | 88 +++++++++---------- README.Rmd | 18 ++-- README.md | 27 +++--- _pkgdown.yml | 0 inst/WORDLIST | 41 +++------ man/figures/logo.png | Bin 0 -> 36125 bytes pkgdown/_pkgdown.yml | 6 ++ pkgdown/favicon/apple-touch-icon-120x120.png | Bin 0 -> 8463 bytes pkgdown/favicon/apple-touch-icon-152x152.png | Bin 0 -> 11163 bytes pkgdown/favicon/apple-touch-icon-180x180.png | Bin 0 -> 13603 bytes pkgdown/favicon/apple-touch-icon-60x60.png | Bin 0 -> 3906 bytes pkgdown/favicon/apple-touch-icon-76x76.png | Bin 0 -> 4890 bytes pkgdown/favicon/apple-touch-icon.png | Bin 0 -> 13603 bytes pkgdown/favicon/favicon-16x16.png | Bin 0 -> 1194 bytes pkgdown/favicon/favicon-32x32.png | Bin 0 -> 2125 bytes pkgdown/favicon/favicon.ico | Bin 0 -> 15086 bytes vignettes/Regional_stats.Rmd | 2 +- 20 files changed, 138 insertions(+), 99 deletions(-) create mode 100644 .github/workflows/rogtemplate-gh-pages.yaml delete mode 100644 _pkgdown.yml create mode 100644 man/figures/logo.png create mode 100644 pkgdown/_pkgdown.yml create mode 100644 pkgdown/favicon/apple-touch-icon-120x120.png create mode 100644 pkgdown/favicon/apple-touch-icon-152x152.png create mode 100644 pkgdown/favicon/apple-touch-icon-180x180.png create mode 100644 pkgdown/favicon/apple-touch-icon-60x60.png create mode 100644 pkgdown/favicon/apple-touch-icon-76x76.png create mode 100644 pkgdown/favicon/apple-touch-icon.png create mode 100644 pkgdown/favicon/favicon-16x16.png create mode 100644 pkgdown/favicon/favicon-32x32.png create mode 100644 pkgdown/favicon/favicon.ico diff --git a/.Rbuildignore b/.Rbuildignore index 28b03fb..a124449 100644 --- a/.Rbuildignore +++ b/.Rbuildignore @@ -21,3 +21,4 @@ ^\.github$ ^paper$ ^not_included$ +^\._pkgdown\.yml$ diff --git a/.github/.gitignore b/.github/.gitignore index 2d19fc7..00fdd19 100644 --- a/.github/.gitignore +++ b/.github/.gitignore @@ -1 +1,3 @@ *.html +R-version +*.Rds diff --git a/.github/workflows/rogtemplate-gh-pages.yaml b/.github/workflows/rogtemplate-gh-pages.yaml new file mode 100644 index 0000000..f704536 --- /dev/null +++ b/.github/workflows/rogtemplate-gh-pages.yaml @@ -0,0 +1,52 @@ +# Workflow derived from https://github.com/r-lib/actions/tree/master/examples +# Need help debugging build failures? Start at https://github.com/r-lib/actions#where-to-find-help +on: + push: + branches: [main, master] + tags: ['*'] + workflow_dispatch: + +name: rogtemplate-gh-pages + +jobs: + rogtemplate-gh-pages: + runs-on: ubuntu-latest + env: + GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }} + steps: + - uses: actions/checkout@v2 + + - uses: r-lib/actions/setup-pandoc@v1 + + - uses: r-lib/actions/setup-r@v1 + with: + use-public-rspm: true + + - uses: r-lib/actions/setup-r-dependencies@v1 + with: + extra-packages: | + magick + ropengov/rogtemplate + + needs: website + + - name: Build logo if not present and prepare template + run: | + # Check that logo is not present + if (isFALSE(file.exists(file.path("man", "figures", "logo.png")) || + file.exists(file.path("man", "figures", "logo.png")))) { + rogtemplate::rog_logo() + } else { + + message("The package already has a logo") + } + + rogtemplate::rog_add_template_pkgdown() + + shell: Rscript {0} + + - name: Deploy package + run: | + git config --local user.name "$GITHUB_ACTOR" + git config --local user.email "$GITHUB_ACTOR@users.noreply.github.com" + Rscript -e 'pkgdown::deploy_to_branch(new_process = FALSE)' diff --git a/DESCRIPTION b/DESCRIPTION index 4a73f53..b986a1c 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -2,65 +2,59 @@ Package: regions Title: Processing Regional Statistics Version: 0.1.8 Date: 2021-06-19 -Authors@R: - c( - person(given = "Daniel", - family = "Antal", - role = c("aut", "cre"), - email = "daniel.antal@ceemid.eu", - comment = c(ORCID = "0000-0001-7513-6760")), - person(given = "Kasia", - family = "Kulma", - role = "ctb", - comment = c(ORCID = "0000-0002-2952-9720")), - person(given = "Istvan", - family = "Zsoldos", - role = c("ctb"), - email = "istvan.zsoldos@gmail.com", - comment = c(ORCID = "0000-0001-5712-2103")), - person(given = "Leo", - family = "Lahti", - role = c("ctb"), - email = "leo.lahti@iki.fi", - comment = c(ORCID = "0000-0001-5537-637X")) - ) -Description: Validating sub-national statistical typologies, re-coding across - standard typologies of sub-national statistics, and making valid aggregate - level imputation, re-aggregation, re-weighting and projection down to - lower hierarchical levels to create meaningful data panels and time series. +Authors@R: c( + person("Daniel", "Antal", , "daniel.antal@ceemid.eu", role = c("aut", "cre"), + comment = c(ORCID = "0000-0001-7513-6760")), + person("Kasia", "Kulma", role = "ctb", + comment = c(ORCID = "0000-0002-2952-9720")), + person("Istvan", "Zsoldos", , "istvan.zsoldos@gmail.com", role = "ctb", + comment = c(ORCID = "0000-0001-5712-2103")), + person("Leo", "Lahti", , "leo.lahti@iki.fi", role = "ctb", + comment = c(ORCID = "0000-0001-5537-637X")) + ) +Description: Validating sub-national statistical typologies, re-coding + across standard typologies of sub-national statistics, and making + valid aggregate level imputation, re-aggregation, re-weighting and + projection down to lower hierarchical levels to create meaningful data + panels and time series. License: GPL-3 -Encoding: UTF-8 -Language: en-US -URL: https://regions.dataobservatory.eu/ -BugReports: https://github.com/rOpenGov/regions -LazyData: true -Roxygen: list(markdown = TRUE) -RoxygenNote: 7.1.1 +URL: https://regions.dataobservatory.eu/, + https://ropengov.github.io/regions/, + https://github.com/rOpenGov/regions +BugReports: https://github.com/rOpenGov/regions/issues Depends: R (>= 2.10) Imports: + assertthat, + countrycode, dplyr, + glue, + here, magrittr, - countrycode, - tidyselect, - utils, purrr, + readxl, rlang, - glue, stats, - tidyr, - readxl, stringr, - assertthat, tibble, - here + tidyr, + tidyselect, + utils Suggests: - knitr, - testthat, - rmarkdown, covr, - spelling, devtools, eurostat, - ggplot2 -VignetteBuilder: knitr + ggplot2, + knitr, + rmarkdown, + spelling, + testthat +VignetteBuilder: + knitr +Encoding: UTF-8 +Language: en-US +LazyData: true +Roxygen: list(markdown = TRUE) +RoxygenNote: 7.1.1 +X-schema.org-isPartOf: http://ropengov.org/ +X-schema.org-keywords: ropengov diff --git a/README.Rmd b/README.Rmd index e3c3f51..3d2e830 100644 --- a/README.Rmd +++ b/README.Rmd @@ -13,9 +13,10 @@ knitr::opts_chunk$set( ) ``` -# regions +# regions +[![rOG-badge](https://ropengov.github.io/rogtemplate/reference/figures/ropengov-badge.svg)](http://ropengov.org/) [![codecov](https://codecov.io/gh/rOpenGov/regions/branch/master/graph/badge.svg?token=Qc3JHI2ILf)](https://app.codecov.io/gh/rOpenGov/regions) [![Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public.](https://www.repostatus.org/badges/latest/wip.svg)](https://www.repostatus.org/#wip) [![license](https://img.shields.io/badge/license-GPL--3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0.en.html) @@ -42,7 +43,7 @@ or the released version from CRAN: install.packages("regions") ``` -You can review the complete package documentation on [regions.dataobservaotry.eu](https://regions.dataobservatory.eu/). If you find any problems with the code, please raise an issue on [Github](https://github.com/rOpenGov/regions). Pull requests are welcome if you agree with the [Contributor Code of Conduct](https://contributor-covenant.org/version/2/0/CODE_OF_CONDUCT.html) +You can review the complete package documentation on [regions.dataobservatory.eu](https://regions.dataobservatory.eu/). If you find any problems with the code, please raise an issue on [Github](https://github.com/rOpenGov/regions). Pull requests are welcome if you agree with the [Contributor Code of Conduct](https://contributor-covenant.org/version/2/0/CODE_OF_CONDUCT.html) If you use `regions` in your work, please [cite the package](https://doi.org/10.5281/zenodo.5006056). @@ -51,18 +52,15 @@ If you use `regions` in your work, please [cite the package](https://doi.org/10. In international comparison, using nationally aggregated indicators often have many disadvantages, which result from the very different levels of homogeneity, but also from the often very limited observation numbers in a cross-sectional analysis. When comparing European countries, a few missing cases can limit the cross-section of countries to around 20 cases which disallows the use of many analytical methods. Working with sub-national statistics has many advantages: the similarity of the aggregation level and high number of observations can allow more precise control of model parameters and errors, and the number of observations grows from 20 to 200-300. ```{r original-map, echo=FALSE, out.width='80%', fig.align='center', fig.cap='The change from national to sub-national level comes with a huge data processing price: internal administrative boundaries, their names, codes codes change very frequently.'} -knitr::include_graphics( - here::here("vignettes", "indicator_with_map.png") -) +knitr::include_graphics("man/figures/indicator_with_map.png") + ``` Yet the change from national to sub-national level comes with a huge data processing price. While national boundaries are relatively stable, with only a handful of changes in each recent decade. The change of national boundaries requires a more-or-less global consensus. But states are free to change their internal administrative boundaries, and they do it with large frequency. This means that the names, identification codes and boundary definitions of sub-national regions change very frequently. Joining data from different sources and different years can be very difficult. ```{r recoded-map, echo=FALSE, out.width='80%', fig.align='center', fig.cap='Our regions R package helps the data processing, validation and imputation of sub-national, regional datasets and their coding.'} -knitr::include_graphics( - here::here("vignettes", "recoded_indicator_with_map.png") -) +knitr::include_graphics("man/figures/recoded_indicator_with_map.png") ``` There are numerous advantages of switching from a national level of the analysis to a sub-national level comes with a huge price in data processing, validation and imputation. The [regions](https://regions.dataobservatory.eu/) package aims to help this process. @@ -135,8 +133,8 @@ We started building an experimental APIs data is running regions regularly and i ## Contributors -Thanks for [\@KKulma](https://github.com/KKulma) for the improved continous integration on Github. +Thanks for [\@KKulma](https://github.com/KKulma) for the improved continuous integration on Github. ## Code of Conduct -Please note that the regions project is released with a [Contributor Code of Conduct](https://contributor-covenant.org/version/2/0/CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms. \ No newline at end of file +Please note that the regions project is released with a [Contributor Code of Conduct](https://contributor-covenant.org/version/2/0/CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms. diff --git a/README.md b/README.md index 268b3b5..1bff933 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,11 @@ -# regions +# regions +[![rOG-badge](https://ropengov.github.io/rogtemplate/reference/figures/ropengov-badge.svg)](http://ropengov.org/) [![codecov](https://codecov.io/gh/rOpenGov/regions/branch/master/graph/badge.svg?token=Qc3JHI2ILf)](https://app.codecov.io/gh/rOpenGov/regions) [![Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the @@ -38,7 +39,7 @@ install.packages("regions") ``` You can review the complete package documentation on -[regions.dataobservaotry.eu](https://regions.dataobservatory.eu/). If +[regions.dataobservatory.eu](https://regions.dataobservatory.eu/). If you find any problems with the code, please raise an issue on [Github](https://github.com/rOpenGov/regions). Pull requests are welcome if you agree with the [Contributor Code of @@ -62,7 +63,7 @@ observations grows from 20 to 200-300.
-The change from national to sub-national level comes with a huge data processing price: internal administrative boundaries, their names, codes codes change very frequently. +The change from national to sub-national level comes with a huge data processing price: internal administrative boundaries, their names, codes codes change very frequently.

The change from national to sub-national level comes with a huge data processing price: internal administrative boundaries, their names, codes @@ -83,7 +84,7 @@ difficult.

-Our regions R package helps the data processing, validation and imputation of sub-national, regional datasets and their coding. +Our regions R package helps the data processing, validation and imputation of sub-national, regional datasets and their coding.

Our regions R package helps the data processing, validation and imputation of sub-national, regional datasets and their coding. @@ -138,14 +139,14 @@ recode_nuts(dat = example_df, knitr::kable() ``` -| geo | values | code\_2013 | -|:------|---------:|:-----------| -| FR | 79.70385 | FR | -| UKI3 | 53.50594 | UKI3 | -| DED | 84.45034 | DED | -| FRK | 63.54153 | FR7 | -| HU12 | 23.97015 | NA | -| DEE32 | 26.95203 | NA | +| geo | values | code\_2013 | +|:------|----------:|:-----------| +| FR | 40.890251 | FR | +| UKI3 | 51.361390 | UKI3 | +| DED | 4.765438 | DED | +| FRK | 3.790729 | FR7 | +| HU12 | 75.573507 | NA | +| DEE32 | 6.354310 | NA | **Hierarchical aggregation and special imputation**: missingness is very frequent in sub-national statistics, because they are created with a @@ -240,7 +241,7 @@ Observatory](https://economy.dataobservatory.eu/). ## Contributors Thanks for [@KKulma](https://github.com/KKulma) for the improved -continous integration on Github. +continuous integration on Github. ## Code of Conduct diff --git a/_pkgdown.yml b/_pkgdown.yml deleted file mode 100644 index e69de29..0000000 diff --git a/inst/WORDLIST b/inst/WORDLIST index 4bc1dd7..3a55de0 100644 --- a/inst/WORDLIST +++ b/inst/WORDLIST @@ -1,13 +1,8 @@ -Adige -Braga -Bragança CENTRE CMD -COVID Centre -Codecov -Comino -Continente +Choropleth +DED DOI Disaggregation EEA @@ -17,28 +12,24 @@ Eurostat Eurostat's Eurostats Eurostat’s +FRK +FTE FUA -Frech GISCO Github -Gozo Guyane HU Kosovo Közép LAU LAUs -Lativa -Latvias Lietuvos Magyarország -Montengro -Montes NL NSW -Norte OBP QLD +README Recode Recoded Recoding @@ -46,45 +37,41 @@ Relabelling Réunion Schwabia Sostinės -Südtirol TAS -Terras Trentino -Trás Tyrol +UKI Vidurio WIP Wordlist XK -analyse assertthat assuringly backcasting -canidates casted +codecov comformity comparators -connectes continous dat -dataobservaotry de disaggregate disaggregated -disaggregating dplyr eu eurostat +eurozone facto fictious geo geocode geocodes geolocational +geospatial harmonises -impracticalities ir iso +json labelled labelling lau @@ -93,12 +80,12 @@ macroregions metacran microdata naïve -os -policymaking +persreg pre programmatically -proximation +rOG rOpenGov +reaggregate recode recoded recoding @@ -106,8 +93,6 @@ recognised regionas relabelling repo -subdivisons territorially -timewise typological vakarų diff --git a/man/figures/logo.png b/man/figures/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..392a0b578b1f5171e064a39f9d943f89d173ddcc GIT binary patch literal 36125 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 Z=r^xLa^{>jZZV?(RWCf@g}ES+nMS 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 F{{x2Ll6U|B literal 0 HcmV?d00001 diff --git a/pkgdown/favicon/apple-touch-icon-76x76.png b/pkgdown/favicon/apple-touch-icon-76x76.png new file mode 100644 index 0000000000000000000000000000000000000000..54069f9f828f09a1f346d986317ebfecae0632fb GIT binary patch literal 4890 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 literal 0 HcmV?d00001 diff --git a/pkgdown/favicon/apple-touch-icon.png b/pkgdown/favicon/apple-touch-icon.png new file mode 100644 index 0000000000000000000000000000000000000000..5a41c8269c4cb325d4ccad4d54f548f989f7a067 GIT binary patch literal 13603 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 tH-{*kzH#NmkuyhRj`|a_ zMW(V*_L98>kqUx}?7igGPw&$^Ims_4$uBu4ACgGZTLxSl7dZd`;6fXs%$X?mN7>FY ztzSUE786)pktRq0D2wGhay;`Vi8nMi0e}D*0HA~dzyUKv`3?XN-~jN`0RYrr008t} zTCJHTGjZ0*$N&YL{E@7N0xC1YN<^FJv3}za<~Ym4Yq~ndtXV;$kXWmhsuWKz>^N^n z@ZwCvVSSzdcvJiMN9uYxy7HS@vP2~n@{P10%|MK?AqqN6XLSr-v*AGL>MZ@c^ z3&Dhi-d=&;xcOWJ%V<|bOk?~6->K>R+U?5Jgm76#iSZtyl`vDj5&w1GsQ*E&C-5xS>|YLmR3*Ekd7gngWA5MNhGZYPLlAcbA3xr+V8@ zdRDcUKLo_*rOk{G7^HdekUJQ9vvoMwhGsowg%G`vx3@0}%N>l9&Wtv+U^Z~^wz1+iE zvS3i#H`0yI{m04Z%o#P4VQQD|EL5cUgWl>&>%icv+#37#+#UNOQyO1ugV_8rLIca1 zWF2VmHFg>P_mUkn%WUB791{DMMOSLbw^oe!i$<0xQJoW@;C61C#Lt=h>Z|hCNAyc? zk<72DbYq^fFiazyJz?HmQaWr$kDp`dTqeVD=I0_&hWVe^!dpT^kb=PhyaCvbO({Bk zAldjFcQ^nCKi$C!y+;5P(zJtxeAw+xaUs*R)qgS)i8Ex@G889%RB1<)ls-CMDj{;S z^BZS9`8!-_thA-n9qj5S{6njI8)j)L`yy}ng3ph4ku(|$onC&@yyR6|5PiSKnCu)X z*>Jb)N5*q7I3s^|R*0&3U5a^=oDN>F3-O7QmV z=Dup6PsIE86?;M2$|m^V^)fkl zTw2lUX3XT0GQuGbr1^pXTm;%x$P#yHk-cgxxqh7|tQt=Vg9;o4-baeM+ zgluJXkf37LoGSNw2cV9C*WgZe@!gq*yyi#Y!eiVT#{@(_9qt=Caw^I5U)C@8ZuS)m ziHGg4es--2YMS!04#;tecq5W4=V)3yS~%*lcl_A6A|k5ifkZf6-YT*U>!DC>tBb>7 zN5kh-pIH=RF@i9Ojmwy3q1eszGRBbY`c|gp_qKnX1UufWwJIuT`*l^O zoZAzDNU1s%E%Dqjd3EAQQ;$jHYm6$eQ?4bOL(FZN>wIXb`N+Xr`6NhnVI>=bJ31ID z{o36`u%=Kc$iHj(_wK}wZp?CD-+t*2Gn-zYlTXMOH}Wyg`%)*Fe2go$J3cMVQF3a1 z?c4V4Lq<;~5DWT?z+iPbuB(gcI(!JFqMyu1>l54>;>qsW+8Yv047>>I`me36kMHuj zL;+;bL%W(~lG;ul;2&mpR8)#Ma=yk5f1>Qw7Cs1o3DkeZ1?S+Ui3F};It&C0-lpklFx|B zf0|DWMNw{XJ}p^+73-N8>1^$76>eqip%`Xi6o8*lUgCz1N)mGffY!T(dadIS@?WKb B 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 HpzXf_O;PQ* literal 0 HcmV?d00001 diff --git a/vignettes/Regional_stats.Rmd b/vignettes/Regional_stats.Rmd index 2ac0736..cf8e582 100644 --- a/vignettes/Regional_stats.Rmd +++ b/vignettes/Regional_stats.Rmd @@ -54,7 +54,7 @@ A typical workflow is this: 4. Aggregate and disaggregate unambiguous changes to the units in the `NUTS2016` – in these cases all the statistical information is present in different form, and any other imputation method would result in loss of existing data. -5. Impute or estimate other regions, using the structural information about the remaining data. This will result in far more superior data than imputation techniques designed for non-aggregated, individual data points; usually a large part of the information is present in statistical tables that can be used for proximation. +5. Impute or estimate other regions, using the structural information about the remaining data. This will result in far more superior data than imputation techniques designed for non-aggregated, individual data points; usually a large part of the information is present in statistical tables that can be used for approximation. When you are working with individual data, you are omitting steps 2-4. When working with national data, especially with small datasets, we can often join data tables by a country name or country code without the problems of 2-4, but even in these cases, imputation rules like using the median value for missing cases is obviously wrong. If the missing value represents a very small member state like Malta, which has a total population smaller than most capital cities in Europe, then using a median or mean country value will very much overestimate a count data for Malta.