diff --git a/DESCRIPTION b/DESCRIPTION index dd2e61d..9cb55f0 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,6 +1,6 @@ Package: tarflow.iquizoo Title: Setup "targets" Workflows for "iquizoo" Data Processing -Version: 3.11.4 +Version: 3.11.5 Authors@R: c( person("Liang", "Zhang", , "psychelzh@outlook.com", role = c("aut", "cre"), comment = c(ORCID = "0000-0001-9041-1150")), @@ -49,4 +49,4 @@ Config/testthat/parallel: true Config/testthat/start-first: targets Encoding: UTF-8 Roxygen: list(markdown = TRUE) -RoxygenNote: 7.3.1 +RoxygenNote: 7.3.2 diff --git a/NEWS.md b/NEWS.md index d650952..df4d34f 100644 --- a/NEWS.md +++ b/NEWS.md @@ -1,3 +1,10 @@ +# tarflow.iquizoo 3.11.5 + +## Enhancements + +* Enhance documentation of `tar_prep_iquizoo()`. +* Support new dark theme of pkgdown. + # tarflow.iquizoo 3.11.4 ## Breaking Changes diff --git a/R/targets.R b/R/targets.R index 37c9bb3..b9ed49e 100644 --- a/R/targets.R +++ b/R/targets.R @@ -16,16 +16,18 @@ #' @param ... For future usage. Should be empty. #' @param what What to fetch. There are basically two types of data, i.e., raw #' data and scores. The former is the logged raw data for each trial of the -#' tasks/games, while the latter is the scores calculated by iQuizoo server. -#' If set as "all", both raw data and scores will be fetched. Further actions -#' on the fetched raw data can be specified by `action_raw_data`. +#' tasks/games, and further actions on the fetched raw data can be specified +#' by `action_raw_data`. The latter is the scores calculated by iQuizoo +#' server. #' @param action_raw_data The action to be taken on the fetched raw data. There -#' are two consecutive actions, i.e., wrangling and pre-processing. The former -#' will parse the raw data into a tidy format, while the latter will calculate -#' indices based on the parsed data. If set as "all", both wrangling and -#' pre-processing will be done. If set as "parse", only wrangling will be -#' done. If set as "none", neither will be done. If `what` is "scores", this -#' argument will be ignored. +#' are two consecutive actions, i.e., raw data parsing and pre-processing. The +#' former will parse the `json` formatted raw data into [data.frame()]s and +#' wrap them into one list column, see [parse_data()] for more details. The +#' latter will calculate indices based on the parsed data, see +#' [preproc.iquizoo::preproc_data()] for more details. If set as `"none"`, +#' neither will be done. If set as `"parse"`, only raw data parsing will be +#' done. If set as `"all"`, both parsing and pre-processing will be done. If +#' `what` is set as `"scores"`, this argument will be ignored. #' @param combine Specify which targets to be combined. Note you should only #' specify names from `c("scores", "raw_data", "raw_data_parsed", "indices")`. #' If `NULL`, none will be combined. diff --git a/_pkgdown.yml b/_pkgdown.yml index f3e8a52..b2be592 100644 --- a/_pkgdown.yml +++ b/_pkgdown.yml @@ -1,6 +1,7 @@ url: https://psychelzh.github.io/tarflow.iquizoo template: bootstrap: 5 + light-switch: true reference: - title: "Targets Factory Related Functions" desc: "A collection of functions to help you build targets." diff --git a/man/tar_prep_iquizoo.Rd b/man/tar_prep_iquizoo.Rd index 4d32985..b12c9e0 100644 --- a/man/tar_prep_iquizoo.Rd +++ b/man/tar_prep_iquizoo.Rd @@ -29,17 +29,19 @@ fetching. Note \code{contents} should at least contain \code{project_id} and \item{what}{What to fetch. There are basically two types of data, i.e., raw data and scores. The former is the logged raw data for each trial of the -tasks/games, while the latter is the scores calculated by iQuizoo server. -If set as "all", both raw data and scores will be fetched. Further actions -on the fetched raw data can be specified by \code{action_raw_data}.} +tasks/games, and further actions on the fetched raw data can be specified +by \code{action_raw_data}. The latter is the scores calculated by iQuizoo +server.} \item{action_raw_data}{The action to be taken on the fetched raw data. There -are two consecutive actions, i.e., wrangling and pre-processing. The former -will parse the raw data into a tidy format, while the latter will calculate -indices based on the parsed data. If set as "all", both wrangling and -pre-processing will be done. If set as "parse", only wrangling will be -done. If set as "none", neither will be done. If \code{what} is "scores", this -argument will be ignored.} +are two consecutive actions, i.e., raw data parsing and pre-processing. The +former will parse the \code{json} formatted raw data into \code{\link[=data.frame]{data.frame()}}s and +wrap them into one list column, see \code{\link[=parse_data]{parse_data()}} for more details. The +latter will calculate indices based on the parsed data, see +\code{\link[preproc.iquizoo:preproc_data]{preproc.iquizoo::preproc_data()}} for more details. If set as \code{"none"}, +neither will be done. If set as \code{"parse"}, only raw data parsing will be +done. If set as \code{"all"}, both parsing and pre-processing will be done. If +\code{what} is set as \code{"scores"}, this argument will be ignored.} \item{combine}{Specify which targets to be combined. Note you should only specify names from \code{c("scores", "raw_data", "raw_data_parsed", "indices")}.