From 9059dd171f0b620b6fdc9d5f3d5162ce5247d33c Mon Sep 17 00:00:00 2001
From: Nils Kehrein <nils.kehrein@gmail.com>
Date: Fri, 22 Nov 2024 13:57:34 +0100
Subject: [PATCH] readme updated

---
 NEWS.md                                  |   2 +
 R/plot.R                                 |   1 +
 README.Rmd                               |  31 ++++++------
 README.md                                |  57 +++++++++++++----------
 doc/figures/readme-unnamed-chunk-5-1.png | Bin 0 -> 6256 bytes
 doc/figures/readme-unnamed-chunk-6-1.png | Bin 4334 -> 6480 bytes
 man/plot.Rd                              |   3 ++
 vignettes/cvasi-1-manual.Rmd             |   2 +-
 vignettes/cvasi-2-howto.Rmd              |   2 +-
 9 files changed, 59 insertions(+), 39 deletions(-)
 create mode 100644 doc/figures/readme-unnamed-chunk-5-1.png

diff --git a/NEWS.md b/NEWS.md
index a349ecf..9bd2eee 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -1,5 +1,7 @@
 # cvasi Development version
 
+# cvasi 1.3.1
+
 * Improved `import_toxswa()`: now supports scaling of imported time series,
   importing selected *TOXSWA* output variables, as well as importing selected
   substance concentrations
diff --git a/R/plot.R b/R/plot.R
index 642889f..373f12e 100644
--- a/R/plot.R
+++ b/R/plot.R
@@ -7,6 +7,7 @@
 #' @param x object to plot
 #' @param y unused parameter
 #' @param ... unused parameters
+#' @return *ggplot2* plot object
 NULL
 
 # S3 overload to plot dose response curves
diff --git a/README.Rmd b/README.Rmd
index d350ee1..691e498 100644
--- a/README.Rmd
+++ b/README.Rmd
@@ -9,6 +9,8 @@ knitr::opts_chunk$set(
   collapse = TRUE,
   comment = "#>",
   fig.path = "doc/figures/readme-",
+  fig.height=4,
+  fig.align='center',
   out.width = "100%"
 )
 
@@ -18,8 +20,8 @@ library(cvasi)
 # cvasi: Calibration, Validation, and Simulation of TKTD models in R
 
 <!-- badges: start -->
