Skip to content

Commit 8af1aae

Browse files
authored
Update README.md
1 parent 828a679 commit 8af1aae

File tree

1 file changed

+28
-14
lines changed

1 file changed

+28
-14
lines changed

README.md

Lines changed: 28 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,21 @@
1-
# MDBI Logger Node
1+
# Autonomy Metrics Logger Node
22

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.
44

55
## Features
66

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.
1113

1214
## Usage
1315

1416
1. **Set Environment Variables:**
1517

16-
Set the following environment variables to configure your robot's session:
18+
Configure the robot session by setting the following environment variables:
1719

1820
```sh
1921
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
3133

3234
## Parameters
3335

34-
The node uses the following parameters, which can be overridden:
36+
The node uses the following ROS parameters, which can be customized:
3537

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).
3643
- `gps_topic` (default: `/gps_base/fix`)
3744
- `gps_odom_topic` (default: `/gps_base/odometry`)
38-
- `battery_status` (default: `/battery_status`)
39-
- `estop_status` (default: `/estop_status`)
45+
- `battery_status_topic` (default: `/diff_drive_controller/battery_status`)
46+
- `estop_status_topic` (default: `/diff_drive_controller/estop_status`)
47+
- `hunter_status_topic` (default: `/hunter_status`)
48+
- `actioned_by_coordinator_topic` (default: `/topological_navigation/execute_policy_mode/goal`)
4049

4150
## Node Details
4251

4352
### Subscriptions
4453

45-
- **GPS Data** (`/gps_base/fix`): Receives GPS data of the robot.
46-
- **Odometry Data** (`/gps_base/odometry`): Receives odometry data for distance calculation.
47-
- **Battery Status** (`/battery_status`): Monitors the battery level.
48-
- **Emergency Stop Status** (`/estop_status`): Monitors the emergency stop status.
54+
- **GPS Data** (`/gps_base/fix`): Receives and logs GPS data of the robot.
55+
- **Odometry Data** (`/gps_base/odometry`): Monitors odometry data to calculate traveled distance.
56+
- **Battery Status** (`/diff_drive_controller/battery_status`): Logs battery level information.
57+
- **Emergency Stop Status** (`/diff_drive_controller/estop_status`): Monitors and logs emergency stop events.
58+
- **Hunter Status** (`/hunter_status`): Tracks the robot's current status, including operation mode and battery voltage.
59+
- **Coordinator Task** (`/topological_navigation/execute_policy_mode/goal`): Logs tasks received from the coordinator.
60+
61+
### Publications
4962
63+
- **Heartbeat** (`mdbi_logger/heartbeat`): Publishes a signal every 5 seconds to indicate node activity.
5064
5165
## License
5266

0 commit comments

Comments
 (0)