[f2e496]: / man / SingleArmCRGIStudy.Rd

Download this file

48 lines (37 with data), 2.2 kB

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/study_constructors.R
\name{SingleArmCRGIStudy}
\alias{SingleArmCRGIStudy}
\title{Create a \code{Study} object for a CRGI type single arm study}
\usage{
SingleArmCRGIStudy(N, study.duration, ctrl.time, ctrl.proportion, k, acc.period,
shape = 1, followup, dropout = NULL, lag.settings = NullLag())
}
\arguments{
\item{N}{Number of subjects to be recruit (integer)}
\item{study.duration}{Number of months the study will be going.}
\item{ctrl.time}{The time at which \code{ctrl.proportion} of subjects have had an event.
Used to set the event rate}
\item{ctrl.proportion}{The proportion of subjects who have had an event by time \code{time}}
\item{k}{non-uniformity of accrual (integer, 1=uniform). Non-uniform accrual is allowed for
using the following distribution for the probability of a patient entering the trial at time \eqn{b}
within the accrual period \eqn{[0,B]}: \eqn{F(b)=b_k/B_k}; \eqn{f(b)=k b_{k-1}/B_k} where \eqn{k} is the
measure of non-uniformity (\eqn{k>0}). \eqn{k=1} indicates uniform accrual. This implies that during
the first half of the accrual period, \eqn{1/2^k} of the patients will be recruited. Half of the patients
will be recruited by time \eqn{B/2^{1/k}}.}
\item{acc.period}{Accrual time.}
\item{shape}{The Weibull shape parameter}
\item{followup}{The follow up time for each subject}
\item{dropout}{if subjects drop out in study (due to competing risks not as there is a finite follow up time)
then this argument should contain a list with proportion and time and optionally shape i.e.
\code{dropout=list(proportion=0.03,time=12,shape=1.2)} meaning in the absence of events 3% of subjects
will have dropped out after 12 months with a Weibull hazard rate with shape=1.2. If shape is not included then
it defaults to 1 (exponential rate). If dropout is NULL then no subjects will drop out}
\item{lag.settings}{The \code{LaggedEffect} object describing any lag effect for the study}
}
\value{
A \code{Study} object
}
\description{
Create a \code{Study} object for a CRGI type single arm study
}