-<!--[![CRAN status](https://www.r-pkg.org/badges/version/cvasi)](https://cran.r-project.org/package=cvasi)-->
-<!--[![R-CMD-check](https://github.com/cvasi-tktd/cvasi/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/cvasi-tktd/cvasi/actions/workflows/R-CMD-check.yaml)-->
+[![CRAN status](https://www.r-pkg.org/badges/version/cvasi)](https://cran.r-project.org/package=cvasi)
+[![R-CMD-check](https://github.com/cvasi-tktd/cvasi/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/cvasi-tktd/cvasi/actions/workflows/R-CMD-check.yaml)
 <!--[![Codecov test coverage](https://codecov.io/gh/xy/cvasi/branch/main/graph/badge.svg)](https://app.codecov.io/gh/xy/cvasi?branch=main)-->
 <!-- badges: end -->
 
@@ -38,7 +40,7 @@ The package provides facilities to
 * import fitted parameters from *morse*
 * and more
 
-A graphical user interface implemented in [Shiny](https://www.rstudio.com/products/shiny/)
+A graphical user interface implemented in [Shiny](https://posit.co/products/open-source/rstudio/)
 is also available, see the *[cvasi.ui](https://github.com/cvasi-tktd/cvasi.ui/)*
 package. Please have a look at the [Changelog](NEWS.md)
 for an overview of user-facing updates and changes.
@@ -68,8 +70,8 @@ on your machine. *Rtools* are required to compile the package's C code.
 
 The package contains the following vignettes
 
-* [User Manual](doc/cvasi-1-manual.md)
-* [Modeling Howto](doc/cvasi-2-howto.md)
+* [User Manual](https://github.com/cvasi-tktd/cvasi/blob/main/doc/cvasi-1-manual.md)
+* [Modeling Howto](https://github.com/cvasi-tktd/cvasi/blob/main/doc/cvasi-2-howto.md)
 
 They can also be accessed locally by executing an *R* statement such as:
 ```{r, eval=FALSE}
@@ -80,23 +82,26 @@ vignette("cvasi-1-manual", package="cvasi")
 ## Usage
 
 Basic usage:
-```{r,message=FALSE}
+```{r,message=FALSE,out.width="70%"}
 library(cvasi)
 
 # create and parameterize a GUTS-RED-IT scenario
 GUTS_RED_IT() %>%
   set_param(c(kd=0.0005, hb=0, alpha=0.4, beta=1.5)) %>%
   set_exposure(data.frame(time=c(0, 100, 101, 200, 201, 400),
-                          conc=c(0, 0, 0.1, 0.1, 0, 0))) -> scenario
+                          conc=c(0, 0, 0.1, 0.1, 0, 0))) %>%
+  set_times(1:400) -> scenario
 
 # simulate scenario
-scenario %>%
-  simulate(times=1:400) %>%
-  tail()
+results <- scenario %>% simulate()
+tail(results)
+
+# ... and plot simulation results
+plot(results)
 ```
 
 Calculation of effects:
-```{r out.width="50%",warning=FALSE}
+```{r out.width="60%",warning=FALSE}
 # calculate effect level
 scenario %>% effect()
 
@@ -105,8 +110,8 @@ scenario %>% dose_response() -> drc
 head(drc)
 
 # plot the dose-response curve
-library(ggplot2)
-ggplot(drc) + geom_point(aes(mf,effect)) + scale_x_log10()
+plot(drc)
+
 # derive EPx values
 scenario %>% epx()
 ```
diff --git a/README.md b/README.md
index 18dda65..0a49224 100644
--- a/README.md
+++ b/README.md
@@ -4,8 +4,10 @@
 # cvasi: Calibration, Validation, and Simulation of TKTD models in R
 
 <!-- badges: start -->
-<!--[![CRAN status](https://www.r-pkg.org/badges/version/cvasi)](https://cran.r-project.org/package=cvasi)-->
-<!--[![R-CMD-check](https://github.com/cvasi-tktd/cvasi/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/cvasi-tktd/cvasi/actions/workflows/R-CMD-check.yaml)-->
+
+[![CRAN
+status](https://www.r-pkg.org/badges/version/cvasi)](https://cran.r-project.org/package=cvasi)
+[![R-CMD-check](https://github.com/cvasi-tktd/cvasi/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/cvasi-tktd/cvasi/actions/workflows/R-CMD-check.yaml)
 <!--[![Codecov test coverage](https://codecov.io/gh/xy/cvasi/branch/main/graph/badge.svg)](https://app.codecov.io/gh/xy/cvasi?branch=main)-->
 <!-- badges: end -->
 
@@ -26,10 +28,10 @@ The package provides facilities to
 - and more
 
 A graphical user interface implemented in
-[Shiny](https://www.rstudio.com/products/shiny/) is also available, see
-the *[cvasi.ui](https://github.com/cvasi-tktd/cvasi.ui/)* package.
-Please have a look at the [Changelog](NEWS.md) for an overview of
-user-facing updates and changes.
+[Shiny](https://posit.co/products/open-source/rstudio/) is also
+available, see the *[cvasi.ui](https://github.com/cvasi-tktd/cvasi.ui/)*
+package. Please have a look at the [Changelog](NEWS.md) for an overview
+of user-facing updates and changes.
 
 ## Installation
 
@@ -55,8 +57,10 @@ your machine. *Rtools* are required to compile the package’s C code.
 
 The package contains the following vignettes
 
-- [User Manual](doc/cvasi-1-manual.md)
-- [Modeling Howto](doc/cvasi-2-howto.md)
+- [User
+  Manual](https://github.com/cvasi-tktd/cvasi/blob/main/doc/cvasi-1-manual.md)
+- [Modeling
+  Howto](https://github.com/cvasi-tktd/cvasi/blob/main/doc/cvasi-2-howto.md)
 
 They can also be accessed locally by executing an *R* statement such as:
 
@@ -75,12 +79,12 @@ library(cvasi)
 GUTS_RED_IT() %>%
   set_param(c(kd=0.0005, hb=0, alpha=0.4, beta=1.5)) %>%
   set_exposure(data.frame(time=c(0, 100, 101, 200, 201, 400),
-                          conc=c(0, 0, 0.1, 0.1, 0, 0))) -> scenario
+                          conc=c(0, 0, 0.1, 0.1, 0, 0))) %>%
+  set_times(1:400) -> scenario
 
 # simulate scenario
-scenario %>%
-  simulate(times=1:400) %>%
-  tail()
+results <- scenario %>% simulate()
+tail(results)
 #>     time           D H        S
 #> 395  395 0.004429420 0 0.998655
 #> 396  396 0.004427206 0 0.998655
@@ -88,40 +92,45 @@ scenario %>%
 #> 398  398 0.004422781 0 0.998655
 #> 399  399 0.004420570 0 0.998655
 #> 400  400 0.004418360 0 0.998655
+
+# ... and plot simulation results
+plot(results)
 ```
 
+<img src="doc/figures/readme-unnamed-chunk-5-1.png" width="70%" style="display: block; margin: auto;" />
+
 Calculation of effects:
 
 ``` r
 # calculate effect level
 scenario %>% effect()
-#> # A tibble: 1 × 4
+#> # A tibble: 1 x 4
 #>   scenario         L L.dat.start L.dat.end
 #>   <list>       <dbl>       <dbl>     <dbl>
-#> 1 <GutsRdIt> 0.00135           0       400
+#> 1 <GutsRdIt> 0.00135           1       400
 
 # create a dose-response curve
 scenario %>% dose_response() -> drc
 head(drc)
 #>   endpoint        mf      effect
-#> 1        L  3.812500 0.009920108
-#> 2        L  4.799653 0.013948570
-#> 3        L  6.042405 0.019601514
-#> 4        L  7.606938 0.027459506
-#> 5        L  9.576567 0.038355140
-#> 6        L 12.056184 0.053336114
+#> 1        L  3.812500 0.009915394
+#> 2        L  4.799653 0.013954569
+#> 3        L  6.042405 0.019597765
+#> 4        L  7.606938 0.027459877
+#> 5        L  9.576567 0.038357524
+#> 6        L 12.056184 0.053336214
 
 # plot the dose-response curve
-library(ggplot2)
-ggplot(drc) + geom_point(aes(mf,effect)) + scale_x_log10()
+plot(drc)
 ```
 
-<img src="doc/figures/readme-unnamed-chunk-6-1.png" width="50%" />
+<img src="doc/figures/readme-unnamed-chunk-6-1.png" width="60%" style="display: block; margin: auto;" />
 
 ``` r
+
 # derive EPx values
 scenario %>% epx()
-#> # A tibble: 1 × 3
+#> # A tibble: 1 x 3
 #>   scenario   L.EP10 L.EP50
 #>   <list>      <dbl>  <dbl>
 #> 1 <GutsRdIt>   19.0   82.1
diff --git a/doc/figures/readme-unnamed-chunk-5-1.png b/doc/figures/readme-unnamed-chunk-5-1.png
new file mode 100644
index 0000000000000000000000000000000000000000..c630badf39683a7a1b2376def68da0b99741b79a
GIT binary patch
literal 6256
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

literal 0
HcmV?d00001

diff --git a/doc/figures/readme-unnamed-chunk-6-1.png b/doc/figures/readme-unnamed-chunk-6-1.png
index 7bd736ede35e0f4e77e4a561f1593934208ad3f0..a222ebc18a214b1c753470b430b362a085791111 100644
GIT binary patch
literal 6480
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

literal 4334
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

diff --git a/man/plot.Rd b/man/plot.Rd
index 959e748..8e9a7a3 100644
--- a/man/plot.Rd
+++ b/man/plot.Rd
@@ -20,6 +20,9 @@ a log10-scaled axis, \code{none} for no scaling, and \code{auto} for automatic s
 
 \item{...}{unused parameters}
 }
+\value{
+\emph{ggplot2} plot object
+}
 \description{
 These functions overload \code{\link[base:plot]{base::plot()}} to provide simple plotting
 routines to display various time-series and scenario objects.
diff --git a/vignettes/cvasi-1-manual.Rmd b/vignettes/cvasi-1-manual.Rmd
index e2e7590..42edc7e 100644
--- a/vignettes/cvasi-1-manual.Rmd
+++ b/vignettes/cvasi-1-manual.Rmd
@@ -1,7 +1,7 @@
 ---
 title: "User Manual"
 author: "N. Kehrein"
-date: "24 Octobre, 2024"
+date: "24 October, 2024"
 output:
   rmarkdown::html_vignette:
     toc: true
diff --git a/vignettes/cvasi-2-howto.Rmd b/vignettes/cvasi-2-howto.Rmd
index 98adff4..430d65e 100644
--- a/vignettes/cvasi-2-howto.Rmd
+++ b/vignettes/cvasi-2-howto.Rmd
@@ -1,7 +1,7 @@
 ---
 title: "Modeling Howto"
 author: "N. Kehrein and contributors"
-date: "24 Octobre, 2024"
+date: "24 October, 2024"
 output:
   rmarkdown::html_vignette:
     toc: true