Skip to content

Commit 889c5fa

Browse files
Add UI destop application
update requirement and new doc link in UI
1 parent 888260e commit 889c5fa

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

54 files changed

+1020
-3
lines changed

.gitignore

+2
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
**/venv/
2+
*.pyc

README.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ Follow the [manufacturing manual](./docs/manufacturing-manual.md)
5555

5656
**:three: Flash the Arduino Board**
5757

58-
Follow the [arduino programming manual](./docs/firmware-programming-manual.md)
58+
Follow the [firmware programming manual](./docs/firmware-programming-manual.md)
5959

6060
**:four: Install the Desktop GUI**
6161

@@ -68,4 +68,4 @@ Your contribution to the MyoCoach project is welcome!
6868
* Have you discovered a bug or you have an improvement ideas ?
6969
* Go to the GitHub [issues](https://github.com/orthopus/0113-myocoach-diy/issues) of the project.
7070
* You have time, some Maker skills and you want to help us ?
71-
* Read the [CONTRIBUTING](CONTRIBUTING.md) file to help us to go to the **Myo Coach** v2.0
71+
* Read the [CONTRIBUTING](CONTRIBUTING.md) file to help us to go to the **Myo Coach v2.0**

docs/ui-programming-manual.md

+42
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# 0113-MyoCoach-DIY :<br>UI Programming Manual
2+
3+
This desktop application allows the visualization of raw EMG signals and allows users to train by observing the raw signals or through a game which is a clone inspired by [FlapPyBird](https://github.com/sourabhv/FlapPyBird) with a different game system.
4+
5+
The MyoCoach application is based on python3 with PyQt5.
6+
7+
## Installation
8+
9+
Tested under MacOS and Linux.
10+
11+
**:one: Installing the dependencies**
12+
13+
Install the following packages :
14+
* [Python](https://www.python.org/downloads) (3.6.x or higher) ;
15+
* [pip](https://techworm.net/programming/install-pip-python-mac-windows-linux/) (20.0.x or later);
16+
17+
Install `virtualenv` :
18+
```
19+
pip install virtualenv
20+
```
21+
22+
**:two: Installing the main program**
23+
24+
Open a terminal, go to the `src/software/ui` folder and launch the installation :
25+
26+
```
27+
$ cd src/software/ui/
28+
make install
29+
```
30+
31+
This command creates a _virtualenv_ and installs the necessary dependencies for the application. These dependencies are listed in the [src/software/ui/requirements.txt](../src/software/ui/requirements.txt) file.
32+
33+
**:three: Launch the application**
34+
35+
```
36+
$ make play
37+
```
38+
39+
## ScreenShot
40+
41+
![Signal Widget](assets/screenShot_signal.png)
42+
![FlappyBird Widget](assets/screenShot_flappybird.png)

docs/user-manual.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -106,7 +106,7 @@ This test protocol allows the placement of two electrodes which are useful for t
106106

107107
![muscle_flechisseur_et_extenseur](./assets/muscle_flechisseur_et_extenseur.png)
108108

109-
* :one: Equip an electrode with a pin header strip to make an adapter with the MyoCoach connector system (see the electrode connector section in the [manufacturing-manual](manufacturing-manual)).
109+
* :one: Equip an electrode with a pin header strip to make an adapter with the MyoCoach connector system (see the electrode connector section in the [manufacturing-manual](./manufacturing-manual.md)).
110110

111111
![adpatateur_electrode](./assets/adpatateur_electrode.png)
112112

@@ -191,4 +191,5 @@ The game play has been modified to better correspond to the use of EMG sensors b
191191
* Use the computer **keyboard Space** ⌨️ to start or restart the game.
192192

193193
![record_bionico](./assets/record_bionico.png)
194+
194195
Record by Bionico :boom:

src/software/ui/Credit.txt

+1
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
Icon made by strip from www.flaticon.com

src/software/ui/Makefile

+8
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
.PHONY: install
2+
install:
3+
python3 -m virtualenv -p python3 venv
4+
venv/bin/pip install -r requirements.txt
5+
6+
.PHONY: play
7+
play:
8+
venv/bin/python3 myocoach.py

0 commit comments

Comments
 (0)