DataMuseum.dk

top - metrics - download

    Length: 5375 (0x14ff)
    Types: TextFile
    Names: »cuberank.6«

└─⟦b20c6495f⟧ Bits:30007238 EUUGD18: Wien-båndet, efterår 1987
    └─⟦this⟧ »EUUGD18/General/Cubes/cuberank.6« 

TextFile

.TH CUBERANK 6 "cubes 5.1" GMP "UNIX Gaming Manual"
.SH NAME
cuberank \- cubes player rankings and statistics
.\"
.\" sccsid: @(#)cuberank.6 5.1 (G.M. Paris) 89/01/22
.\"
.\"
.\"
.\"	cubes 5.1  Copyright 1988 Gregory M. Paris
.\"		Permission granted to redistribute on a no charge basis.
.\"		All other rights are reserved.
.\"
.\"
.SH SYNOPSIS
.B cuberank
[
.B \-ahlsuCLPRST
] [
.B \-n rng
[
.B \-p plr
]] [
.B \-g gms
] [
.B plr ...
]
.SH OVERVIEW
The
.I cuberank
program analyzes the
.IR cubes (6)
score file and prints statistics about the players.
The various command line options allow the user
to affect which statistics the program displays
and which players the program provides information about.
.PP
Although useful in and of itself,
combining multiple calls of
.I cuberank
with pipes to
.IR sed (1)
and/or
.IR awk (1),
can provide more concise summaries of player ranking information.
The shell script /usr/games/scr provides one such summary,
which can be used as is,
or as an example for your own summary script.
.PP
.SH OUTPUT
Depending on the set of command line options specified,
.I cuberank
will produce from seven to twelve columns of information
about a selected subset of players who have played
.I cubes
on this system.
The columns are defined as follows.
.PP
.IP Heading 12
Description
.IP Up
up next number (displayed using the
.B \-u
option)
.IP ##
the player's rank (1 being the top rank)
.IP Player
the name of the player
.IP GP
the number of games played
.IP LG
the last game the player played in
(displayed using the
.B \-l
option)
.IP WinRt
win rate (wins / games played)
.IP GamPt
average points per game (total points / games)
.IP TnPt
average points per turn (sum of turn averages / games)
.IP WgtPt
weighted points derived from
.BR WinRt ,
.BR GamPt ,
and
.BR TnPt
.IP Pr
the player's game type preference:
.B \-
for no preference,
.B S
for Standard,
.B B
for Blitz,
.B FS
for Forced Standard,
.B FB
for Forced Blitz, and
.B ?
for fickle
(displayed using the
.B \-P
option)
.IP Tmp
the three character abbreviation for the player's temperament,
which is the roll-or-hold decision function used by this player
(displayed using the
.B \-P
option)
.IP Str
the three character abbreviation for the player's strategy,
which is the the die-discarding function used by this player
(displayed using the
.B \-P
option)
.PP
The ranking order is based on the weighted point value,
so that the player with the highest weighted point value is the
highest ranked player (number one).
The weighted point value is determined using the following formula.
.IP
.B WgtPt
= 1000 *
.B WinRt
+
.B GamPt
+
.B TnPt
.PP
The largest value in each of the
.BR WinRt ,
.BR GamPt ,
.BR TnPt ,
and
.BR WgtPt
columns is marked with an asterisk.
.SH "COMMAND LINE OPTIONS"
Several command line options are provided to alter the output produced by
.IR cuberank .
.IP Option 12
Description
.IP \-a
Display ``ancient'' records, where ancient records are those
corresponding to players that haven't played a game
in as many games as there are players in the score file.
.IP \-g\ count
Tell only about players that have played in the last
.B count
games.
.IP \-h
Produce information about human players only.
.IP \-l
Display the game number of the last game each player played.
.IP \-n\ range
Produce information only about players ranked within plus or minus
.B range
of your ranking.
.IP \-p\ plr
Use
.B plr
as the center for the
.B \-n range
option.
.IP \-s
Change spaces in player names to underscores.
(Allows easier
.IR awk ing
of
.I cuberank
output.)
.IP \-u
List computer players only, in order of decreasing likelihood
of playing in the next game.
(Due to the random factors involved,
there's no guarantee that players at the top of the list will be
in the next game.)
.IP \-L
Display
.RB `` Lifetime ''
values for
.BR WinRt ,
.BR GamPt ,
.BR TnPt ,
and
.BR WgtPt .
These values are representative of the complete history of games
played by each player.
.IP \-R
Display
.RB `` Recent ''
values for
.BR WinRt ,
.BR GamPt ,
.BR TnPt ,
and
.BR WgtPt .
.B Recent
values are computed using a moving average with a window of twenty-five games.
Thus, these values are representative of each player's recent performance.
.IP \-C
Display
.RB `` Combined ''
values for
.BR WinRt ,
.BR GamPt ,
.BR TnPt ,
and
.BR WgtPt .
.B Combined
values are derived from the mean of the
.B Recent
and
.B Lifetime
values.
(This is the default.)
.IP \-P
Display the player's ``personality.''
This option causes the
.BR Pr ,
.BR Tmp ,
and
.B Str
columns to be produced.
.IP \-S
Tabulate and display statistics for the strategies
employed by the players.
The tabulated values correspond to the subset of
players selected by any other command line options.
.IP \-T
Tabulate and display statistics for the temperaments
of the players.
The tabulated values correspond to the subset of
players selected by any other command line options.
.IP plr\ ...
Restrict output to that corresponding to the named players.
.PP
Two other commonly desired options,
to print the top or bottom of the rankings,
are not provided,
as they can be had as easily using the
.IR head (1)
and
.IR tail (1)
utilities.
.SH FILES
.ta 3.5i
.nf
/usr/games/lib/cubes.hist	the score file
/usr/games/scr	summarize cuberank script
.fi
.SH AUTHOR
Greg Paris <gmp@rayssd.ray.com>
.SH "SEE ALSO"
cubes(6), awk(1), head(1), sed(1), tail(1)