Skip to content

Minimal Working Example

This is a quick guide for creating and running a simple pipeline to extract missing, outgoing, and incoming call features for 24 hr (00:00:00 to 23:59:59) and night (00:00:00 to 05:59:59) time segments of every day of data of one participant that was monitored on the US East coast with an Android smartphone.

  1. Install RAPIDS and make sure your conda environment is active (see Installation)
  2. Download this CSV file and save it as data/external/aware_csv/calls.csv
  3. Make the changes listed below for the corresponding Configuration step (we provide an example of what the relevant sections in your config.yml will look like after you are done)

    Required configuration changes (click to expand)
    1. Supported data streams.

      Based on the docs, we decided to use the aware_csv data stream because we are processing aware data saved in a CSV file. We will use this label in a later step; there’s no need to type it or save it anywhere yet.

    2. Create your participants file.

      Since we are processing data from a single participant, you only need to create a single participant file called p01.yaml in data/external/participant_files. This participant file only has a PHONE section because this hypothetical participant was only monitored with a smartphone. Note that for a real analysis, you can do this automatically with a CSV file

      1. Add p01 to [PIDS] in config.yaml

      2. Create a file in data/external/participant_files/p01.yaml with the following content:

        PHONE:
            DEVICE_IDS: [a748ee1a-1d0b-4ae9-9074-279a2b6ba524] # the participant's AWARE device id
            PLATFORMS: [android] # or ios
            LABEL: MyTestP01 # any string
            START_DATE: 2020-01-01 # this can also be empty
            END_DATE: 2021-01-01 # this can also be empty
        
    3. Select what time segments you want to extract features on.

      1. Set [TIME_SEGMENTS][FILE] to data/external/timesegments_periodic.csv

      2. Create a file in data/external/timesegments_periodic.csv with the following content

        label,start_time,length,repeats_on,repeats_value
        daily,00:00:00,23H 59M 59S,every_day,0
        night,00:00:00,5H 59M 59S,every_day,0
        
    4. Choose the timezone of your study.

      We will use the default time zone settings since this example is processing data collected on the US East Coast (America/New_York)

      TIMEZONE: 
          TYPE: SINGLE
          SINGLE:
              TZCODE: America/New_York
      
    5. Modify your device data stream configuration

      1. Set [PHONE_DATA_STREAMS][USE] to aware_csv.

      2. We will use the default value for [PHONE_DATA_STREAMS][aware_csv][FOLDER] since we already stored the test calls CSV file there.

    6. Select what sensors and features you want to process.

      1. Set [PHONE_CALLS][CONTAINER] to calls.csv in the config.yaml file.

      2. Set [PHONE_CALLS][PROVIDERS][RAPIDS][COMPUTE] to True in the config.yaml file.

    Example of the config.yaml sections after the changes outlined above

    This will be your config.yaml after following the instructions above. Click on the numbered markers to know more.

    PIDS: [p01] # (1)
    
    TIMEZONE:
        TYPE: SINGLE # (2)
        SINGLE:
            TZCODE: America/New_York
    
    # ... other irrelevant sections
    
    TIME_SEGMENTS: &time_segments
        TYPE: PERIODIC # (3)
        FILE: "data/external/timesegments_periodic.csv" # (4)
        INCLUDE_PAST_PERIODIC_SEGMENTS: FALSE
    
    PHONE_DATA_STREAMS:
        USE: aware_csv # (5)
    
        aware_csv:
            FOLDER: data/external/aware_csv # (6)
    
    # ... other irrelevant sections
    
    ############## PHONE ###########################################################
    ################################################################################
    
    # ... other irrelevant sections
    
    # Communication call features config, TYPES and FEATURES keys need to match
    PHONE_CALLS:
        CONTAINER: calls.csv  # (7) 
        PROVIDERS:
            RAPIDS:
                COMPUTE: True # (8)
                CALL_TYPES: ...
    
    1. We added p01 to PIDS after creating the participant file:

      data/external/participant_files/p01.yaml
      

      With the following content:

      PHONE:
          DEVICE_IDS: [a748ee1a-1d0b-4ae9-9074-279a2b6ba524] # the participant's AWARE device id
          PLATFORMS: [android] # or ios
          LABEL: MyTestP01 # any string
          START_DATE: 2020-01-01 # this can also be empty
          END_DATE: 2021-01-01 # this can also be empty
      

    2. We use the default SINGLE time zone.

    3. We use the default PERIODIC time segment [TYPE]

    4. We created this time segments file with these lines:

      label,start_time,length,repeats_on,repeats_value
      daily,00:00:00,23H 59M 59S,every_day,0
      night,001:00:00,5H 59M 59S,every_day,0
      
    5. We set [USE] to aware_device to tell RAPIDS to process sensor data collected with the AWARE Framework stored in CSV files.

    6. We used the default [FOLDER] for awre_csv since we already stored our test calls.csv file there

    7. We changed [CONTAINER] to calls.csv to process our test call data.

    8. We flipped [COMPUTE] to True to extract call behavioral features using the RAPIDS feature provider.

  4. Run RAPIDS

    ./rapids -j1
    

  5. The call features for daily and morning time segments will be in
    data/processed/features/all_participants/all_sensor_features.csv
    

Comments