table tennis racket

Myrtscht

My Round robin Tournament SCHeduling for Table tennis

Tutorial

Since all the stuff in the embedded documentation of myrtscht is very theoretical, I give a big example of the operating process in a tournament here. It can be seen as a tutorial which makes getting used to myrtscht easy. Nonetheless it is required to read the documentation itself because of some extra information not written down in this document.

Step 1: Initiation and Registration

The first step running a tournament is the initiation. After -n comes the name of the directory in which all files are stored in and after -g the number of groups of playing people.

There have four women and seven men registered, thus we make two groups out of them.

    $ myrtscht -n Aremorican_Open-50BC -g 2
    $ cd Aremorican_Open-50BC
    $ ls
    01.g  02.g

After that there are the files 01.g and 02.g in the tournament directory. They have got this structure:

    $ cat 01.g
    Name: 
    Tables:

There we have to fill in the name of the group, the tables where they play and of course the names of the members:

    $ vim 01.g          # of course we use vim(1)
    $ cat 01.g
    Name: Women
    Tables: 1
    Impedimenta
    Mrs Fulliautomatix
    Bravura
    Bacteria
    $ vim 02.g
    $ cat 02.g
    Name: Men
    Tables: 2, 3
    Asterix
    Obelix
    Gaius Iulius Caesar
    Gaius Bonus
    Anticlimax
    Edifis
    Dogmatix

Step 2: Processing the group files

The printer is already set up, therefore we can start creating the group directories. -p means that group files *.g are processed (we could also write -p 01.g 02.g. -P is only necessary when a printer which is not the standard printer is used.

    $ myrtscht -p *.g -P GS-Printfix-50BC
    $ ls
    01.d  02.d
    $ ls *.d
    01.d:
    01.g  01.s  02.s  03.s  04.s  05.s  06.s    

    02.d:
    01.s  03.s  06.s  09.s  12.s  15.s  18.s  21.s
    02.g  04.s  07.s  10.s  13.s  16.s  19.s
    02.s  05.s  08.s  11.s  14.s  17.s  20.s

As you can see the group files have changed into group directories where the former group files and the files into which the results of the games are about to be written are in.

Also, there are sheets of paper printed where the referees should write down the results of the games. Now there are two possibilities: Either we give the whole gamesheets to the referees, relax now and have some hurry later, or we cut the gamesheets up into the parts belonging to just one game, relax never because of continuous getting of little slips and have not so much hurry afterwards. I recommend the former method.

Step 3: Intyping of the Results

Whatever, when the referees have got the gamesheets the playing can start, they can write the results on the paper easily and we have just the job to write them into the computer. (This could grow quite uncomfortable if the used editor is not capable of having multiple files opended. One could also write a script that asks for the results and writes them into the files. – This task seems to be somehow annoying, but it can be solved elegantly. Personally, I do it with vim and some shortcuts and I am faster as someone with a GUI could be. Maybe I'll create a document on rational inputting.)

    $ vim -p 01.d/*.s  # If you prefer the latter of the above
                       # described methods of getting the results,
                       # tabs are helpful.
    $ cat 01.d/*.s
    Impedimenta | Mrs Fulliautomatix
    11  4
    11  8
    Bacteria | Bravura
    11  8
    10  12
    11  9
    Impedimenta | Bravura
    11  4
    11  3
    Bacteria | Mrs Fulliautomatix
    14  16
    12  10
    18  20
    Impedimenta | Bacteria
    11  7
    5   11
    9   11
    Bravura | Mrs Fulliautomatix
    3   11
    8   11
    $ vim -p 02.d/*.s
    # I leave the "cat" out here. It needs too much space and food with
    # two of them.

Note:

Thanks to the ID on the game sheets it is easy to discover the related game file. The first two digits are synonymous with the number of the group directory, the last two to three with the number of the game file.

Example:
        04.s
         /\
   ID: 0304   ==> vim 03.d/04.s
       \/
      03.d

Step 4: Evaluation

As soon as the results of the single games are typed in, the ranking of the whole group can be calculated.

    $ myrtscht -a 01.d
    $ cat 01.d/ranking
    Rank | Name                  |  Games  |   Sets    |  SD  |    Balls    |  BD
    -----+-----------------------+---------+-----------+------+-------------+------
      1. | Impedimenta           |  2 : 1  |   5 : 2   |  3   |   69 : 48   |  21
      2. | Bacteria              |  2 : 1  |   5 : 4   |  1   |  105 : 100  |   5
      3. | Mrs Fulliautomatix    |  2 : 1  |   4 : 3   |  1   |   80 : 77   |   3
      4. | Bravura               |  0 : 3  |   1 : 6   |  -5  |   47 : 76   |  -29
    $ cd 02.d
    $ myrtscht -a *.s
    $ cat ranking
    Rank | Name                  |  Games  |   Sets    |  SD  |    Balls    |  BD
    -----+-----------------------+---------+-----------+------+-------------+------
      1. | Anticlimax            |  6 : 0  |  12 : 0   |  12  |  140 : 104  |  36
      2. | Asterix               |  5 : 1  |  10 : 3   |  7   |  148 : 105  |  43
      3. | Edifis                |  4 : 2  |   8 : 5   |  3   |  134 : 108  |  26
      4. | Gaius Iulius Caesar   |  3 : 3  |   7 : 7   |  0   |  134 : 116  |  18
      5. | Obelix                |  2 : 4  |   5 : 9   |  -4  |  123 : 150  |  -27
      6. | Dogmatix              |  1 : 5  |   4 : 10  |  -6  |  118 : 134  |  -16
      7. | Gaius Bonus           |  0 : 6  |   0 : 12  | -12  |   52 : 132  |  -80

See Also