Merge pull request #14 from PayalLakra/bio_amptool

Adding notebooks,gui,game,ecg and update chords file

Author: lorforlinux

Notebooks/ECG.ipynb

@@ -115915,7 +115915,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3 (ipykernel)",
+   "display_name": "venv",
    "language": "python",
    "name": "python3"
   },
@@ -115929,7 +115929,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.7"
+   "version": "3.10.10"
   }
  },
  "nbformat": 4,

README.md

@@ -28,93 +28,115 @@ Chords Python script is designed to interface with an Arduino-based bioamplifier
 ## Installation
 
 1. Ensure you have Python 3.x installed.
-2. Install the required Python libraries:
+2. Create Virtual Environment
+   ```bash
+   python -m venv venv      #Create Virtual Environment
+   .\venv\Scripts\activate  #to activate environment 
+   ```
+3. Install the required Python libraries:
     ```bash
     pip install -r requirements.txt
     ```
 
 ## Usage
 
 To use the script, run it from the command line with various options:
-
-First Create Virtual Environment
-
-  ```bash
-   python -m venv venv      #Create Virtual Environment
-   .\venv\Scripts\activate  #to activate environment 
-  ```
-Then,
-
   ```bash
-  python bioamp_tool.py [options]
+  python chords.py [options]
   ```
-
 ### Options
 
 - `-p`, `--port` <port>: Specify the serial port to use (e.g., COM5, /dev/ttyUSB0).
-- `-b`, `--baudrate` <baudrate>: Set the baud rate for serial communication (default is 115200).
+- `-b`, `--baudrate` <baudrate>: Set the baud rate for serial communication (default is 230400).
 - `--csv`: Enable CSV logging. Data will be saved to a timestamped file.
 - `--lsl`: Enable LSL streaming. Sends data to an LSL outlet.
 - `-v`, `--verbose`: Enable verbose output with detailed statistics and error reporting.
-- `--gui`: Enable the real-time data plotting GUI.
 - `-t` : Enable the timer to run program for a set time in seconds.
 
-## Script Functions
+### Data Logging
 
- `auto_detect_arduino(baudrate, timeout=1)`
+- **CSV Output**: The script saves the processed data in a CSV file with a timestamped name.
+  - The CSV file contains the following columns:
+    - `Counter`: The sample counter from the Arduino.
+    - `Channel1` to `Channel6`: The data values from each channel.
 
-Detects an Arduino connected via serial port. Returns the port name if detected.
+- **Log Intervals**: The script logs data counts every second and provides a summary every 10 minutes, including the sampling rate and drift in seconds per hour.
 
-`read_arduino_data(ser, csv_writer=None)`
+### LSL Streaming
 
-Reads and processes data from the Arduino. Writes data to CSV and/or LSL stream if enabled.
+- **Stream Name**: `BioAmpDataStream`
+- **Stream Type**: `EXG`
+- **Channel Count**: `6`
+- **Sampling Rate**: `UNO-R3 : 250 Hz` , `UNO-R4 : 500 Hz`
+- **Data Format**: `float32`
 
- `start_timer()`
 
-Initializes timers for 1-second and 10-minute intervals.
+### Script Functions
 
- `log_one_second_data(verbose=False)`
+`auto_detect_arduino(baudrate, timeout=1)`: Detects an Arduino connected via serial port. Returns the port name if detected.
 
-Logs and resets data for the 1-second interval.
+`read_arduino_data(ser, csv_writer=None)`: Reads and processes data from the Arduino. Writes data to CSV and/or LSL stream if enabled.
 
- `log_ten_minute_data(verbose=False)`
+`start_timer()`: Initializes timers for 1-second and 10-minute intervals.
 
-Logs data and statistics for the 10-minute interval.
+`log_one_second_data(verbose=False)`: Logs and resets data for the 1-second interval.
 
- `parse_data(port, baudrate, lsl_flag=False, csv_flag=False, gui_flag=False, verbose=False)`
+`log_ten_minute_data(verbose=False)`: Logs data and statistics for the 10-minute interval.
 
