PRODUCTS: NONMEM® USER TIPS

These tips are brought to you as information of interest from experiences in using NONMEM. All tips can also be found in the tips folder on the NONMEM Repository@GloboMax.

Tip # 21 - Using more than one line perdata record -> using more than 20 data items:

Occasionally, several data records may be needed to describe one event.
An example of this is the need for more than the 20 data items that NONMEM allows the user.
More than one line per data record is coded by using the CONT data item in the data file and
accessed using EVTREC in the control stream. All lines prior to the last line in the data record
must code for CONT=1. The last line is coded CONT=0. The data items on the last line of the data
record may be accessed in the conventional manner and correspond to the items in your $INPUT record.
The data items in lines prior to the last line must be defined using abbreviated code and
EVTREC(line_number, item_number). For example, if AGE is the fourth item on the second line,
the abbvreviated code would be:
" AGE=EVTREC(2,4)

Example control stream (based on the control5 control stream and THEOPP data file):

;Model Desc: using more than one line per record
;Project Name: iqual
;Project ID: GM00-004

$PROB RUN# cont THEOPHYLLINE POPULATION DATA
$INPUT C ID TIME AMT DV SEX LAB CONT
$DATA THEOPPcont.csv IGNORE=C

$SUBROUTINES ADVAN2

$PK

" WT=EVTREC(1,7)

CALLFL=1
KA=THETA(1)+ETA(1)
K=THETA(2)+ETA(2)
CL=THETA(3)*WT+ETA(3)
SC=CL/K/WT

$THETA
(.1,3,5) ;[KA]
(.008,.08,.5) ;[K]
(.004,.04,.9) ;[CL]
$OMEGA BLOCK(3)
6 ;[A]
.005 ;[F]
.0002;[A]
.3 ;[F]
.006 ;[F]
.4 ;[A]

$ERROR
Y=F+EPS(1)

$SIGMA
.4 ;[A]

$EST MAXEVAL=450 PRINT=5
$COV

First individual of the data file:

C,Data Desc: using more than one line per record,,,,,,
C,ID,TIME,AGE,STDY,FORM,WT,CONT
C,ID,TIME,AMT,DV,SEX,LAB,CONT
,1,0,22,802,0,79.6,1
,1,0,4.02,.,1,3,0
,1,0,22,802,0,.,1
,1,0,.,0.74,1,3,0
,1,0.25,22,802,0,.,1
,1,0.25,.,2.84,1,3,0
,1,0.57,22,802,0,.,1
,1,0.57,.,6.57,1,3,0
,1,1.12,22,802,0,.,1
,1,1.12,.,10.5,1,3,0
,1,2.02,22,802,0,.,1
,1,2.02,.,9.66,1,3,0
,1,3.82,22,802,0,.,1
,1,3.82,.,8.58,1,3,0
,1,5.1,22,802,0,.,1
,1,5.1,.,8.36,1,3,0
,1,7.03,22,802,0,.,1
,1,7.03,.,7.47,1,3,0
,1,9.05,22,802,0,.,1
,1,9.05,.,6.89,1,3,0
,1,12.12,22,802,0,.,1
,1,12.12,.,5.94,1,3,0
,1,24.37,22,802,0,.,1
,1,24.37,.,3.28,1,3,

nmconsult@globomaxnm.com
GloboMax®
The Strategic Pharmaceutical Development Division of ICON plc
7250 Parkway Drive, Suite 430
Hanover, MD 21076
Voice: (410) 782-2205
FAX: (410) 712-0737

-------------------------------------------------------------------
| |
| CONT DATA ITEM |
| |
------------------------------------------------------------------
MEANING: Continuation (CONT) data item for PREDPP
CONTEXT: $INPUT record and NONMEM data set
USAGE:
$INPUT ... CONT ...
DISCUSSION:
CONT labels PREDPP's continuation (CONT) data item. The continuation
data item is optional. The CONT data item allows a PREDPP event
record to span several data records. It is useful when more than 20
data items are needed to describe a single event. When the CONT data
item is not defined on the $INPUT record, every event record consists
of a single data record.
Values are:
0 This is the last or only data record of the event record.
1 This and the succeeding record are both members of the same event
record. MDV must be 1.
PREDPP ignores records having CONT=1, except to pass them to the PK
and ERROR routines as part of the complete event record. Values of
PREDPP data items such as EVID, AMT, etc., are significant only on the
final record of each event record, i.e., on records having CONT=0.
With NM-TRAN abbreviated code, values on data records having CONT=1
are not available for use as right-hand quantities, i.e., abbreviated
code cannot reference the values in data records other than the last
of each event record. (It would be possible to reference such values
using verbatim code, however). When NM-TRAN performs time translation
or ii conversion (see date, time, ii), it does so only for the event
records having CONT=0.
REFERENCES: Guide VI, section II (p. 5), V.A (p. 55), V.I (p. 62)
REFERENCES: Guide IV, section V.B (p. 61), V.C.5 (p. 70)

(This tip is supplied "gratis" and without implicit or explicit support from
GloboMax divison of ICON plc).