README
¶
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
Directories