TURF.FILES
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 test 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:
- SIZE: the combination size.
- RANK: the rank within size.
- REACH: a reach value.
- NUMBER.OF.COMBOS: the number of
combinations that have that reach value.
- PCT.OF.COMBOS: the percent of the
combinations that have that reach value.
- LOWEST.FREQ: The lowest freq value in
the combinations at that reach value.
- 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:
- SIZE: the combination size.
- RANK: the rank within size.
- FREQ: a freq value.
- NUMBER.OF.COMBOS: the number of
combinations that have that freq value.
- PCT.OF.COMBOS: the percent of the
combinations that have that freq value.
- LOWEST.REACH: The lowest reach value
in the combinations at that freq value.
- 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:
- the reach value for the combination.
- the FREQ value for the combination.
- 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 - - -