github.com/robocup-ssl/ssl-match-stats

ssl-match-stats

A tool that generates statistics from official SSL log files.

Requirements

You need to install following dependencies first:

• Go >= 1.11

Installation

Use go get to install all packages / executables:

go get -u github.com/RoboCup-SSL/ssl-match-stats/...

Run

The executables are installed to your $GOPATH/bin folder. If you have it on your $PATH, you can directly run them. Else, switch to this folder first.

Usage

Generate Statistics

The ssl-match-stats command will generate the statistics into an intermediate data structure match-stats.{json|bin} from which they can be exported. This must be done per tournament and division.

The command takes a list of log files as input:

ssl-match-stats *.log.gz

Export Statistics to CSV files

The generated statistics can be exported into CSV files for further processing, for example with a spreadsheet software or Matlab. The ssl-match-stats-csv command will read the match-stats.bin protobuf file from the current folder and produces a set of CSV files:

ssl-match-stats-csv

Export Statistics to a Database

The generated statistics can be exported into a PostgreSQL database (other DBs not yet tested). This is useful if you want to apply some BI (Business Intelligence) application on the data.

See Setup for Match Stats DB for instructions on setting up the database.

See Setup for Metabase for instructions on setting up Metabase, an open-source BI software.

The command requires some parameters:

• tournament: A unique name for the tournament of the log files, for example 'RoboCup2019'
• division: The division of the log files, one of: 'DivA', 'DivB', 'none'
• sqlDbSource: A connection string to the target database

ssl-match-stats-db -sqlDbSource postgres://user:password@host:port/db-name -tournament RoboCup2019 -division DivA