Multi-Sport Calibration using the kee sport Configuration

Friendly Reminder: For the most up-to-date information regarding this article, please use the following link: https://confluence.sportradar.ag/display/SK/Multi-sport+calibration%3A+kee+sport+configuration

It is possible to calibrate multi-sport arenas without using the Matlab machine if some configurations are set on the server. This configuration is done by using the kee sport KeeCLI commands.

You can execute kee commands in the Settings tab inside webadmin:

1. Set main calibrated arena.
2. Add calibration for the other sports of the multi-sport arena

How to Set the Main Calibrated Sport

This defines the sport which has been calibrated in webadmin and KeeCalib. The general structure to set the main calibrated sport is using the <name of sport> and the <court model> with the command below:

kee sport set_calibrated -s <name of sport> -c <court model>

If you are not sure which sports and court models are available, the following kee CLI command might help you find the information you are looking for. An example of this is using the command below:

kee sport get

If there is still no fitting court model, due to diverging court size, you can fallback to the CUSTOM court model. This allows you to specify custom court dimensions in <width in cm> and <height in cm>. The provided dimensions are expected to be in centimeters:

kee sport set_calibrated -s <name of sport> -c <court model> --court_size <width in cm> <height in cm>

For example, assuming there is a main calibration for a basketball FIBA court, the corresponding kee command would be:

kee sport set_calibrated -s basketball -c FIBA

Adding Multi-Sport Configurations

In this step, we define the derived multi-sport configurations relative to the calibrated sport. The general command structure is analogous to set_calibrated. 

kee sport add -s <name of sport> -c <court model>

By default, we assume the newly added sport is to be centered, relative to the center of the calibrated sport field. In case of deviation from this assumption, please provide a shift parameter with shifts on the x and y axis in cm:

kee sport add -s <name of sport> -c <court model> --shift <x in cm> <y in cm>

The court model and court size behave the same as for kee sport set_calibrated. Hence, you can define custom court dimensions using the CUSTOM court model.

For example, assuming there is a multi-sport for handball and futsal with their origin in the center (i.e. no shift), the corresponding kee commands would be:

kee sport add -s handball -c IHF
kee sport add -s futsal -c FS

Synchronization

Commands will generate local changes on the server.

Once you are satisfied with the configuration you must synchronize with the database.

The resulting configuration is stored inside /home/setup/dbconfig/sports_court_transformation.json on the venue. In order to perform the synchronization execute the command below:

kee config send -m "Configure venue for multi-sport calibration" -y

Tips and tricks

If you are not sure if multi-sport has already been configured, kee sport get can provide you valuable information.

To get a list of configured sports use the command below:

kee sport get --configured_sports

To find out which court model you can use for a sport use the command below:

kee sport get --sport_court_model <sport name>

To remove a configured sport, use the command below:

kee sport remove -s <sport name>

To update an already configured sport use the command below:

kee sport update --calibrated_sport  -s <name of sport>

--calibrated_sport assigns a new calibrated sport as the origin.

kee sport update -s <name of sport> -c <court model> --court_size <width in cm> <height in cm> --shift <x in cm> <y in cm>

The kee sport update allows you to also update the court model, court size and shift of an existing configuration.