The primary turf output files are the REACH.RESULTS                     
        file and the FREQ.RESULTS file; they are described                      
        in the TURF.RESULTS helpfile.                                           
                                                                                
        This helpfile describes four additional output files                    
        that P-STAT'S TURF command can produce if requested.                    
        This helpfile was last updated on Sept 16, 2006.                        
                                                                                
              ********************************************                      
              *  other optional output file identifiers  *                      
              ********************************************                      
                                                                                
        REACH.SUMMARY qqq 200,                                                  
                                                                                
                    optional output p-stat system file.                         
                    This file tells you how many combinations                   
                    had each of the reach values that were found.               
                                                                                
                    The default is to write the 100 best reach                  
                    values for each size being processed.                       
                    If an integer like 200 follows the file name,               
                    that many would be written for each size.                   
                                                                                
                    Each row in the reach.summary file contains:                
                      (1)  SIZE: the combination size.                          
                      (2)  RANK: the rank within size.                          
                      (3)  REACH: a reach value.                                
                                                                                
                      (4)  NUMBER.OF.COMBOS: the number of                      
                           combinations that have that reach value.             
                      (5)  PCT.OF.COMBOS: the percent of the                    
                                combinations that have that reach value.        
                                                                                
                      (6)  LOWEST.FREQ: The lowest freq value in                
                           the combinations at that reach value.                
                      (7)  HIGHEST.FREQ: The highest freq value in              
                           the combinations at that reach value.                
                                                                                
        FREQ.SUMMARY qqq 200,                                                   
                                                                                
                    optional output p-stat system file.                         
                    This file tells you how many combinations                   
                    had each of the freq values that were found.                
                                                                                
                    The default is to write the 100 best freq                   
                    values for each size being processed.                       
                    If an integer like 200 follows the file name,               
                    that many would be written for each size.                   
                                                                                
                    Each row in the freq.summary file contains:                 
                      (1)  SIZE: the combination size.                          
                      (2)  RANK: the rank within size.                          
                      (3)  FREQ: a freq value.                                  
                                                                                
                      (4)  NUMBER.OF.COMBOS: the number of                      
                           combinations that have that freq value.              
                      (5)  PCT.OF.COMBOS: the percent of the                    
                           combinations that have that freq value.              
                                                                                
                      (6)  LOWEST.REACH: The lowest reach value                 
                           in the combinations at that freq value.              
                      (7)  HIGHEST.REACH: The highest reach value               
                           in the combinations at that freq value.              
                                                                                
        FULL.OUTPUT fff 200,                                                    
                                                                                
                    optional output p-stat system file.                         
                    This has the results of combinations                        
                    in the order that they were processed.                      
                                                                                
                    The default is to write the results of the                  
                    initial 5,000 combinations that were tried,                 
                    regardless of size.                                         
                                                                                
                    If an integer like 25,000 follows the file                  
                    name, up to that many would be written.                     
                    Such a large number should be used with                     
                    caution, and only if really needed, because                 
                    this can create a very large file.                          
                                                                                
                    Each row in the full.output file contains:                  
                      (1 ) the reach value for the combination.                 
                      (2 ) the FREQ  value for the combination.                 
                                                                                
                      (3+) the positions of the items that                      
                           make up the combination.                             
                           If the USE.NAMES identifier is also                  
                           used, the names of the items will                    
                           be used instead of the positions.                    
                           Names, however, make the file larger.                
                                                                                
              ************************************************                  
              *  passing results to the TURF.SCORES command  *                  
              *  using a TEMPLATE file                       *                  
              ************************************************                  
                                                                                
        The TURF.SCORES command needs to know the items and options             
        to be used in the scoring. These can be supplied within the             
        TURF.SCORES command itself. However, if you want to score               
        the best result from a TURF run, it is easier to have TURF              
        write a template file which TURF.SCORES can read directly.              
        This option cannot be used when several sizes are being run.            
                                                                                
        TEMPLATE ttt,                                                           
                                                                                
                    optional output p-stat system file.                         
                    This contains the names of the items                        
                    that comprised the best combination.                        
                    It also contains information about the                      
                    options (like weighting) that were used.                    
                                                                                
                    This file can be given to the TURF.SCORES                   
                    command, to score the cases on the combination              
                    contained in the file. TURF.SCORES then writes              
                    an output file that has the reach score for                 
                    each case on that combination.                              
                                                                                
                    It is then quite easy to investigate the                    
                    demographics of the reached cases.                          
                                                                                
              ****************************                                      
              *  a simple TEMPLATE file  *                                      
              ****************************                                      
                                                                                
                    The following shows a typical template file                 
                    for a combination of 5 items, with variable                 
                    www being used as a caseweight, and                         
                    no other options in use.                                    
                                                                                
                              item  case     response      reach                
                    items  weights  weights  weights   threshold                
                                                                                
                    VAR3         1  www      no                1                
                    VAR4         1  -        -                 -                
                    VAR5         1  -        -                 -                
                    VAR13        1  -        -                 -                
                    VAR23        1  -        -                 -