You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+28-14Lines changed: 28 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,19 +1,21 @@
1
-
# MDBI Logger Node
1
+
# Autonomy Metrics Logger Node
2
2
3
-
MDBI Logger is a ROS2 node designed to log robot events and calculate the Mean Distance Between Incidents (MDBI). The node subscribes to various topics to gather data such as GPS coordinates, battery status, and emergency stop status, and logs these events to a database.
3
+
The Autonomy Metrics Logger is a ROS2 node that tracks various robot events and computes the **Mean Distance Between Incidents (MDBI)**. This node monitors topics such as GPS, odometry, battery status, and emergency stop status to log incidents and key metrics into a MongoDB database.
4
4
5
5
## Features
6
6
7
-
-**Calculate MDBI**: Computes the mean distance between incidents based on the robot's GPS data.
8
-
-**Event Logging**: Logs significant events such as emergency stops and operation mode changes.
9
-
-**Database Integration**: Stores event logs and distance metrics in a database.
10
-
7
+
-**MDBI Calculation**: Computes the Mean Distance Between Incidents based on traveled distance and logged incidents.
8
+
-**Autonomous Mode Tracking**: Records the time spent and distance covered in autonomous mode.
9
+
-**Event Logging**: Logs critical events like emergency stops, manual overrides, and coordinator tasks.
10
+
-**Database Integration**: Uses MongoDB to store event logs, distances, and operational details of the robot.
11
+
-**Heartbeat Signal**: Publishes a heartbeat message every 5 seconds to indicate the node is alive.
12
+
-**Git Repositories Logging**: Captures and stores Git information of the active repositories for traceability.
11
13
12
14
## Usage
13
15
14
16
1.**Set Environment Variables:**
15
17
16
-
Set the following environment variables to configure your robot's session:
18
+
Configure the robot session by setting the following environment variables:
17
19
18
20
```sh
19
21
export ROBOT_NAME=<your-robot-name>
@@ -31,22 +33,34 @@ MDBI Logger is a ROS2 node designed to log robot events and calculate the Mean D
31
33
32
34
## Parameters
33
35
34
-
The node uses the following parameters, which can be overridden:
36
+
The node uses the following ROS parameters, which can be customized:
35
37
38
+
- `mongodb_host` (default: `localhost`): MongoDB server host.
39
+
- `mongodb_port` (default: `27017`): MongoDB server port.
40
+
- `aoc_scenario_path` (default: `""`): Path to the AOC scenario repository.
41
+
- `aoc_navigation_path` (default: `""`): Path to the AOC navigation repository.
42
+
- `min_distance_threshold` (default: `0.2`): Minimum distance threshold for recording traveled distance (in meters).
0 commit comments