___________________________________________________________________
 |                                                                 |
 |                                 MIX                             |
 |_________________________________________________________________|

 MEANING: MIX subroutine
 CONTEXT: User-supplied subroutine; replaces a NONMEM dummy routine

 USAGE:
 SUBROUTINE MIX (ICALL,NSPOP,P)
 INTEGER ICALL,NSPOP
 DIMENSION P(*)
 COMMON /ROCM0/ THETA(LTH)
 (If double precision is to be used):
 DOUBLE PRECISION P,THETA
 (If single precision is to be used):
 REAL P,THETA

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

 DISCUSSION:
 MIX is a NONMEM routine that is replaced by  a  user-supplied  routine
 when  a mixture model is used.  The MIX subroutine is used to describe
 the mixture parameters of a mixture model.  It  is  called  by  NONMEM
 with one individual record after another.

 Input argument:

  ICALL
      Similar to ICALL for PRED subroutine.

 Output argument:

  NSPOP
      An integer variable or integer constant.  The maximum  number  of
      sub-populations  that  are  possible.  Must be given a value when
      ICALL=1.

  P
      An array. For each i (i=1, ... , NSPOP), P(i) gives  the  modeled
      fraction  of the population in the ith subpopulation.  The sum of
      the P(i) should equal 1.  In principle, the P(i) can change  from
      individual  to individual.  If for a given individual, the second
      (for example) subpopulation doesn't apply, then  set  P(2)=0  for
      that individual.

 Other inputs are available to MIX in  NONMEM  read-only  commons.   In
 particular, data items that are requested using the $CONTR record, and
 the current value of THETA, as shown above.  (See rocm1, rocm0).   The
 TEMPLT  data  record  in NONMEM read-only common ROCM31 also serves to
 provide an additional way for individual-specific  information  to  be
 made available

 With mixture models, MIXNUM, MIXEST and MIXP are variables that may be
 used  as  right-hand  quantities (or in logical conditions) in various
 other abbreviated codes or  user-supplied  routines.   MIXNUM  is  the
 index of the subpopulation for which variables are to be computed.  At
 ICALL=3, and at ICALL=2 when COMACT is not 0, MIXEST is the  index  of
 the  subpopulation  estimated  to  be that from which the individual's
 data most probably arises.  MIXP refers to the mixture probabilities P
 computed by subroutine MIX.

 (See rocm11, rocm25, mixture model example, mixnum mixest).

REFERENCES: Guide IV Section III.B.4, III.B.6
REFERENCES: Guide IV Section IV.E.1, 4.E.2
REFERENCES: Guide VI Section III.L.2, Figure 6

  
Go to main index.
  

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