v0.1.4

robogauge/tasks/gauge/goals/__init__.py

@@ -0,0 +1,2 @@
+from robogauge.tasks.gauge.goals.base_goal import BaseGoal
+from robogauge.tasks.gauge.goals.velocity_goals import MaxVelocityGoal

robogauge/tasks/gauge/goals/base_goal.py

@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*-
+'''
+@File    : base_goals.py
+@Time    : 2025/11/30 21:52:59
+@Author  : wty-yy
+@Version : 1.0
+@Blog    : https://wty-yy.github.io/
+@Desc    : Base Goal Class
+'''
+
+from robogauge.tasks.simulator.sim_data import SimData
+from robogauge.tasks.gauge.goal_data import GoalData
+
+class BaseGoal:
+    count = 0
+    total = 0
+
+    def is_done(self) -> bool:
+        raise NotImplementedError
+
+    def is_reset(self, sim_data: SimData) -> bool:
+        raise NotImplementedError
+
+    def get_goal(self, sim_data: SimData) -> GoalData:
+        raise NotImplementedError

robogauge/tasks/gauge/goals/velocity_goals.py

@@ -0,0 +1,57 @@
+# -*- coding: utf-8 -*-
+'''
+@File    : velocity_goals.py
+@Time    : 2025/11/30 21:44:13
+@Author  : wty-yy
+@Version : 1.0
+@Blog    : https://wty-yy.github.io/
+@Desc    : Velocity Goals Implementation
+'''
+from typing import Optional
+
+from robogauge.tasks.gauge.goals import BaseGoal
+from robogauge.tasks.robots import RobotConfig
+from robogauge.tasks.simulator.sim_data import SimData
+from robogauge.tasks.gauge.goal_data import GoalData, VelocityGoal
+from robogauge.utils.helpers import class_to_dict
+from robogauge.utils.logger import logger
+
+class MaxVelocityGoal(BaseGoal):
+    """ Goal class for maximizing velocity commands. """
+    def __init__(self, max_velocity: RobotConfig.commands, cmd_duration: float = 5, **kwargs):
+        kwargs.pop('enabled', None)
+        if kwargs:
+            logger.warning(f"Unused kwargs in MaxVelocityGoal: {kwargs}")
+
+        self.max_velocity = class_to_dict(max_velocity)
+        self.cmd_duration = cmd_duration
+        self.last_reset_time = 0.0
+
+        self.goals = []
+        for key, min_max in self.max_velocity.items():
+            if min_max is None: continue
+            for value in min_max:
+                if value != 0:
+                    self.goals.append(VelocityGoal(**{key: value}))
+        
+        self.count = 0
+        self.total = len(self.goals)
+
+    def is_reset(self, sim_data: SimData) -> bool:
+        if sim_data.sim_time - self.last_reset_time >= self.cmd_duration:
+            self.last_reset_time = sim_data.sim_time
+            return True
+        return False
+
+    def get_goal(self, sim_data: SimData) -> Optional[GoalData]:
+        self.count = int(sim_data.sim_time / self.cmd_duration)
+        if self.count >= self.total:
+            return None
+        self.current_goal = self.goals[self.count]
+        return GoalData(
+            goal_type='velocity',
+            velocity_goal=self.current_goal
+        )
+    
+    def __repr__(self):
+        return f"{self.current_goal}"