Interactive README and single host for Wrapper interactive

Author: marcomelloni

agents/matlab/matlab_agent/docs/examples/interactive-simulation/README.md

@@ -0,0 +1,46 @@
+# Interactive Simulation
+
+This example showcases a basic "Hello world" interactive simulation.
+
+The simulation relies on `SimulationWrapperInteractive.m` to manage TCP/IP communication with the MATLAB agent, allowing real-time data exchange between the simulation and the client.
+
+## Table of Contents
+
+- [Interactive Simulation](#interactive-simulation)
+  - [Table of Contents](#table-of-contents)
+  - [Usage](#usage)
+
+## Usage
+
+Before running the simulation, you need to configure the Matlab agent by setting the simulation folder path in the `config.yaml` file under the simulation section:
+
+```yaml
+simulation:
+  path: <path_to_simulation_folder>
+```
+
+This path should point to the directory `interactive-simulation` containing the simulation files
+
+Once configured, you can initiate the simulation using the API as described below.
+
+The simulation can be initiated via the API by submitting a YAML payload, a template of which is available in the file `api/simulation.yaml`
+
+```yaml
+simulation:
+  request_id: abcdef12345 # Unique identifier for this simulation request
+  client_id: dt # Client identifier for tracking purposes
+  simulator: matlab # Specifies MATLAB as the simulation engine
+  type: interactive # Indicates this is an interactive simulation type
+  file: InteractiveSimulation.m # Main MATLAB file to execute
+  inputs:
+    stream_source: "rabbitmq://streaming.inputs.sim123" # RabbitMQ stream for input data
+  outputs:
+    predicted:
+      x_next: float # Next predicted X coordinate value
+      y_next: float # Next predicted Y coordinate value
+    misc:
+      distance_from_origin: float # Calculated distance from origin point
+      timestamp: float # Simulation timestamp in epoch seconds
+```
+
+Use the client `use_matlab_agent_interactive.py` to start the client.

agents/matlab/matlab_agent/resources/README.md

@@ -78,7 +78,7 @@ In the directory
 you will find several folders containing practical examples. Each example folder includes a `README.md` with detailed instructions:
 
 - [Streaming Simulation](../docs/examples/streaming-simulation/README.md)
-- [Interactive Simulation](../docs/examples/interactive-simulation/InteractiveSimulation.m)
+- [Interactive Simulation](../docs/examples/interactive-simulation/README.md)
 - [Batch Simulation](../docs/examples/batch-simulation/README.md)
 - [Industrial Cooling Fan Anomaly Detection](../docs/examples/industrial-cooling-fan-anomaly-detection/README.md)
 

agents/matlab/matlab_agent/resources/SimulationWrapperInteractive.m

@@ -10,9 +10,8 @@
         % Constructor for the SimulationWrapperInteractive class
         function obj = SimulationWrapperInteractive()
             % Default host and ports (modifiable)
-            out_host = 'localhost';
+            host = 'localhost';
             out_port = 5678;
-            in_host = 'localhost';
             in_port = 5679;
             % Max retries for connecting to the server
             max_retries = 5;
@@ -22,8 +21,8 @@
             for retry = 1:max_retries
                 try
                     % Create a TCP client object to connect to Python server
-                    obj.out_client = tcpclient(out_host, out_port);
-                    obj.in_client = tcpclient(in_host, in_port);
+                    obj.out_client = tcpclient(host, out_port);
+                    obj.in_client = tcpclient(host, in_port);
                     configureTerminator(obj.out_client, "LF");
                     configureTerminator(obj.in_client, "LF");
                     break; % Exit the loop if the connection is successful