From 89969775f950f2ed7f74d7b9c0db8e97131f4be9 Mon Sep 17 00:00:00 2001 From: Vang Le-Quy Date: Sat, 28 Aug 2021 23:29:05 +0200 Subject: [PATCH 01/19] Add priliminary support for Vietnam subnational data --- .github/workflows/Vietnam.yaml | 48 +++++++++++ NAMESPACE | 1 + R/Vietnam.R | 85 +++++++++++++++++++ R/datasets.R | 6 ++ README.md | 41 +++++---- data-raw/vietnam_codes.R | 33 ++++++++ data/all_country_data.rda | Bin 2817 -> 3010 bytes data/vietnam_codes.rda | Bin 0 -> 619 bytes man/Belgium.Rd | 3 +- man/Brazil.Rd | 3 +- man/Canada.Rd | 3 +- man/Colombia.Rd | 3 +- man/Covid19DataHub.Rd | 3 +- man/Cuba.Rd | 3 +- man/France.Rd | 3 +- man/Germany.Rd | 3 +- man/Google.Rd | 3 +- man/India.Rd | 3 +- man/Italy.Rd | 3 +- man/JHU.Rd | 3 +- man/Lithuania.Rd | 3 +- man/Mexico.Rd | 3 +- man/Netherlands.Rd | 3 +- man/SouthAfrica.Rd | 3 +- man/Switzerland.Rd | 3 +- man/UK.Rd | 3 +- man/USA.Rd | 3 +- man/Vietnam.Rd | 138 +++++++++++++++++++++++++++++++ man/all_country_data.Rd | 2 +- man/figures/README-g7_plot-1.png | Bin 66088 -> 65596 bytes man/figures/README-uk_plot-1.png | Bin 59389 -> 62810 bytes man/vietnam_codes.Rd | 19 +++++ 32 files changed, 388 insertions(+), 42 deletions(-) create mode 100644 .github/workflows/Vietnam.yaml create mode 100644 R/Vietnam.R create mode 100644 data-raw/vietnam_codes.R create mode 100644 data/vietnam_codes.rda create mode 100644 man/Vietnam.Rd create mode 100644 man/vietnam_codes.Rd diff --git a/.github/workflows/Vietnam.yaml b/.github/workflows/Vietnam.yaml new file mode 100644 index 00000000..1425587e --- /dev/null +++ b/.github/workflows/Vietnam.yaml @@ -0,0 +1,48 @@ +on: + schedule: + - cron: '36 12 * * *' + workflow_dispatch: + +name: Vietnam + +jobs: + Vietnam: + runs-on: macOS-latest + env: + GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }} + steps: + - uses: actions/checkout@v2 + + - uses: r-lib/actions/setup-r@v1 + + - name: Query dependencies + run: | + install.packages('remotes') + saveRDS(remotes::dev_package_deps(dependencies = TRUE), ".github/depends.Rds", version = 2) + writeLines(sprintf("R-%i.%i", getRversion()$major, getRversion()$minor), ".github/R-version") + shell: Rscript {0} + + - name: Cache R packages + uses: actions/cache@v2 + with: + path: ${{ env.R_LIBS_USER }} + key: ${{ runner.os }}-${{ hashFiles('.github/R-version') }}-1-${{ hashFiles('.github/depends.Rds') }} + restore-keys: ${{ runner.os }}-${{ hashFiles('.github/R-version') }}-1- + + - name: Install dependencies + run: | + install.packages(c("remotes")) + remotes::install_deps(dependencies = TRUE) + install.packages("devtools") + shell: Rscript {0} + + - name: Install package + run: R CMD INSTALL . + + - name: Test dataset + run: | + options("testDownload" = TRUE) + options("testSource" = "Vietnam") + devtools::load_all() + testthat::test_file("tests/testthat/test-regional-datasets.R", reporter = c("summary", "fail")) + shell: Rscript {0} diff --git a/NAMESPACE b/NAMESPACE index ce3bcc43..37b43471 100644 --- a/NAMESPACE +++ b/NAMESPACE @@ -24,6 +24,7 @@ export(SouthAfrica) export(Switzerland) export(UK) export(USA) +export(Vietnam) export(WHO) export(expect_clean_cols) export(expect_columns_contain_data) diff --git a/R/Vietnam.R b/R/Vietnam.R new file mode 100644 index 00000000..3a9e0567 --- /dev/null +++ b/R/Vietnam.R @@ -0,0 +1,85 @@ +#' Vietnam Class for downloading, cleaning and processing +#' notification data +#' +#' @description Information for downloading, cleaning +#' and processing covid-19 region data for Vietnam. +#' +# nolint start +#' @source \url{https://github.com/biocyberman/covidregionaldata/} +# nolint end +#' @export +#' @concept dataset +#' @family subnational +#' @examples +#' \dontrun{ +#' region <- Vietnam$new(verbose = TRUE, steps = TRUE, get = TRUE) +#' region$return() +#' } +Vietnam <- R6::R6Class("Vietnam", + inherit = DataClass, + public = list( + + # Core Attributes (amend each paramater for country specific infomation) + #' @field origin name of country to fetch data for + origin = "Vietnam", + #' @field supported_levels List of supported levels. + supported_levels = list("1"), + #' @field supported_region_names List of region names in order of level. + supported_region_names = list("1" = "region"), + #' @field supported_region_codes List of region codes in order of level. + supported_region_codes = list("1" = "is_3166_2"), + #' @field common_data_urls List of named links to raw data. + # nolint start + common_data_urls = list( + "main" = "https://docs.google.com/spreadsheets/d/1_d7oK-SKj-7KrWAW7DbGYEad2JO4TyR7ApsUAuoiH5g/export?format=csv&gid=0" + ), + # nolint end + #' @field source_data_cols existing columns within the raw data + source_data_cols = c( + "cases_new" + ), + #' @field source_text Plain text description of the source of the data + source_text = "Public COVID-19 data curated by 5F team", + #' @field source_url Website address for explanation/introduction of the + #' data + source_url = "https://datastudio.google.com/u/0/reporting/1cc8d45e-2c74-4084-af70-cbbe60f1660e/page/bLUVC", # nolint + + #' @description Set up a table of region codes for clean data + #' @importFrom tibble tibble + set_region_codes = function(){ + self$codes_lookup$`1` <- covidregionaldata::vietnam_codes + }, + + #' @description Provincial Level Data + #' cleaning + #' @param ... pass additional arguments + #' + #' @importFrom dplyr filter select mutate rename + #' @importFrom tidyr replace_na + #' @importFrom lubridate dmy + clean_common = function() { + self$data$clean <- self$data$raw[["main"]] %>% + `colnames<-`(c('date', 'region', 'cases_new', 'case_group')) %>% + select( + date, + region, + cases_new + ) %>% + rename(level_1_region = region) %>% + mutate( + date = dmy(date), + cases_new = as.numeric(cases_new) + )%>% + mutate( + level_1_region = stringi::stri_trans_general(level_1_region, "latin-ascii"), + level_1_region = stringi::stri_trim_both(level_1_region), + level_1_region = stringr::str_replace_all(level_1_region, '\\(.*\\)|-| ', ''), + level_1_region = stringr::str_to_title(level_1_region) + ) %>% + left_join( + self$codes_lookup$`1`, + by = c("level_1_region" = "level_1_region") + ) + } + ) +) diff --git a/R/datasets.R b/R/datasets.R index efd04202..3c1ad8a2 100644 --- a/R/datasets.R +++ b/R/datasets.R @@ -33,6 +33,12 @@ #' @return A tibble of region codes and related information. "france_codes" +#' Region Codes for Vietnam Dataset. +#' +#' @description The region codes for Viet Nam +#' @return A tibble of region codes and related information. +"vietnam_codes" + #' Region Codes for JHU Dataset. Taken from the region codes provided as #' part of the WHO dataset. #' diff --git a/README.md b/README.md index b1700d62..b452cac6 100644 --- a/README.md +++ b/README.md @@ -80,7 +80,7 @@ the temporary directory by default), ``` r start_using_memoise() -#> Using a cache at: /tmp/RtmprTOAdV +#> Using a cache at: /tmp/RtmpPgZXiv ``` To stop using `memoise` use, @@ -105,7 +105,7 @@ the Google COVID-19 open data project), use: ``` r nots <- get_national_data() #> Downloading data from https://covid19.who.int/WHO-COVID-19-global-data.csv -#> Rows: 132483 Columns: 8 +#> Rows: 142911 Columns: 8 #> ── Column specification ──────────────────────────────────────────────────────── #> Delimiter: "," #> chr (3): Country_code, Country, WHO_region @@ -117,20 +117,20 @@ nots <- get_national_data() #> Cleaning data #> Processing data nots -#> # A tibble: 132,483 x 15 -#> date un_region who_region country iso_code cases_new cases_total -#> -#> 1 2020-01-03 Asia EMRO Afghanistan AF 0 0 -#> 2 2020-01-03 Europe EURO Albania AL 0 0 -#> 3 2020-01-03 Africa AFRO Algeria DZ 0 0 -#> 4 2020-01-03 Oceania WPRO American Samoa AS 0 0 -#> 5 2020-01-03 Europe EURO Andorra AD 0 0 -#> 6 2020-01-03 Africa AFRO Angola AO 0 0 -#> 7 2020-01-03 Americas AMRO Anguilla AI 0 0 -#> 8 2020-01-03 Americas AMRO Antigua & Bar… AG 0 0 -#> 9 2020-01-03 Americas AMRO Argentina AR 0 0 -#> 10 2020-01-03 Asia EURO Armenia AM 0 0 -#> # … with 132,473 more rows, and 8 more variables: deaths_new , +#> # A tibble: 142,911 × 15 +#> date un_region who_region country iso_code cases_new cases_total +#> +#> 1 2020-01-03 Asia EMRO Afghanistan AF 0 0 +#> 2 2020-01-03 Europe EURO Albania AL 0 0 +#> 3 2020-01-03 Africa AFRO Algeria DZ 0 0 +#> 4 2020-01-03 Oceania WPRO American Samoa AS 0 0 +#> 5 2020-01-03 Europe EURO Andorra AD 0 0 +#> 6 2020-01-03 Africa AFRO Angola AO 0 0 +#> 7 2020-01-03 Americas AMRO Anguilla AI 0 0 +#> 8 2020-01-03 Americas AMRO Antigua & Barbuda AG 0 0 +#> 9 2020-01-03 Americas AMRO Argentina AR 0 0 +#> 10 2020-01-03 Asia EURO Armenia AM 0 0 +#> # … with 142,901 more rows, and 8 more variables: deaths_new , #> # deaths_total , recovered_new , recovered_total , #> # hosp_new , hosp_total , tested_new , tested_total ``` @@ -171,7 +171,7 @@ for example by level 1 region in the UK, use: ``` r uk_nots <- get_regional_data(country = "UK", verbose = FALSE) uk_nots -#> # A tibble: 6,916 x 26 +#> # A tibble: 7,501 × 26 #> date region region_code cases_new cases_total deaths_new deaths_total #> #> 1 2020-01-30 East Mi… E12000004 NA NA NA NA @@ -184,16 +184,13 @@ uk_nots #> 8 2020-01-30 Scotland S92000003 NA NA NA NA #> 9 2020-01-30 South E… E12000008 NA NA NA NA #> 10 2020-01-30 South W… E12000009 NA NA NA NA -#> # … with 6,906 more rows, and 19 more variables: recovered_new , +#> # … with 7,491 more rows, and 19 more variables: recovered_new , #> # recovered_total , hosp_new , hosp_total , tested_new , #> # tested_total , areaType , cumCasesByPublishDate , #> # cumCasesBySpecimenDate , newCasesByPublishDate , #> # newCasesBySpecimenDate , cumDeaths28DaysByDeathDate , #> # cumDeaths28DaysByPublishDate , newDeaths28DaysByDeathDate , -#> # newDeaths28DaysByPublishDate , newPillarFourTestsByPublishDate , -#> # newPillarOneTestsByPublishDate , -#> # newPillarThreeTestsByPublishDate , -#> # newPillarTwoTestsByPublishDate +#> # newDeaths28DaysByPublishDate , … ``` Now we have the data we can create plots, for example the time-series of diff --git a/data-raw/vietnam_codes.R b/data-raw/vietnam_codes.R new file mode 100644 index 00000000..59a32f5d --- /dev/null +++ b/data-raw/vietnam_codes.R @@ -0,0 +1,33 @@ +# Set vietnam region codes +# +# Level 1 codes: ISO-3166-2 +# Source: https://en.wikipedia.org/wiki/ISO_3166-2:VN +# +library(rvest) +library(stringi) +library(stringr) +library(dplyr) +library(tibble) + +# Level 1 ----------------------------------------------------------------- +# Get ISO codes +vn_iso <- "https://en.wikipedia.org/wiki/ISO_3166-2:VN" + +level_1_region_df <- read_html(vn_iso) %>% + html_element(css="table.wikitable:nth-child(11)") %>% + html_table() + +vietnam_codes <- data.frame( + level_1_region_code = level_1_region_df$Code, + level_1_region = level_1_region_df$`Subdivision name (vi)`, + stringsAsFactors = FALSE +) %>% + mutate( + level_1_region = stringi::stri_trans_general(level_1_region, "latin-ascii"), + level_1_region = stringi::stri_trim_both(level_1_region), + level_1_region = stringr::str_replace_all(level_1_region, '\\(.*\\)|-| ', ''), + level_1_region = stringr::str_to_title(level_1_region) + ) + +# update package region_codes +usethis::use_data(vietnam_codes, overwrite = TRUE) diff --git a/data/all_country_data.rda b/data/all_country_data.rda index f95a7f512e7e80dbb09e85e5338935b82dd03b6e..68b9a1c3cbc9f77c3729a77345a64f82bf3fb1ba 100644 GIT binary patch literal 3010 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 T2q_oQf8y>)rwS4fnnaO6RL2}{ diff --git a/data/vietnam_codes.rda b/data/vietnam_codes.rda new file mode 100644 index 0000000000000000000000000000000000000000..f13d7abdcbaf85e2dd17ceddd03803f3a693e115 GIT binary patch literal 619 zcmV-x0+jtiT4*^jL0KkKS=ho_yZ{2=|HS|INB{r>f8e~$ePF-u|DZqsAOHXXzydvz zcO7IJn3Doi^n~(dG8qA*OpO2l(W5m3Qg~`mrLh1W>}59MhCG=qAhGS`ieMxe zte=#y*?Oz#e|fiF#i>@O!obcN!mf!Azg*UcA!`Xot%I>?(7W{X3|b>UPbzy`YTa^& z&g%UOQgIY2{)oFtIyqE94p2$ux3Bs4=pKrc34VmIEB zNh>(@wlH9`)C496CvtN25e6dU#DYc&=}4qV1y^Sz0IcM=keaKKM3Av^Kv$bROw*mg ziykx?5qYJZk&5M2suBBngrp!zJmn{LBL~hVW@eP4CUBgC<3gkAqIeXXwXsT4l`uKs zsAS2w6EN0Z;9mR8$K~kK(!@RF&`2eWB;)bi3KF5qGay(^R(n&%%p&^WbIOvhQY&j^HXf%DLzfVSEOLuP zHd(+~0XIEYh*+>dpLQW8re+c?QwwcSH6(bfU4WohAT4;n$`qP^yg>s07ji{7P>|Td FTD \code{Vietnam} +} +\section{Public fields}{ +\if{html}{\out{
}} +\describe{ +\item{\code{origin}}{name of country to fetch data for} + +\item{\code{supported_levels}}{List of supported levels.} + +\item{\code{supported_region_names}}{List of region names in order of level.} + +\item{\code{supported_region_codes}}{List of region codes in order of level.} + +\item{\code{common_data_urls}}{List of named links to raw data.} + +\item{\code{source_data_cols}}{existing columns within the raw data} + +\item{\code{source_text}}{Plain text description of the source of the data} + +\item{\code{source_url}}{Website address for explanation/introduction of the +data} +} +\if{html}{\out{
}} +} +\section{Methods}{ +\subsection{Public methods}{ +\itemize{ +\item \href{#method-set_region_codes}{\code{Vietnam$set_region_codes()}} +\item \href{#method-clean_common}{\code{Vietnam$clean_common()}} +\item \href{#method-clone}{\code{Vietnam$clone()}} +} +} +\if{html}{ +\out{
Inherited methods} +\itemize{ +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-process}{\code{covidregionaldata::DataClass$process()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-return}{\code{covidregionaldata::DataClass$return()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-summary}{\code{covidregionaldata::DataClass$summary()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-test}{\code{covidregionaldata::DataClass$test()}}\out{} +} +\out{
} +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-set_region_codes}{}}} +\subsection{Method \code{set_region_codes()}}{ +Set up a table of region codes for clean data +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{Vietnam$set_region_codes()}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-clean_common}{}}} +\subsection{Method \code{clean_common()}}{ +Provincial Level Data +cleaning +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{Vietnam$clean_common()}\if{html}{\out{
}} +} + +\subsection{Arguments}{ +\if{html}{\out{
}} +\describe{ +\item{\code{...}}{pass additional arguments} +} +\if{html}{\out{
}} +} +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-clone}{}}} +\subsection{Method \code{clone()}}{ +The objects of this class are cloneable with this method. +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{Vietnam$clone(deep = FALSE)}\if{html}{\out{
}} +} + +\subsection{Arguments}{ +\if{html}{\out{
}} +\describe{ +\item{\code{deep}}{Whether to make a deep clone.} +} +\if{html}{\out{
}} +} +} +} diff --git a/man/all_country_data.Rd b/man/all_country_data.Rd index d8dcc66b..052c4727 100644 --- a/man/all_country_data.Rd +++ b/man/all_country_data.Rd @@ -6,7 +6,7 @@ \title{Table of available datasets along with level and other information. Rendered from the individual R6 class objects included in this package.} \format{ -An object of class \code{tbl_df} (inherits from \code{tbl}, \code{data.frame}) with 22 rows and 10 columns. +An object of class \code{tbl_df} (inherits from \code{tbl}, \code{data.frame}) with 23 rows and 10 columns. } \usage{ all_country_data diff --git a/man/figures/README-g7_plot-1.png b/man/figures/README-g7_plot-1.png index 51e78de45d31bea6cc696e015ecef516dadc4cbc..75fa7c693ec4183507477f69586ea2739b6212de 100644 GIT binary patch literal 65596 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 +} +\section{Methods}{ +\subsection{Public methods}{ +\itemize{ +\item \href{#method-set_region_codes}{\code{Vietnam$set_region_codes()}} +\item \href{#method-clean_common}{\code{Vietnam$clean_common()}} +\item \href{#method-clone}{\code{Vietnam$clone()}} +} +} +\if{html}{ +\out{
Inherited methods} +\itemize{ +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-process}{\code{covidregionaldata::DataClass$process()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-return}{\code{covidregionaldata::DataClass$return()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-summary}{\code{covidregionaldata::DataClass$summary()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-test}{\code{covidregionaldata::DataClass$test()}}\out{} +} +\out{
} +} +\if{html}{\out{
}} +\if{html}{\out{
}} +\if{latex}{\out{\hypertarget{method-set_region_codes}{}}} +\subsection{Method \code{set_region_codes()}}{ +Set up a table of region codes for clean data +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{Vietnam$set_region_codes()}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-clean_common}{}}} +\subsection{Method \code{clean_common()}}{ +Provincial Level Data +cleaning +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{Vietnam$clean_common()}\if{html}{\out{
}} +} + +\subsection{Arguments}{ +\if{html}{\out{
}} +\describe{ +\item{\code{...}}{pass additional arguments} +} +\if{html}{\out{
}} +} +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-clone}{}}} +\subsection{Method \code{clone()}}{ +The objects of this class are cloneable with this method. +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{Vietnam$clone(deep = FALSE)}\if{html}{\out{
}} +} + +\subsection{Arguments}{ +\if{html}{\out{
}} +\describe{ +\item{\code{deep}}{Whether to make a deep clone.} +} +\if{html}{\out{
}} +} +} +} diff --git a/man/all_country_data.Rd b/man/all_country_data.Rd index d8dcc66b..052c4727 100644 --- a/man/all_country_data.Rd +++ b/man/all_country_data.Rd @@ -6,7 +6,7 @@ \title{Table of available datasets along with level and other information. Rendered from the individual R6 class objects included in this package.} \format{ -An object of class \code{tbl_df} (inherits from \code{tbl}, \code{data.frame}) with 22 rows and 10 columns. +An object of class \code{tbl_df} (inherits from \code{tbl}, \code{data.frame}) with 23 rows and 10 columns. } \usage{ all_country_data diff --git a/man/figures/README-g7_plot-1.png b/man/figures/README-g7_plot-1.png index 51e78de45d31bea6cc696e015ecef516dadc4cbc..75fa7c693ec4183507477f69586ea2739b6212de 100644 GIT binary patch literal 65596 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 } +} +\if{html}{\out{
}} +\if{html}{\out{
}} +\if{latex}{\out{\hypertarget{method-download}{}}} +\subsection{Method \code{download()}}{ +download function to get raw data +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{Vietnam$download()}\if{html}{\out{
}} +} + } \if{html}{\out{
}} \if{html}{\out{}} From b54bd033a9310fa5731bc28564d0704fd7821937 Mon Sep 17 00:00:00 2001 From: Richard Martin-Nielsen Date: Thu, 16 Sep 2021 19:57:23 +0300 Subject: [PATCH 10/19] Reformatting of code --- DESCRIPTION | 2 +- R/Vietnam.R | 210 +++++++++++++++++++------------------- data/all_country_data.rda | Bin 3010 -> 2867 bytes inst/WORDLIST | 1 + man/Vietnam.Rd | 14 ++- 5 files changed, 120 insertions(+), 107 deletions(-) diff --git a/DESCRIPTION b/DESCRIPTION index 87d1d841..77d724f5 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -122,4 +122,4 @@ Encoding: UTF-8 Language: en-gb LazyData: true Roxygen: list(markdown = TRUE) -RoxygenNote: 7.1.1 +RoxygenNote: 7.1.2 diff --git a/R/Vietnam.R b/R/Vietnam.R index 7135e79f..da03fdae 100644 --- a/R/Vietnam.R +++ b/R/Vietnam.R @@ -13,117 +13,119 @@ #' region <- Vietnam$new(verbose = TRUE, steps = TRUE, get = TRUE) #' region$return() #' } -# nolint start Vietnam <- R6::R6Class("Vietnam", - inherit = DataClass, - public = list( + inherit = DataClass, + public = list( - # Core Attributes (amend each parameter for country specific information) - #' @field origin name of country to fetch data for - origin = "Vietnam", - #' @field supported_levels List of supported levels. - supported_levels = list("1"), - #' @field supported_region_names List of region names in order of level. - supported_region_names = list("1" = "region"), - #' @field supported_region_codes List of region codes in order of level. - supported_region_codes = list("1" = "iso_3166_2"), - #' @field common_data_urls List of named links to raw data. - common_data_urls = list(), - #' @field source_data_cols existing columns within the raw data - source_data_cols = c( - "cases_total", "deaths_total", "recovered_total" - ), - #' @field source_text Plain text description of the source of the data - source_text = "Public COVID-19 for Vietnam, curated by NCSC's COVID-19 team", - #' @field source_url Website address for explanation/introduction of the - #' data - source_url = "https://covid.ncsc.gov.vn", # nolint + # Core Attributes (amend each parameter for country specific information) + #' @field origin name of country to fetch data for + origin = "Vietnam", + #' @field supported_levels List of supported levels. + supported_levels = list("1"), + #' @field supported_region_names List of region names in order of level. + supported_region_names = list("1" = "region"), + #' @field supported_region_codes List of region codes in order of level. + supported_region_codes = list("1" = "iso_3166_2"), + #' @field common_data_urls List of named links to raw data. + common_data_urls = list(), + #' @field source_data_cols existing columns within the raw data + source_data_cols = c( + "cases_total", "deaths_total", "recovered_total" + ), + #' @field source_text Plain text description of the source of the data + source_text = "Public COVID-19 for Vietnam, curated by NCSC's COVID-19 team", + #' @field source_url Website address for explanation/introduction of the + #' data + source_url = "https://covid.ncsc.gov.vn", # nolint - #' @description Set up a table of region codes for clean data - #' @importFrom tibble tibble - set_region_codes = function(){ - self$codes_lookup$`1` <- covidregionaldata::vietnam_codes - }, + #' @description Set up a table of region codes for clean data + #' @importFrom tibble tibble + set_region_codes = function() { + self$codes_lookup$`1` <- covidregionaldata::vietnam_codes + }, - #' @description download function to get raw data - #' @importFrom tidyr replace_na drop_na - #' @importFrom lubridate dmy - #' @importFrom jsonlite fromJSON - download = function() { - bundles_urls = list( - "case_by_time" = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=case_by_time', - "death_by_time" = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=death_by_time', - "recovered_by_time" = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=recovered_by_time' + #' @description download function to get raw data + #' @importFrom tidyr replace_na drop_na + #' @importFrom lubridate dmy + #' @importFrom jsonlite fromJSON + download = function() { + bundles_urls <- list( + "case_by_time" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=case_by_time", + "death_by_time" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=death_by_time", + "recovered_by_time" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=recovered_by_time" + ) + Sys.setenv("VROOM_CONNECTION_SIZE" = 131072 * 4) # Fix VROOM error + provines_url <- "https://covid.ncsc.gov.vn/api/v3/covid/provinces" + bundles <- names(bundles_urls) + provines_data <- fromJSON(provines_url) - ) - Sys.setenv("VROOM_CONNECTION_SIZE" = 131072*4) # Fix VROOM error - provines_url = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces' - bundles = names(bundles_urls) - provines_data = fromJSON(provines_url) + get_bundles_data <- function(bundles) { + bundles_data <- list() + for (bundle in bundles) { + url <- paste0("https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=", bundle) + data <- fromJSON(url) + bundles_data <- c(bundles_data, setNames(list(data), bundle)) + } + bundles_data + } - get_bundles_data = function(bundles){ - bundles_data = list() - for (bundle in bundles){ - url = paste0('https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=', bundle) - data = fromJSON(url) - bundles_data = c(bundles_data, setNames(list(data), bundle)) - } - bundles_data - } + bundles_data <- get_bundles_data(bundles) - bundles_data = get_bundles_data(bundles) + get_province <- function(id, data) { + row_dat <- provines_data[(id <- id), ] + death_by_time <- do.call(cbind, data$death_by_time[id]) + case_by_time <- do.call(cbind, data$case_by_time[id]) + recovered_by_time <- do.call(cbind, data$recovered_by_time[id]) + if (!identical(row.names(death_by_time), row.names(death_by_time))) { + stop("Dates on case_by_time and death_by_time do not match!") + } + df <- tibble( + date = dmy(row.names(case_by_time)), + id = row_dat$id, + name = row_dat$name, + case_by_time = case_by_time, + death_by_time = death_by_time, + recovered_by_time = recovered_by_time + ) + df + } - get_province = function(id, data){ - row_dat = provines_data[(id=id),] - death_by_time= do.call(cbind, data$death_by_time[id]) - case_by_time=do.call(cbind, data$case_by_time[id]) - recovered_by_time=do.call(cbind, data$recovered_by_time[id]) - if (!identical(row.names(death_by_time), row.names(death_by_time))) { - stop("Dates on case_by_time and death_by_time do not match!") - } - df = tibble(date= dmy(row.names(case_by_time)), - id = row_dat$id, - name = row_dat$name, - case_by_time= case_by_time, - death_by_time= death_by_time, - recovered_by_time= recovered_by_time) - df - } + df <- do.call(rbind, lapply(provines_data$id, function(id) { + get_province(id, bundles_data) + })) + names(df) <- c("date", "id", "region_name", "cases_total", "deaths_total", "recovered_total") + self$data$raw[["main"]] <- df + }, - df = do.call(rbind, lapply(provines_data$id, function(id){get_province(id, bundles_data)})) - names(df) <- c("date", "id", "region_name", "cases_total", "deaths_total", "recovered_total") - self$data$raw[['main']] = df - }, - - #' @description Provincial Level Data - #' cleaning - #' @param ... pass additional arguments - #' - #' @importFrom dplyr filter select mutate rename tibble - #' @importFrom tidyr replace_na drop_na - clean_common = function() { - self$data$clean <- self$data$raw[['main']] %>% - select( date, region_name, cases_total, deaths_total, recovered_total) %>% - mutate(cases_total = as.numeric(cases_total), - deaths_total = as.numeric(deaths_total), - recovered_total = as.numeric(recovered_total), - region_name = stringr::str_replace_all(region_name, 'TP HCM', 'Hochiminh'), - ) %>% - tidyr::drop_na(date, region_name) %>% - rename(level_1_region = region_name) %>% - mutate( - level_1_region = stringi::stri_trans_general(level_1_region, "latin-ascii"), - level_1_region = stringi::stri_trim_both(level_1_region), - level_1_region = stringr::str_replace_all(level_1_region, '\\(.*\\)|-| ', ''), - level_1_region = stringr::str_to_title(level_1_region), - level_1_region = tidyr::replace_na(level_1_region, "Unknown") - ) %>% - left_join( - self$codes_lookup$`1`, - by = c("level_1_region" = "level_1_region") - ) - } - - ) + #' @description Provincial Level Data + #' cleaning + #' @param ... pass additional arguments + #' + #' @importFrom dplyr filter select mutate rename tibble + #' @importFrom tidyr replace_na drop_na + clean_common = function() { + self$data$clean <- self$data$raw[["main"]] %>% + select(date, region_name, cases_total, deaths_total, recovered_total) %>% + mutate( + cases_total = as.numeric(cases_total), + deaths_total = as.numeric(deaths_total), + recovered_total = as.numeric(recovered_total), + region_name = stringr::str_replace_all(region_name, "TP HCM", "Hochiminh"), + ) %>% + tidyr::drop_na(date, region_name) %>% + rename(level_1_region = region_name) %>% + mutate( + level_1_region = stringi::stri_trans_general(level_1_region, "latin-ascii"), + level_1_region = stringi::stri_trim_both(level_1_region), + level_1_region = stringr::str_replace_all(level_1_region, "\\(.*\\)|-| ", ""), + level_1_region = stringr::str_to_title(level_1_region), + level_1_region = tidyr::replace_na(level_1_region, "Unknown") + ) %>% + left_join( + self$codes_lookup$`1`, + by = c("level_1_region" = "level_1_region") + ) + } + ) ) -# nolint end + diff --git a/data/all_country_data.rda b/data/all_country_data.rda index 68b9a1c3cbc9f77c3729a77345a64f82bf3fb1ba..4a1e847de9efc6e1da3cc51f9d6c7806e3d83abd 100644 GIT binary patch literal 2867 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\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} -\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} @@ -99,6 +99,16 @@ Set up a table of region codes for clean data \if{html}{\out{
}}\preformatted{Vietnam$set_region_codes()}\if{html}{\out{
}} } +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-download}{}}} +\subsection{Method \code{download()}}{ +download function to get raw data +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{Vietnam$download()}\if{html}{\out{
}} +} + } \if{html}{\out{
}} \if{html}{\out{}} From abf4cdd6b18aff062aa97a2b95809d644f8409f1 Mon Sep 17 00:00:00 2001 From: Richard Martin-Nielsen Date: Thu, 16 Sep 2021 20:24:28 +0300 Subject: [PATCH 11/19] Initial implementation of a generic json_reader function and download_JSON method --- DESCRIPTION | 2 +- NAMESPACE | 1 + R/shared-methods.R | 14 ++++++++++++++ R/utils.R | 24 ++++++++++++++++++++++++ man/Belgium.Rd | 1 + man/Brazil.Rd | 1 + man/Canada.Rd | 1 + man/Colombia.Rd | 1 + man/CountryDataClass.Rd | 1 + man/Covid19DataHub.Rd | 1 + man/Cuba.Rd | 1 + man/DataClass.Rd | 14 ++++++++++++++ man/ECDC.Rd | 1 + man/France.Rd | 1 + man/Germany.Rd | 1 + man/Google.Rd | 1 + man/India.Rd | 1 + man/Italy.Rd | 1 + man/JHU.Rd | 1 + man/JRC.Rd | 1 + man/Lithuania.Rd | 1 + man/Mexico.Rd | 1 + man/Netherlands.Rd | 1 + man/SouthAfrica.Rd | 1 + man/Switzerland.Rd | 1 + man/UK.Rd | 1 + man/USA.Rd | 1 + man/WHO.Rd | 1 + man/json_reader.Rd | 23 +++++++++++++++++++++++ 29 files changed, 100 insertions(+), 1 deletion(-) create mode 100644 man/json_reader.Rd diff --git a/DESCRIPTION b/DESCRIPTION index 86fd1d5f..f6529692 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -121,4 +121,4 @@ Encoding: UTF-8 Language: en-gb LazyData: true Roxygen: list(markdown = TRUE) -RoxygenNote: 7.1.1 +RoxygenNote: 7.1.2 diff --git a/NAMESPACE b/NAMESPACE index ce3bcc43..58d7719e 100644 --- a/NAMESPACE +++ b/NAMESPACE @@ -79,6 +79,7 @@ importFrom(httr,GET) importFrom(httr,POST) importFrom(httr,content) importFrom(httr,status_code) +importFrom(jsonlite,fromJSON) importFrom(lifecycle,deprecate_warn) importFrom(lifecycle,deprecated) importFrom(lifecycle,is_present) diff --git a/R/shared-methods.R b/R/shared-methods.R index bd7eff52..3b413380 100644 --- a/R/shared-methods.R +++ b/R/shared-methods.R @@ -302,6 +302,20 @@ DataClass <- R6::R6Class( ) }, + #' @description Download raw data from `data_urls`, stores a named list + #' of the `data_url` name and the corresponding raw data table in + #' `data$raw`. Designed as a drop-in replacement for `download` so + #' it can be used in sub-classes. + #' @importFrom purrr map + download_JSON = function() { + if (length(self$data_urls) == 0) { + stop("No data to download as data_urls is empty") + } + self$data$raw <- map(self$data_urls, json_reader, + verbose = self$verbose + ) + }, + #' @description Cleans raw data (corrects format, converts column types, #' etc). Works on raw data and so should be called after #' \href{#method-download}{\code{download()}} diff --git a/R/utils.R b/R/utils.R index 276f6613..da992a3d 100644 --- a/R/utils.R +++ b/R/utils.R @@ -53,6 +53,30 @@ csv_reader <- function(file, verbose = FALSE, guess_max = 1000, ...) { return(tibble(data)) } +#' Custom JSON reading function +#' +#' @description Checks for use of memoise and then uses vroom::vroom. +#' @param file A URL or filepath to a JSON +#' @param ... extra parameters to be passed to jsonlite::fromJSON +#' @inheritParams message_verbose +#' @return A data table +#' @importFrom tibble tibble +#' @importFrom jsonlite fromJSON +#' @concept utility +json_reader <- function(file, verbose = FALSE, ...) { + if (verbose) { + message("Downloading data from ", file) + data <- fromJSON(file, ...) + } else { + data <- suppressWarnings( + suppressMessages( + fromJSON(file, ...) + ) + ) + } + return(tibble(data)) +} + #' Wrapper for message #' #' @description A wrapper for `message` that only prints output when diff --git a/man/Belgium.Rd b/man/Belgium.Rd index 16578b4d..e8f93f4f 100644 --- a/man/Belgium.Rd +++ b/man/Belgium.Rd @@ -88,6 +88,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean_common}{\code{covidregionaldata::DataClass$clean_common()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} diff --git a/man/Brazil.Rd b/man/Brazil.Rd index 1016a6aa..fdc4e241 100644 --- a/man/Brazil.Rd +++ b/man/Brazil.Rd @@ -84,6 +84,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} diff --git a/man/Canada.Rd b/man/Canada.Rd index 022d5277..6e71c605 100644 --- a/man/Canada.Rd +++ b/man/Canada.Rd @@ -79,6 +79,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} diff --git a/man/Colombia.Rd b/man/Colombia.Rd index e8ff1a8d..cde549ca 100644 --- a/man/Colombia.Rd +++ b/man/Colombia.Rd @@ -78,6 +78,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} diff --git a/man/CountryDataClass.Rd b/man/CountryDataClass.Rd index f6b5ae67..3c4bc56a 100644 --- a/man/CountryDataClass.Rd +++ b/man/CountryDataClass.Rd @@ -46,6 +46,7 @@ Defaults to the country level of the data.} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean_common}{\code{covidregionaldata::DataClass$clean_common()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-process}{\code{covidregionaldata::DataClass$process()}}\out{} diff --git a/man/Covid19DataHub.Rd b/man/Covid19DataHub.Rd index b305691f..b5e276e2 100644 --- a/man/Covid19DataHub.Rd +++ b/man/Covid19DataHub.Rd @@ -134,6 +134,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-process}{\code{covidregionaldata::DataClass$process()}}\out{} diff --git a/man/Cuba.Rd b/man/Cuba.Rd index 4b688582..c488b553 100644 --- a/man/Cuba.Rd +++ b/man/Cuba.Rd @@ -78,6 +78,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} diff --git a/man/DataClass.Rd b/man/DataClass.Rd index 191071a1..7fa7793b 100644 --- a/man/DataClass.Rd +++ b/man/DataClass.Rd @@ -104,6 +104,7 @@ Defaults to the target level.} \item \href{#method-set_region_codes}{\code{DataClass$set_region_codes()}} \item \href{#method-new}{\code{DataClass$new()}} \item \href{#method-download}{\code{DataClass$download()}} +\item \href{#method-download_JSON}{\code{DataClass$download_JSON()}} \item \href{#method-clean}{\code{DataClass$clean()}} \item \href{#method-clean_common}{\code{DataClass$clean_common()}} \item \href{#method-available_regions}{\code{DataClass$available_regions()}} @@ -203,6 +204,19 @@ of the \code{data_url} name and the corresponding raw data table in \if{html}{\out{
}}\preformatted{DataClass$download()}\if{html}{\out{
}} } +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-download_JSON}{}}} +\subsection{Method \code{download_JSON()}}{ +Download raw data from \code{data_urls}, stores a named list +of the \code{data_url} name and the corresponding raw data table in +\code{data$raw}. Designed as a drop-in replacement for \code{download} so +it can be used in sub-classes. +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{DataClass$download_JSON()}\if{html}{\out{
}} +} + } \if{html}{\out{
}} \if{html}{\out{}} diff --git a/man/ECDC.Rd b/man/ECDC.Rd index 7b501efb..d7cc9bcb 100644 --- a/man/ECDC.Rd +++ b/man/ECDC.Rd @@ -69,6 +69,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-process}{\code{covidregionaldata::DataClass$process()}}\out{} diff --git a/man/France.Rd b/man/France.Rd index fb3d2b12..c90e1ae5 100644 --- a/man/France.Rd +++ b/man/France.Rd @@ -85,6 +85,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean_common}{\code{covidregionaldata::DataClass$clean_common()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} diff --git a/man/Germany.Rd b/man/Germany.Rd index bca080b9..951a3cd5 100644 --- a/man/Germany.Rd +++ b/man/Germany.Rd @@ -81,6 +81,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} diff --git a/man/Google.Rd b/man/Google.Rd index a4ff31af..b6fc5ed5 100644 --- a/man/Google.Rd +++ b/man/Google.Rd @@ -126,6 +126,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-process}{\code{covidregionaldata::DataClass$process()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-return}{\code{covidregionaldata::DataClass$return()}}\out{} diff --git a/man/India.Rd b/man/India.Rd index d676bd92..7045947b 100644 --- a/man/India.Rd +++ b/man/India.Rd @@ -79,6 +79,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} diff --git a/man/Italy.Rd b/man/Italy.Rd index 1c527c0a..530a6ec5 100644 --- a/man/Italy.Rd +++ b/man/Italy.Rd @@ -79,6 +79,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} diff --git a/man/JHU.Rd b/man/JHU.Rd index 53e56a88..519833c6 100644 --- a/man/JHU.Rd +++ b/man/JHU.Rd @@ -130,6 +130,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-process}{\code{covidregionaldata::DataClass$process()}}\out{} diff --git a/man/JRC.Rd b/man/JRC.Rd index 50cdcac7..19073ba5 100644 --- a/man/JRC.Rd +++ b/man/JRC.Rd @@ -82,6 +82,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-process}{\code{covidregionaldata::DataClass$process()}}\out{} diff --git a/man/Lithuania.Rd b/man/Lithuania.Rd index 789460d5..6b3b931c 100644 --- a/man/Lithuania.Rd +++ b/man/Lithuania.Rd @@ -206,6 +206,7 @@ by OSP} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-process}{\code{covidregionaldata::DataClass$process()}}\out{} diff --git a/man/Mexico.Rd b/man/Mexico.Rd index 5c9c653f..37c51974 100644 --- a/man/Mexico.Rd +++ b/man/Mexico.Rd @@ -93,6 +93,7 @@ data} \itemize{ \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} diff --git a/man/Netherlands.Rd b/man/Netherlands.Rd index d1fe4ff0..df72ed76 100644 --- a/man/Netherlands.Rd +++ b/man/Netherlands.Rd @@ -84,6 +84,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} diff --git a/man/SouthAfrica.Rd b/man/SouthAfrica.Rd index 78c0b096..e3e6e0e5 100644 --- a/man/SouthAfrica.Rd +++ b/man/SouthAfrica.Rd @@ -78,6 +78,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} diff --git a/man/Switzerland.Rd b/man/Switzerland.Rd index 90e35976..63e89f32 100644 --- a/man/Switzerland.Rd +++ b/man/Switzerland.Rd @@ -103,6 +103,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} diff --git a/man/UK.Rd b/man/UK.Rd index c70c18c1..c27f3856 100644 --- a/man/UK.Rd +++ b/man/UK.Rd @@ -147,6 +147,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean_common}{\code{covidregionaldata::DataClass$clean_common()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-process}{\code{covidregionaldata::DataClass$process()}}\out{} diff --git a/man/USA.Rd b/man/USA.Rd index ff36de2f..8009eb18 100644 --- a/man/USA.Rd +++ b/man/USA.Rd @@ -81,6 +81,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean_common}{\code{covidregionaldata::DataClass$clean_common()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} diff --git a/man/WHO.Rd b/man/WHO.Rd index 6cc63911..6f34e2b3 100644 --- a/man/WHO.Rd +++ b/man/WHO.Rd @@ -68,6 +68,7 @@ data} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-process}{\code{covidregionaldata::DataClass$process()}}\out{} diff --git a/man/json_reader.Rd b/man/json_reader.Rd new file mode 100644 index 00000000..6081d976 --- /dev/null +++ b/man/json_reader.Rd @@ -0,0 +1,23 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/utils.R +\name{json_reader} +\alias{json_reader} +\title{Custom JSON reading function} +\usage{ +json_reader(file, verbose = FALSE, ...) +} +\arguments{ +\item{file}{A URL or filepath to a JSON} + +\item{verbose}{Logical, defaults to \code{TRUE}. Should verbose processing +messages and warnings be returned.} + +\item{...}{extra parameters to be passed to jsonlite::fromJSON} +} +\value{ +A data table +} +\description{ +Checks for use of memoise and then uses vroom::vroom. +} +\concept{utility} From 7bd4fb00f6e44bebe0bf01a10125176813e6e28e Mon Sep 17 00:00:00 2001 From: Richard Martin-Nielsen Date: Thu, 16 Sep 2021 21:43:23 +0300 Subject: [PATCH 12/19] Using JSON reader to download Vietnam code --- NAMESPACE | 2 + R/Vietnam.R | 139 +++++++++++++++++++++++++++++++++++ data-raw/vietnam_codes.R | 33 +++++++++ data/all_country_data.rda | Bin 2817 -> 2935 bytes data/vietnam_codes.rda | Bin 0 -> 619 bytes man/Belgium.Rd | 3 +- man/Brazil.Rd | 3 +- man/Canada.Rd | 3 +- man/Colombia.Rd | 3 +- man/Covid19DataHub.Rd | 3 +- man/Cuba.Rd | 3 +- man/France.Rd | 3 +- man/Germany.Rd | 3 +- man/Google.Rd | 3 +- man/India.Rd | 3 +- man/Italy.Rd | 3 +- man/JHU.Rd | 3 +- man/Lithuania.Rd | 3 +- man/Mexico.Rd | 3 +- man/Netherlands.Rd | 3 +- man/SouthAfrica.Rd | 3 +- man/Switzerland.Rd | 3 +- man/UK.Rd | 3 +- man/USA.Rd | 3 +- man/Vietnam.Rd | 149 ++++++++++++++++++++++++++++++++++++++ man/all_country_data.Rd | 2 +- 26 files changed, 362 insertions(+), 20 deletions(-) create mode 100644 R/Vietnam.R create mode 100644 data-raw/vietnam_codes.R create mode 100644 data/vietnam_codes.rda create mode 100644 man/Vietnam.Rd diff --git a/NAMESPACE b/NAMESPACE index 58d7719e..4c694bca 100644 --- a/NAMESPACE +++ b/NAMESPACE @@ -24,6 +24,7 @@ export(SouthAfrica) export(Switzerland) export(UK) export(USA) +export(Vietnam) export(WHO) export(expect_clean_cols) export(expect_columns_contain_data) @@ -73,6 +74,7 @@ importFrom(dplyr,slice_tail) importFrom(dplyr,starts_with) importFrom(dplyr,summarise) importFrom(dplyr,tally) +importFrom(dplyr,tibble) importFrom(dplyr,ungroup) importFrom(dplyr,vars) importFrom(httr,GET) diff --git a/R/Vietnam.R b/R/Vietnam.R new file mode 100644 index 00000000..f55bbed8 --- /dev/null +++ b/R/Vietnam.R @@ -0,0 +1,139 @@ +#' Vietnam Class for downloading, cleaning and processing +#' notification data +#' +#' @description Information for downloading, cleaning +#' and processing covid-19 region data for Vietnam. +#' +#' @source \url{https://covid.ncsc.gov.vn} +#' @export +#' @concept dataset +#' @family subnational +#' @examples +#' \dontrun{ +#' region <- Vietnam$new(verbose = TRUE, steps = TRUE, get = TRUE) +#' region$return() +#' } +Vietnam <- R6::R6Class("Vietnam", + inherit = DataClass, + public = list( + + # Core Attributes (amend each parameter for country specific information) + #' @field origin name of country to fetch data for + origin = "Vietnam", + #' @field supported_levels List of supported levels. + supported_levels = list("1"), + #' @field supported_region_names List of region names in order of level. + supported_region_names = list("1" = "region"), + #' @field supported_region_codes List of region codes in order of level. + supported_region_codes = list("1" = "iso_3166_2"), + #' @field common_data_urls List of named links to raw data. + common_data_urls = list( + "main" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=case_by_time", + "death_by_time" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=death_by_time", + "recovered_by_time" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=recovered_by_time", + "provinces" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces" + ), + #' @field source_data_cols existing columns within the raw data + source_data_cols = c( + "cases_total", "deaths_total", "recovered_total" + ), + #' @field source_text Plain text description of the source of the data + source_text = "Public COVID-19 for Vietnam, curated by NCSC's COVID-19 team", + #' @field source_url Website address for explanation/introduction of the + #' data + source_url = "https://covid.ncsc.gov.vn", # nolint + + #' @description Set up a table of region codes for clean data + #' @importFrom tibble tibble + set_region_codes = function() { + self$codes_lookup$`1` <- covidregionaldata::vietnam_codes + }, + + #' @description download function to get raw data + #' @importFrom tidyr replace_na drop_na + #' @importFrom lubridate dmy + #' @importFrom jsonlite fromJSON + download = function(){ + super$download_JSON() + }, + # function() { + # bundles_urls <- list( + # "case_by_time" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=case_by_time", + # "death_by_time" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=death_by_time", + # "recovered_by_time" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=recovered_by_time" + # ) + # Sys.setenv("VROOM_CONNECTION_SIZE" = 131072 * 4) # Fix VROOM error + # provines_url <- "https://covid.ncsc.gov.vn/api/v3/covid/provinces" + # bundles <- names(bundles_urls) + # provines_data <- fromJSON(provines_url) + # + # get_bundles_data <- function(bundles) { + # bundles_data <- list() + # for (bundle in bundles) { + # url <- paste0("https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=", bundle) + # data <- fromJSON(url) + # bundles_data <- c(bundles_data, setNames(list(data), bundle)) + # } + # bundles_data + # } + # + # bundles_data <- get_bundles_data(bundles) + # + # get_province <- function(id, data) { + # row_dat <- provines_data[(id <- id), ] + # death_by_time <- do.call(cbind, data$death_by_time[id]) + # case_by_time <- do.call(cbind, data$case_by_time[id]) + # recovered_by_time <- do.call(cbind, data$recovered_by_time[id]) + # if (!identical(row.names(death_by_time), row.names(death_by_time))) { + # stop("Dates on case_by_time and death_by_time do not match!") + # } + # df <- tibble( + # date = dmy(row.names(case_by_time)), + # id = row_dat$id, + # name = row_dat$name, + # case_by_time = case_by_time, + # death_by_time = death_by_time, + # recovered_by_time = recovered_by_time + # ) + # df + # } + # + # df <- do.call(rbind, lapply(provines_data$id, function(id) { + # get_province(id, bundles_data) + # })) + # names(df) <- c("date", "id", "region_name", "cases_total", "deaths_total", "recovered_total") + # self$data$raw[["main"]] <- df + # }, + + #' @description Provincial Level Data + #' cleaning + #' @param ... pass additional arguments + #' + #' @importFrom dplyr filter select mutate rename tibble + #' @importFrom tidyr replace_na drop_na + clean_common = function() { + self$data$clean <- self$data$raw[["main"]] %>% + select(date, region_name, cases_total, deaths_total, recovered_total) %>% + mutate( + cases_total = as.numeric(cases_total), + deaths_total = as.numeric(deaths_total), + recovered_total = as.numeric(recovered_total), + region_name = stringr::str_replace_all(region_name, "TP HCM", "Hochiminh"), + ) %>% + tidyr::drop_na(date, region_name) %>% + rename(level_1_region = region_name) %>% + mutate( + level_1_region = stringi::stri_trans_general(level_1_region, "latin-ascii"), + level_1_region = stringi::stri_trim_both(level_1_region), + level_1_region = stringr::str_replace_all(level_1_region, "\\(.*\\)|-| ", ""), + level_1_region = stringr::str_to_title(level_1_region), + level_1_region = tidyr::replace_na(level_1_region, "Unknown") + ) %>% + left_join( + self$codes_lookup$`1`, + by = c("level_1_region" = "level_1_region") + ) + } + ) +) + diff --git a/data-raw/vietnam_codes.R b/data-raw/vietnam_codes.R new file mode 100644 index 00000000..438c1031 --- /dev/null +++ b/data-raw/vietnam_codes.R @@ -0,0 +1,33 @@ +# Set vietnam region codes +# +# Level 1 codes: ISO-3166-2 +# Source: https://en.wikipedia.org/wiki/ISO_3166-2:VN +# +library(rvest) +library(stringi) +library(stringr) +library(dplyr) +library(tibble) + +# Level 1 ----------------------------------------------------------------- +# Get ISO codes +vn_iso <- "https://en.wikipedia.org/wiki/ISO_3166-2:VN" + +level_1_region_df <- read_html(vn_iso) %>% + html_element(css="table.wikitable:nth-child(11)") %>% + html_table() + +vietnam_codes <- data.frame( + level_1_region_code = level_1_region_df$Code, + level_1_region = level_1_region_df$`Subdivision name (vi)`, + stringsAsFactors = FALSE +) %>% + mutate( + level_1_region = stringi::stri_trans_general(level_1_region, "latin-ascii"), + level_1_region = stringi::stri_trim_both(level_1_region), + level_1_region = stringr::str_replace_all(level_1_region, '\\(.*\\)|-| ', ''), + level_1_region = stringr::str_to_title(level_1_region) + ) + +# update package region_codes +usethis::use_data(vietnam_codes, overwrite = TRUE) diff --git a/data/all_country_data.rda b/data/all_country_data.rda index f95a7f512e7e80dbb09e85e5338935b82dd03b6e..aead1c321977ed9a353e1caa7f69608de15f49f9 100644 GIT binary patch literal 2935 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 literal 2817 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 T2q_oQf8y>)rwS4fnnaO6RL2}{ diff --git a/data/vietnam_codes.rda b/data/vietnam_codes.rda new file mode 100644 index 0000000000000000000000000000000000000000..f13d7abdcbaf85e2dd17ceddd03803f3a693e115 GIT binary patch literal 619 zcmV-x0+jtiT4*^jL0KkKS=ho_yZ{2=|HS|INB{r>f8e~$ePF-u|DZqsAOHXXzydvz zcO7IJn3Doi^n~(dG8qA*OpO2l(W5m3Qg~`mrLh1W>}59MhCG=qAhGS`ieMxe zte=#y*?Oz#e|fiF#i>@O!obcN!mf!Azg*UcA!`Xot%I>?(7W{X3|b>UPbzy`YTa^& z&g%UOQgIY2{)oFtIyqE94p2$ux3Bs4=pKrc34VmIEB zNh>(@wlH9`)C496CvtN25e6dU#DYc&=}4qV1y^Sz0IcM=keaKKM3Av^Kv$bROw*mg ziykx?5qYJZk&5M2suBBngrp!zJmn{LBL~hVW@eP4CUBgC<3gkAqIeXXwXsT4l`uKs zsAS2w6EN0Z;9mR8$K~kK(!@RF&`2eWB;)bi3KF5qGay(^R(n&%%p&^WbIOvhQY&j^HXf%DLzfVSEOLuP zHd(+~0XIEYh*+>dpLQW8re+c?QwwcSH6(bfU4WohAT4;n$`qP^yg>s07ji{7P>|Td FTD \code{Vietnam} +} +\section{Public fields}{ +\if{html}{\out{
}} +\describe{ +\item{\code{origin}}{name of country to fetch data for} + +\item{\code{supported_levels}}{List of supported levels.} + +\item{\code{supported_region_names}}{List of region names in order of level.} + +\item{\code{supported_region_codes}}{List of region codes in order of level.} + +\item{\code{common_data_urls}}{List of named links to raw data.} + +\item{\code{source_data_cols}}{existing columns within the raw data} + +\item{\code{source_text}}{Plain text description of the source of the data} + +\item{\code{source_url}}{Website address for explanation/introduction of the +data} +} +\if{html}{\out{
}} +} +\section{Methods}{ +\subsection{Public methods}{ +\itemize{ +\item \href{#method-set_region_codes}{\code{Vietnam$set_region_codes()}} +\item \href{#method-download}{\code{Vietnam$download()}} +\item \href{#method-clean_common}{\code{Vietnam$clean_common()}} +\item \href{#method-clone}{\code{Vietnam$clone()}} +} +} +\if{html}{ +\out{
Inherited methods} +\itemize{ +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download_JSON}{\code{covidregionaldata::DataClass$download_JSON()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-process}{\code{covidregionaldata::DataClass$process()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-return}{\code{covidregionaldata::DataClass$return()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-summary}{\code{covidregionaldata::DataClass$summary()}}\out{} +\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-test}{\code{covidregionaldata::DataClass$test()}}\out{} +} +\out{
} +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-set_region_codes}{}}} +\subsection{Method \code{set_region_codes()}}{ +Set up a table of region codes for clean data +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{Vietnam$set_region_codes()}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-download}{}}} +\subsection{Method \code{download()}}{ +download function to get raw data +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{Vietnam$download()}\if{html}{\out{
}} +} + +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-clean_common}{}}} +\subsection{Method \code{clean_common()}}{ +Provincial Level Data +cleaning +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{Vietnam$clean_common()}\if{html}{\out{
}} +} + +\subsection{Arguments}{ +\if{html}{\out{
}} +\describe{ +\item{\code{...}}{pass additional arguments} +} +\if{html}{\out{
}} +} +} +\if{html}{\out{
}} +\if{html}{\out{}} +\if{latex}{\out{\hypertarget{method-clone}{}}} +\subsection{Method \code{clone()}}{ +The objects of this class are cloneable with this method. +\subsection{Usage}{ +\if{html}{\out{
}}\preformatted{Vietnam$clone(deep = FALSE)}\if{html}{\out{
}} +} + +\subsection{Arguments}{ +\if{html}{\out{
}} +\describe{ +\item{\code{deep}}{Whether to make a deep clone.} +} +\if{html}{\out{
}} +} +} +} diff --git a/man/all_country_data.Rd b/man/all_country_data.Rd index d8dcc66b..052c4727 100644 --- a/man/all_country_data.Rd +++ b/man/all_country_data.Rd @@ -6,7 +6,7 @@ \title{Table of available datasets along with level and other information. Rendered from the individual R6 class objects included in this package.} \format{ -An object of class \code{tbl_df} (inherits from \code{tbl}, \code{data.frame}) with 22 rows and 10 columns. +An object of class \code{tbl_df} (inherits from \code{tbl}, \code{data.frame}) with 23 rows and 10 columns. } \usage{ all_country_data From 3aeddbea6378f044abab394ea4877e8d9b3ff742 Mon Sep 17 00:00:00 2001 From: Richard Martin-Nielsen Date: Fri, 17 Sep 2021 21:40:09 +0300 Subject: [PATCH 13/19] Closer to a tidy version of cleaning Vietnam data --- NAMESPACE | 5 +++++ R/Vietnam.R | 48 +++++++++++++++++++++++++++++++----------------- 2 files changed, 36 insertions(+), 17 deletions(-) diff --git a/NAMESPACE b/NAMESPACE index 4c694bca..15e79cf3 100644 --- a/NAMESPACE +++ b/NAMESPACE @@ -48,6 +48,7 @@ importFrom(countrycode,countryname) importFrom(dplyr,"%>%") importFrom(dplyr,across) importFrom(dplyr,arrange) +importFrom(dplyr,as_tibble) importFrom(dplyr,bind_rows) importFrom(dplyr,count) importFrom(dplyr,distinct) @@ -110,6 +111,9 @@ importFrom(rlang,"!!") importFrom(rlang,":=") importFrom(rlang,.data) importFrom(rlang,syms) +importFrom(stringi,stri_replace_all) +importFrom(stringi,stri_trans_general) +importFrom(stringi,stri_trim_both) importFrom(stringr,str_detect) importFrom(stringr,str_replace_all) importFrom(stringr,str_to_sentence) @@ -126,6 +130,7 @@ importFrom(tidyr,nesting) importFrom(tidyr,pivot_longer) importFrom(tidyr,pivot_wider) importFrom(tidyr,replace_na) +importFrom(tidyr,separate) importFrom(tidyselect,all_of) importFrom(tidyselect,ends_with) importFrom(tidyselect,starts_with) diff --git a/R/Vietnam.R b/R/Vietnam.R index f55bbed8..1a61c465 100644 --- a/R/Vietnam.R +++ b/R/Vietnam.R @@ -28,7 +28,7 @@ Vietnam <- R6::R6Class("Vietnam", supported_region_codes = list("1" = "iso_3166_2"), #' @field common_data_urls List of named links to raw data. common_data_urls = list( - "main" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=case_by_time", + "case_by_time" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=case_by_time", "death_by_time" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=death_by_time", "recovered_by_time" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=recovered_by_time", "provinces" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces" @@ -109,30 +109,44 @@ Vietnam <- R6::R6Class("Vietnam", #' cleaning #' @param ... pass additional arguments #' - #' @importFrom dplyr filter select mutate rename tibble - #' @importFrom tidyr replace_na drop_na + #' @importFrom dplyr filter select mutate rename tibble as_tibble full_join + #' @importFrom tidyr replace_na drop_na separate + #' @importFrom purrr map + #' @importFrom stringi stri_trans_general stri_trim_both stri_replace_all + #' @importFrom stringr str_to_title str_replace_all clean_common = function() { - self$data$clean <- self$data$raw[["main"]] %>% - select(date, region_name, cases_total, deaths_total, recovered_total) %>% + data_inputs <- self$data$raw[1:3] + flat_all <- map(map(vn_data_inputs, function(x) as_tibble(unlist(x), rownames="date")), + function(x) {x %>% separate(date, sep="[.]+", into=c(NA, "province", "date"))}) + self$data$clean <- full_join( + full_join( + vn_flat_all$case_by_time, vn_flat_all$death_by_time, by=c("province","date"),suffix=c(".cases", ".deaths"),copy=TRUE), + vn_flat_all$recovered_by_time, by=c("province","date"), suffix=c("",".recovered"), copy=TRUE) %>% + select(level_1_region_code=province, date, cases_total = value.cases, deaths_total=value.deaths, recovered_total = value) %>% + mutate(level_1_region_code = as.numeric(level_1_region_code)) %>% + left_join(self$data$raw$provinces%>%select(level_1_region_code=id,level_1_region=name), by=c("level_1_region_code")) + #select(date, region_name, cases_total, deaths_total, recovered_total) %>% mutate( cases_total = as.numeric(cases_total), deaths_total = as.numeric(deaths_total), recovered_total = as.numeric(recovered_total), - region_name = stringr::str_replace_all(region_name, "TP HCM", "Hochiminh"), + level_1_region = str_replace_all(level_1_region, "TP HCM", "Hochiminh"), ) %>% - tidyr::drop_na(date, region_name) %>% - rename(level_1_region = region_name) %>% + #tidyr::drop_na(date, region_name) %>% + #rename(level_1_region = region_name) %>% mutate( - level_1_region = stringi::stri_trans_general(level_1_region, "latin-ascii"), - level_1_region = stringi::stri_trim_both(level_1_region), - level_1_region = stringr::str_replace_all(level_1_region, "\\(.*\\)|-| ", ""), - level_1_region = stringr::str_to_title(level_1_region), - level_1_region = tidyr::replace_na(level_1_region, "Unknown") - ) %>% - left_join( - self$codes_lookup$`1`, - by = c("level_1_region" = "level_1_region") + level_1_region = stri_trans_general(level_1_region, "latin-ascii"), + level_1_region = stri_trim_both(level_1_region), + level_1_region = str_replace_all(level_1_region, "\\(.*\\)|-| ", ""), + level_1_region = str_to_title(level_1_region), + level_1_region = replace_na(level_1_region, "Unknown"), + level_1_region_code = paste0("VN-",level_1_region_code) ) + + # left_join( + # self$codes_lookup$`1`, + # by = c("level_1_region" = "level_1_region") + # ) } ) ) From 5681a2cb09f845c1b83e4bdc0b597a5d04008be8 Mon Sep 17 00:00:00 2001 From: Richard Martin-Nielsen Date: Fri, 17 Sep 2021 22:04:01 +0300 Subject: [PATCH 14/19] Fixing final glitches in clean_common --- R/Vietnam.R | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/R/Vietnam.R b/R/Vietnam.R index 1a61c465..403d12e7 100644 --- a/R/Vietnam.R +++ b/R/Vietnam.R @@ -114,6 +114,7 @@ Vietnam <- R6::R6Class("Vietnam", #' @importFrom purrr map #' @importFrom stringi stri_trans_general stri_trim_both stri_replace_all #' @importFrom stringr str_to_title str_replace_all + #' @importFrom lubridate dmy clean_common = function() { data_inputs <- self$data$raw[1:3] flat_all <- map(map(vn_data_inputs, function(x) as_tibble(unlist(x), rownames="date")), @@ -124,13 +125,14 @@ Vietnam <- R6::R6Class("Vietnam", vn_flat_all$recovered_by_time, by=c("province","date"), suffix=c("",".recovered"), copy=TRUE) %>% select(level_1_region_code=province, date, cases_total = value.cases, deaths_total=value.deaths, recovered_total = value) %>% mutate(level_1_region_code = as.numeric(level_1_region_code)) %>% - left_join(self$data$raw$provinces%>%select(level_1_region_code=id,level_1_region=name), by=c("level_1_region_code")) + left_join(self$data$raw$provinces%>%select(level_1_region_code=id,level_1_region=name), by=c("level_1_region_code")) %>% #select(date, region_name, cases_total, deaths_total, recovered_total) %>% mutate( cases_total = as.numeric(cases_total), deaths_total = as.numeric(deaths_total), recovered_total = as.numeric(recovered_total), - level_1_region = str_replace_all(level_1_region, "TP HCM", "Hochiminh"), + date = dmy(date), + level_1_region = str_replace_all(level_1_region, "TP HCM", "Hochiminh") ) %>% #tidyr::drop_na(date, region_name) %>% #rename(level_1_region = region_name) %>% From 2c20067c5b8199ffe53b8781b1784654d1ee2c0e Mon Sep 17 00:00:00 2001 From: Richard Martin-Nielsen Date: Sun, 19 Sep 2021 20:02:55 +0300 Subject: [PATCH 15/19] JSON-reading implementation of Vietnam Uses download_json method for downloading. Adjustment to the DataClass tests to deal with tables of lists. Addition of stringi to imported packages, and of fromJSON and jsonlinte to the WORDLIST. Tests run and data stored. --- DESCRIPTION | 1 + R/Vietnam.R | 128 ++++++++---------- R/test-DataClass.R | 3 +- data/all_country_data.rda | Bin 2867 -> 2933 bytes inst/WORDLIST | 2 + man/Vietnam.Rd | 3 +- .../testthat/custom_data/Vietnam_level_1.rds | Bin 0 -> 49730 bytes 7 files changed, 64 insertions(+), 73 deletions(-) create mode 100644 tests/testthat/custom_data/Vietnam_level_1.rds diff --git a/DESCRIPTION b/DESCRIPTION index 77d724f5..207ed1eb 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -95,6 +95,7 @@ Imports: R6, readxl, rlang, + stringi, stringr, tibble, tidyr (>= 1.0.0), diff --git a/R/Vietnam.R b/R/Vietnam.R index 578db160..f1d98afd 100644 --- a/R/Vietnam.R +++ b/R/Vietnam.R @@ -28,20 +28,23 @@ Vietnam <- R6::R6Class("Vietnam", supported_region_codes = list("1" = "iso_3166_2"), #' @field common_data_urls List of named links to raw data. common_data_urls = list( + # nolint start "case_by_time" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=case_by_time", "death_by_time" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=death_by_time", "recovered_by_time" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=recovered_by_time", "provinces" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces" + # nolint end ), #' @field source_data_cols existing columns within the raw data source_data_cols = c( "cases_total", "deaths_total", "recovered_total" ), #' @field source_text Plain text description of the source of the data - source_text = "Public COVID-19 for Vietnam, curated by NCSC's COVID-19 team", + source_text = + "Public COVID-19 for Vietnam, curated by NCSC's COVID-19 team", #' @field source_url Website address for explanation/introduction of the #' data - source_url = "https://covid.ncsc.gov.vn", # nolint + source_url = "https://covid.ncsc.gov.vn", #' @description Set up a table of region codes for clean data #' @importFrom tibble tibble @@ -49,61 +52,11 @@ Vietnam <- R6::R6Class("Vietnam", self$codes_lookup$`1` <- covidregionaldata::vietnam_codes }, - #' @description download function to get raw data - #' @importFrom tidyr replace_na drop_na - #' @importFrom lubridate dmy - #' @importFrom jsonlite fromJSON - download = function(){ + #' @description Download function to get raw data. Uses the + #' parent class JSON-specific method for downloads. + download = function() { super$download_JSON() }, - # function() { - # bundles_urls <- list( - # "case_by_time" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=case_by_time", - # "death_by_time" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=death_by_time", - # "recovered_by_time" = "https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=recovered_by_time" - # ) - # Sys.setenv("VROOM_CONNECTION_SIZE" = 131072 * 4) # Fix VROOM error - # provines_url <- "https://covid.ncsc.gov.vn/api/v3/covid/provinces" - # bundles <- names(bundles_urls) - # provines_data <- fromJSON(provines_url) - # - # get_bundles_data <- function(bundles) { - # bundles_data <- list() - # for (bundle in bundles) { - # url <- paste0("https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=", bundle) - # data <- fromJSON(url) - # bundles_data <- c(bundles_data, setNames(list(data), bundle)) - # } - # bundles_data - # } - # - # bundles_data <- get_bundles_data(bundles) - # - # get_province <- function(id, data) { - # row_dat <- provines_data[(id <- id), ] - # death_by_time <- do.call(cbind, data$death_by_time[id]) - # case_by_time <- do.call(cbind, data$case_by_time[id]) - # recovered_by_time <- do.call(cbind, data$recovered_by_time[id]) - # if (!identical(row.names(death_by_time), row.names(death_by_time))) { - # stop("Dates on case_by_time and death_by_time do not match!") - # } - # df <- tibble( - # date = dmy(row.names(case_by_time)), - # id = row_dat$id, - # name = row_dat$name, - # case_by_time = case_by_time, - # death_by_time = death_by_time, - # recovered_by_time = recovered_by_time - # ) - # df - # } - # - # df <- do.call(rbind, lapply(provines_data$id, function(id) { - # get_province(id, bundles_data) - # })) - # names(df) <- c("date", "id", "region_name", "cases_total", "deaths_total", "recovered_total") - # self$data$raw[["main"]] <- df - # }, #' @description Provincial Level Data #' cleaning @@ -116,31 +69,64 @@ Vietnam <- R6::R6Class("Vietnam", #' @importFrom stringr str_to_title str_replace_all #' @importFrom lubridate dmy clean_common = function() { + # The first three elements of self$data$raw are the data + # tables downloaded and so these can be processed identically + # data_inputs <- self$data$raw[1:3] - flat_all <- map(map(vn_data_inputs, function(x) as_tibble(unlist(x), rownames="date")), - function(x) {x %>% separate(date, sep="[.]+", into=c(NA, "province", "date"))}) + flat_all <- map( + map( + data_inputs, + function(x) as_tibble(unlist(x), + rownames = "date")), + function(y) { + y %>% separate(date, sep = "[.]+", into = c(NA, "province", "date")) + } + ) self$data$clean <- full_join( full_join( - vn_flat_all$case_by_time, vn_flat_all$death_by_time, by=c("province","date"),suffix=c(".cases", ".deaths"),copy=TRUE), - vn_flat_all$recovered_by_time, by=c("province","date"), suffix=c("",".recovered"), copy=TRUE) %>% - select(level_1_region_code=province, date, cases_total = value.cases, deaths_total=value.deaths, recovered_total = value) %>% - mutate(level_1_region_code = as.numeric(level_1_region_code)) %>% - left_join(self$data$raw$provinces%>%select(level_1_region_code=id,level_1_region=name), by=c("level_1_region_code")) %>% - #select(date, region_name, cases_total, deaths_total, recovered_total) %>% + flat_all$case_by_time, flat_all$death_by_time, + by = c("province", "date"), + suffix = c(".cases", ".deaths"), + copy = TRUE + ), + flat_all$recovered_by_time, + by = c("province", "date"), + suffix = c("", ".recovered"), + copy = TRUE + ) %>% + # The api uses integer codes for provinces which do not + # line up with ISO 3166-2 (some of which are not numbers) + # so we use this as a temporary code to line names up + # with data. + select( + ncsc_region_code = province, + date, + cases_total = value.cases, + deaths_total = value.deaths, + recovered_total = value) %>% + mutate(ncsc_region_code = as.numeric(ncsc_region_code)) %>% + left_join( + self$data$raw$provinces %>% + select(ncsc_region_code = id, level_1_region = name), + by = c("ncsc_region_code")) %>% + select( -ncsc_region_code ) %>% mutate( + date = dmy(date), cases_total = as.numeric(cases_total), deaths_total = as.numeric(deaths_total), recovered_total = as.numeric(recovered_total), - region_name = stringr::str_replace_all(region_name, "TP HCM", "Hochiminh"), + level_1_region = str_replace_all(level_1_region, + "TP HCM", "Hochiminh"), ) %>% - tidyr::drop_na(date, region_name) %>% - rename(level_1_region = region_name) %>% + # + #tidyr::drop_na(date, region_name) %>% mutate( - level_1_region = stringi::stri_trans_general(level_1_region, "latin-ascii"), - level_1_region = stringi::stri_trim_both(level_1_region), - level_1_region = stringr::str_replace_all(level_1_region, "\\(.*\\)|-| ", ""), - level_1_region = stringr::str_to_title(level_1_region), - level_1_region = tidyr::replace_na(level_1_region, "Unknown") + level_1_region = stri_trans_general(level_1_region, "latin-ascii"), + level_1_region = stri_trim_both(level_1_region), + level_1_region = str_replace_all(level_1_region, + "\\(.*\\)|-| ", ""), + level_1_region = str_to_title(level_1_region), + level_1_region = replace_na(level_1_region, "Unknown") ) %>% left_join( self$codes_lookup$`1`, diff --git a/R/test-DataClass.R b/R/test-DataClass.R index 4349124b..3c1408f3 100644 --- a/R/test-DataClass.R +++ b/R/test-DataClass.R @@ -102,7 +102,8 @@ test_download <- function(DataClass_obj, download, snapshot_path) { walk(DataClass_obj$data$raw, function(data) { testthat::expect_s3_class(data, "data.frame") testthat::expect_true(nrow(data) > 0) - testthat::expect_true(ncol(data) >= 2) + testthat::expect_true(ncol(data) >= 2 + || typeof(data[[1]])=="list") }) } ) diff --git a/data/all_country_data.rda b/data/all_country_data.rda index 4a1e847de9efc6e1da3cc51f9d6c7806e3d83abd..7498ad3c49bc969f6450a9c91062fe04d1749fad 100644 GIT binary patch literal 2933 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 literal 2867 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 \if{latex}{\out{\hypertarget{method-download}{}}} \subsection{Method \code{download()}}{ -download function to get raw data +Download function to get raw data. Uses the +parent class JSON-specific method for downloads. \subsection{Usage}{ \if{html}{\out{
}}\preformatted{Vietnam$download()}\if{html}{\out{
}} } diff --git a/tests/testthat/custom_data/Vietnam_level_1.rds b/tests/testthat/custom_data/Vietnam_level_1.rds new file mode 100644 index 0000000000000000000000000000000000000000..6758afb1fc7d31f5d521792d3b716e14a5ffe173 GIT binary patch literal 49730 zcmc$`2Ut_vwl;i3(alDM&|*PQsz?MCkxo=VK$?O|s9^(wNH0=DBBGE`rEh8!QB)9& zC`Fnjkq!z9A`l<~p$H+g1PIALgL|KH&$-Wc?)RMke&$(|tTmIk)?9Or@s4-AV@byU z@|VqjTW5#(P!3n~IrQNg+zg$x?_hlpqS?`_KXg5de1kBX+X)sB9EYLwlvnAX*|n1PcJd~ z(WlSqIxuNxGBRL0GC(h7-k|h_JQ+TW4vgQ(+`iE(hcb-cNa8_PF?A>cad2_E;l3q9 zer6g3^YkWMMUQPC%|`LF?rh&Er(lFJCM+Gg01+-Se3V_z!}g_fMCL7|*)_~Q%J7H+ z+dG==5Wlg$n<2SxDHF>%p~vQHAOmFAa`q~9F zfmL9)TFo>kupDhx?THKPXU9t@zHywAZR`|g6NJ;XbG6uv$>3!*dDj|})gpT1LPRAG zqVF;H&`FRs{7iU5wKt;`Q@-4aH;I6c4OU%%(V&r8apPUo#ScU%_9}keLYNcJZ0lSc zj|^m2kd%WZ?lNYgV&leXcH76AkRRn6E}+s7x}C7QIyTi=%uDn@;)3ogBe⪻B*D& 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℞-aE&ML%irg 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 literal 0 HcmV?d00001 From 26cd8ad718d694ccf835b9354128e15a10251ff1 Mon Sep 17 00:00:00 2001 From: Richard Martin-Nielsen Date: Sun, 19 Sep 2021 21:19:07 +0300 Subject: [PATCH 16/19] Remove prefixes in vietnam_codes.R --- data-raw/vietnam_codes.R | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/data-raw/vietnam_codes.R b/data-raw/vietnam_codes.R index 438c1031..bdba31fc 100644 --- a/data-raw/vietnam_codes.R +++ b/data-raw/vietnam_codes.R @@ -23,10 +23,10 @@ vietnam_codes <- data.frame( stringsAsFactors = FALSE ) %>% mutate( - level_1_region = stringi::stri_trans_general(level_1_region, "latin-ascii"), - level_1_region = stringi::stri_trim_both(level_1_region), - level_1_region = stringr::str_replace_all(level_1_region, '\\(.*\\)|-| ', ''), - level_1_region = stringr::str_to_title(level_1_region) + level_1_region = stri_trans_general(level_1_region, "latin-ascii"), + level_1_region = stri_trim_both(level_1_region), + level_1_region = str_replace_all(level_1_region, '\\(.*\\)|-| ', ''), + level_1_region = str_to_title(level_1_region) ) # update package region_codes From 9c35694df1cf9c5d77176f94febfd5a2014e1288 Mon Sep 17 00:00:00 2001 From: Richard Martin-Nielsen Date: Sun, 19 Sep 2021 21:23:51 +0300 Subject: [PATCH 17/19] lint cleaning --- R/Vietnam.R | 4 ++-- R/test-DataClass.R | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/R/Vietnam.R b/R/Vietnam.R index f1d98afd..ebc35abb 100644 --- a/R/Vietnam.R +++ b/R/Vietnam.R @@ -109,7 +109,7 @@ Vietnam <- R6::R6Class("Vietnam", self$data$raw$provinces %>% select(ncsc_region_code = id, level_1_region = name), by = c("ncsc_region_code")) %>% - select( -ncsc_region_code ) %>% + select(-ncsc_region_code) %>% mutate( date = dmy(date), cases_total = as.numeric(cases_total), @@ -118,7 +118,7 @@ Vietnam <- R6::R6Class("Vietnam", level_1_region = str_replace_all(level_1_region, "TP HCM", "Hochiminh"), ) %>% - # + # #tidyr::drop_na(date, region_name) %>% mutate( level_1_region = stri_trans_general(level_1_region, "latin-ascii"), diff --git a/R/test-DataClass.R b/R/test-DataClass.R index 3c1408f3..e6f7f2fd 100644 --- a/R/test-DataClass.R +++ b/R/test-DataClass.R @@ -103,7 +103,7 @@ test_download <- function(DataClass_obj, download, snapshot_path) { testthat::expect_s3_class(data, "data.frame") testthat::expect_true(nrow(data) > 0) testthat::expect_true(ncol(data) >= 2 - || typeof(data[[1]])=="list") + || typeof(data[[1]]) == "list") }) } ) From 4b26675107f2a67eafd598d25f45f978f8002e3c Mon Sep 17 00:00:00 2001 From: Sam Abbott Date: Mon, 20 Sep 2021 11:06:33 +0100 Subject: [PATCH 18/19] Update DESCRIPTION --- DESCRIPTION | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/DESCRIPTION b/DESCRIPTION index 207ed1eb..262c9961 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,6 +1,6 @@ Package: covidregionaldata Title: Subnational Data for COVID-19 Epidemiology -Version: 0.9.2.1000 +Version: 0.9.2.2000 Authors@R: c(person(given = "Joseph", family = "Palmer", From d1232f1ff1f3d096ac8953194003cd654d850883 Mon Sep 17 00:00:00 2001 From: seabbs Date: Mon, 27 Sep 2021 11:52:46 +0000 Subject: [PATCH 19/19] update description, news and run tests --- .devcontainer/Dockerfile | 3 +- .devcontainer/devcontainer.json | 4 +- DESCRIPTION | 8 ++- NEWS.md | 5 +- inst/WORDLIST | 66 ++++++++++++++++++ .../testthat/custom_data/Estonia_level_1.rds | Bin 0 -> 3298 bytes 6 files changed, 80 insertions(+), 6 deletions(-) create mode 100644 tests/testthat/custom_data/Estonia_level_1.rds diff --git a/.devcontainer/Dockerfile b/.devcontainer/Dockerfile index a66ad0aa..75442281 100644 --- a/.devcontainer/Dockerfile +++ b/.devcontainer/Dockerfile @@ -38,7 +38,8 @@ RUN install2.r --error --skipinstalled --repos ${CRAN} --ncpus -1 \ RUN apt-get update \ && export DEBIAN_FRONTEND=noninteractive \ && apt-get -y install --no-install-recommends libgdal-dev \ - libudunits2-dev libharfbuzz-dev libfribidi-dev + libudunits2-dev libharfbuzz-dev libfribidi-dev \ + libjq-dev libprotobuf-dev # install dependencies COPY DESCRIPTION /tmp/package/DESCRIPTION diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json index e2a87fc7..f4c1f7db 100644 --- a/.devcontainer/devcontainer.json +++ b/.devcontainer/devcontainer.json @@ -23,7 +23,9 @@ "extensions": [ "ikuyadeu.r", "reditorsupport.r-lsp", - "shan.code-settings-sync" + "shan.code-settings-sync", + "searking.preview-vscode", + "tht13.html-preview-vscode" ], // Use 'forwardPorts' to make a list of ports inside the container available locally. diff --git a/DESCRIPTION b/DESCRIPTION index 262c9961..20e44186 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,6 +1,6 @@ Package: covidregionaldata Title: Subnational Data for COVID-19 Epidemiology -Version: 0.9.2.2000 +Version: 0.9.2.3000 Authors@R: c(person(given = "Joseph", family = "Palmer", @@ -55,6 +55,10 @@ Authors@R: family = "Gruson", role = "ctb", comment = c(ORCID = "0000-0002-4094-1476")), + person(given = "Vang", + family = "Le", + role = "ctb", + comment = c(URL = "https://github.com/biocyberman")), person(given = "Sebastian", family = "Funk", role = "aut", @@ -102,7 +106,7 @@ Imports: tidyselect, vroom, withr, - xml2, + xml2 Suggests: ggplot2, ggspatial, diff --git a/NEWS.md b/NEWS.md index 38acad4c..27fe3285 100644 --- a/NEWS.md +++ b/NEWS.md @@ -4,11 +4,12 @@ This release is currrently under development ## New data sets -- Support for level 1 region data in Estonia (thanks to @RichardMN). See `?Estonia` for details. +- Support for level 1 region data in Estonia (thanks to @RichardMN). See `?Estonia` for details. +- Support for level 1 region data in Vietnam (thanks to @biocyberman). See `?Vietname` for details. # covidregionaldata 0.9.2 -This release adds support for the Covid19 Data Hub which includes Google and Apple mobility data amongst a large range of other data sets, data from the European Commission's Joint Research Centre which is at both the regional and national level, and individual sources for regional data from several countries. Package updates have been made in line with a software review at the [Journal of Open Source Software](https://github.com/openjournals/joss-reviews/issues/3290). Finally, this release exposes more of the testing infrastructure to users and adds a package hexsticker. +This release adds support for the Covid19 Data Hub which includes Google and Apple mobility data amongst a large range of other data sets, data from the European Commission's Joint Research Centre which is at both the regional and national level, and individual sources for regional data from several countries. Package updates have been made in line with a software review at the [Journal of Open Source Software](https://github.com/openjournals/joss-reviews/issues/3290). Finally, this release exposes more of the testing infrastructure to users and adds a package hexsticker. Thanks to @joseph-palmer, @RichardMN, and @kathsherratt for contributions towards this release. diff --git a/inst/WORDLIST b/inst/WORDLIST index 94e9ecfe..e3fb521e 100644 --- a/inst/WORDLIST +++ b/inst/WORDLIST @@ -1,108 +1,174 @@ +abbott ac ACAPS afghanistan api APL apskritis +aut BB BBSRC +bevan +biocyberman +BugReports Bundesland +campbell cloneable CMD CMMID Codecov com +Config conuntry Cota countries’ +countrycode CoV covid Covid COVID +covidregionaldata +cre CSSE +ctb +currrently DataClass datahub dd DD documentaion doi +dplyr ec ECDC +epiforecasts Estados etc filepath +flavio +Flavio fns fromJSON +gb geocode geocoding +ggplot +ggspatial github Github GoogleData +Gruson Guidotti +hellewell +Hellewell hexsticker +httr ICD inegi INEGI Inf initalize Initalize +io IPC iso JHU +joe +joel +jonnie +Jonnie jrc JRC jsonlite jure +katharine +knitr Kreise Landkreis +LazyData +lifecycle linelist Linelist linelists +lshtm ltla +lubridate magrittr md +Meakin +meaking Meixco memoise metacran +msf MX Nam nhs nhsregions nr OpenDataZH +ORCID org OSP params +patrick +paul paulcampbell PHE +pkgdown PRs +purrr quickstart +rboyes rds +readxl recomended regioni reparameterise +rhul +RichardMN +rlang +rmarkdown +Roxygen +RoxygenNote +rvest RVIM +rworldmap +sam SARS savivaldybe SciELOPreprints +sebastian seperate shapefiles +sherratt +Sherratt +sophie SouthAfrica spi st +stringi +stringr subnationaldata subnationally supertracker +tessella testthat tibble tibbles +tidyr +tidyselect UCPM uk urls useMemoise +usethis utla +Vang +VignetteBuilder Wellcome wikipedia +withr yaml yyyy YYYY diff --git a/tests/testthat/custom_data/Estonia_level_1.rds b/tests/testthat/custom_data/Estonia_level_1.rds new file mode 100644 index 0000000000000000000000000000000000000000..7a285cf5506e359e9ad75e543c3a6343ff2ed047 GIT binary patch literal 3298 zcmaJ;dpy&7AFrp=ah%R+DkZ|NLT+VsN`!4Gw-85>lx<4os8fis4O<-vDNAn2?YM

