springbeann / softwareengineering24

Cardio Data Simulator

The Cardio Data Simulator is a Java-based application designed to simulate real-time cardiovascular data for multiple patients. This tool is particularly useful for educational purposes, enabling students to interact with real-time data streams of ECG, blood pressure, blood saturation, and other cardiovascular signals.

Features

• Simulate real-time ECG, blood pressure, blood saturation, and blood levels data.
• Supports multiple output strategies:
  • Console output for direct observation.
  • File output for data persistence.
  • WebSocket and TCP output for networked data streaming.
• Configurable patient count and data generation rate.
• Randomized patient ID assignment for simulated data diversity.

Getting Started

Prerequisites

• Java JDK 11 or newer.
• Maven for managing dependencies and compiling the application.

Installation

1. Clone the repository:

   git clone https://github.com/tpepels/signal_project.git

2. Navigate to the project directory:

   cd signal_project

3. Compile and package the application using Maven:

   mvn clean package

   This step compiles the source code and packages the application into an executable JAR file located in the target/ directory.

Running the Simulator

After packaging, you can run the simulator directly from the executable JAR:

java -jar target/cardio_generator-1.0-SNAPSHOT.jar

To run with specific options (e.g., to set the patient count and choose an output strategy):

java -jar target/cardio_generator-1.0-SNAPSHOT.jar --patient-count 100 --output file:./output

Supported Output Options

• console: Directly prints the simulated data to the console.
• file:<directory>: Saves the simulated data to files within the specified directory.
• websocket:<port>: Streams the simulated data to WebSocket clients connected to the specified port.
• tcp:<port>: Streams the simulated data to TCP clients connected to the specified port.

License

This project is licensed under the MIT License - see the LICENSE file for details.