End user documentation for the W4H platform
diff --git a/README.md b/README.md index bf02cf8..a814851 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,5 @@ -# w4h-documentation -End user documentation for the W4H platform +# W4H Documentation + +Documentation for the W4H Toolkit. + +[Home](docs/index.md) \ No newline at end of file diff --git a/docs/getting-started/how_to_start.md b/docs/getting-started/how_to_start.md index 8e1809c..29934a1 100644 --- a/docs/getting-started/how_to_start.md +++ b/docs/getting-started/how_to_start.md @@ -1,6 +1,7 @@ # Use W4h dashboard to track your patients' health data ## Introduction + The W4H GeoMTS dashboard is designed to provide visualization and analysis capabilities for GeoMTS data catered specifically for Apple Watch demo purposes. ## How to play with it diff --git a/docs/getting-started/other_things.md b/docs/getting-started/other_things.md index 0b55d52..2ac3587 100644 --- a/docs/getting-started/other_things.md +++ b/docs/getting-started/other_things.md @@ -1,4 +1,5 @@ -## Other things: +# Other things + 1. If you want to try how to set up, try in this link: https://labs.play-with-docker.com/ 2. There is a 5min video to show how to set up the environment: https://drive.google.com/file/d/1basc9nWQKclpZJgMq-K81KAGihfxkdb2/view?usp=sharing \ No newline at end of file diff --git a/docs/getting-started/setting_up.md b/docs/getting-started/setting_up.md index 94c6190..c23800b 100644 --- a/docs/getting-started/setting_up.md +++ b/docs/getting-started/setting_up.md @@ -1,13 +1,16 @@ # Welcome to w4h setting up toturial! ## Prerequisites + 1. In order to install W4H on your server, it is highly recommended to use Docker. This approach helps avoid potential issues related to software version mismatches and environment configurations. Ensure that Docker is running on your server, then execute the following command in your terminal: + > wget https://raw.githubusercontent.com/USC-InfoLab/w4h-integrated-toolkit/jize/docker-compose.yml && docker-compose up --build 2. To set your own database, ensure you have your database service in somewhere, and you know the db's host,username,password,database name, and the port it is listening to. ## Set up + login in with username and password(use "admin" for both username and password in first time) Then following instruction to set your database diff --git a/images/choose_exist_db.png b/docs/images/choose_exist_db.png similarity index 100% rename from images/choose_exist_db.png rename to docs/images/choose_exist_db.png diff --git a/images/conf.py.example b/docs/images/conf.py.example similarity index 100% rename from images/conf.py.example rename to docs/images/conf.py.example diff --git a/images/create_new_db.png b/docs/images/create_new_db.png similarity index 100% rename from images/create_new_db.png rename to docs/images/create_new_db.png diff --git a/images/create_success.png b/docs/images/create_success.png similarity index 100% rename from images/create_success.png rename to docs/images/create_success.png diff --git a/images/db_config.yaml.example b/docs/images/db_config.yaml.example similarity index 100% rename from images/db_config.yaml.example rename to docs/images/db_config.yaml.example diff --git a/images/docker_readme.png b/docs/images/docker_readme.png similarity index 100% rename from images/docker_readme.png rename to docs/images/docker_readme.png diff --git a/images/docker_readme2.png b/docs/images/docker_readme2.png similarity index 100% rename from images/docker_readme2.png rename to docs/images/docker_readme2.png diff --git a/images/import_page_create.png b/docs/images/import_page_create.png similarity index 100% rename from images/import_page_create.png rename to docs/images/import_page_create.png diff --git a/images/input_select_db.png b/docs/images/input_select_db.png similarity index 100% rename from images/input_select_db.png rename to docs/images/input_select_db.png diff --git a/images/legacy_synthetic_subject_data.csv b/docs/images/legacy_synthetic_subject_data.csv similarity index 100% rename from images/legacy_synthetic_subject_data.csv rename to docs/images/legacy_synthetic_subject_data.csv diff --git a/images/manage_database_1.png b/docs/images/manage_database_1.png similarity index 100% rename from images/manage_database_1.png rename to docs/images/manage_database_1.png diff --git a/images/manage_database_2.png b/docs/images/manage_database_2.png similarity index 100% rename from images/manage_database_2.png rename to docs/images/manage_database_2.png diff --git a/images/pgadmin.png b/docs/images/pgadmin.png similarity index 100% rename from images/pgadmin.png rename to docs/images/pgadmin.png diff --git a/images/populate_db.png b/docs/images/populate_db.png similarity index 100% rename from images/populate_db.png rename to docs/images/populate_db.png diff --git a/images/populate_db_time.png b/docs/images/populate_db_time.png similarity index 100% rename from images/populate_db_time.png rename to docs/images/populate_db_time.png diff --git a/images/result_page.png b/docs/images/result_page.png similarity index 100% rename from images/result_page.png rename to docs/images/result_page.png diff --git a/images/select_exist_db.png b/docs/images/select_exist_db.png similarity index 100% rename from images/select_exist_db.png rename to docs/images/select_exist_db.png diff --git a/images/set_db_name.png b/docs/images/set_db_name.png similarity index 100% rename from images/set_db_name.png rename to docs/images/set_db_name.png diff --git a/images/subjects_and_control_group.png b/docs/images/subjects_and_control_group.png similarity index 100% rename from images/subjects_and_control_group.png rename to docs/images/subjects_and_control_group.png diff --git a/images/synthetic_subject_data.csv b/docs/images/synthetic_subject_data.csv similarity index 100% rename from images/synthetic_subject_data.csv rename to docs/images/synthetic_subject_data.csv diff --git a/images/synthetic_timeseries_data_reduced.csv b/docs/images/synthetic_timeseries_data_reduced.csv similarity index 100% rename from images/synthetic_timeseries_data_reduced.csv rename to docs/images/synthetic_timeseries_data_reduced.csv diff --git a/images/upload_subject_csv.png b/docs/images/upload_subject_csv.png similarity index 100% rename from images/upload_subject_csv.png rename to docs/images/upload_subject_csv.png diff --git a/images/upload_time_csv.png b/docs/images/upload_time_csv.png similarity index 100% rename from images/upload_time_csv.png rename to docs/images/upload_time_csv.png diff --git a/docs/index.md b/docs/index.md index e69de29..6ce70d2 100644 --- a/docs/index.md +++ b/docs/index.md @@ -0,0 +1,47 @@ +# Home + +## Introduction + +### What is the W4H Toolkit? + +The W4H Toolkit provides an ecosystem of tools health researchers can use to collect, store, query and analyze wearable and EHR data. + +### A Progressive Toolkit + +W4H Toolkit is an ecosystem that covers most of the common features needed when using wearables in a clinical study or or trial. As studies can have very different requirements, W4H toolkit is designed to be flexible and incrementally adoptable. These are some of the use cases we currently support: + +- Collect Fitbit and Garmin data +- Analyze compliance +- Transform the data, e.g., to compute energy expenditure +- Produce data reports for patients in a study +- Provide approximate queries, e.g., to query the HR of a cohort over an extended period of time +- Running your data science notebooks on Apache Spark +- Implementing data workflows using the library to simplify how you interact with wearable data. + +Some of these use cases are provided both in notebooks and in dashboard. + +## Quick Start + +The best way to try the toolkit is to use the Docker container by following the [Quick Start](quick-start.md) that will get you up and running with the dashboard and some sample notebooks in less than 20 minutes. + +## Components + +The toolkit includes the following components: + +- [Dashboard](dashboard/index.md): provides data input forms and visual analytics. +- [Notebooks](notebooks/index.md): is a collection of sample notebooks that demonstrate include Panda and Spark notebooks. +- [w4h-datasets](notebooks/): is a collection of datasets used in the W4H examples. +- [Postgres Extensions](): provides useful extensions to queries data in the W4H database. +- [Library](w4h-core): core python library of high-level commands to simplify how users interact with wearable data, making the platform more accessible and user-friendly. + +## Best Practices + +### Production Deployment + +## Extra Topics + +### Extending the Dashboard + +### Using your own Postgres Database + +### Contributing diff --git a/docs/quick-start.md b/docs/quick-start.md new file mode 100644 index 0000000..2e51c9b --- /dev/null +++ b/docs/quick-start.md @@ -0,0 +1,18 @@ +# Quick Start + +The W4H Toolkit provides an ecosystem of tools to manage and analyze wearable and other EHR data. We have created a Docker container to give you an overview of what's included in the toolkit. + +## Starting the Container + +You will need to install the `Docker Engine` by following the instructions to [Install Docker Engine](https://docs.docker.com/engine/install/) for your platform. + +Once that is done start and type `uscimsc/w4h` in the search bar and select the `preview` tagged image. After pulling to download the image, run the container by clicking on the “run” icon under “Actions” next to the image name. + + + +## Using the Dashboard + +## Using the Sample Notebookes + +## Next Steps +