Skip to content

Latest commit

 

History

History
31 lines (16 loc) · 2.09 KB

graph_generation.md

File metadata and controls

31 lines (16 loc) · 2.09 KB

Graph generation

In order to track our progress and where we stand against the competition, we generate lots of data and turn it into graphs as seen here for CMU, here for Paragon, and here for the Matinee fight scene.

The steps to generate these graphs are detailed here for transparency.

Generating the compression performance data

The first step is to run the compression algorithms in order to extract the raw performance data. This is done by running the acl_compressor executable.

We run it on the input data with the associated python script found here. Typical usage looks like this:

python acl_compressor.py -acl=<path/to/raw/acl/clips> -stats=<path/to/output/stats> -parallel=4 -csv_summary -csv_bit_rate -csv_error

This script generates various CSV files.

Yet another script automates dumping various permutations and can be found here.

Generating the decompression performance data

Much like the compression data, we use a custom tool to generate the decompression CSV files. It is fairly simple with the python script found here. Typical usage looks like this:

python acl_decompressor -stats=<path/to/output/stats> -csv [-ios] [-android]

The script will generate various CSV files. Note that for iOS you must copy the generated SJSON files manually from the device after running the acl_decompressor tool manually as well as add the -ios switch to the python script, and for Android you must add the -android switch after running the tool manually.

Generating the graphs

The generated CSV files in the previous steps can be very large and contain lots of things. In order to make sense of it and to make graph generation easier, we use an array of scripts to parse, extract, and format the data into simpler and cleaner CSV files.

These scripts can be found here along with some instructions on how to run them.