s8 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 Kl4IfP*8Lk1A}PuM literal 0 HcmV?d00001

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 diff --git a/man/figures/README-uk_plot-1.png b/man/figures/README-uk_plot-1.png index 7f0f3d83fd0027729d48b63613dceba622256761..8a19f88a059be37af4c1deae82dd60b19ac16833 100644 GIT binary patch literal 62810 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 JLH0xB{{czTVy^%I literal 59389 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 LJ=MyGwh{jY1MWPg diff --git a/man/vietnam_codes.Rd b/man/vietnam_codes.Rd new file mode 100644 index 00000000..00bf8534 --- /dev/null +++ b/man/vietnam_codes.Rd @@ -0,0 +1,19 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/datasets.R +\docType{data} +\name{vietnam_codes} +\alias{vietnam_codes} +\title{Region Codes for Vietnam Dataset.} +\format{ +An object of class \code{data.frame} with 63 rows and 2 columns. +} +\usage{ +vietnam_codes +} +\value{ +A tibble of region codes and related information. +} +\description{ +The region codes for Viet Nam +} +\keyword{datasets} From cd25e34047b3010b978d583b35535a31845cd37a Mon Sep 17 00:00:00 2001 From: biocyberman Date: Thu, 2 Sep 2021 21:17:11 +0200 Subject: [PATCH 06/19] Add empty locations to Unknown --- R/Vietnam.R | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/R/Vietnam.R b/R/Vietnam.R index 3a9e0567..ba5735b8 100644 --- a/R/Vietnam.R +++ b/R/Vietnam.R @@ -74,7 +74,8 @@ Vietnam <- R6::R6Class("Vietnam", level_1_region = stringi::stri_trans_general(level_1_region, "latin-ascii"), level_1_region = stringi::stri_trim_both(level_1_region), level_1_region = stringr::str_replace_all(level_1_region, '\\(.*\\)|-| ', ''), - level_1_region = stringr::str_to_title(level_1_region) + level_1_region = stringr::str_to_title(level_1_region), + level_1_region = tidyr::replace_na(level_1_region, "Unknown") ) %>% left_join( self$codes_lookup$`1`, From 7edc95c9ca154cff70ce29451ddb72eb84c57844 Mon Sep 17 00:00:00 2001 From: biocyberman Date: Mon, 13 Sep 2021 00:31:35 +0200 Subject: [PATCH 07/19] Update with cases_death from 5F team --- R/Vietnam.R | 29 ++++++++++++++++++++--------- 1 file changed, 20 insertions(+), 9 deletions(-) diff --git a/R/Vietnam.R b/R/Vietnam.R index ba5735b8..8ba1eb49 100644 --- a/R/Vietnam.R +++ b/R/Vietnam.R @@ -36,7 +36,7 @@ Vietnam <- R6::R6Class("Vietnam", # nolint end #' @field source_data_cols existing columns within the raw data source_data_cols = c( - "cases_new" + "cases_new", "deaths_total" ), #' @field source_text Plain text description of the source of the data source_text = "Public COVID-19 data curated by 5F team", @@ -59,17 +59,28 @@ Vietnam <- R6::R6Class("Vietnam", #' @importFrom lubridate dmy clean_common = function() { self$data$clean <- self$data$raw[["main"]] %>% - `colnames<-`(c('date', 'region', 'cases_new', 'case_group')) %>% + `colnames<-`(c('date', 'region', 'cases_new', + 'case_group', 'deaths_date', + 'deaths_region', 'deaths_total')) %>% select( - date, - region, - cases_new + date, region, cases_new, deaths_date, + deaths_region, deaths_total ) %>% + mutate(date = dmy(date), + deaths_date = dmy(deaths_date), + cases_new = as.numeric(cases_new), + deaths_total = as.numeric(deaths_total)) %>% + full_join(x = select(., date, region, cases_new)%>% + group_by(date, region)%>% + mutate(cases_new=sum(cases_new))%>%distinct(), + y=select(., deaths_date, deaths_region, deaths_total) %>% + group_by(deaths_date, deaths_region)%>% + mutate(deaths_total=first(deaths_total))%>%distinct(), + by=c("date" = "deaths_date", + "region" = "deaths_region" + )) %>% + tidyr::drop_na(date, region) %>% rename(level_1_region = region) %>% - mutate( - date = dmy(date), - cases_new = as.numeric(cases_new) - )%>% mutate( level_1_region = stringi::stri_trans_general(level_1_region, "latin-ascii"), level_1_region = stringi::stri_trim_both(level_1_region), From 7ca169a96f4764a4e5ee6fa49a30c8e8d00ea5f5 Mon Sep 17 00:00:00 2001 From: biocyberman Date: Mon, 13 Sep 2021 19:09:18 +0200 Subject: [PATCH 08/19] Change data source for Vietnam --- R/Vietnam.R | 83 +++++++++++++++++++++++++++++++++++------------------ 1 file changed, 55 insertions(+), 28 deletions(-) diff --git a/R/Vietnam.R b/R/Vietnam.R index 8ba1eb49..9afa1eea 100644 --- a/R/Vietnam.R +++ b/R/Vietnam.R @@ -31,18 +31,21 @@ Vietnam <- R6::R6Class("Vietnam", #' @field common_data_urls List of named links to raw data. # nolint start common_data_urls = list( - "main" = "https://docs.google.com/spreadsheets/d/1_d7oK-SKj-7KrWAW7DbGYEad2JO4TyR7ApsUAuoiH5g/export?format=csv&gid=0" + "case_by_time" = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=case_by_time', + "death_by_time" = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=death_by_time', + "recovered_by_time" = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=recovered_by_time' + ), # nolint end #' @field source_data_cols existing columns within the raw data source_data_cols = c( - "cases_new", "deaths_total" + "cases_total", "deaths_total", "recovered_total" ), #' @field source_text Plain text description of the source of the data source_text = "Public COVID-19 data curated by 5F team", #' @field source_url Website address for explanation/introduction of the #' data - source_url = "https://datastudio.google.com/u/0/reporting/1cc8d45e-2c74-4084-af70-cbbe60f1660e/page/bLUVC", # nolint + source_url = "https://covid.ncsc.gov.vn", # nolint #' @description Set up a table of region codes for clean data #' @importFrom tibble tibble @@ -55,32 +58,56 @@ Vietnam <- R6::R6Class("Vietnam", #' @param ... pass additional arguments #' #' @importFrom dplyr filter select mutate rename - #' @importFrom tidyr replace_na - #' @importFrom lubridate dmy + #' @importFrom tidyr replace_na drop_na + #' @importFrom lubridate dmy + #' @importFrom jsonlite fromJSON clean_common = function() { - self$data$clean <- self$data$raw[["main"]] %>% - `colnames<-`(c('date', 'region', 'cases_new', - 'case_group', 'deaths_date', - 'deaths_region', 'deaths_total')) %>% - select( - date, region, cases_new, deaths_date, - deaths_region, deaths_total - ) %>% - mutate(date = dmy(date), - deaths_date = dmy(deaths_date), - cases_new = as.numeric(cases_new), - deaths_total = as.numeric(deaths_total)) %>% - full_join(x = select(., date, region, cases_new)%>% - group_by(date, region)%>% - mutate(cases_new=sum(cases_new))%>%distinct(), - y=select(., deaths_date, deaths_region, deaths_total) %>% - group_by(deaths_date, deaths_region)%>% - mutate(deaths_total=first(deaths_total))%>%distinct(), - by=c("date" = "deaths_date", - "region" = "deaths_region" - )) %>% - tidyr::drop_na(date, region) %>% - rename(level_1_region = region) %>% + Sys.setenv("VROOM_CONNECTION_SIZE" = 131072*4) # Fix VROOM error + provines_url = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces' + bundles = names(self$data$raw) + provines_data = jsonlite::fromJSON(provines_url) + + get_bundles_data = function(bundles){ + bundles_data = list() + for (bundle in bundles){ + url = paste0('https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=', bundle) + data = jsonlite::fromJSON(url) + bundles_data = c(bundles_data, setNames(list(data), bundle)) + } + bundles_data + } + + bundles_data = get_bundles_data(bundles) + + get_province = function(id, data){ + row_dat = provines_data[(id=id),] + death_by_time= do.call(cbind, data$death_by_time[id]) + case_by_time=do.call(cbind, data$case_by_time[id]) + recovered_by_time=do.call(cbind, data$recovered_by_time[id]) + if (!identical(row.names(death_by_time), row.names(death_by_time))) { + stop("Dates on case_by_time and death_by_time do not match!") + } + df = dplyr::tibble(date= lubridate::dmy(row.names(case_by_time)), + id = row_dat$id, + name = row_dat$name, + case_by_time= case_by_time, + death_by_time= death_by_time, + recovered_by_time= recovered_by_time) + df + } + + df = do.call(rbind, lapply(provines_data$id, function(id){get_province(id, bundles_data)})) + names(df) <- c("date", "id", "region_name", "cases_total", "deaths_total", "recovered_total") + + self$data$clean <- df %>% + select( date, region_name, cases_total, deaths_total, recovered_total) %>% + mutate(cases_total = as.numeric(cases_total), + deaths_total = as.numeric(deaths_total), + recovered_total = as.numeric(recovered_total), + region_name = stringr::str_replace_all(region_name, 'TP HCM', 'Hochiminh'), + ) %>% + tidyr::drop_na(date, region_name) %>% + rename(level_1_region = region_name) %>% mutate( level_1_region = stringi::stri_trans_general(level_1_region, "latin-ascii"), level_1_region = stringi::stri_trim_both(level_1_region), From 29070dd0429e7bb674f73e5eee198915b2e9661a Mon Sep 17 00:00:00 2001 From: biocyberman Date: Wed, 15 Sep 2021 21:36:40 +0200 Subject: [PATCH 09/19] Refactor code for PR #413 --- DESCRIPTION | 3 +- NAMESPACE | 2 ++ R/Vietnam.R | 81 +++++++++++++++++++++++++++----------------------- man/Vietnam.Rd | 14 +++++++-- 4 files changed, 59 insertions(+), 41 deletions(-) diff --git a/DESCRIPTION b/DESCRIPTION index 86fd1d5f..87d1d841 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -86,6 +86,7 @@ Imports: countrycode (>= 1.2.0), dplyr, httr, + jsonlite, lifecycle, lubridate, magrittr, @@ -100,7 +101,7 @@ Imports: tidyselect, vroom, withr, - xml2 + xml2, Suggests: ggplot2, ggspatial, diff --git a/NAMESPACE b/NAMESPACE index 37b43471..4c694bca 100644 --- a/NAMESPACE +++ b/NAMESPACE @@ -74,12 +74,14 @@ importFrom(dplyr,slice_tail) importFrom(dplyr,starts_with) importFrom(dplyr,summarise) importFrom(dplyr,tally) +importFrom(dplyr,tibble) importFrom(dplyr,ungroup) importFrom(dplyr,vars) importFrom(httr,GET) importFrom(httr,POST) importFrom(httr,content) importFrom(httr,status_code) +importFrom(jsonlite,fromJSON) importFrom(lifecycle,deprecate_warn) importFrom(lifecycle,deprecated) importFrom(lifecycle,is_present) diff --git a/R/Vietnam.R b/R/Vietnam.R index 9afa1eea..22ed8302 100644 --- a/R/Vietnam.R +++ b/R/Vietnam.R @@ -4,9 +4,7 @@ #' @description Information for downloading, cleaning #' and processing covid-19 region data for Vietnam. #' -# nolint start -#' @source \url{https://github.com/biocyberman/covidregionaldata/} -# nolint end +#' @source \url{https://covid.ncsc.gov.vn} #' @export #' @concept dataset #' @family subnational @@ -15,11 +13,12 @@ #' region <- Vietnam$new(verbose = TRUE, steps = TRUE, get = TRUE) #' region$return() #' } +# nolint start Vietnam <- R6::R6Class("Vietnam", inherit = DataClass, public = list( - # Core Attributes (amend each paramater for country specific infomation) + # Core Attributes (amend each parameter for country specific information) #' @field origin name of country to fetch data for origin = "Vietnam", #' @field supported_levels List of supported levels. @@ -27,22 +26,15 @@ Vietnam <- R6::R6Class("Vietnam", #' @field supported_region_names List of region names in order of level. supported_region_names = list("1" = "region"), #' @field supported_region_codes List of region codes in order of level. - supported_region_codes = list("1" = "is_3166_2"), + supported_region_codes = list("1" = "iso_3166_2"), #' @field common_data_urls List of named links to raw data. - # nolint start - common_data_urls = list( - "case_by_time" = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=case_by_time', - "death_by_time" = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=death_by_time', - "recovered_by_time" = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=recovered_by_time' - - ), - # nolint end + common_data_urls = list(), #' @field source_data_cols existing columns within the raw data source_data_cols = c( "cases_total", "deaths_total", "recovered_total" ), #' @field source_text Plain text description of the source of the data - source_text = "Public COVID-19 data curated by 5F team", + source_text = "Public COVID-19 for Vietnam, curated by NCSC's COVID-19 team", #' @field source_url Website address for explanation/introduction of the #' data source_url = "https://covid.ncsc.gov.vn", # nolint @@ -53,26 +45,28 @@ Vietnam <- R6::R6Class("Vietnam", self$codes_lookup$`1` <- covidregionaldata::vietnam_codes }, - #' @description Provincial Level Data - #' cleaning - #' @param ... pass additional arguments - #' - #' @importFrom dplyr filter select mutate rename + #' @description download function to get raw data #' @importFrom tidyr replace_na drop_na - #' @importFrom lubridate dmy + #' @importFrom lubridate dmy #' @importFrom jsonlite fromJSON - clean_common = function() { - Sys.setenv("VROOM_CONNECTION_SIZE" = 131072*4) # Fix VROOM error + download = function() { + bundles_urls = list( + "case_by_time" = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=case_by_time', + "death_by_time" = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=death_by_time', + "recovered_by_time" = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=recovered_by_time' + + ) + Sys.setenv("VROOM_CONNECTION_SIZE" = 131072*4) # Fix VROOM error provines_url = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces' - bundles = names(self$data$raw) - provines_data = jsonlite::fromJSON(provines_url) + bundles = names(bundles_urls) + provines_data = fromJSON(provines_url) get_bundles_data = function(bundles){ bundles_data = list() - for (bundle in bundles){ + for (bundle in bundles){ url = paste0('https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=', bundle) - data = jsonlite::fromJSON(url) - bundles_data = c(bundles_data, setNames(list(data), bundle)) + data = fromJSON(url) + bundles_data = c(bundles_data, setNames(list(data), bundle)) } bundles_data } @@ -82,30 +76,39 @@ Vietnam <- R6::R6Class("Vietnam", get_province = function(id, data){ row_dat = provines_data[(id=id),] death_by_time= do.call(cbind, data$death_by_time[id]) - case_by_time=do.call(cbind, data$case_by_time[id]) - recovered_by_time=do.call(cbind, data$recovered_by_time[id]) + case_by_time=do.call(cbind, data$case_by_time[id]) + recovered_by_time=do.call(cbind, data$recovered_by_time[id]) if (!identical(row.names(death_by_time), row.names(death_by_time))) { stop("Dates on case_by_time and death_by_time do not match!") } - df = dplyr::tibble(date= lubridate::dmy(row.names(case_by_time)), - id = row_dat$id, - name = row_dat$name, - case_by_time= case_by_time, - death_by_time= death_by_time, - recovered_by_time= recovered_by_time) + df = tibble(date= dmy(row.names(case_by_time)), + id = row_dat$id, + name = row_dat$name, + case_by_time= case_by_time, + death_by_time= death_by_time, + recovered_by_time= recovered_by_time) df } df = do.call(rbind, lapply(provines_data$id, function(id){get_province(id, bundles_data)})) names(df) <- c("date", "id", "region_name", "cases_total", "deaths_total", "recovered_total") - - self$data$clean <- df %>% + self$data$raw[['main']] = df + }, + + #' @description Provincial Level Data + #' cleaning + #' @param ... pass additional arguments + #' + #' @importFrom dplyr filter select mutate rename tibble + #' @importFrom tidyr replace_na drop_na + clean_common = function() { + self$data$clean <- self$data$raw[['main']] %>% select( date, region_name, cases_total, deaths_total, recovered_total) %>% mutate(cases_total = as.numeric(cases_total), deaths_total = as.numeric(deaths_total), recovered_total = as.numeric(recovered_total), region_name = stringr::str_replace_all(region_name, 'TP HCM', 'Hochiminh'), - ) %>% + ) %>% tidyr::drop_na(date, region_name) %>% rename(level_1_region = region_name) %>% mutate( @@ -120,5 +123,7 @@ Vietnam <- R6::R6Class("Vietnam", by = c("level_1_region" = "level_1_region") ) } + ) ) +# nolint end diff --git a/man/Vietnam.Rd b/man/Vietnam.Rd index 20f22e4b..56f9876e 100644 --- a/man/Vietnam.Rd +++ b/man/Vietnam.Rd @@ -5,7 +5,7 @@ \title{Vietnam Class for downloading, cleaning and processing notification data} \source{ -\url{https://github.com/biocyberman/covidregionaldata/} +\url{https://covid.ncsc.gov.vn} } \description{ Information for downloading, cleaning @@ -70,6 +70,7 @@ data} \subsection{Public methods}{ \itemize{ \item \href{#method-set_region_codes}{\code{Vietnam$set_region_codes()}} +\item \href{#method-download}{\code{Vietnam$download()}} \item \href{#method-clean_common}{\code{Vietnam$clean_common()}} \item \href{#method-clone}{\code{Vietnam$clone()}} } @@ -79,7 +80,6 @@ data} \itemize{ \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-available_regions}{\code{covidregionaldata::DataClass$available_regions()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-clean}{\code{covidregionaldata::DataClass$clean()}}\out{} -\item \out{}\href{../../covidregionaldata/html/DataClass.html#method-download}{\code{covidregionaldata::DataClass$download()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-filter}{\code{covidregionaldata::DataClass$filter()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-get}{\code{covidregionaldata::DataClass$get()}}\out{} \item \out{}\href{../../covidregionaldata/html/DataClass.html#method-initialize}{\code{covidregionaldata::DataClass$initialize()}}\out{} @@ -99,6 +99,16 @@ Set up a table of region codes for clean data \if{html}{\out{

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 diff --git a/man/figures/README-uk_plot-1.png b/man/figures/README-uk_plot-1.png index 7f0f3d83fd0027729d48b63613dceba622256761..8a19f88a059be37af4c1deae82dd60b19ac16833 100644 GIT binary patch literal 62810 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 JLH0xB{{czTVy^%I literal 59389 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 LJ=MyGwh{jY1MWPg diff --git a/man/vietnam_codes.Rd b/man/vietnam_codes.Rd new file mode 100644 index 00000000..00bf8534 --- /dev/null +++ b/man/vietnam_codes.Rd @@ -0,0 +1,19 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/datasets.R +\docType{data} +\name{vietnam_codes} +\alias{vietnam_codes} +\title{Region Codes for Vietnam Dataset.} +\format{ +An object of class \code{data.frame} with 63 rows and 2 columns. +} +\usage{ +vietnam_codes +} +\value{ +A tibble of region codes and related information. +} +\description{ +The region codes for Viet Nam +} +\keyword{datasets} From 4f57d0f14cd5158889a7f7d9761c8d6898db5df0 Mon Sep 17 00:00:00 2001 From: Vang Le-Quy Date: Thu, 2 Sep 2021 21:17:11 +0200 Subject: [PATCH 02/19] Add empty locations to Unknown --- R/Vietnam.R | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/R/Vietnam.R b/R/Vietnam.R index 3a9e0567..ba5735b8 100644 --- a/R/Vietnam.R +++ b/R/Vietnam.R @@ -74,7 +74,8 @@ Vietnam <- R6::R6Class("Vietnam", level_1_region = stringi::stri_trans_general(level_1_region, "latin-ascii"), level_1_region = stringi::stri_trim_both(level_1_region), level_1_region = stringr::str_replace_all(level_1_region, '\\(.*\\)|-| ', ''), - level_1_region = stringr::str_to_title(level_1_region) + level_1_region = stringr::str_to_title(level_1_region), + level_1_region = tidyr::replace_na(level_1_region, "Unknown") ) %>% left_join( self$codes_lookup$`1`, From a66539fc6104f126ece19ca50b4ce4a71ec78edd Mon Sep 17 00:00:00 2001 From: Vang Le-Quy Date: Mon, 13 Sep 2021 00:31:35 +0200 Subject: [PATCH 03/19] Update with cases_death from 5F team --- R/Vietnam.R | 29 ++++++++++++++++++++--------- 1 file changed, 20 insertions(+), 9 deletions(-) diff --git a/R/Vietnam.R b/R/Vietnam.R index ba5735b8..8ba1eb49 100644 --- a/R/Vietnam.R +++ b/R/Vietnam.R @@ -36,7 +36,7 @@ Vietnam <- R6::R6Class("Vietnam", # nolint end #' @field source_data_cols existing columns within the raw data source_data_cols = c( - "cases_new" + "cases_new", "deaths_total" ), #' @field source_text Plain text description of the source of the data source_text = "Public COVID-19 data curated by 5F team", @@ -59,17 +59,28 @@ Vietnam <- R6::R6Class("Vietnam", #' @importFrom lubridate dmy clean_common = function() { self$data$clean <- self$data$raw[["main"]] %>% - `colnames<-`(c('date', 'region', 'cases_new', 'case_group')) %>% + `colnames<-`(c('date', 'region', 'cases_new', + 'case_group', 'deaths_date', + 'deaths_region', 'deaths_total')) %>% select( - date, - region, - cases_new + date, region, cases_new, deaths_date, + deaths_region, deaths_total ) %>% + mutate(date = dmy(date), + deaths_date = dmy(deaths_date), + cases_new = as.numeric(cases_new), + deaths_total = as.numeric(deaths_total)) %>% + full_join(x = select(., date, region, cases_new)%>% + group_by(date, region)%>% + mutate(cases_new=sum(cases_new))%>%distinct(), + y=select(., deaths_date, deaths_region, deaths_total) %>% + group_by(deaths_date, deaths_region)%>% + mutate(deaths_total=first(deaths_total))%>%distinct(), + by=c("date" = "deaths_date", + "region" = "deaths_region" + )) %>% + tidyr::drop_na(date, region) %>% rename(level_1_region = region) %>% - mutate( - date = dmy(date), - cases_new = as.numeric(cases_new) - )%>% mutate( level_1_region = stringi::stri_trans_general(level_1_region, "latin-ascii"), level_1_region = stringi::stri_trim_both(level_1_region), From 0f0cafb4751a4599037f59a1bf88ee6e9dc0e660 Mon Sep 17 00:00:00 2001 From: Vang Le-Quy Date: Mon, 13 Sep 2021 19:09:18 +0200 Subject: [PATCH 04/19] Change data source for Vietnam --- R/Vietnam.R | 83 +++++++++++++++++++++++++++++++++++------------------ 1 file changed, 55 insertions(+), 28 deletions(-) diff --git a/R/Vietnam.R b/R/Vietnam.R index 8ba1eb49..9afa1eea 100644 --- a/R/Vietnam.R +++ b/R/Vietnam.R @@ -31,18 +31,21 @@ Vietnam <- R6::R6Class("Vietnam", #' @field common_data_urls List of named links to raw data. # nolint start common_data_urls = list( - "main" = "https://docs.google.com/spreadsheets/d/1_d7oK-SKj-7KrWAW7DbGYEad2JO4TyR7ApsUAuoiH5g/export?format=csv&gid=0" + "case_by_time" = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=case_by_time', + "death_by_time" = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=death_by_time', + "recovered_by_time" = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=recovered_by_time' + ), # nolint end #' @field source_data_cols existing columns within the raw data source_data_cols = c( - "cases_new", "deaths_total" + "cases_total", "deaths_total", "recovered_total" ), #' @field source_text Plain text description of the source of the data source_text = "Public COVID-19 data curated by 5F team", #' @field source_url Website address for explanation/introduction of the #' data - source_url = "https://datastudio.google.com/u/0/reporting/1cc8d45e-2c74-4084-af70-cbbe60f1660e/page/bLUVC", # nolint + source_url = "https://covid.ncsc.gov.vn", # nolint #' @description Set up a table of region codes for clean data #' @importFrom tibble tibble @@ -55,32 +58,56 @@ Vietnam <- R6::R6Class("Vietnam", #' @param ... pass additional arguments #' #' @importFrom dplyr filter select mutate rename - #' @importFrom tidyr replace_na - #' @importFrom lubridate dmy + #' @importFrom tidyr replace_na drop_na + #' @importFrom lubridate dmy + #' @importFrom jsonlite fromJSON clean_common = function() { - self$data$clean <- self$data$raw[["main"]] %>% - `colnames<-`(c('date', 'region', 'cases_new', - 'case_group', 'deaths_date', - 'deaths_region', 'deaths_total')) %>% - select( - date, region, cases_new, deaths_date, - deaths_region, deaths_total - ) %>% - mutate(date = dmy(date), - deaths_date = dmy(deaths_date), - cases_new = as.numeric(cases_new), - deaths_total = as.numeric(deaths_total)) %>% - full_join(x = select(., date, region, cases_new)%>% - group_by(date, region)%>% - mutate(cases_new=sum(cases_new))%>%distinct(), - y=select(., deaths_date, deaths_region, deaths_total) %>% - group_by(deaths_date, deaths_region)%>% - mutate(deaths_total=first(deaths_total))%>%distinct(), - by=c("date" = "deaths_date", - "region" = "deaths_region" - )) %>% - tidyr::drop_na(date, region) %>% - rename(level_1_region = region) %>% + Sys.setenv("VROOM_CONNECTION_SIZE" = 131072*4) # Fix VROOM error + provines_url = 'https://covid.ncsc.gov.vn/api/v3/covid/provinces' + bundles = names(self$data$raw) + provines_data = jsonlite::fromJSON(provines_url) + + get_bundles_data = function(bundles){ + bundles_data = list() + for (bundle in bundles){ + url = paste0('https://covid.ncsc.gov.vn/api/v3/covid/provinces?filter_type=', bundle) + data = jsonlite::fromJSON(url) + bundles_data = c(bundles_data, setNames(list(data), bundle)) + } + bundles_data + } + + bundles_data = get_bundles_data(bundles) + + get_province = function(id, data){ + row_dat = provines_data[(id=id),] + death_by_time= do.call(cbind, data$death_by_time[id]) + case_by_time=do.call(cbind, data$case_by_time[id]) + recovered_by_time=do.call(cbind, data$recovered_by_time[id]) + if (!identical(row.names(death_by_time), row.names(death_by_time))) { + stop("Dates on case_by_time and death_by_time do not match!") + } + df = dplyr::tibble(date= lubridate::dmy(row.names(case_by_time)), + id = row_dat$id, + name = row_dat$name, + case_by_time= case_by_time, + death_by_time= death_by_time, + recovered_by_time= recovered_by_time) + df + } + + df = do.call(rbind, lapply(provines_data$id, function(id){get_province(id, bundles_data)})) + names(df) <- c("date", "id", "region_name", "cases_total", "deaths_total", "recovered_total") + + self$data$clean <- df %>% + select( date, region_name, cases_total, deaths_total, recovered_total) %>% + mutate(cases_total = as.numeric(cases_total), + deaths_total = as.numeric(deaths_total), + recovered_total = as.numeric(recovered_total), + region_name = stringr::str_replace_all(region_name, 'TP HCM', 'Hochiminh'), + ) %>% + tidyr::drop_na(date, region_name) %>% + rename(level_1_region = region_name) %>% mutate( level_1_region = stringi::stri_trans_general(level_1_region, "latin-ascii"), level_1_region = stringi::stri_trim_both(level_1_region), From abcd78ab0cbbaf7203480a8d96a20515af4cddb9 Mon Sep 17 00:00:00 2001 From: biocyberman Date: Sat, 28 Aug 2021 23:29:05 +0200 Subject: [PATCH 05/19] Add priliminary support for Vietnam subnational data --- .github/workflows/Vietnam.yaml | 48 +++++++++++ NAMESPACE | 1 + R/Vietnam.R | 85 +++++++++++++++++++ R/datasets.R | 6 ++ README.md | 41 +++++---- data-raw/vietnam_codes.R | 33 ++++++++ data/all_country_data.rda | Bin 2817 -> 3010 bytes data/vietnam_codes.rda | Bin 0 -> 619 bytes man/Belgium.Rd | 3 +- man/Brazil.Rd | 3 +- man/Canada.Rd | 3 +- man/Colombia.Rd | 3 +- man/Covid19DataHub.Rd | 3 +- man/Cuba.Rd | 3 +- man/France.Rd | 3 +- man/Germany.Rd | 3 +- man/Google.Rd | 3 +- man/India.Rd | 3 +- man/Italy.Rd | 3 +- man/JHU.Rd | 3 +- man/Lithuania.Rd | 3 +- man/Mexico.Rd | 3 +- man/Netherlands.Rd | 3 +- man/SouthAfrica.Rd | 3 +- man/Switzerland.Rd | 3 +- man/UK.Rd | 3 +- man/USA.Rd | 3 +- man/Vietnam.Rd | 138 +++++++++++++++++++++++++++++++ man/all_country_data.Rd | 2 +- man/figures/README-g7_plot-1.png | Bin 66088 -> 65596 bytes man/figures/README-uk_plot-1.png | Bin 59389 -> 62810 bytes man/vietnam_codes.Rd | 19 +++++ 32 files changed, 388 insertions(+), 42 deletions(-) create mode 100644 .github/workflows/Vietnam.yaml create mode 100644 R/Vietnam.R create mode 100644 data-raw/vietnam_codes.R create mode 100644 data/vietnam_codes.rda create mode 100644 man/Vietnam.Rd create mode 100644 man/vietnam_codes.Rd diff --git a/.github/workflows/Vietnam.yaml b/.github/workflows/Vietnam.yaml new file mode 100644 index 00000000..1425587e --- /dev/null +++ b/.github/workflows/Vietnam.yaml @@ -0,0 +1,48 @@ +on: + schedule: + - cron: '36 12 * * *' + workflow_dispatch: + +name: Vietnam + +jobs: + Vietnam: + runs-on: macOS-latest + env: + GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }} + steps: + - uses: actions/checkout@v2 + + - uses: r-lib/actions/setup-r@v1 + + - name: Query dependencies + run: | + install.packages('remotes') + saveRDS(remotes::dev_package_deps(dependencies = TRUE), ".github/depends.Rds", version = 2) + writeLines(sprintf("R-%i.%i", getRversion()$major, getRversion()$minor), ".github/R-version") + shell: Rscript {0} + + - name: Cache R packages + uses: actions/cache@v2 + with: + path: ${{ env.R_LIBS_USER }} + key: ${{ runner.os }}-${{ hashFiles('.github/R-version') }}-1-${{ hashFiles('.github/depends.Rds') }} + restore-keys: ${{ runner.os }}-${{ hashFiles('.github/R-version') }}-1- + + - name: Install dependencies + run: | + install.packages(c("remotes")) + remotes::install_deps(dependencies = TRUE) + install.packages("devtools") + shell: Rscript {0} + + - name: Install package + run: R CMD INSTALL . + + - name: Test dataset + run: | + options("testDownload" = TRUE) + options("testSource" = "Vietnam") + devtools::load_all() + testthat::test_file("tests/testthat/test-regional-datasets.R", reporter = c("summary", "fail")) + shell: Rscript {0} diff --git a/NAMESPACE b/NAMESPACE index ce3bcc43..37b43471 100644 --- a/NAMESPACE +++ b/NAMESPACE @@ -24,6 +24,7 @@ export(SouthAfrica) export(Switzerland) export(UK) export(USA) +export(Vietnam) export(WHO) export(expect_clean_cols) export(expect_columns_contain_data) diff --git a/R/Vietnam.R b/R/Vietnam.R new file mode 100644 index 00000000..3a9e0567 --- /dev/null +++ b/R/Vietnam.R @@ -0,0 +1,85 @@ +#' Vietnam Class for downloading, cleaning and processing +#' notification data +#' +#' @description Information for downloading, cleaning +#' and processing covid-19 region data for Vietnam. +#' +# nolint start +#' @source \url{https://github.com/biocyberman/covidregionaldata/} +# nolint end +#' @export +#' @concept dataset +#' @family subnational +#' @examples +#' \dontrun{ +#' region <- Vietnam$new(verbose = TRUE, steps = TRUE, get = TRUE) +#' region$return() +#' } +Vietnam <- R6::R6Class("Vietnam", + inherit = DataClass, + public = list( + + # Core Attributes (amend each paramater for country specific infomation) + #' @field origin name of country to fetch data for + origin = "Vietnam", + #' @field supported_levels List of supported levels. + supported_levels = list("1"), + #' @field supported_region_names List of region names in order of level. + supported_region_names = list("1" = "region"), + #' @field supported_region_codes List of region codes in order of level. + supported_region_codes = list("1" = "is_3166_2"), + #' @field common_data_urls List of named links to raw data. + # nolint start + common_data_urls = list( + "main" = "https://docs.google.com/spreadsheets/d/1_d7oK-SKj-7KrWAW7DbGYEad2JO4TyR7ApsUAuoiH5g/export?format=csv&gid=0" + ), + # nolint end + #' @field source_data_cols existing columns within the raw data + source_data_cols = c( + "cases_new" + ), + #' @field source_text Plain text description of the source of the data + source_text = "Public COVID-19 data curated by 5F team", + #' @field source_url Website address for explanation/introduction of the + #' data + source_url = "https://datastudio.google.com/u/0/reporting/1cc8d45e-2c74-4084-af70-cbbe60f1660e/page/bLUVC", # nolint + + #' @description Set up a table of region codes for clean data + #' @importFrom tibble tibble + set_region_codes = function(){ + self$codes_lookup$`1` <- covidregionaldata::vietnam_codes + }, + + #' @description Provincial Level Data + #' cleaning + #' @param ... pass additional arguments + #' + #' @importFrom dplyr filter select mutate rename + #' @importFrom tidyr replace_na + #' @importFrom lubridate dmy + clean_common = function() { + self$data$clean <- self$data$raw[["main"]] %>% + `colnames<-`(c('date', 'region', 'cases_new', 'case_group')) %>% + select( + date, + region, + cases_new + ) %>% + rename(level_1_region = region) %>% + mutate( + date = dmy(date), + cases_new = as.numeric(cases_new) + )%>% + mutate( + level_1_region = stringi::stri_trans_general(level_1_region, "latin-ascii"), + level_1_region = stringi::stri_trim_both(level_1_region), + level_1_region = stringr::str_replace_all(level_1_region, '\\(.*\\)|-| ', ''), + level_1_region = stringr::str_to_title(level_1_region) + ) %>% + left_join( + self$codes_lookup$`1`, + by = c("level_1_region" = "level_1_region") + ) + } + ) +) diff --git a/R/datasets.R b/R/datasets.R index efd04202..3c1ad8a2 100644 --- a/R/datasets.R +++ b/R/datasets.R @@ -33,6 +33,12 @@ #' @return A tibble of region codes and related information. "france_codes" +#' Region Codes for Vietnam Dataset. +#' +#' @description The region codes for Viet Nam +#' @return A tibble of region codes and related information. +"vietnam_codes" + #' Region Codes for JHU Dataset. Taken from the region codes provided as #' part of the WHO dataset. #' diff --git a/README.md b/README.md index b1700d62..b452cac6 100644 --- a/README.md +++ b/README.md @@ -80,7 +80,7 @@ the temporary directory by default), ``` r start_using_memoise() -#> Using a cache at: /tmp/RtmprTOAdV +#> Using a cache at: /tmp/RtmpPgZXiv ``` To stop using `memoise` use, @@ -105,7 +105,7 @@ the Google COVID-19 open data project), use: ``` r nots <- get_national_data() #> Downloading data from https://covid19.who.int/WHO-COVID-19-global-data.csv -#> Rows: 132483 Columns: 8 +#> Rows: 142911 Columns: 8 #> ── Column specification ──────────────────────────────────────────────────────── #> Delimiter: "," #> chr (3): Country_code, Country, WHO_region @@ -117,20 +117,20 @@ nots <- get_national_data() #> Cleaning data #> Processing data nots -#> # A tibble: 132,483 x 15 -#> date un_region who_region country iso_code cases_new cases_total -#> -#> 1 2020-01-03 Asia EMRO Afghanistan AF 0 0 -#> 2 2020-01-03 Europe EURO Albania AL 0 0 -#> 3 2020-01-03 Africa AFRO Algeria DZ 0 0 -#> 4 2020-01-03 Oceania WPRO American Samoa AS 0 0 -#> 5 2020-01-03 Europe EURO Andorra AD 0 0 -#> 6 2020-01-03 Africa AFRO Angola AO 0 0 -#> 7 2020-01-03 Americas AMRO Anguilla AI 0 0 -#> 8 2020-01-03 Americas AMRO Antigua & Bar… AG 0 0 -#> 9 2020-01-03 Americas AMRO Argentina AR 0 0 -#> 10 2020-01-03 Asia EURO Armenia AM 0 0 -#> # … with 132,473 more rows, and 8 more variables: deaths_new , +#> # A tibble: 142,911 × 15 +#> date un_region who_region country iso_code cases_new cases_total +#> +#> 1 2020-01-03 Asia EMRO Afghanistan AF 0 0 +#> 2 2020-01-03 Europe EURO Albania AL 0 0 +#> 3 2020-01-03 Africa AFRO Algeria DZ 0 0 +#> 4 2020-01-03 Oceania WPRO American Samoa AS 0 0 +#> 5 2020-01-03 Europe EURO Andorra AD 0 0 +#> 6 2020-01-03 Africa AFRO Angola AO 0 0 +#> 7 2020-01-03 Americas AMRO Anguilla AI 0 0 +#> 8 2020-01-03 Americas AMRO Antigua & Barbuda AG 0 0 +#> 9 2020-01-03 Americas AMRO Argentina AR 0 0 +#> 10 2020-01-03 Asia EURO Armenia AM 0 0 +#> # … with 142,901 more rows, and 8 more variables: deaths_new , #> # deaths_total , recovered_new , recovered_total , #> # hosp_new , hosp_total , tested_new , tested_total ``` @@ -171,7 +171,7 @@ for example by level 1 region in the UK, use: ``` r uk_nots <- get_regional_data(country = "UK", verbose = FALSE) uk_nots -#> # A tibble: 6,916 x 26 +#> # A tibble: 7,501 × 26 #> date region region_code cases_new cases_total deaths_new deaths_total #> #> 1 2020-01-30 East Mi… E12000004 NA NA NA NA @@ -184,16 +184,13 @@ uk_nots #> 8 2020-01-30 Scotland S92000003 NA NA NA NA #> 9 2020-01-30 South E… E12000008 NA NA NA NA #> 10 2020-01-30 South W… E12000009 NA NA NA NA -#> # … with 6,906 more rows, and 19 more variables: recovered_new , +#> # … with 7,491 more rows, and 19 more variables: recovered_new , #> # recovered_total , hosp_new , hosp_total , tested_new , #> # tested_total , areaType , cumCasesByPublishDate , #> # cumCasesBySpecimenDate , newCasesByPublishDate , #> # newCasesBySpecimenDate , cumDeaths28DaysByDeathDate , #> # cumDeaths28DaysByPublishDate , newDeaths28DaysByDeathDate , -#> # newDeaths28DaysByPublishDate , newPillarFourTestsByPublishDate , -#> # newPillarOneTestsByPublishDate , -#> # newPillarThreeTestsByPublishDate , -#> # newPillarTwoTestsByPublishDate +#> # newDeaths28DaysByPublishDate , … ``` Now we have the data we can create plots, for example the time-series of diff --git a/data-raw/vietnam_codes.R b/data-raw/vietnam_codes.R new file mode 100644 index 00000000..59a32f5d --- /dev/null +++ b/data-raw/vietnam_codes.R @@ -0,0 +1,33 @@ +# Set vietnam region codes +# +# Level 1 codes: ISO-3166-2 +# Source: https://en.wikipedia.org/wiki/ISO_3166-2:VN +# +library(rvest) +library(stringi) +library(stringr) +library(dplyr) +library(tibble) + +# Level 1 ----------------------------------------------------------------- +# Get ISO codes +vn_iso <- "https://en.wikipedia.org/wiki/ISO_3166-2:VN" + +level_1_region_df <- read_html(vn_iso) %>% + html_element(css="table.wikitable:nth-child(11)") %>% + html_table() + +vietnam_codes <- data.frame( + level_1_region_code = level_1_region_df$Code, + level_1_region = level_1_region_df$`Subdivision name (vi)`, + stringsAsFactors = FALSE +) %>% + mutate( + level_1_region = stringi::stri_trans_general(level_1_region, "latin-ascii"), + level_1_region = stringi::stri_trim_both(level_1_region), + level_1_region = stringr::str_replace_all(level_1_region, '\\(.*\\)|-| ', ''), + level_1_region = stringr::str_to_title(level_1_region) + ) + +# update package region_codes +usethis::use_data(vietnam_codes, overwrite = TRUE) diff --git a/data/all_country_data.rda b/data/all_country_data.rda index f95a7f512e7e80dbb09e85e5338935b82dd03b6e..68b9a1c3cbc9f77c3729a77345a64f82bf3fb1ba 100644 GIT binary patch literal 3010 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 T2q_oQf8y>)rwS4fnnaO6RL2}{ diff --git a/data/vietnam_codes.rda b/data/vietnam_codes.rda new file mode 100644 index 0000000000000000000000000000000000000000..f13d7abdcbaf85e2dd17ceddd03803f3a693e115 GIT binary patch literal 619 zcmV-x0+jtiT4*^jL0KkKS=ho_yZ{2=|HS|INB{r>f8e~$ePF-u|DZqsAOHXXzydvz zcO7IJn3Doi^n~(dG8qA*OpO2l(W5m3Qg~`mrLh1W>}59MhCG=qAhGS`ieMxe zte=#y*?Oz#e|fiF#i>@O!obcN!mf!Azg*UcA!`Xot%I>?(7W{X3|b>UPbzy`YTa^& z&g%UOQgIY2{)oFtIyqE94p2$ux3Bs4=pKrc34VmIEB zNh>(@wlH9`)C496CvtN25e6dU#DYc&=}4qV1y^Sz0IcM=keaKKM3Av^Kv$bROw*mg ziykx?5qYJZk&5M2suBBngrp!zJmn{LBL~hVW@eP4CUBgC<3gkAqIeXXwXsT4l`uKs zsAS2w6EN0Z;9mR8$K~kK(!@RF&`2eWB;)bi3KF5qGay(^R(n&%%p&^WbIOvhQY&j^HXf%DLzfVSEOLuP zHd(+~0XIEYh*+>dpLQW8re+c?QwwcSH6(bfU4WohAT4;n$`qP^yg>s07ji{7P>|Td FTD \code{Vietnam} +} +\section{Public fields}{ +\if{html}{\out{