home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / MISC / EDUCATIO / STAGES12.ZIP / STAGES.DOC < prev    next >
Encoding:
Text File  |  1991-03-30  |  4.4 KB  |  125 lines
  1. Stage Predictor Program
  2. Latest revision:  March 1991           Version: V1.2
  3.  
  4. Direct correspondence to:
  5.     Dr. Rex A. Hess
  6.     Veterinary Biosciences
  7.     University of Illinois at Urbana-Champaign
  8.     2001 S. Lincoln Avenue
  9.     Urbana, IL  61801
  10.     
  11.     Phone:  217/333-8933 or 333-2506
  12.       FAX:    217/333-4628
  13.  
  14. Program written by:
  15.     Paul P. Chen
  16.     Coordinated Science Laboratory
  17.     University of Illinois at Urbana-Champaign
  18.     Urbana, IL  61801
  19.  
  20.         Stages was created using Turbo C, copyright Borland 1987, 1988.
  21.  
  22. Description:
  23.     Given a list of initial cells of observation, the program
  24.     calculates, for any given number of days, the cells reached
  25.     from the first third, second third, and end of each initial
  26.     cell's stage.
  27.  
  28.     To determine in what stage a cell was x days ago,
  29.     use -x days (negative number of days) as input;
  30.     to determine in what stage a cell will be x days hence,
  31.     use x days (positive number of days) as input.
  32.  
  33. I.  Required input files:
  34.         The program requires the following 5 input files for each animal.
  35.  
  36.     1/  Stage information file format:
  37.               (example: "sdrat.stg")
  38.         This file contains information about the stages of the
  39.         cycle of spermatogenesis for the particular animal.
  40.           
  41.          cycletime                   (in units of days)
  42.         number of stages        (integer)
  43.             length of stage 1           (in units of days)
  44.             length of stage 2           (in units of days)
  45.                 ...
  46.         length of stage n           (last stage)
  47.         epididymis transit time      (in units of days)
  48.  
  49.     2/  Cell sequence file format:
  50.               (example: "sdrat.seq")
  51.         This file contains a sequential list of all the cell names
  52.         in the cycle of spermatogenesis for the particular animal.
  53.  
  54.             cellname            (text)
  55.         cellname            (text)
  56.         cellname            (text)
  57.                 ... etc.
  58.  
  59.     3/  Stage/Cell association printout file:
  60.           (example: "sdrat.fil")
  61.         This file contains the formatted text of cellular associations
  62.         within stages; this file gets printed out verbatim whenever
  63.             the user requests to see the "cell sequence data."
  64.  
  65.     4/  Reference file:
  66.           (example: "sdrat.ref")
  67.         This file contains the formatted text of references for the
  68.         stage and cell data.  This file gets printed out whenever the
  69.         user requests to see either the "stage information data" or
  70.         the "cell sequence data."
  71.         
  72.         5/  Multi-cell file format:
  73.           (example: "sdrat.mcl")
  74.         This file contains a table of cells for stages in which more
  75.         than one cell may exist.  For example, in the Sprague-Dawley
  76.         rat, cells I-4 and B-4 can both be found in Stage 4.  I-4
  77.         cells are typically found in the first 2/3 or so of the stage;
  78.         B-4 cells may be found in the latter 1/3 of the stage.  The
  79.         format of this file groups cells of the same stage in rows;
  80.         there are 3 cells in each row, corresponding to what cell
  81.         type is found in the first 1/3, the second 1/3, and the third
  82.         1/3 of the stage.
  83.  
  84.           Example:  sdrat.mcl
  85.        
  86.           3            (# of multicell stages: integer, required)
  87.           I-4    I-4    B-4
  88.           B-6    B-6    PL-6
  89.           M1-14    SS-14    M2-14
  90.  
  91. II.  Input may be interactive or batch mode, using input from a batch file.
  92.           1)  In interactive mode, Stages is menu-oriented.  The user
  93.         simply types responses to questions from menus, thereby
  94.         selecting choices from menus and moving among the menus.
  95.  
  96.       2)  A batch file has the following format:
  97.         (example: "sdrat.bat")
  98.  
  99.         initcell (string)    days
  100.         initcell (string)    days
  101.                 ... etc.
  102.  
  103.     See "IV.  Running the Program" on using batch input files 
  104.     to the program.
  105.  
  106. III.  Output can be directed to the file <stages.out> or to a line
  107.     printer, using one of the options in the General Menu.
  108.  
  109.  
  110. IV.  Running the program:
  111.  
  112.     -------------------------------------------------------------
  113.                                   program uses
  114.          mode:        you type:        input from:
  115.     -------------------------------------------------------------
  116.       interactive             stages             terminal
  117.     
  118.          batch          stages <file>          <file>
  119.     -------------------------------------------------------------
  120.  
  121.     If a specified input file does not exist,
  122.     the program will ask the user to re-enter the name of the
  123.     file, or to simply hit <return> if the user has decided
  124.     not to use input from a file.
  125.