marcin(a)studio4plus.com

# PTScore Plots - documentation

## Data:

Plot data is being read from a text file containing a table. Every row contains a turn number and points for every player in this turn, eg:

1  24953  9315   23528  8257   24624  8918   23828  8465   23828  8465
2  27181  11476  25021  11730  26422  15167  25325  13320  25531  11555
4  34378  15458  27680  19240  30895  19598  30891  15982  30186  14479
5  37975  16026  29323  21450  33315  21875  35002  17113  33194  15888
6  41836  17076  31925  21450  36743  23376  38472  17779  36274  17016
7  45765  19103  34322  23114  40532  26683  41980  19033  39453  18648
8  49946  19238  37241  24170  44463  28964  44676  20255  42361  19685
9  54141  20128  39871  24161  47989  29627  47615  21429  49889  28552
10 62432  29356  42469  26133  50697  30251  51427  23816  52946  29952

Column orderning isn't important. In this case these are: turn number, total and used scores for races: 1, 3, 4, 10 and 11 respectively.

There is a simple Perl script included in the package that runs ptscore, reads the output and writes a row with scores for current turn to stdout.

Basically, all you have to do is:

ptscore.pl <game_dir> >> ptscore.hist

after each host run.

## Invocation Example:

Assuming that ptscore.hist file containes abovementioned data the following command will generate a plot in PNG graphic format:

pl ptscore.plo data=ptscore.hist turn=1 total1=2 used1=3 total3=4 used3=5 total4=6 used4=7 total10=8 used10=9 total11=10 used11=11 -png

Emphasized parameters are defined in ploticus.plo script and described below. The other are standard ploticus parameters and are described in its documentation.

## Parameters:

All of the parameters are of the form:

parameter=value

This group of parameters tells the script from which columns (numbering starts at 1) to read data. At least a column with turn number and score for one race have to be defined.

turn
turn numbers
used1 - used11
used score for race of the given number
total1 - total11
total score for race of the given number

The following parameters describe graph colors, race names etc. Proper values for those parameters are described in ploticus documentation.

usedstyle and totalstyle
line style for used and total plot lines
default are 0 (solid) and 3 (dashed) respectively
usedwidth and totalwidth
line widths for used and total plot lines
default: 0.5
linewidth
line width for both used and total plots (sets the above to the specified value)
default: 0.5
color1 - color11
color of plot lines for race of the given number
racename1 - racename11
name of for race of the given number (displayed in legend)

One more example: scores only for races 3 and 10 will be plotted, in colors red and blue respectively with line thicker than the default and the Birdmen race name is changed to "The Romulans":

pl ptscore.plo data=ptscore.hist turn=1 total3=4 used3=5 total10=8 used10=8 linewidth=1 racename3="The Romulans" color3=red color10=blue -png
2005