% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/evidPush.R
\name{replace}
\alias{replace}
\title{Replace dose the rxode2 system in the model}
\usage{
replace(amt, cmt = 1)
}
\arguments{
\item{amt}{Numeric dose amount (for dose events) or \code{0} for
observations.  When \code{rate > 0} this is interpreted as the total
infusion amount and the infusion duration is \code{amt / rate}.}

\item{cmt}{Integer compartment number (1-based) to which the dose is
applied.  Default is 1}
}
\value{
This function is only meaningful inside an rxode2 model; it
returns \code{NULL} invisibly if called from R directly (after signaling
an error).
}
\description{
Replace dose the rxode2 system in the model
}
\details{
\subsection{Behavior inside a model}{

\code{replace()} is evaluated at every output time point (when the solver is
exactly at a scheduled event time).  The pushed event is inserted into
the individual's event timeline and the solver visits it now or at the
specified future time.

The number of events that may be pushed per individual is limited by
the \code{maxExtra} argument of \code{\link[=rxSolve]{rxSolve()}}.  When \code{maxExtra = 0}
(the default) there is no limit.  Exceeding the limit causes an
error.

Past-time pushes (where \code{time < t}) are silently ignored and counted;
a warning is issued after solving.
}
}
