common/carp_core_common library
Contains common CARP domain classes which are used across the libraries.
Classes
- Acceleration
- Change in velocity, including gravity, along perpendicular x, y, and z axes in meters per second squared (m/s^2). Typically captured by an accelerometer.
- Account
- Uniquely identifies an account and its associated identity.
- AccountIdentity
- Identifies an Account.
- AddressInput
- The full address of a participant.
- AltBeacon
- A beacon meeting the open AltBeacon standard.
- AltBeaconDeviceRegistration
- A DeviceRegistration for AltBeacon specifying which beacon to listen to.
- AssignedTo
- Determines which participant roles to assign to something.
- BackgroundTask
- A task which specifies that all containing measures and/or outputs should immediately start running in the background once triggered. The task runs for the specified duration, or until stopped, or until all measures and/or outputs have completed.
- BatteryAwareSamplingConfiguration
- A sampling configuration which changes based on how much battery the device has left.
- BLEHeartRateDevice
- A Bluetooth Low Energy (BLE) device which implements a GATT Heart Rate service (https://www.bluetooth.com/specifications/gatt/services/).
- CarpDataTypes
- Contains CARP data type definitions, as defined in CARP Core.
- CompletedTask
- Indicates the interactive task with taskName was completed. taskData holds the result of a completed interactive task, or null if no result is collected.
- CustomInput
- Custom input data as requested by a researcher.
- CustomProtocolDevice
- A general-purpose primary device for custom protocols. Only used when downloading custom protocols from the CARP web service.
- CustomProtocolTask
- A task which contains a definition of a custom protocol which differs from the CARP domain model.
- Data
- Holds data for a DataType. This is an abstract class and contains no data as such.
- DataType
- Specifies the type of a Measure.
- DataTypeMetaData
- Contains meta data about type.
- DataTypeSamplingScheme
- Specifies the sampling scheme for a data type (dataType), including possible options, defaults, and constraints.
- DataTypeSamplingSchemeMap
-
A set of DataTypeSamplingScheme mapped to their data type as
String. - DefaultDeviceConfiguration
- A default device configuration just implementing the basics.
- DefaultDeviceRegistration
- A concrete DeviceRegistration which solely implements the base properties and nothing else.
-
DeviceConfiguration<
TRegistration extends DeviceRegistration> - Describes any type of electronic device, such as a sensor, video camera, desktop computer, or smartphone that collects data which can be incorporated into the platform after it has been processed by a primary device (potentially itself). Optionally, a device can present output and receive user input.
- DeviceRegistration
- A DeviceRegistration configures a DeviceConfiguration as part of the deployment of a StudyProtocol.
- DiagnosisInput
- The diagnosis of a patient.
- ECG
- Electrocardiogram data of a single lead.
- EDA
- Single-channel electrodermal activity (EDA) data, represented as skin conductance. Among others, also known as galvanic skin response (GSR) or skin conductance response/level.
- ElapsedTimeTrigger
- A trigger which starts a task after elapsedTime has elapsed since the start of a study deployment, i.e. when a protocol is deployed on the phone for the first time.
- EmailAccountIdentity
- Identifies an account by a unique emailAddress.
- End
- Specify how a RecurrenceRule ends.
- Error
- Indicates that some error occurred during data collection. message holds any message about the error which might have been captured.
- ExpectedParticipantData
- Describes a participant attribute that pertains to all or specified participants in a study.
- Geolocation
- Geolocation data as latitude and longitude in decimal degrees within the World Geodetic System 1984.
- GranularitySamplingConfiguration
- A SamplingConfiguration which allows specifying a desired level of granularity, corresponding to expected degrees of power consumption.
- HeartRate
- Heart rate data in beats per minute (bpm).
- InformedConsentInput
- The informed consent from a participant.
- InputType
- Custom input data as requested by a researcher.
- MACAddressDeviceRegistration
- A DeviceRegistration for devices which have a MAC address.
- MagneticField
- Magnetic field of the device in 3D space, measured in microteslas μT for each three-dimensional axis. Typically captured by a magnetometer sensor.
- ManualTrigger
- A trigger initiated by a user, i.e., the user decides when to start a task.
- Measure
- Defines data that needs to be measured/collected passively as part of a task defined by TaskConfiguration.
- NameInput
- The full name of a participant.
- NameSpace
- Enumeration of data type namespaces.
- NoOptionsSamplingConfiguration
- A sampling configuration which does not provide any configuration options.
- ParticipantAttribute
- Describes expected data to be input by users related to one or multiple participants in a study.
- ParticipantRole
- Describes a participant playing a role in a study, and whether this role isOptional.
- PersonalComputer
-
Configuration of an internet-connected personal computer with no built-in
sensors. - PersonalComputerRegistration
- A DeviceRegistration for a PersonalComputer specifying details of the PC.
- PhoneNumberInput
- The social security number (SSN) of a participant.
-
PrimaryDeviceConfiguration<
TRegistration extends DeviceRegistration> - A device which aggregates, synchronizes, and optionally uploads incoming data received from one or more connected devices (potentially just itself).
- RecurrenceRule
- Represents the iCalendar RFC 5545 standard recurrence rule to specify repeating events: https://tools.ietf.org/html/rfc5545#section-3.3.10
- Rotation
- Rate of rotation of the device in 3D space. Typically captured by a gyroscope.
- SamplingConfiguration
- Contains configuration on how to sample a data stream of a given type.
- Schedulable
- An interface marking that a TriggerConfiguration can be scheduled.
- ScheduledTrigger
- A trigger which starts a task according to a recurring schedule starting on the date that the study starts.
- SensorData
- Holds data for a DataType collected by a sensor which may include additional sensorSpecificData.
- ServiceRequest
- An abstract base class for all RPC requests to CARP.
- SexInput
- The biological sex assigned at birth of a participant.
- SignalStrength
- The relative received signal strength of a wireless device. The unit of the received signal strength indicator (rssi) is arbitrary and determined by the chip manufacturer, but the greater the value, the stronger the signal.
- Smartphone
-
Configuration of an internet-connected smartphone with built-in
sensors. - SmartphoneDeviceRegistration
- A DeviceRegistration for a Smartphone specifying details of the phone.
- Snapshot
- An immutable snapshot of a CARP Core domain object. Used as the base class for serializable CARP domain objects.
- SocialSecurityNumberInput
- The social security number (SSN) of a participant.
- StepCount
- Step count data as number of steps taken in a corresponding time interval.
- TaskConfiguration
- Describes requested measures and/or output to be presented on a device.
- TaskControl
- Specifies that once a condition of the trigger with triggerId applies, the task with taskName on destinationDeviceRoleName should be started or stopped (as specified by the control parameter).
- TimeOfDay
- A time on a day in 24-hour format. Used in a ScheduledTrigger.
- TriggerConfiguration
- Any condition on a device (DeviceConfiguration) which starts or stops TaskConfigurations at certain points in time when the condition applies. The condition can either be time-bound, based on data streams, initiated by a user of the platform, or a combination of these.
- TriggeredTask
- Indicates the task with taskName was started or stopped (control) by the trigger with triggerId on the device with destinationDeviceRoleName, referring to identifiers in the study protocol. triggerData may contain additional information related to the circumstances which caused the trigger to fire.
- UsernameAccountIdentity
- Identifies an account by a unique username.
- WebBrowser
-
Configuration of an internet-connected web browser device with no built-in
sensors. - WebBrowserRegistration
- A DeviceRegistration for a WebBrowser specifying details of the browser.
- WebTask
- Redirects to a web page which contains the task which needs to be performed. The passive measures are started when the website is opened and stopped when it is closed.
Enums
- Control
- Determines what to do with a task once the condition of a trigger is met.
- DataTimeType
- Describes how Data for a DataType is stored temporally.
- EndType
- Specify how a RecurrenceRule may end as specified in End.
- Frequency
- Specify repeating events in a RecurrenceRule based on an interval of a chosen type or multiples thereof.
- Granularity
- The level of detail a data stream should be sampled at, corresponding to expected degrees of power consumption.
- Sex
- Biological sex of a person.