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
- myrtscht
The manual to the program itself.
Games::Tournament::TableTennis
The module on which the program is based.