W4H Toolkit ICDE Demo

W4H Toolkit ICDE demonstration. A video demo is available at here.

About

The Wearables for Health (W4H) Toolkit is a suite of Open Source tools for managing, analyzing, and visualizing wearable data used in health applications. The Toolkit leverages a novel Geospatial Multivariate Time Series (GeoMTS) abstraction, which enables streamlined management and analysis of wearable data. The ICDE Demo provides a preview of the following W4H Toolkit components:

• StreamSim: A real-time data streaming simulator tool for tabular data.
• W4H ImportHub: A gateway to ingesting datasets.
• pyGarminAPI: A Python library to interact with the Garmin API.
• Analytics Dashboard: Dashboard demonstrating the W4H capabilities

See also the W4H Toolkit for Acquisition, Storage, Analysis and Visualization of Data from Wearable Devices video demonstration.

Run the Demo

The following instructions are provided for Mac ONLY!

You will need the following to run the demo:

• Docker Desktop
• pgAdmin
• Postgres.app

After you install Docker, pgAdmin and Postgres.app, start Postgres.app server and verify the installation:accessible: - Verify the installation running pg_config --version - Verify the connection with pgAdmin

            host: localhost
            port: 5432
            maintenance database: postgres
            user: postgres
            password: postgres

You can then run the demo in 3 different ways:

1. DockerHub image (easiest)
2. Building a Docker image
3. From code base

See below for instructions on how to proceeds. Once the W4H toolkit container is running, open the dashboard at http://localhost:8501/ and follow DEMO_SCENARIO.md.

1. DockerHub image

Download the DockerHub w4h:icde-demo image and run the container:

    docker pull uscimsc/w4h:icde-demo
    docker run -dp 8501:8501 uscimsc/w4h:icde-demo

2. Building a Docker image

Build a Docker Image and run the Container:

    docker build -t uscimsc/w4h:icde-demo .
    docker run -dp 8501:8501 uscimsc/w4h:icde-demo

If you wish to start the container in interactive mode:

    docker run -it -p 8501:8501 uscimsc/w4h:icde-demo /bin/zsh

    # Start the dashboard
    python -m venv venv
    source venv/bin/activate
    pip install -r requirements.txt
    python stream_sim.py&  
    streamlit run viz.py&  # Starts the dashboard at: http://localhost:8501/

3. From code base

From within this repository start the dashboard:

    python -m venv venv
    source venv/bin/activate
    pip install -r requirements.txt
    python stream_sim.py&  
    streamlit run viz.py  # Starts the dashboard at: http://localhost:8501/