designspec_file_formats.html

9 File formats

9.1 Introduction

This chapter contains specifications of the file formats used.

The administration program, the client program and each project, test and scale need to have a configuration file to store their settings in. All configuration files will be realized using Java file serialization, and will not be human readable.

Results from individual projects must be stored and need a format as well. These will also be realized using Java serialization.

Finally, it must be possible to export a summary of results to a file that can be read by external applications such as Excel. A format for this file is specified as well. This format will be human readable.

See chapter 6, "Directory structure" for location of configuration files.

9.2 AudioJury Administrator configuration file

Table 6: AudioJuryAdministrator configuration file data
Field	Type	Comment
activeProjectsPath	String	Where to save a copy of activated projects (shared folder).
resultsPath	String	Where to look for project results (shared folder result subdirectory).
lastAddFileDirectory	String	The directory in which the last added file was located.
lastReportDirectory	String	The directory in which the last report was done.

9.3 AudioJuryClient configuration file

Table 7: AudioJuryClient configuration file data
Field	Type	Comment
activeProjectsPath	String	Where to look for activated projects (shared folder).
resultsPath	String	Where to save project results (shared folder result subdirectory).

9.4 Project configuration file

A project configuration file consists of a serialized project object. Sub-objects and in particular the test objects inside the project object are not serialized. Each test object should instead individually be serialized into the respective test directory. See section 9.5, "Test configuration file", section 6.5, "Project directory" and section 6.6, "Test directory".

9.5 Test configuration file

A test configuration file consists of a serialized test object. No sub-objects such as judgements are serialized.

9.6 Scale configuration file

A scale configuration file consists of a serialized scale object.

9.7 Result file

A result file consists of a serialized result object.

9.8 Report file

This file is a comma separated ASCII text file. It contains a result summary for a project. This file can be opened in mathematical software, statistical analysis software or Microsoft Excel. See appendix A, which contains an example of how a report file can look like and what it will look like when loaded in a spreadsheet application. The report file has a tabular format.

9.8.1 Structure

Table 8: Report file structure
Column Name	Meaning
<Project Name>	Project name.
Personal attributes	Each personal attribute represents a column.
<Test Name>	Test name.
<Test Method>	Name of a test method.
<Test Scale>	Name of a scale.
<Interaction>	Automatic or interactive mode.
<Sound A>	Name of a sound A.
<Sound B>	Name of a sound B.
<Score Value>	Score value.
<Score Label>	Score label.