___________________________________________________________________
 |                                                                 |
 |                                GETETA                           |
 |_________________________________________________________________|

 MEANING: GETETA subroutine
 CONTEXT: NONMEM utility routine

 USAGE:

 DIMENSION ETA(LVR)

 (If double precision is to be used):
 DOUBLE PRECISION ETA
 (If single precision is to be used):
 REAL ETA

 CALL GETETA (ETA)

 The value of LVR must  be  the  same  as  that  found  in  file  SIZES
 (See sizes).

 DISCUSSION:
 The NONMEM utility routine GETETA is used to  obtain  subject-specific
 values  of  eta.   It  may be called only when the data are population
 data.

 Output argument:

  ETA
      An array into which GETETA  stores  subject-specific  eta  values
      ETA(1),  ETA(2),  etc.  If a conditional estimation method is not
      used, GETETA stores zeros in the ETA array.

 GETETA must always be initialized at  ICALL=1.  This  simply  involves
 calling GETETA at ICALL=1. No values are stored in ETA at this call.

 When the data are population and abbreviated code is used,  values  of
 etas are always obtained by a call to GETETA occurring in generated or
 Library PK or PRED subroutines.  (In the case of PK, the array of etas
 is  stored  in  a  common  and is available to the ERROR subroutine as
 well.)  This call occurs even if a conditional  estimation  method  is
 not  implemented,  in  which  case  GETETA  stores zeros in ETA.  As a
 result, when the first-order method is used, apparent subject-specific
 values  computed  in NM-TRAN abbreviated code are the required typical
 values.  Thus, an executable resulting from using an abbreviated  code
 for  PRED  (for  PK  and ERROR if PREDPP is used) can be used with any
 estimation method.

 EXAMPLE OF USAGE:

 IF (ICALL.EQ.1) THEN
  ...
 CALL GETETA (ETA)
  ...
 RETURN
 ENDIF
  ...
 IF (ICALL.EQ.2) CALL GETETA (ETA)

 It is also possible to obtain  simulated  subject-specific  values  of
 eta.  (See simeta).

REFERENCES: Guide IV Section V.C.5
REFERENCES: Guide VI Section III.E.2, IV.B.2


  
Go to main index.
  

    Created by nmhelp2html v. 1.0 written by Niclas Jonsson (Modified by AJB 5/2006,11/2007)