Calculators

Calculators are used to determine the way points are awarded in a ranking. Each calculator is responsible for analysing matches and awarding points using a specific method. Several calculators can be used at the same time. The points are then calculated by adding up the points of each calculator.

Calculators may be limited to analysing only certain data. They may be limited to matches or match sets only. They may also be limited to certain match types (bye, duel or ffa). It is therefore essential to ensure that calculators are properly configured on the stage.

Calculators are described as an array contain one or several calculator configurations. Each calculator is identified by a name and has options that can configure the calculation methods.

Example: 

[
    {"name": "calculator name", "options": options},
    {"name": "calculator name", "options": options},
    ...
]

Match:

Match set:

Calculator that awards points based on a match result (in duel or bye matches). A number of points can be configured for each possible result: win, draw or loss.

Schema: 

{
    "name": "match_result_points",
    "options": {
        "win": integer,
        "draw": integer,
        "loss": integer
    }
}

Calculator that awards points based on a match rank (in ffa matches). A ranking scale is used to configure how many points are awarded.

Schema: 

{
    "name": "match_rank_points",
    "options": {
        "scale": {
            "1": integer,
            "2": integer,
            "3-4": integer
        }
    }
}

Calculator that awards points based on a match score.

Schema: 

{
    "name": "match_score_points",
    "options": {}
}

Calculator that awards points when a participant plays a bye match. This can be useful to avoid penalising a participant because no opponent could be found for one round.

Schema: 

{
    "name": "match_bye_points",
    "options": {
        "bye": integer
    }
}

Calculator that awards points when a participant is forfeit in match. A negative value should be provided to apply a penalty.

Schema: 

{
    "name": "match_result_forfeit_penalties",
    "options": {
        "forfeit": integer
    }
}

Calculator that awards points based on a match set result (in duel or bye matches). A number of points can be configured for each possible result: win, draw or loss.

Schema: 

{
    "name": "match_set_result_points",
    "options": {
        "win": integer,
        "draw": integer,
        "loss": integer
    }
}

Calculator that awards points based on a match set rank (in ffa matches). A ranking scale is used to configure how many points are awarded.

Schema: 

{
    "name": "match_set_rank_points",
    "options": {
        "scale": {
            "1": integer,
            "2": integer,
            "3-4": integer
        }
    }
}

Calculator that awards points based on a match set score.

Schema: 

{
    "name": "match_set_score_points",
    "options": {}
}

Calculator that awards points when a participant is forfeit in a match set. A negative value should be provided to apply a penalty.

Schema: 

{
    "name": "match_result_set_forfeit_penalties",
    "options": {
        "forfeit": integer
    }
}