-Parses data from Arduino and manages logging, streaming, and GUI updates.
+`parse_data(port,baudrate,lsl_flag=False,csv_flag=False,verbose=False)`: Parses data from Arduino and manages logging, streaming, and GUI updates.
 
- `init_gui()`
+`cleanup()`: Handles all the cleanup tasks.
 
-Initializes and displays the GUI with six real-time plots, one for each bio-signal channel.
+`main()`: Handles command-line argument parsing and initiates data processing.
 
-`cleanup()`
+## Applications
 
-Handles all the cleanup tasks.
+> [!IMPORTANT]
+ Before using the below Applications make sure you are in Application folder.
 
- `main()`
+### GUI
 
-Handles command-line argument parsing and initiates data processing.
+- `python gui.py`: Enable the real-time data plotting GUI.
 
-## Data Logging
+#### Script Functions
 
-- **CSV Output**: The script saves the processed data in a CSV file with a timestamped name.
-  - The CSV file contains the following columns:
-    - `Counter`: The sample counter from the Arduino.
-    - `Channel1` to `Channel6`: The data values from each channel.
+`init_gui()`: Initializes and displays the GUI with six real-time plots, one for each bio-signal channel.
 
-- **Log Intervals**: The script logs data counts every second and provides a summary every 10 minutes, including the sampling rate and drift in seconds per hour.
+`update_plots()`: Updates the plot data by pulling new samples from the LSL stream and shifting the existing buffer.
 
-## LSL Streaming
+### FORCE BALL GAME
 
-- **Stream Name**: `BioAmpDataStream`
-- **Stream Type**: `EXG`
-- **Channel Count**: `6`
-- **Sampling Rate**: `UNO-R3 : 250 Hz` , `UNO-R4 : 500 Hz`
-- **Data Format**: `float32`
+- `python game.py`: Enable a GUI to play game using EEG Signal.
+
+#### Script Functions
+
+`bandpower(data, sf, band, window_sec=None, relative=False)`: Calculates the band power of EEG data in a specified frequency band using the Welch method.
+
+`eeg_data_thread(eeg_queue)`: Continuously retrieves EEG data from an LSL stream and computes power ratios for Player A and Player B.
+
+`reset_game()`: Resets the game state and initializes the ball and player forces.
 
-If GUI is not enabled, you can use an LSL viewer (e.g., BrainVision LSL Viewer) to visualize the streamed data in real-time.
+`update_ball_position(force_player1, force_player2)`: Updates the ball's position based on the net force exerted by both players.
+
+`check_win_condition()`: Determines if either player has won based on the ball's position.
+
+### Heart Rate
+
+- `python heartbeat.ecg.py`:Enable a GUI with real-time ECG and heart rate
+
+#### Script Functions
+
+`butter_filter(cutoff, fs, order=4, btype='low')`: Designs a Butterworth filter to remove unwanted frequencies from the ECG signal.
+
+`apply_filter(data, b, a)`: Applies the designed Butterworth filter to the ECG data for noise reduction.
+
+`detect_heartbeats(ecg_data, sampling_rate)`: Detects heartbeats in the ECG signal using peak detection.
+
+`run(self)`: Collects ECG data from the LSL stream, applies filtering, and emits the filtered data for real-time plotting.
+
+`update_plot(self, ecg_data)`: Updates the plot with the latest ECG data and detects heartbeats to display on the GUI.
+
+`update_heart_rate(self)`: Calculates and updates the heart rate based on detected R-peaks in the ECG signal.
 
 ## Troubleshooting
 
@@ -126,4 +148,6 @@ If GUI is not enabled, you can use an LSL viewer (e.g., BrainVision LSL Viewer)
 
 We are thankful to our awesome contributors, the list below is alphabetically sorted.
 
-- [Payal Lakra](https://github.com/payallakra)
+- [Payal Lakra](https://github.com/payallakra)
+
+The audio file used in `game.py` is sourced from [Pixabay](https://pixabay.com/sound-effects/brass-fanfare-with-timpani-and-windchimes-reverberated-146260/)