home *** CD-ROM | disk | FTP | other *** search
/ Between Heaven & Hell 2 / BetweenHeavenHell.cdr / 500 / 474 / ems.arc / PC-PLAN.DOC < prev    next >
Text File  |  1986-02-25  |  6KB  |  169 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                    PC-PLAN
  12.                              Randomization Plans
  13.                                  Version 1.0
  14.                               December 12, 1985
  15.  
  16.  
  17.                                Gerard E. Dallal
  18.  
  19.                 USDA Human Nutrition Research Center on Aging
  20.                              at Tufts University
  21.                             711 Washington Street
  22.                               Boston, MA  02111
  23.  
  24.                                      and
  25.  
  26.                      Tufts University School of Nutrition
  27.                               132 Curtis Street
  28.                               Medford, MA  02155
  29.  
  30.         PC-PLAN generates randomization  plans.  The  resulting  file
  31.         can  be  used as input to a word processing program for touch
  32.         up and entry into a report.
  33.  
  34.  
  35.  
  36.  
  37.                                     NOTICE
  38.  
  39.         Documentation and original code copyright 1985 by  Gerard  E.
  40.         Dallal.  Reproduction of material for non-commercial purposes
  41.         is   permitted,   without  charge,   provided  that  suitable
  42.         reference is made to PC-PLAN and its author.
  43.  
  44.         Neither PC-PLAN nor its documentation should be  modified  in
  45.         any way without permission from the author,  except for those
  46.         changes  that  are  essential  to  move  PC-PLAN  to  another
  47.         computer.
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                                  INSTALLATION
  61.  
  62.         PC-PLAN  was written for the IBM-PC but few changes should be
  63.         needed to install it on  another  computer.  The  first  DATA
  64.         statement initializes the variables
  65.  
  66.                       IIN -- input unit number (screen)
  67.                      IOUT -- output unit number (screen)
  68.                     IWOUT -- external output file unit number
  69.  
  70.         The only major change involves the  routine  that  seeds  the
  71.         random  number  generator.  The three seeds are obtained from
  72.         the computer's internal clock.  The  subroutine  SEEDER  will
  73.         probably  have  to  be  tailored  to  the  user's  particular
  74.         computer.  All three seeds should be integers between  1  and
  75.         30,000, exclusive.
  76.  
  77.  
  78.  
  79.  
  80.                                  DESCRIPTION
  81.  
  82.         PC-PLAN  generates  randomization  plans in a form that lends
  83.         itself  to  easy  editing   with   a   word   processor   for
  84.         incorporation  into memos and reports.  The program is driven
  85.         by prompts to the user.  The terminology is as follows:
  86.  
  87.         The number of BLOCKs is  the  number  of  experimental  units
  88.         defined  by  variables that are not subject to randomization.
  89.         For example,  in a study in which men and  women  are  to  be
  90.         analyzed  separately,  the  number  of  groups is 2 and their
  91.         names are "men" and  "women".  If  there  is  more  than  one
  92.         classification  variable,  the  units should be thought of as
  93.         being classified by a single variable  whose  categories  are
  94.         all  possible  combinations of the categories of the original
  95.         variables.  For example,  if an experiment is to measure  the
  96.         effect of drinking coffee on both men and women,  the  number
  97.         of groups is 4:  "male drinkers", "male nondrinkers", "female
  98.         drinkers", and "female nondrinkers".
  99.  
  100.  
  101.         The   number   of   TREATMENTS  is  the  number  of  sets  of
  102.         experimental conditions that will be applied to subject.  For
  103.         example,  if there are three diets under  investigation,  the
  104.         number  of  treatments  is 3.  If there are many experimental
  105.         factors being randomized,  the number of  treatments  is  the
  106.         number of possible combinations of the original factors.  For
  107.         example,  if  a subject is given either a high protein or low
  108.         protein diet and is subjected  to  one  of  three  levels  of
  109.         exercise,  the  number  of treatments is 6:  "low protein/low
  110.         exercise", "low protein/moderate exercise", "low protein/high
  111.         exercise",     "high     protein/low     exercise",     "high
  112.         protein/moderate exercise", "high protein/high exercise",
  113.  
  114.  
  115.  
  116.  
  117.         PC-PLAN  allows the user to specify whether the treatment for
  118.         each subject should be selected (1) totally at random, (2) so
  119.         that an equal number of each treatment are assigned,  or  (3)
  120.         so that prespecified numbers of each treatment are assigned.
  121.  
  122.         PC-PLAN  can  also  permute  treatments  within subject.  For
  123.         example,  if each  subject  is  to  undergo  three  different
  124.         treatments,  PC-PLAN  will  generate a random permutations of
  125.         the three treatment.
  126.  
  127.  
  128.  
  129.                            RANDOM NUMBER GENERATOR
  130.  
  131.         PC-PLAN uses the random number generator of Wichmann and Hill
  132.         (1981) as modified by McLeod (1985).
  133.  
  134.  
  135.  
  136.                                  CONSTRAINTS
  137.  
  138.         PC-PLAN makes provision for up to 20 blocks, 400 subjects per
  139.         blocks,  20  treatments  when  assigned,  5  treatments  when
  140.         permuted.  Block labels may  contain  up  to  40  characters,
  141.         treatment labels up to 15.
  142.  
  143.  
  144.  
  145.                                   REFERENCES
  146.  
  147.         McLeod, A. Ian (1985).  Remark AS R58.  A remark on algorithm
  148.            AS  183.  An  efficient  and portable pseudo-random number
  149.            generator.  Appl. Statist.,34,198-200.
  150.  
  151.         Wichmann, B.A.  and I.D.  Hill (1981).  Algorithm AS 183.  An
  152.            efficient and  portable  pseudo-random  number  generator.
  153.            Appl. Statist.,31,188-190.
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.