sus Files

The sus (standing for "Script-readable User Statistics") file is a text file with a Python-syntax dictionary with two entrys:

table

This is a list of dictionaries. Each dictionary represents one data record, which consists of label:value pairs. All labels and values are strings (enclosed in single quotes).

labels

This is a list of labels used in the table. It is used mainly to specify the order of the labels, as the keys of a dictionary are not ordered.

There may be some 'newline' characters in the sus file to improve readablility.

When writing a sus filewith sus2sus, text2sus or table2sus, one can add the switch --binary. The sus filewill then be written in a binary format. The format is produced by the python standard module ``pickle'' and is much faster to parse by the computer, but unreadable for humans.

Example:

test.sus

{'labels': ['instance', 'size'],
 'table': [{'size': '450', 'instance': 'test1'},
 {'size': '694', 'instance': 'test2'},
 {'size': '90', 'instance': 'test3'}]}

is a sus file representing the table

instance	size
test1	450
test2	694
test3	90