Minor doc edits

Author: dom-muston

R/dynamic.R

@@ -20,12 +20,18 @@
 #' 
 #' Calculate present value for a payoff with dynamic (lifecycle) pricing and dynamic uptake (stacked cohorts).
 #'
-#' Let us partition time as follows.
+#' Suppose payoffs in relation to patients receiving treatment (such as costs or health outcomes) occur over timesteps \eqn{t=1, ..., T}. Let us partition time as follows.
 #' 
-#' - Suppose \eqn{j=1,...,T} indexes the time at which the patient begins treatment, where \eqn{T} is the time horizon of the decision-maker.
+#' - Suppose \eqn{j=1,...,T} indexes the time at which the patient begins treatment.
 #' - Suppose \eqn{k=1,...,T} indexes time since initiating treatment.
 #' 
-#' In general, \eqn{t=j+k-1}, and we are interested in \eqn{t=1,...,T}.
+#' In general, \eqn{t=j+k-1}, and we are interested in the set of \eqn{(j,k)} such that \eqn{1 \leq t \leq T}.
+#' 
+#' For example, \eqn{t=3} comprises:
+#' 
+#' - patients who are in the third timestep of treatment that began in timestep 1: (j,k)=(1,3);
+#' - patients who are in the second timestep of treatment that began in timestep 2, (j,k)=(2,2); and
+#' - patients who are in the first timestep of treatment that began in timestep 3, (j,k)=(3,1)
 #' 
 #' The [Present Value](https://en.wikipedia.org/wiki/Present_value) of a cashflow \eqn{p_k} for the \eqn{u_j} patients who began treatment at time \eqn{j} and who are in their \eqn{k}th timestep of treatment is as follows
 #' \deqn{PV(j,k,l) = u_j \cdot p_k \cdot R_{j+k+l-1} \cdot (1+i)^{2-j-k}}

README.Rmd

@@ -23,7 +23,7 @@ knitr::opts_chunk$set(
 
 The goal of *dynamicpv* is to evaluate present values and cost-effectiveness with dynamic pricing and uptake.
 
-Through the `dynamicpv::dynpv()` function, the package provides calculations of the present values of costs, life years, QALYs or other payoffs allowing for dynamic uptake (also known as multiple cohorts) and dynamic pricing (also known as life-cycle). The starting point is a conventional cohort cost-effectiveness model, such as one computed using the [heemod](https://cran.r-project.org/package=heemod) package.
+Through the [dynpv()](https://msdllcpapers.github.io/dynacem/reference/dynpv.html) function, the package provides calculations of the present values of costs, life years, QALYs or other payoffs allowing for dynamic uptake (also known as multiple cohorts) and dynamic pricing (also known as life-cycle). The starting point is a conventional cohort cost-effectiveness model, such as one computed using the [heemod](https://cran.r-project.org/package=heemod) package.
 
 ## Installation
 

README.md

@@ -15,12 +15,14 @@ coverage](https://codecov.io/gh/MSDLLCpapers/dynacem/graph/badge.svg)](https://a
 The goal of *dynamicpv* is to evaluate present values and
 cost-effectiveness with dynamic pricing and uptake.
 
-Through the `dynamicpv::dynpv()` function, the package provides
-calculations of the present values of costs, life years, QALYs or other
-payoffs allowing for dynamic uptake (also known as multiple cohorts) and
-dynamic pricing (also known as life-cycle). The starting point is a
-conventional cohort cost-effectiveness model, such as one computed using
-the [heemod](https://cran.r-project.org/package=heemod) package.
+Through the
+[dynpv()](https://msdllcpapers.github.io/dynacem/reference/dynpv.html)
+function, the package provides calculations of the present values of
+costs, life years, QALYs or other payoffs allowing for dynamic uptake
+(also known as multiple cohorts) and dynamic pricing (also known as
+life-cycle). The starting point is a conventional cohort
+cost-effectiveness model, such as one computed using the
+[heemod](https://cran.r-project.org/package=heemod) package.
 
 ## Installation