+--------------------------------------------------------------------+
| |
| $TOL |
| |
+--------------------------------------------------------------------+
MEANING: Marks the beginning of abbreviated code for the TOL routine
CONTEXT: NM-TRAN Control Record
USAGE:
$TOL
abbreviated code
DISCUSSION:
The $TOL record is used to specify compartment-specific NRD values.
It is used with PREDPP's general non-linear models (ADVAN6, ADVAN8,
ADVAN9, ADVAN13, ADVAN14, ADVAN15 and SS6 and SS9). NRD stands for
"Number of Required Digits," although the precise meaning depends on
the particular ADVAN or SS routine that uses it.
$TOL cannot be present if the $SUBROUTINES record includes any of the
corresponding options.
The following are equivalent:
$SUBROUTINES ... TOL=n
and
$SUBROUTINES ...
$TOL NRD=n
Left-hand quantities:
These are identical to the left-hand variables that may be set in sub-
routine TOL. If subscript "(I)" is omitted, it defaults to 1.
NRD(I)
The number of digits that are required to be accurate in the com-
putation of the drug amount in compartment I, i.e., the relative
tolerance. ADVAN 9, 13, 14, and 15 have the capability of using
different values of NRD for different compartments. For compart-
ments not specified, the tolerance of the last compartment speci-
fied will be used.
However, all the other ADVAN routines requiring TOL take the rel-
ative tolerance to be the same for all compartments; NRD(I), I >
1, is ignored, and only NRD(1) is used. With NONMEM 7.4, NRD(0)
is the relative tolerance for the Steady State computations. If
NRD(0) is not specified, NRD(1) is used.
The value of NRD(1) can also be specified using $SUBROUTINES
option TOL.
The value of NRD(0) can also be specified using $SUBROUTINES
option SSTOL.
ANRD(I) (NM74)
The absolute tolerance in the computation of the drug amount in
compartment I. The default is 12 (that is, accuracy is
10**(-12)). Used by ADVAN 9, 13, 14, and 15, which have the
capability of using different values of ANRD for different com-
partments. For compartments not specified, the tolerance of the
last compartment specified will be used.
ANRD(0) is the absolute tolerance for the Steady State computa-
tions. If ANRD(0) is not specified, ANRD(1) is used.
The value of ANRD(1) can also be specified using $SUBROUTINES
option ATOL.
The value of ANRD(0) can also be specified using $SUBROUTINES
option SSATOL.
NRDC(I) (NM74)
Same as NRD(I), but used for the FOCE/LAPLACE covariance step.
Used with ADVAN 9, 13, 14, and 15. If not set, NRDC defaults to
the value of NRD. NRDC(0) is used for Steady State computations
during the FOCE/LAPLACE covariance step.
The value of NRDC(1) can also be specified using $SUBROUTINES
option TOLC.
The value of NRDC(0) can also be specified using $SUBROUTINES
option SSTOLC.
ANRDC(I) (NM74)
Same as ANRD(I), but used for the FOCE/LAPLACE covariance step.
Used with ADVAN 9, 13, 14, and 15. If not set, ANRDC defaults to
the value of ANRD. ANRDC(0) is used for Steady State computa-
tions during the FOCE/LAPLACE covariance step.
The value of ANRDC(1) can also be specified using $SUBROUTINES
option ATOLC.
The value of ANRDC(0) can also be specified using $SUBROUTINES
option SSATOLC.
Right-hand quantities:
Integers, e.g., NRD(1)=4
Forbidden Variable Names:
All other variables.
RECORD ORDER:
Follows $SUBROUTINES and $MODEL
REFERENCES: Guide IV Section V.C.3, V.C.10
REFERENCES: Guide VI Section VI.D, Figure 41
Go to main index.
Created by nmhelp2html v. 1.0 written by Niclas Jonsson (Modified by AJB 5/2006,11/2007,10/2012)