.. -*- coding: utf-8 -*- .. :Project: SoL .. :Created: mer 25 dic 2013 11:16:02 CET .. :Author: Lele Gaifax .. :License: GNU General Public License version 3 or later .. :Copyright: © 2013, 2014, 2015, 2018, 2020 Lele Gaifax .. .. _championships management: Championships management ------------------------ .. index:: pair: Championships; Management A *championship* is a set of one or more *tourneys*, organized by the same *club* with the same `format`: all tourneys of a particular championship are obligatorily all *singles* **or** all *doubles* and use the same prize-giving method. .. contents:: Menu actions ~~~~~~~~~~~~ In addition to the :ref:`standard actions ` the menu at the top contains the following items: .. figure:: championships.png :figclass: float-right Championships management :guilabel:`Tourneys` Opens the :ref:`management of the tourneys ` organized within the selected championship :guilabel:`Club` Opens the :ref:`management of the clubs ` filtered on the club that organize the selected championship :guilabel:`Download` Downloads an archive of all the tourneys organized within the selected championship :guilabel:`Ranking` Creates a PDF document with the ranking of the selected championship :guilabel:`Assign` Change the ownership of the selected championship: you can select one or more championships keeping pressed the :kbd:`Ctrl` key and extend the selection with the :kbd:`Shift` key .. _championships insert and edit: Insert and edit ~~~~~~~~~~~~~~~ .. index:: pair: Insert and edit; Championship Club and Description ++++++++++++++++++++ Each championship belongs to a particular :guilabel:`club` and has a :guilabel:`description` that must be unique within the same club. Players per team ++++++++++++++++ :guilabel:`Players per team` determines the maximum number of players participating as a single :ref:`competitor `: 1 for singles, 2 for doubles, up to 4 for teams. Skip worst results ++++++++++++++++++ With :guilabel:`skip worst results` you specify how many *worst* result will be ignored in the final sum for each player at the end of the season. This is in order not to penalize who have not been able to participate in **all** the events. .. _training championship: Training boards +++++++++++++++ Usually left blank, when set the value indicates the number of boards that every participant to a :ref:`solitaire tournaments ` must play. In this kind of tourneys, the *score* of each player is computed from the *average of missing shots*, that is the number of shots that do *not* pocket any carromman, in the course of several consecutive boards. Those values can be either entered as usual, or inserted directly by the players themselves, using a form that they must fill at the end of each round: each time the tourney's manager generates a new round, he can use the :guilabel:`Send emails` action of the :ref:`matches panel ` (visible *only* in this kind of tournaments) to send an email to each competitor with the URL they will have to visit. It is clearly a duty of the tourney's manager to check that the typed in values are correct: from time to time he should use the :guilabel:`Update` action to refresh the matches, and when all the scores have been inserted correctly he can use the :guilabel:`Recompute ranking` action and eventually generate the next turn. .. _championship rating: Rating ++++++ The :guilabel:`rating` is used as the default value when creating new tourneys within the championship: usually, but not always, all events in a championship use the same rating; in any case, it's the :ref:`tourney's setting ` to be decisive, because it may happens that a particular event, even if it belongs to a given championship, uses a different rating, for example for an *open* tournament. Pairing method ++++++++++++++ The :guilabel:`pairing method` is used as the default value when creating new tourneys within the championship and determines how SoL will pair the participants at each round (see :ref:`pairing generation method ` of the tourney for details). .. index:: Bounties Bounties ++++++++ The :guilabel:`bounty-giving method` field determine the method used to assign final bounties. These bounties have two primary scopes: 1. to have uniform, and thus `addable`, tourney results with the goal of producing the championship ranking 2. by being essentially freely assignable, it becomes possible to swap the positions of the first two (or four) players, should the final matches between the first and the second (or between the third and the fourth) competitors determine a different winner One particular case is the value ``No final bounties``, which basically means that the bounty-giving will simply assigns a monotonically decreasing sequence of integer numbers, starting from the number of competitors down to 1 as the bounty, just to allow swapping competitors ranking positions after tournament's final rounds. These bounties won't appear in the final ranking printout of the tourney. Moreover, the championship's ranking does not sum up competitor's bounties, but rather his points. The other four values have the following meanings: ``Fixed bounties`` assigns 18 points to the winner, 16 to the second, 14 to the third, 13 to the fourth and so on down to the 16th place; ``Fixed 40 bounties`` assigns 1000 points to the winner, 900 to the second, 800 to the third, 750 to the fourth etc, down to 1 point to the 40th place; ``Classic millesimal bounties`` assigns 1000 points to the winner and a proportional prize to all other players; this is usually preferable when the number of competitors is higher than 20 or so; ``Centesimal bounties`` assigns 100 points to the winner, 1 point to the last competitor in the ranking, and a linear interpolation to the other competitors. .. _closed championship: Closed ++++++ The field :guilabel:`closed` indicates whether the championship is complete: no other tourney can be associated with these championships. The championship lookup combos (for example, when inserting :ref:`new tourneys `) show only those still active. Previous championship +++++++++++++++++++++ :guilabel:`Previous championship` allows browsing the various seasons of tournaments. It allows the selection of one *closed* championship. Owner +++++ The user who is *responsible* of the championship data, usually the one that inserted that particular record: the information related to the championship are changeable only by him (and also by the *administrator* of the system).