-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.Rmd
117 lines (81 loc) · 4.24 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r setup, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# somalia: Datasets for Use in Designing Surveys in Somalia <img src="man/figures/somalia.png" width="200px" align="right" />
[](https://www.repostatus.org/#active)
[](https://www.tidyverse.org/lifecycle/#maturing)
[](https://cran.r-project.org/package=somalia)
[](https://travis-ci.org/validmeasures/somalia)
[](https://ci.appveyor.com/project/validmeasures/somalia)
Designing surveys require relevant datasets to be used as basis for sample size calculations, sampling design, survey planning/logistics and survey implementation. These include datasets on population, lists of sampling clusters, map datasets for spatial sampling, and previous survey datasets that can be used for estimating indicator variance and design effects. This package contains relevant datasets for use in designing surveys in Somalia.
## Installation
`somalia` is not yet released on [CRAN](https://cran.r-project.org).
You can install the development version of `somalia` from [GitHub](https://github.com/validmeasures/somalia) with:
```{r install, echo = TRUE, eval = FALSE}
if(!require(devtools)) install.packages("devtools")
install_github("validmeasures/somalia")
```
## Usage
The `somalia` package has the following datasets.
### Somalia map datasets
Four map datasets are included in the `somalia` pacakge. These are:
* Administrative level 1 or region map of Somalia (`district_map`)
* Administrative level 2 or district map of Somalia (`region_map`)
* Livelihood zones map of Somalia (`lhz2015`)
* Villages (with geographical coordinates) of Somalia (`villages`)
The administrative level 1 or region map, administrative level 2 or district map and livelihoods zones map of Somalia are provided as a dataset class `SpatialPolygonsDataFrame`. These datasets are taken from the [Humanitarian Data Exchange](https://data.humdata.org/dataset/somalia-administrative-boundaries) in [ESRI Shapefile format](https://support.esri.com/en/white-paper/279) and then converted into `SpatialPolygonsDataFrame`.
The villages of Somalia with geographical coordinates dataset is provided by [UNICEF Somalia](https://www.unicef.org/somalia/).
### Accessing area information from map datasets
Underlying area information for the regions, districts and livelihood zones of Somalia can be accessed from the `SpatialPolygonsDataFrame` as follows:
```{r usage1, echo = TRUE, eval = FALSE}
## Regions dataset
somalia::region_map@data
```
```{r usage1a, echo = FALSE, eval = TRUE}
## Regions dataset
somalia::region_map@data[1:10, ]
```
```{r usage2, echo = TRUE, eval = FALSE}
## Districts dataset
somalia::district_map@data
```
```{r usage2a, echo = FALSE, eval = TRUE}
## Districts dataset
somalia::district_map@data[1:10, ]
```
```{r usage3, echo = TRUE, eval = FALSE}
## Livelihoods zones dataset
somalia::lhz2015@data
```
```{r usage3a, echo = FALSE, eval = TRUE}
## Livelihoods zones dataset
somalia::lhz2015@data[1:10, ]
```
### Plotting map datasets
Map datasets can be mapped using the `plot()` function in the `sp` package. This is implemented as follows:
1. Map of Regions of Somalia
```{r usage4, ecoh = TRUE, eval = TRUE}
sp::plot(somalia::region_map)
```
2. Map of Districts of Somalia
```{r usage5, echo = TRUE, eval = TRUE}
sp::plot(somalia::district_map)
```
3. Map of Livelihood Zones of Somalia
```{r usage6, echo = TRUE, eval = TRUE}
sp::plot(somalia::lhz2015)
```
4. Map of villages of Somalia
```{r usage7, echo = TRUE, eval = TRUE}
sp::plot(somalia::region_map)
points(somalia::villages[ , c("longitude", "latitude")], pch = 20, cex = 0.1, col = "darkgreen")
```