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.
        AGE="Early 50's"
        HOUSEHOLD="Married, lives with spouse" />
        AGE="Mid 50's"
        HOUSEHOLD="Married, lives with spouse" />
        TYPE="Single Family Residence"
        LOCATION="Suburban" />
        Sample dataset contrived for illustration purposes.
    <START_DT>2010-08-01 00:00:00.000</START_DT>
    <STOP_DT>2010-08-31 23:59:59.999</STOP_DT>

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.
    <!-- Provide string labels to associate with integer confidence ratings -->
    <RATING_NAME VALUE = "0">Not Happening</RATING_NAME>
    <RATING_NAME VALUE = "3">Definitely</RATING_NAME>
Any number of *.settings.xml files may be present for a given dataset, allowing users to create subsets of preferences that are easily duplicated.
  <!-- Decompressed video images will be stored here -->
  <CACHE_FOLDER VALUE = "C:\BoxLabCache\" />
  <!-- Number of recent labels to appear in annotation menu -->
   <!-- Toggle whether double coding interface appears -->
  <!-- Should data files be resaved with active labels? -->
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