Skip to content

Commit

Permalink
rev
Browse files Browse the repository at this point in the history
  • Loading branch information
Edouard-Legoupil committed Nov 2, 2023
1 parent 5fb7f16 commit 1150e11
Show file tree
Hide file tree
Showing 26 changed files with 560 additions and 12,608 deletions.
3 changes: 2 additions & 1 deletion DESCRIPTION
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,8 @@ Remotes:
edouard-legoupil/riddle,
edouard-legoupil/unhcrshiny,
unhcr-americas/XlsFormUtil,
vidonne/unhcrdown
unhcr-dataviz/unhcrdown,
unhcr-dataviz/unhcrthemes
Config/fusen/version: 0.5.2
Encoding: UTF-8
Roxygen: list(markdown = TRUE)
Expand Down
11 changes: 9 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,10 @@
# {kobocruncher}

<!-- badges: start -->
[![:name status badge](https://unhcrverse.r-universe.dev/badges/:name)](https://unhcrverse.r-universe.dev/)
[![IndicatorCalc status badge](https://unhcrverse.r-universe.dev/badges/HighFrequencyChecks)](https://unhcrverse.r-universe.dev/HighFrequencyChecks)
<!-- badges: end -->

An organized workflow generating 'Rmd' files from an extended 'xlsform' questionnaire structure to facilitate survey data crunching.

`{kobocruncher}` support organised data analysis workflow, to conduct data discovery and analysis for data collected through [KoboToolbox](https://www.kobotoolbox.org/), [ODK](https://opendatakit.org/), [ONA](https://ona.io/home/) or any __[xlsform](http://xlsform.org)__ compliant data collection platform.
Expand Down Expand Up @@ -57,7 +62,9 @@ The easiest way to do that is by calling `usethis::edit_r_environ()` and adding

Contributions to the packages are welcome. Please read first the [contribution guidelines](CONTRIBUTING.html), follow the [code of conduct](CODE_OF_CONDUCT.html) and use the [issue template](ISSUE_TEMPLATE.html).

## References and rational for the package
## References

* JIPS Essential Toolkit, "How do we process and prepare data for analysis": https://jet.jips.org/wp-content/uploads/Guidance-Data-Processing-Phase5-JET.pdf

The package falls into the category of Automatic Data Exploration package (see an [extensive review here](https://github.com/mstaniak/autoEDA-resources)) and mostly act as a __wrapper__ for different specialized packages from the [tidyverse](https://www.tidyverse.org/) .

Expand All @@ -71,4 +78,4 @@ Compare to those packages, `{kobocruncher}` provides:

* Relabeling functions and Questions grouping ability

* Full integration with UNHCR Brand Style
* Full integration with [UNHCR Brand Style](https://dataviz.unhcr.org/tools/r/)
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
18 changes: 15 additions & 3 deletions docs/index.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion docs/pkgdown.yml
Original file line number Diff line number Diff line change
Expand Up @@ -4,5 +4,5 @@ pkgdown_sha: ~
articles:
Troubleshooting: Troubleshooting.html
crunching-function-for-xlsform: crunching-function-for-xlsform.html
last_built: 2023-11-02T17:39Z
last_built: 2023-11-02T18:47Z

Binary file modified docs/reference/kobo_cruncher-3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/reference/plot_text-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/search.json

Large diffs are not rendered by default.

18 changes: 8 additions & 10 deletions docs/tutorial/00-Intro.Rmd
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "Survey Data Analysis with Kobocruncher"
title: "Survey Data Analysis with {Kobocruncher}"
subtitle: "Session 0 - Introduction"
author: "[Link to Documentation](https://edouard-legoupil.github.io/kobocruncher/) -- [Link to Next Session](01-First_Report.html) "
date: "Training Content as of `r format(Sys.Date(), '%d %B %Y')`"
Expand Down Expand Up @@ -39,19 +39,17 @@ Based on a questionnaires, __standardized indicators are calculated__ with a vie

## Survey Data, aka micro-data have secificities

The raw data need to go through a number of __technical manipulations__ before one can use them for interpretation:
[Clean and anonymized data](https://edouard-legoupil.github.io/HighFrequencyChecks/tutorial/index.html) need to go through a number of __technical manipulations__ before one can use them for interpretation:

* _relabeling_ the original question wording to make them quickly legible when doing the interpretation

* perform some data _cleaning_ to account for any issues on the raw data

* apply some basic data _anonymization_ treatment techniques to manage statistical disclosure and re-identification risks
* Need to __relabel__ the original question wording to make them quickly legible when doing the interpretation

* Need to __regroup__ and __crosstabulate__ questions

* create intermediary indicator _calculations_
* create intermediary indicator __calculations__

* use specific survey _weights_ to correctly express the representativeness of each records in the raw data in relation with the original sampling universe
* use specific survey __weights__ to correctly express the representativeness of each records in the raw data in relation with the original sampling universe

* translate the data into _visual charts_ than be easily consumed (understood and intepretated) by subject matter experts
* translate the data into __visual charts__ than be easily consumed (understood and interpreted) by subject matter experts


---
Expand Down
140 changes: 129 additions & 11 deletions docs/tutorial/00-Intro.html

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion docs/tutorial/01-First_Report.Rmd
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "Survey Data Analysis with Kobocruncher"
title: "Survey Data Analysis with {Kobocruncher}"
subtitle: "Session 1 - Your first report"
author: "[Link to Documentation](https://edouard-legoupil.github.io/kobocruncher/) -- [Link to Previous Session](00-Intro.html) -- [Link to Next Session](02-Relabeling.html) "
date: "Training Content as of `r format(Sys.Date(), '%d %B %Y')`"
Expand Down
Loading

0 comments on commit 1150e11

Please sign in to comment.