User's Manual

Table Of Contents
The information contained in this document is confidential and is the property solely of Empatica, S.r.l.. Any reproduction in part or in whole without
the written permission of Empatica, S.r.l. is prohibited. © Empatica S.R.L, 2021. All rights reserved.
20
Biomarkers
Description: Biomarkers are pre-processed data by Empatica’s algorithms that are
calculated every minute.
Flow: Biomarkers are computed in-app every minute from sensor raw data and
securely uploaded to the Empatica Cloud.
Data type: Biomarkers files can be used as normal CSV files. Each row is 1 minute for
the specific day and each column is a type of biomarker calculated (see below for the
complete list).
Data access: Biomarkers are accessible in the same way as the sensor raw data when
accessing the data bucket (see Data Access section above). Biomarkers can also be
visible in the Care Portal (see Software section below).
Data usage: Biomarkers files can be used in almost every editor.
API access: The Empatica Biomarkers Service (coming in Q1 2021) makes all the
biomarkers available for a given timeframe for a specific user (request up to 14 days of
data in one request). The data is provided in json file format.
Sensors Raw Data Specifications
The frequencies of the sensor raw data are the ones specified in the sensor configurations above.
The Avro schema can be shared upon request together with a sample dataset.
The content of an Avro file is summarized below:
General Information
Schema Version: (string) Version of the Avro schema used
Firmware Version: (string) Version of the EmbracePlus firmware
Timezone: (int) Delta in seconds from UTC time at the location of the user
User Identifier: (int) Internal user identifier in Empatica’s systems
Serial Number: (string) EmbracePlus Serial Number
Timestamp
(long) Timestamp in UTC (µs) of the start of the file. All the sensor's starts are
synchronized with this timestamp.
Acceleration
Description: Data from 3-axis accelerometer sensor expressed in ADC counts.
Conversion to actual gravitational units (g) can be performed using physical
and digital dimensions of the selected configuration.
Sampling frequency: refer to the sensor configurations above.
x: (array/int) Acceleration in the x-axis (ADC counts)
y: (array/int) Acceleration in the y-axis (ADC counts)
z: (array/int) Acceleration in the z-axis (ADC counts)
Gyroscope
Description: Data from 3-axis gyroscope expressed in ADC counts. Conversion
to actual degrees per seconds (dps) can be performed using physical and
digital dimensions of the selected configuration.
Sampling frequency: refer to the sensor configurations above.
x: (array/int) Angular velocity in the x-axis (ADC counts)
y: (array/int) Angular velocity in the y-axis (ADC counts)
z: (array/int) Angular velocity in the z-axis (ADC counts)
Peripheral Temperature
Description: Data from temperature sensor expressed degrees on the Celsius
(°C) scale.
Sampling frequency: refer to the sensor configurations above.
Values: (array/float): Temperature (°C).