How to maintain a rating system using tsh.
Updated Sun 10 Jun 2018 15:31:21 EDT for tsh 3.300.
One of the more popular features of
tsh is its calculation of tournament ratings.
When you set up your tournament’s
“.t” files
with information about your players,
you enter their pretournament ratings, and if necessary their career game totals
(depending on your rating system, you may be able to use the
“USERATINGS
”
command to do this automatically).
As your tournament progresses, you can display current ratings using the
“RATings
”
and
“ScoreBoard
”
commands.
At the end of your tournament, you can submit ratings data to your
rating officer using the
“SUBMIT
”
command (if your rating system is supported),
or by generating a ratings report using commands like
“ABSPgrid
”
or
“AUPAIR
”
and emailing the results.
The rest of this section describes in greater technical detail what is involved in connecting tsh to a rating system, and its intended audience includes ratings officers and directors who want to discuss tsh with their ratings officers. As always, if there is anything that tsh doesn’t yet do that you would like it to do, please contact John Chew at poslfit@gmail.com. Each one of tsh’s features is there because someone asked for it; if a feature is missing, it’s just because you haven’t asked for it yet.
tsh stores pretournament rating information for each player in a tournament’s “.t” data files.
tsh stores information about rating systems in its “lib/ratings” folder. This folder contains one sub-folder per rating system. For historical reasons, NASPA ratings are stored as “nsa”. If you want tsh to support a new rating system, the first step is to ask John Chew to assign you a new, unique rating system name.
Rating system sub-folders contain contain files such as:
Example users: Philippines, Toronto Speed
It’s easy to use tsh to run a small rating system for one or more people to use on one computer.
USERATINGS
”
command.
This copies ratings from your current ratings file to your tournament data files.
EXPORTRATINGS
”
command.
This creates a new ratings file.
Example users: WESPA
If you have an existing legacy rating system that cannot easily be connected
to the web, you should determine what ratings data format it uses (tsh
currently supports its native format, Homan, Aupair and ABSP grid formats),
and have your tournament directors e-mail the appropriate reports to your
ratings officer. If you can persuade your ratings officer to post current
ratings online, your directors can use the
“USERATINGS
”
command.
Example users: PSA
If you use more than one computer to run rated events but do not have a system set up to automatically receive online rating submissions, you can use an FTP client to maintain a shared rating database online.
First, ask John Chew to do the following:
Then, at each rated event:
UPDATERATINGS
”
command.
This fetches the current ratings file from the FTP server.
USERATINGS
”
command.
This copies ratings from your current ratings file to your tournament data files.
EXPORTRATINGS
”
command.
This creates a new ratings file.
Example users: Scrabble Kenya
If you use more than one computer to run rated events but do not have a system set up to automatically receive online rating submissions, you can use a web client to maintain a shared rating database online.
First, ask John Chew to do the following:
Then, at each rated event:
UPDATERATINGS
”
command.
This fetches the current ratings file from the FTP server.
USERATINGS
”
command.
This copies ratings from your current ratings file to your tournament data files.
EXPORTRATINGS
”
command.
This creates a new ratings file.
Example users: ABSP, NASPA
If you have a large rating system or like automation, you should set up
(or ask John Chew to set up) a web page to which your tournament directors
can upload ratings data using the
“SUBMIT
”
command.
Once it’s uploaded, your web site may immediately calculate new ratings
and make them available for download to the
“USERATINGS
”
command,
or it may hold them for manual verification, as NASPA currently does.