___________________________________________________________________
 |                                                                 |
 |                                NCONTR                           |
 |_________________________________________________________________|

 MEANING: NCONTR subroutine
 CONTEXT: NONMEM utility routine

 This feature is not fully documented.  The interested user may be able  L
 to  obtain  more  information  by studying the appropriate sections of  L
 NONMEM code and previous examples that may be available from  advanced  L
 users.                                                                  L

 USAGE:                                                                  L
 INTEGER IER1,IER2                                                       L
 (If double precision is to be used):                                    L
 DOUBLE PRECISION CNT                                                    L
 (If single precision is to be used):                                    L
 REAL CNT                                                                L
  ...                                                                    L
 CALL NCONTR (CNT,IER1,IER2,L2R)                                         L

 DISCUSSION:                                                             L
 NCONTR is a NONMEM utility routine. It computes the normal-based  con-  L
 tribution  to the objective function from the data from a single indi-  L
 vidual ("L1") record.                                                   L

 NCONTR may be called by a user-supplied CONTR.   NCONTR  can  be  used  L
 when  eta  is  from  a  normal  distribution with mean 0 and variance-  L
 covariance OMEGA.  It can be used with population data.  It should not  L
 be used with single-subject data.                                       L

 Output argument:                                                        L

  CNT Contribution to -2log likelihood for data from the L1 record       L

  IER1                                                                   L
      IER1 return codes:                                                 L

       1                                                                 L
           HESSIAN OF OBJ. FUNC. FOR COMPUTING SOME  CONDITIONAL  ESTI-  L
           MATE  IS  SINGULAR, IF LAPLACIAN IS NOT USED, OR NONPOSITIVE  L
           DEFINITE, IF LAPLACIAN IS USED.                               L

       2                                                                 L
           ETA-DERIVATIVE OF SOME CONDITIONAL -2LOG LIKELIHOOD VALUE IS  L
           TOO LARGE                                                     L

       3                                                                 L
           NUMERICAL HESSIAN OF OBJ. FUNC. FOR  COMPUTING  SOME  CONDI-  L
           TIONAL ESTIMATE IS NON POSITIVE DEFINITE                      L

       11                                                                L
           IF CCONTR IS NOT USED AND F = PREDICTION, SOME  INTRAINDIVI-  L
           DUAL VARIANCE-COVARIANCE IS SINGULAR.                         L
           IF CCONTR IS NOT USED AND F = LIKELIHOOD,  SOME  CONDITIONAL  L
           LIKELIHOOD VALUE IS NEGLIGIBLE.                               L

       12                                                                L
           IF CCONTR IS NOT USED AND F = PREDICTION,  WEIGHTED  SUM  OF  L
           "SQUARED" INDIVIDUAL RESIDUALS IS INFINITE.                   L

       10+                                                               L
           IF CCONTR IS USED, 10 IS ADDED TO A NONZERO  VALUE  OF  IER1  L
           FROM CCONTR.                                                  L

  IER2                                                                   L
      0 if error-recovery is to be implemented when IER1 is nonzero.     L
      1 if NONMEM is to stop when IER1 is nonzero.                       L

   L2R                                                                   L
      Index of L2 record giving rise to error condition.                 L

 Other inputs:                                                           L
      NCONTR obtains all its inputs from NONMEM read-only commons.       L

 REFERENCES: None.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     


  
Go to main index.
  

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