Skip to content

Commit ad04a4c

Browse files
committed
Updated Readme
1 parent a6d9a60 commit ad04a4c

File tree

1 file changed

+32
-14
lines changed

1 file changed

+32
-14
lines changed

README.md

Lines changed: 32 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -37,11 +37,16 @@ Chords Python script is designed to interface with an Arduino-based bio-potentia
3737
```bash
3838
.\venv\Scripts\activate
3939
```
40-
3. Install the required Python libraries:
40+
3. Install the required Python libraries needed to run the python script:
4141
```bash
4242
pip install -r chords_requirements.txt
4343
```
4444

45+
4. Install the required Python libraries needed to run the applications:
46+
```bash
47+
pip install -r app_requirements.txt
48+
```
49+
4550
## Usage
4651

4752
To use the script, run it from the command line with various options:
@@ -57,6 +62,12 @@ To use the script, run it from the command line with various options:
5762
- `-v`, `--verbose`: Enable verbose output with detailed statistics and error reporting.
5863
- `-t` : Enable the timer to run program for a set time in seconds.
5964

65+
### Example:
66+
```bash
67+
python chords.py --lsl -v --csv -t 60
68+
```
69+
-This command executes the Python script `chords.py`, initiates the LSL stream, enables verbose output, activates CSV logging, and sets a timer for 60 seconds:
70+
6071
### Data Logging
6172

6273
- **CSV Output**: The script saves the processed data in a CSV file with a timestamped name.
@@ -82,7 +93,7 @@ pip install -r app_requirements.txt
8293

8394
- `python gui.py`: Enable the real-time data plotting GUI.
8495

85-
#### TUG OF WAR GAME
96+
#### EEG TUG OF WAR GAME
8697

8798
- `python game.py`: Enable a GUI to play tug of war game using EEG Signal.
8899

@@ -106,9 +117,13 @@ pip install -r app_requirements.txt
106117

107118
- `python keystroke.py`: On running, a pop-up opens for connecting, and on pressing Start, blinks are detected to simulate spacebar key presses.
108119

109-
## Running All Applications Together
120+
#### EEG BEETLE GAME
121+
122+
- `python beetle.py`: Enable a GUI for Beetle Game using EEG signal.
123+
124+
## Running All Applications Together in a Web-Interface
110125

111-
To run all applications together:
126+
To run all applications simultaneously, execute:
112127

113128
```bash
114129
python app.py
@@ -122,29 +137,32 @@ pip install -r app_requirements.txt
122137

123138
This will launch a Web interface. Use the interface to control the applications:
124139

125-
1. Click the `Start LSL Stream` button to initiate the LSL stream.
140+
1. Click the `Start LSL Stream` button to initiate the LSL stream or `Start NPG Stream` button to initiate the NPG stream.
126141
2. Then, click on any application button to run the desired module.
142+
Important: Keep the `python app.py` script running in the background while using any application.
127143

128144
### Available Applications
129-
- `ffteeg`: Real-time EEG analysis with FFT and brainwave power calculation.
130-
- `heartbeat_ecg`: Analyze ECG data and extract heartbeat metrics.
131-
- `eog`: Real-time EOG monitoring with blink detection.
132-
- `emgenvelope`: Real-time EMG monitor with filtering and RMS envelope.
133-
- `keystroke`: GUI for EOG-based blink detection triggering a keystroke.
134-
- `game`: Launch an EEG game for 2 players (Tug of War).
135-
- `csv_plotter`: Plot data from a CSV file.
136-
- `gui`: Launch the GUI for real time signal visualization.
145+
- `ECG with Heart Rate`: Analyze ECG data and extract heartbeat metrics.
146+
- `EMG with Envelope`: Real-time EMG monitor with filtering and RMS envelope.
147+
- `EOG with Blinks`: Real-time EOG monitoring with blink detection.
148+
- `EEG with FFT`: Real-time EEG analysis with FFT and brainwave power calculation.
149+
- `EEG Tug of War Game`: Launch an EEG game for 2 players (Tug of War).
150+
- `EEG Beetle Game`: Launch an EEG Beetle Game.
151+
- `GUI of Channels`: Launch the GUI for real time signal visualization.
152+
- `EOG Keystroke Emulator`: GUI for EOG-based blink detection triggering a keystroke.
153+
- `CSV Plotter`: Plot data from a CSV file.
137154

138155
## Troubleshooting
139156

140157
- **Arduino Not Detected:** Ensure the Arduino is properly connected and powered. Check the serial port and baud rate settings.
141158
- **CSV File Not Created:** Ensure you have write permissions in the directory where the script is run.
142-
- **LSL Stream Issues:** Verify that the `pylsl` library is installed and configured correctly.
159+
- **LSL Stream Issues:** Ensure that the `pylsl` library is properly installed and configured. Additionally, confirm that Bluetooth is turned off.
143160

144161
## Contributors
145162

146163
We are thankful to our awesome contributors, the list below is alphabetically sorted.
147164

148165
- [Payal Lakra](https://github.com/payallakra)
166+
- [Aman Maheshwari](https://github.com/Amanmahe)
149167

150168
The audio file used in `game.py` is sourced from [Pixabay](https://pixabay.com/sound-effects/brass-fanfare-with-timpani-and-windchimes-reverberated-146260/)

0 commit comments

Comments
 (0)