Skip to content

Commit

Permalink
update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
Mian Zhong committed Jul 24, 2024
1 parent 7faee17 commit 97c0495
Show file tree
Hide file tree
Showing 10 changed files with 38 additions and 23 deletions.
8 changes: 6 additions & 2 deletions README.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -130,8 +130,12 @@ This dataset is shared as part of a capstone project in Data Science for openwas
## Methodology
The data was obtained from @SIASAR, an information system containing data on rural water supply and sanitation services. Using SIASAR's "download data by country" tool, all available data for Peru (10 excel files) were downloaded. After examining the 10 excel files, only 5 pertained to potable water systems. Those 5 data sets were imported into R and subsequently empty values and unnecessary columns were deleted from them. Finally, the 5 data sets were combined into 1 data frame based on community ID. The combined, cleaned data set contains data from 32 communities.

Documentaion of the dataset went through:
https://globalsiasar.org/sites/default/files/documents/water_supply_system_v10.pdf
SIASAR does not provide a matching data dictionary. openwashdata developer went through the attachements of the original questionnaire:

- https://globalsiasar.org/es/content/documentacion-tecnica
- https://globalsiasar.org/en/content/technical-documentation

The variable description is written with our best guess with the information from the attachements.

## License

Expand Down
18 changes: 12 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@

[![License: CC BY
4.0](https://img.shields.io/badge/License-CC_BY_4.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)

[![R-CMD-check](https://github.com/openwashdata/portawaterperu/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/openwashdata/portawaterperu/actions/workflows/R-CMD-check.yaml)
<!-- badges: end -->

The goal of the package `portawaterperu` is to provide access to data
Expand Down Expand Up @@ -64,7 +64,7 @@ portawaterperu |>
gt::as_raw_html()
```

<div id="eouknuqrfo" style="padding-left:0px;padding-right:0px;padding-top:10px;padding-bottom:10px;overflow-x:auto;overflow-y:auto;width:auto;height:auto;">
<div id="rutvwqeijw" style="padding-left:0px;padding-right:0px;padding-top:10px;padding-bottom:10px;overflow-x:auto;overflow-y:auto;width:auto;height:auto;">
&#10; <table class="gt_table" data-quarto-disable-processing="false" data-quarto-bootstrap="false" style="-webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale; font-family: system-ui, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji'; display: table; border-collapse: collapse; line-height: normal; margin-left: auto; margin-right: auto; color: #333333; font-size: 16px; font-weight: normal; font-style: normal; background-color: #FFFFFF; width: auto; border-top-style: solid; border-top-width: 2px; border-top-color: #A8A8A8; border-right-style: none; border-right-width: 2px; border-right-color: #D3D3D3; border-bottom-style: solid; border-bottom-width: 2px; border-bottom-color: #A8A8A8; border-left-style: none; border-left-width: 2px; border-left-color: #D3D3D3;" bgcolor="#FFFFFF">
<thead style="border-style: none;">
<tr class="gt_col_headings" style="border-style: none; border-top-style: solid; border-top-width: 2px; border-top-color: #D3D3D3; border-bottom-style: solid; border-bottom-width: 2px; border-bottom-color: #D3D3D3; border-left-style: none; border-left-width: 1px; border-left-color: #D3D3D3; border-right-style: none; border-right-width: 1px; border-right-color: #D3D3D3;">
Expand Down Expand Up @@ -916,8 +916,14 @@ from them. Finally, the 5 data sets were combined into 1 data frame
based on community ID. The combined, cleaned data set contains data from
32 communities.

Documentaion of the dataset went through:
<https://globalsiasar.org/sites/default/files/documents/water_supply_system_v10.pdf>
SIASAR does not provide a matching data dictionary. openwashdata
developer went through the attachements of the original questionnaire:

- <https://globalsiasar.org/es/content/documentacion-tecnica>
- <https://globalsiasar.org/en/content/technical-documentation>

The variable description is written with our best guess with the
information from the attachements.

## License

Expand All @@ -934,15 +940,15 @@ citation("portawaterperu")
#>
#> Judah L, Loos S, Zhong M (2024). _portawaterperu: A Preliminary
#> Review of Peruvian Potable Water System Data_. R package version
#> 0.0.0.9000, <https://github.com/openwashdata/portawaterperu>.
#> 0.0.1, <https://github.com/openwashdata/portawaterperu>.
#>
#> A BibTeX entry for LaTeX users is
#>
#> @Manual{,
#> title = {portawaterperu: A Preliminary Review of Peruvian Potable Water System Data},
#> author = {Lauren Judah and Sebastian Camilo Loos and Mian Zhong},
#> year = {2024},
#> note = {R package version 0.0.0.9000},
#> note = {R package version 0.0.1},
#> url = {https://github.com/openwashdata/portawaterperu},
#> }
```
2 changes: 1 addition & 1 deletion docs/404.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/LICENSE.html

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

6 changes: 3 additions & 3 deletions docs/authors.html

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

17 changes: 11 additions & 6 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 @@ -2,7 +2,7 @@ pandoc: 3.1.11
pkgdown: 2.0.9
pkgdown_sha: ~
articles: {}
last_built: 2024-07-24T19:06Z
last_built: 2024-07-24T22:09Z
urls:
reference: https://github.com/openwashdata/portawaterperu/reference
article: https://github.com/openwashdata/portawaterperu/articles
Expand Down
2 changes: 1 addition & 1 deletion docs/reference/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/reference/portawaterperu.html

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

Loading

0 comments on commit 97c0495

Please sign in to comment.