rapids/docs/datastreams/aware-mysql.md

4.7 KiB

aware-mysql

This data stream handles iOS and Android sensor data collected with the AWARE Framework and stored in a MySQL database.

Container

A MySQL database with a table per sensor, each containing the data for all participants. This is the default database created by the old PHP AWARE server (as opposed to the new JavaScript Micro server).

The script to connect and download data from this container is at:

src/data/streams/aware_mysql/container.R

Format

If you collected sensor data with the vanilla (original) AWARE mobile clients you shouldn't need to modify this format (described below).

Remember that a format maps and transforms columns in your raw data stream to the mandatory columns RAPIDS needs.

The yaml file that describes the format of this data stream is at:

src/data/streams/aware_mysql/format.yaml

Stream columns named FLAG_TO_MUTATE means they are extracted from the FLAG_AS_EXTRA RAPIDS column. You can refer to OS complex mapping section for detailed information.

!!! hint The mappings in this stream (RAPIDS/Stream) are the same names because AWARE data was the first stream RAPIDS supported, meaning that it considers AWARE column names the default.

??? info "PHONE_ACCELEROMETER"

=== "ANDROID"

    **COLUMN_MAPPINGS**

    | RAPIDS column   | Stream column   |
    |-----------------|-----------------|
    | TIMESTAMP       | timestamp       |
    | DEVICE_ID       | device_id       |
    | DOUBLE_VALUES_0 | double_values_0 |
    | DOUBLE_VALUES_1 | double_values_1 |
    | DOUBLE_VALUES_2 | double_values_2 |

    **MUTATION_SCRIPTS**

    None

=== "IOS"

    Same as ANDROID

??? info "PHONE_ACTIVITY_RECOGNITION"

=== "ANDROID"

    **COLUMN_MAPPINGS**

    | RAPIDS column   | Stream column   |
    |-----------------|-----------------|
    | TIMESTAMP       | timestamp       |
    | DEVICE_ID       | device_id       |
    | ACTIVITY_TYPE   | activity_type   |
    | ACTIVITY_NAME   | activity_name   |
    | CONFIDENCE      | confidence      |

    **MUTATION_SCRIPTS**

    None

=== "IOS"

    **COLUMN_MAPPINGS**

    | RAPIDS column   | Stream column   |
    |-----------------|-----------------|
    | TIMESTAMP       | timestamp       |
    | DEVICE_ID       | device_id       |
    | ACTIVITY_TYPE   | FLAG_TO_MUTATE  |
    | ACTIVITY_NAME   | FLAG_TO_MUTATE  |
    | CONFIDENCE      | confidence      |
    | FLAG_AS_EXTRA   | activities      |

    **MUTATION_SCRIPTS**
    
    ```bash
    src/data/streams/mutations/phone/aware/activity_recogniton_ios_unification.R
    ```

??? info "PHONE_APPLICATIONS_FOREGROUND"

=== "ANDROID"

    **COLUMN_MAPPINGS**

    | RAPIDS column      | Stream column      |
    |--------------------|--------------------|
    | TIMESTAMP          | timestamp          |
    | DEVICE_ID          | device_id          |
    | PACKAGE_NAME       | package_name       |
    | APPLICATION_NAME   | application_name   |
    | IS_SYSTEM_APP      | is_system_app      |

    **MUTATION_SCRIPTS**

    None

??? info "PHONE_BATTERY"

=== "ANDROID"

    **COLUMN_MAPPINGS**

    | RAPIDS column        | Stream column       |
    |----------------------|---------------------|
    | TIMESTAMP            | timestamp           |
    | DEVICE_ID            | device_id           |
    | BATTERY_STATUS       | battery_status      |
    | BATTERY_LEVEL        | battery_level       |

    **MUTATION_SCRIPTS**

    None

=== "IOS"

    **COLUMN_MAPPINGS**

    Same as ANDROID

    **MUTATION_SCRIPTS**
    
    ```bash
    src/data/streams/mutations/phone/aware/battery_ios_unification.R
    ```

??? info "PHONE_CONVERSATION"

=== "ANDROID"

    **COLUMN_MAPPINGS**

    | RAPIDS column        | Stream column       |
    |----------------------|---------------------|
    | TIMESTAMP            | timestamp           |
    | DEVICE_ID            | device_id           |
    | DOUBLE_ENERGY        | double_energy       |
    | INFERENCE            | inference           |
    | DOUBLE_CONVO_START   | double_convo_start  |
    | DOUBLE_CONVO_END     | double_convo_end    |

    **MUTATION_SCRIPTS**

    None

=== "IOS"

    **COLUMN_MAPPINGS**

    Same as ANDROID

    **MUTATION_SCRIPTS**
    
    ```bash
    src/data/streams/mutations/phone/aware/conversation_ios_timestamp.R
    ```