ResPrint [-f options_file] [-o output_file] [-fields list_of_fieldIDs] [-items list_of_itemIDs] [-sessions list_of_sessionIDs] [-subjects list_of_subjectIDs] file ...
ResPrint takes as arguments the file names of the serialized results files, reads them in and prints out the information in tabulated text format. When ResPrint starts, it first loads GP system's default result output options file. Then it looks for the 'results.properties' output options file in the current directory and if found, loads it (see also section files).
Command line options can be used to select some of the test items to print. Also an options file can be given that can be used to configure the output.
Some options can be used to filter the output of results. You can filter by item ID, session ID or subject ID:
If several filters are specified, the intersection of the item sets produced by the separate filters are included for output.
Output files: The tool converts the serialized results files to TAB-delimeted text format and outputs it to stardard output. You can save the results to a file by redirecting the output of the tool to a file. In the output, results are output one line per test item with item's parameters and answers as fields. Fields are separated by a ASCII TAB character. Comment lines may be output, they always begin with the hash ('#') character.
Result printing options files: The default printing options are first automatically loaded from GP systems default results options file '/usr/GuineaPig/lib/results.parameters'. Then, if a file named 'results.properties' is found in the current directory, it is loaded. Options found in that file override the corresponding options in the default options. Then if an additional option file is provided with the -f option, it is loaded.
The format of the options file(s) is described here.
ResPrint results_*if your result file names begin with 'results_'. The converter then scans in the files given as arguments and prints out the results in a tabulated table. If you have the result printing options file 'results.properties' in the same directory, it is loaded automatically.
To use an additional or alternate options file you want to use, give its name with the -f option, for example:
ResPrint -f results-alt.properties results_*where the 'results-alt.properties' is the name of the additional options file.
To print only the item ID, the parameters 'A' and 'B' and the answer for question 'q1' (such as in example for A/B test in demos):
ResPrint -fields ITEMID,A,B,q1 results_*
To print only results given for items with IDs 'item01', 'item04' and 'item22':
ResPrint -items item01,item04,item22 results_*
To print the the same items above, but only those during sessions 'SES04', 'SES05' and 'SES06':
ResPrint -items item01,item04,item22 -sessions SES04,SES05,SES06 results_*
Note that you can put those filters in an additional options file and read them with the -f option.