Contents of downloaded data files

Updated:

In this article, you can find samples and information about the contents of your downloaded data files.

 

Common files

README.txt: contains information about the package content and query information.

UPLOAD_STATUS.txt: shows the data upload status of all the Embrace devices paired with the subjects enrolled in the study during the requested time interval. See an example below:

upload_Status.png

metadata.csv: shows timing information and the Embrace settings during the considered time window (Timezone, Firmware, Seizure Model, App Name, App Version, OS Version). If it contains more than one row, it means that a column has changed during the considered duration (e.g., change in the timezone or Firmware update). See an example below:

metadata.png

 

Sensors Data

In each file, the first column of the exported raw sensors data corresponds to the timestamp expressed as Unix Time in milliseconds (UTC), synced with the paired device’s clock.

The following columns contain the raw data recorded by the sensors:

  • temp.csvdata from temperature sensor expressed in degrees on the Celsius (°C) scale
  • eda.csv: data from the electrodermal activity sensor expressed in microsiemens (μS)
  • acc.csv: data from 3-axis accelerometer sensor expressed as [g] unit. The accelerometer is configured to measure acceleration in the range [-16g, 16g]; data from x, y, and z axes are respectively in the second, third, and fourth columns.

 

Dummy data examples:

temp.csv

 temp.png

eda.csv

eda.png 

acc.csv

acc.png 

 

Summary Data

The summary.csv is a spreadsheet that provides a synopsis of all the raw sensor data mentioned above in one file, aggregated by the minute. It includes the following information:

  • Datetime (UTC) with 1 minute resolution, e.g.  2019-01-01T23:49:00Z
  • Timezone (minutes)e.g. 60 (which means the data was recorded in UTC+1 timezone)
  • Acceleration magnitude average [normalized by g] over a minute
  • EDA - 1 minute averages expressed as microsiemens [μS]
  • Skin temperature - 1 minute averages expressed as degrees Celsius (°C)
  • Movement intensity - an integer value as an arbitrary unit calculated by Empatica’s Physical Activity Algorithm. It can assume values in the range [0-180]. 
  • Rest - classification of rest period according to Empatica’s Sleep Detection Algorithm. Values are as follows:
    • 0=No-sleep; 1=Sleep; 2=Turns & Tosses; 3=Interruption
  • On Wrist flag - boolean value resulting from the analysis of Empatica’s compliance detection algorithm
    • True if the Embrace has been worn correctly, false if otherwise

Below is an example of the summary.csv file: summary.png

 

Seizures / Events Reports

The exported spreadsheet (.CSV format) of the subjects’ reported seizures/events include the following information:

  • Site ID
  • Subject ID
  • Date and time (UTC)
  • Timezone (minutes)
  • Duration of the event (seconds)
  • Subjects notes
  • Creation (for seizure studies: detected or manual)

The report can provide you with important contextual information on the subjects’ circumstances at the time of the event, including duration, possible triggers, and any other pertinent information that subjects note. In line with this, you may check the relevant raw data for any patterns and further analysis.

Below is an example of the seizures report exported for a site, with the ID, TEST.

seizure_list.png

Please note that the file will contain all the seizures or events experienced by all subjects for the whole duration of their enrollment.


If you’d like to view and download the report from a specific subject per month, you can do so by going directly to the Subject Overview Page. You can find more info here: Subject Compliance Reports

Have more questions?