BoxLab File Formats



Wherever possible, BoxLab data is stored in standard, easy-to-read file formats such as Comma-Separated Values (CSV) and Extensible Markup Language (XML). Binary-formatted data also uses standard formats wherever possible, such as JPEG and WAV. Below is a description of the files currently in use by BoxLab.


BoxLabVisualizer Loader (*.blv)
Contains XML markup with basic descriptive information about the data. Double-clicking on this file will launch the current dataset in the BoxLab Visualizer. When loading a dataset from within BoxLabVisualizer, navigate the File Open window to select a valid .blv file to load the dataset.
<BOXLAB>
  <DATASET NAME="GTX76E">
    <PARTICIPANT
        ID="GTA76"
        SEX="Male"
        AGE="Early 50's"
        OCCUPATION="Professional"
        HOUSEHOLD="Married, lives with spouse" />
    <PARTICIPANT
        ID="GTB76"
        SEX="Female"
        AGE="Mid 50's"
        OCCUPATION="Homemaker"
        HOUSEHOLD="Married, lives with spouse" />
    <SITE
        TYPE="Single Family Residence"
        LOCATION="Suburban" />
    <DESCRIPTION>
        Sample dataset contrived for illustration purposes.
    </DESCRIPTION>
    <START_DT>2010-08-01 00:00:00.000</START_DT>
    <STOP_DT>2010-08-31 23:59:59.999</STOP_DT>
  </DATASET>
</BOXLAB>


Settings File (*.settings.xml)
Used to specify run-time settings for BoxLab Visualizer that will override the application's default values for the current dataset.
<SETTINGS>
  <RATING_NAMES>
    <!-- Provide string labels to associate with integer confidence ratings -->
    <RATING_NAME VALUE = "0">Not Happening</RATING_NAME>
    <RATING_NAME VALUE = "1">Possibly</RATING_NAME>
    <RATING_NAME VALUE = "2">Likely</RATING_NAME>
    <RATING_NAME VALUE = "3">Definitely</RATING_NAME>
  </RATING_NAMES>
</SETTINGS>
Any number of *.settings.xml files may be present for a given dataset, allowing users to create subsets of preferences that are easily duplicated.
<SETTINGS>
  <!-- Decompressed video images will be stored here -->
  <CACHE_FOLDER VALUE = "C:\BoxLabCache\" />
  <!-- Number of recent labels to appear in annotation menu -->
  <NUMBER_OF_RECENT_ANNOTATIONS VALUE = "5" />
   <!-- Toggle whether double coding interface appears -->
  <SHOW_META_RATINGS VALUE = "False" />
  <!-- Should data files be resaved with active labels? -->
  <SAVE_ANNOTATED_DATA VALUE = "False" />
</SETTINGS>
In cases where multiple files accidentally specify different values for the same settings, values from the last file loaded in alphabetical order will be used.


Sensor Data Files (*.csv)
Data files containing information from Object and Motion MITes, final version is merged across kiosks and hours of the day. Files are five columns with a header row:
  • TIME_STAMP: time of activation, for example 2009-11-10 00-02-21.249
  • SENSOR_ID: unique ID of activated sensor, for example 238
  • SENSOR_VALUE: reading of sensor at time of activation
  • SENSOR_TYPE: code indicated type of sensor activated
  • RESEND_ID: ordinal of broadcast transmission received