Upload
vumien
View
220
Download
2
Embed Size (px)
Citation preview
Physical Therapy App
User Manual
Team Members: James Burton & Everett Williams
Table of Contents
Abstract.......................................................................................................................1
Introduction.................................................................................................................2Summary of App Functionality.............................................................................................................................2Target Audience.......................................................................................................................................................... 2Target Devices..............................................................................................................................................................2Benefits........................................................................................................................................................................... 2
Android App.................................................................................................................4Opening the App..........................................................................................................................................................4Screenshots................................................................................................................................................................... 5Home screen functions.............................................................................................................................................5Submenu Bar................................................................................................................................................................ 5Exercise List Screen...................................................................................................................................................6Settings screen functions........................................................................................................................................6Exercise screen functions........................................................................................................................................6Log view screen functions......................................................................................................................................7Comparing video view functions.........................................................................................................................7
Web Authoring Tool.....................................................................................................7Exercise Videos and Annotations........................................................................................................................7Exercise Plans...............................................................................................................................................................8
i
Abstract
This app is intended to help physical therapists and their patients. Patients will use the app to view instructional videos on how to correctly perform the rehabilitation exercises and to record themselves doing the exercises. This app will allow patients to either record themselves via the front-facing camera or have a caregiver record them through the rear-facing camera. Practitioners will be able to upload exercises and create training plans for patients via an online interface. Practitioners will be able to review the recorded exercises on the patient’s handheld device and provide feedback during appointments.
1
Introduction
Summary of App Functionality
This App allows physical therapy patients to view annotated instructional videos of physical therapy exercises provided by their physical therapy practitioner (doctor, physical therapist, etc.). Patients can then use the App to record themselves doing the exercises on the handheld device. The exercise will be logged and the video saved on the handheld device. App users (either the patient or the practitioner during an appointment) will be able to add custom annotations to both the instructional videos and the user-generated videos.
Target Audience
The target audience of the app is physical therapy patients and caregivers. Physical therapy practitioners will use the Web Authoring Tool to provide patients with the information they will need to do their therapy, such as exercises and “off the shelf” pre-made exercise plans.
Target Devices
This app is for smartphones and tablets. The device must be running Android 4.0 (Ice Cream Sandwich) or later. A camera will be required to use this app. A front facing camera is required for self-recorded videos. A tablet is strongly recommended for self-recorded videos, but they will work on smartphones. User recordings will be stored on external SD Card storage.
Benefits
The purpose of this app is to make therapy more convenient, accessible and effective. Patients sometimes lose paper handouts given to them by practitioners. They may be unaware how to properly do exercises, reducing the effectiveness of the therapy. Caregivers may not understand the exercise protocols. Practitioners are rarely able to give feedback on proper form except for during appointments. This project aspires to bring therapy instruction, exercise, and feedback from practitioners into a single convenient application, improving communication between practitioners and caregivers and
2
patients and compliance by patients. The will result in more satisfactory physical therapy outcomes and lower health care costs.
3
Android App
Opening the App
Find the icon for the app and touch it to start the application.
4
Screenshots
Home screen functions
The home screen shows a list of exercises already downloaded to the app from the external database. If the patient has selected an exercise plan in the preferences, then the plan items will be displayed on the home screen.
Submenu Bar
The submenu bar (accessed by touching the options button on the device) allows the user to navigate to the application settings and the info screen. This is generic throughout the app.
5
Touching the update button will download any videos that are not held in the app
Exercise List Screen
Touching any of the exercises on the list will allow the patient to access that exercise.
Settings screen functions
The settings screen allows users to setup the background information of the app such as their current exercise plan and whether or not they would like annotations in their videos.
Touching any of the fields in the list will grant the user the ability to modify the field
Exercise screen functions
Touching the “view exercise” button will begin the practitioner video uploaded for the exercise.
Touching the “log view” button will navigate the patient client to their saved video history.
Touching the “do exercise” button brings up the camera for the userclients to record themselves doing the exercises. After the recording the patient is pushed to the comparing video view.
App userThe client will be able to add customer user annotations to the exercise video. These will be stored in the internal database.
6
Log view screen functions
Touching an entry in the log will allow the user the opportunity to view or delete a record.
When viewing a log video the user may add an annotation for the current time in the video.
Comparing video view functions
The comparing video view shows the user their recent recording side-by-side with the video downloaded from their practitioner.
By touching the back button the patient can return to the exercise screen.
By touching the “save log” button the patient can save the video to their video log for later viewing.
Web Authoring Tool
A physical therapy practitioner will log into the system via the web interface.
Exercise Videos and Annotations
The practitioner will also be able to add various exercise videos to the system. This project assumes that the practitioner will be using their own professional quality video equipment to create videos and not a handheld device. There will be an upload tool on the website to upload the videos. The practitioner can add general comments to the videos as well as annotations at selected time marks using either the web tool or the app. The videos will be stored as files on the webserver. The website will store the location of the videos as well as any additional comments in the external database.
7
Exercise PlansThe practitioner will be able to go to another web page to create exercise plans. The exercise plan will consist of various exercises to be performed in a certain sequence. The practitioner will also be able to add instructions such as number of repetitions (e.g. do 10 repetitions) or time (e.g. hold position for 30 seconds) as well as additional notes. This will be stored in the external database.
8
Physical Therapy App
Technical Reference Manual
Team Members: James Burton & Everett Williams
Table of Contents
Introduction and Overall Technical Summary...............................................................1
Hardware Components Used........................................................................................2
Internal Database Schema............................................................................................3
External Database Schema...........................................................................................4
Web Authoring Tool.....................................................................................................5
Android App.................................................................................................................6
Acknowledgements......................................................................................................6
Appendix......................................................................................................................6
List of Deliverables.......................................................................................................7
Assignment of Deliverables..........................................................................................9
Schedule....................................................................................................................12
i
Introduction and Overall Technical Summary
The purpose of this project is to make physical therapy more convenient, accessible, and effective. Currently, the effectiveness of physical therapy is limited by deficiencies in practitioner/patient communication. Patients sometimes lose paper handouts given to them by practitioners. They may be unaware how to properly do exercises, reducing the effectiveness of the therapy. Caregivers may not understand the exercise protocols. Practitioners are rarely able to give feedback on proper form except for during appointments. This project aspires to bring therapy instruction, exercise, and feedback from practitioners into a single convenient application, improving communication between practitioners and caregivers and patients and compliance by patients.
This project consists of a web-based authoring tool for practitioners and an Android 4.x app for patients. Using the web-based authoring tool, practitioners will be able to:
Upload instructional videos that show how patients should do the therapeutic exercises.
Add general instructions for each video. Add time-specific annotations to each video. Create appropriate off-the-shelf exercise plans for patients. Information will be stored in a MySQL database and accessed via
PHP scripts on an Apache web server. Video files will be stored as flat files on the server.
Using the Android application, patients will be able to: Download practitioner-provided information from the server.
o Select an appropriate exercise plan from a listo Play instructional videos with and without practitioner
annotations.o View instructional documents.
Record themselves doing the exercise via front (self-recorded) or rear (caregiver-recorded) video camera.
o Add general notes and time specific annotations to the videos.
o Video recordings will be saved on the external storage card.
o Information and annotations will be stored in an SQLite database
Playback exercise video with and without annotations.
1
Hardware Components Used
The following hardware components are used Android tablet (recommended) or smartphone running Android
4.0 (Ice Cream Sandwich) or later. Internet access in order to access external database. Video and audio playback to play instructional videos. Rear-facing camera for caregiver recording. Front-facing camera for self-recorded videos. (optional) Orientation sensor. External storage card.
2
Internal Database Schema
exercise_log Table This table stores a log of each recorded exercise
Column Data-type P-Key
Not Null
Unique
Auto-incr
Description
id_exercise_log INT Yes Yes Yes Yes Id numberexercise_id INT Yes Yes Id of exercise performed (from
external db)exercise_log_video_location
VarChar(255) Yes Full path to video file on Android device.
exercise_log_video_notes
VarChar(255) User notes for video
create_time TIMESTAMP Timestamp (autogenerated)
exercise_log_annotation TableThis table stores each user annotation for the video. Annotations are stored against a specific time on the video.
Column Data-type P-Key
Not Null
Unique
Auto-incr
Description
id_exercise_log_annotation INT Yes Yes Yes Yes Id numberexercise_log_id_exercise_log INT Yes Yes Id of exercise log associated with
annotationexercise_log_annotation_video_ti TIME Yes Video time associated with
3
me annotationexercise_log_annotation_annotation
VarChar(255)
Yes The annotation
create_time TIMESTAMP Timestamp (autogenerated)
exercise, exercise_annotation, exercise_plan, exercise_plan_item Tables
These are cached versions of the external database tables described in the External Database Schema section. The internal and external tables are identical except that (1) primary keys are not autoincremented and (2) as otherwise noted.
External Database Schema
exercise Table This table stores information about a provider recorded exercise
video.Column Data-type P-
KeyNot Null
Unique
Auto-incr
Description
id_exercise INT Yes Yes Yes Yes Id numberexercise_name VarChar(45) Yes Yes Name of exerciseexercise_video_url VarChar(127) Yes URL of exercise video.exercise_instruction_url VarChar(127) URL of instructional page.
4
exercise_file_location VarChar(127) Yes Location of exercise video on server. (Note: In internal DB table, this is the location of the file on the handheld)
create_time TIMESTAMP Timestamp (autogenerated)update_time TIMESTAMP Timestamp (autogenerated)
exercise_annotation TableThis table stores each user annotation for the video. Annotations are stored against a specific time on the video.
Column Data-type P-Key
Not Null
Unique
Auto-incr
Description
id_exercise_annotation INT Yes Yes Yes Yes Id numberexercise_id_exercise INT Yes Yes Id of exercise associated with
annotationexercise_annotation_video_time TIME Yes Video time associated with
annotationexercise_annotation_annotation VarChar(25
5)Yes The annotation
create_time TIMESTAMP Timestamp (autogenerated)exercise_plan Table
This table lists all the off-the-shelf exercise plans availableColumn Data-type P-
KeyNot Null
Unique
Auto-incr
Description
id_exercise_plan INT Yes Yes Yes Yes Id numberexercise_plan_name VarChar(45) Yes Yes Name of exercise planexercise_plan_description
VarChar(255) Yes Short description of exercise plan.
exercise_plan TableThis table stores the individual elements in each exercise plan.
Column Data-type P-Key
Not Null
Unique
Auto-incr
Description
id_exercise_annotation INT Yes Yes Yes Yes Id numberexercise_id_exercises INT Yes Yes Id of exercise associated with itemexercise_plan_idexercise_plan INT Yes Id of exercise plan associated with
itemexercise_plan_item_sequence INT Yes Sequence of item in planexercise_plan_quantity INT Number repetitionsexercise_plan_item_description VarChar(25
5)Description of plan element
Web Authoring Tool
This section will be a technical walkthrough of the web authoring tool. Coming soon!
Android App
5
This section will contain a technical walkthrough of the Android App. Coming soon!
Acknowledgements
Database schema generated with MySQL Workbench 6.0.User interface mockup designed with FluidUI.
More to come...
Appendix
PHP Scripts
db_config.php - Basic configuration db_get_exercises.php - Get all exercise videos information. db_get_annotations_for_exercise.php - Get all annotations for a
given exercise db_get_exercise_plans.php - Get all exercise plans. db_get_exercise_plan_items.php - Get all exercise plan items for
a given exercise plan.
6
Deliverables
List of Deliverables External database scripts
o MySQL schemao PHP/web scripts
db_config.php - Basic configuration db_get_exercises.php - Get all exercise videos
information. db_get_annotations_for_exercise.php - Get all
annotations for a given exercise db_get_exercise_plans.php - Get all exercise plans. db_get_exercise_plan_items.php - Get all exercise
plan items for a given exercise plan. Web Authoring Tool for practitioners
o Main pageo Exercise video upload page.
Allow upload of video to server. Allow practitioner to enter general instructions.
o Exercise video annotation page. Playback exercise video. Allow practitioner to add annotations linked to
specific times.o Exercise plan list pageo Exercise plan edit page
Android Appo Screen Design, Layout, and Flowo Video recording functionalityo Video playback functionality
Playback with and without annotations Allow users to add annotations linked to specific
times on video.o Exercise log “sharing” featureo Database viewing/modification
External database access Internal database access Internal database scripts
SQLite schema Internal data storage structures Database/screen interfacing
o About pageo User Preferences
User manual Technical manual One minute video preview Sample data
o Sample datao Sample exercise videos
Assignment of Deliverables
External database scripts (James)o MySQL schema (James)o PHP/web scripts (Everett)
db_config.php - Basic configuration - (Everett) db_get_exercises.php - Get all exercise videos
information. (Everett) db_get_annotations_for_exercise.php - Get all
annotations for a given exercise. (Everett) db_get_exercise_plans.php - Get all exercise plans.
(Everett) db_get_exercise_plan_items.php - Get all exercise
plan items for a given exercise plan. (Everett) Web Authoring Tool for practitioners (Everett)
o Main page (Everett)o Exercise video upload page. (Everett)
Allow upload of video to server. (Everett) Allow practitioner to enter general instructions.
(Everett)o Exercise video annotation page. (Everett)
Playback exercise video. (Everett) Allow practitioner to add annotations linked to
specific times. (Everett)o Exercise plan list page (Everett)o Exercise plan edit page (Everett)
Allow practitioner to add exercises to plans. (Everett) Android App (James)
o Screen design and flow (Everett) XML screen layouts (Everett) Screen flow (move from screen to screen) (Everett)
o Video recording functionality (James) Allow caretaker to record video via rear camera.
(James) Allow user to record video of self via front camera.
(James) Store video on app specific external storage. Correctly record video regardless of handheld device
orientation. (James)o Video playback functionality (James)
Play practitioner videos with and without annotations. (James)
Play recorded user videos with and without annotations. (James)
Support multiple video file formats, including iPhone and Android video. (James)
Allow users to add annotations to user videos linked to specific times. (Everett)
o Database viewing/modification (James) Internal database scripts (James)
SQL Database creation scripts (James) SQLite database access (James)
External database access (Everett) Database login (Everett) JSON parser (James)
Internal data object storage (James) Classes to represent objects in database
(James) Implement appropriate CRUD (Create, Read,
Update, Delete) operations for data object classes. (James)
Database/screen interfacing (James) Create dynamically generated table views for
Exercise log, exercise plan, and annotation screens. (James)
Interface data to XML screens where appropriate (James)
o About view (James) Display simple HTML about view (James) Brief user guide (Snippet of larger user guide)
(Everett) Acknowledgements (James)
User manual (Everett) Technical manual (James) Sample data generation (James)
o Sample data generation (James)o Sample data generation SQL scripts (James)o Sample exercise videos (James)
One minute video preview (Everett)
Schedule
24 March: Database tables finalized. (James)
o MySQL schema completed (James)o SQLite schema completed (James)
Android screens designed w/basic flow (click between screens) and menus. (Everett)
User Manual (incr) (Everett), Technical Reference Manual (incr) (James)
31 March: External database access PHP scripts completed without
login/security. (Everett) Video recording feature completed (James) User Manual (incr) (Everett), Technical Reference Manual (incr) (James)
7 April: Web authoring tool complete, except annotation and security.
(Everett) Database viewing and modification features in App complete
(James) User Manual (incr) (Everett), Technical Reference Manual (incr) (James)
14 April Video annotation (Everett) Basic video playback (no annotations) completed (James) User Manual (incr) (Everett), Technical Reference Manual (incr) (James)
21 April Database security (login) and user preferences (Everett) Video playback with annotation (James) About view (James)
30 April: Sample data (James)
o Sample exercise videos (James) Android App bug fixes/polishing (James) Web Authoring Tool bug fixes/polishing (Everett) User Manual (final) (Everett) Technical Reference Manual (final) (James)
Demonstration Video (Everett)