How can I download my experiment data?

Once you have ended an experiment, follow along with the steps below to download all data from your Sensor Dots and reset them so they are ready for the next experiment.

Downloading

Make sure the Composer application is open and the Dock is connected to your computer via the provided USB cable. Next, place your Sensor Dots back into the Dock. The Dock will automatically start downloading all data on each Sensor Dot, one-by-one, as indicated by the red status LED. After the data download has completed, the Sensor Dot will be reset so it’s ready for a new experiment.

A download of multiple Sensor Dots with long recordings may take time. Please be patient and refrain from taking Sensor Dots off the dock while the download is still in progress as this may result in loss of data!

Where is my data stored

Your data will be uploaded to the Byteflies cloud so it is always accessible from your account. At this time, this functionality is not yet active, stay tuned for an update.

macOS

Your data will be stored on your local drive as CSV files in ~/Documents/byteflies-data.

Windows

Your data will be stored on your local drive as CSV files in %userprofile%/Documents/byteflies-data.

OS Independent

On both macOS and Windows, your data will be stored according to the following structure:

Experiment Name & ID / Recording ID / Sensor Dot Name and ID / data_stream.csv

data_stream can be any of the following:

ECG: electrocardiogram PPG_GREEN: photoplethysmography, green channel PPG_RED: photoplethysmography, red channel PPG_IR: photoplethysmography, infrared channel RES: respiration ACM_X: acceleration, x-axis ACM_Y: acceleration, y-axis ACM_Z: acceleration, z-axis GYR_X: rotation, x-axis GYR_Y: rotation, y-axis GYR_Z: rotation, z-axis

The CSV files can be opened with any text or spreadsheet editor. Each file contains a single column of data with two special rows:

row 1: recording start time as UNIX timestamp row 2: sampling frequency in Hertz (Hz) row 3+: data

Unit Conversion

The values in the CSV files currently reflect the raw output of the sensor. To convert to more human readable units, you can use the following conversion factors:

ECG Role

  • ECG: Multiply by 0.000048 and round to two decimal points for a value in mV
  • ACM: Divide by 8192 for a value in g; range is ± 4g

PPG Role

  • PPG: Multiply by 0.00114 and round to one decimal point for a value in µA
  • ACM: Divide by 8192 for a value in g; range is ± 4g

RES Role

  • ECG: Multiply by 0.000048 and round to two decimal points for a value in mV
  • RES: Divide by 200 and round to one decimal point for a unitless value
  • ACM: Divide by 8192 for a value in g; range is ± 4g

IMU Role

  • ACM: Divide by 4096 for a value in g; range is ± 8g
  • GYR: Divide by 16.384 for a value in ‘degrees’; range is ± 2000 degrees/sec

Note that we will soon reflect the proper units in the CSV files and in the Byteflies cloud. To learn more about which signals will be recorded based on the Sensor Dot configuration, check the roles and Signal Quality pages.

Charging

Any time your Sensor Dots are on a Dock that is connected to a powered-on computer, they are charging, as indicated by the blue status LED.

Next, you will probably want to examine your data, so keep reading.

^ Top of Page