Files
RoboGauge/robogauge/tasks/gauge/metrics/dof_metrics.py
2026-01-10 02:11:44 +08:00

94 lines
3.4 KiB
Python

# -*- coding: utf-8 -*-
'''
@File : dof_metrics.py
@Time : 2025/12/18 20:18:24
@Author : wty-yy
@Version : 1.0
@Blog : https://wty-yy.github.io/
@Desc : DOF Limits Metric Implementation
'''
import numpy as np
from robogauge.tasks.robots import RobotConfig
from robogauge.tasks.gauge.metrics.base_metric import BaseMetric, GoalData, SimData
from robogauge.utils.logger import logger
class DofLimitsMetric(BaseMetric):
""" Metric to log DOF limit violations. """
name = 'dof_limits_metric'
def __init__(self,
robot_cfg: RobotConfig,
soft_dof_limit_ratio: float = 0.9,
dof_names: list = None,
**kwargs
):
super().__init__(robot_cfg)
self.soft_dof_limit_ratio = soft_dof_limit_ratio
self.calc_dof_names = dof_names
def __call__(self, sim_data: SimData, goal_data: GoalData) -> float:
values = []
for i in range(len(sim_data.proprio.joint.limits)):
lower_limit = sim_data.proprio.joint.limits[i, 0]
upper_limit = sim_data.proprio.joint.limits[i, 1]
dof_range = upper_limit - lower_limit
if dof_range <= 1e-6:
logger.warning(f"DOF range for {sim_data.proprio.joint.names[i]} is too small ({dof_range:.6f}), skipping metric calculation.")
continue
soft_lower_limit = lower_limit + (1 - self.soft_dof_limit_ratio) * dof_range / 2
soft_upper_limit = upper_limit - (1 - self.soft_dof_limit_ratio) * dof_range / 2
pos = sim_data.proprio.joint.pos[i]
dof_name = sim_data.proprio.joint.names[i]
value = 0
if pos < soft_lower_limit:
value = soft_lower_limit - pos
elif pos > soft_upper_limit:
value = pos - soft_upper_limit
value /= dof_range # Normalize by DOF range
logger.log(value, f'dof_limits/{dof_name}', step=sim_data.n_step)
if self.calc_dof_names is not None:
for use_name in self.calc_dof_names:
if use_name in dof_name:
values.append(value)
else:
values.append(value)
if len(values) == 0:
logger.warning("No DOF limit values calculated, returning 0.0.")
return 0.0
rms_value = 1 - np.sqrt(np.mean(np.square(values)))
logger.log(1 - rms_value, f'dof_limits/rms', step=sim_data.n_step)
return rms_value
class DofPowerMetric(BaseMetric):
""" Metric to log DOF power efficiency. """
name = 'dof_power_metric'
def __init__(self,
robot_cfg: RobotConfig,
scaling_factor: float = 100.0,
**kwargs
):
super().__init__(robot_cfg)
self.scaling_factor = scaling_factor
def __call__(self, sim_data: SimData, goal_data: GoalData) -> float:
values = []
for i in range(len(sim_data.proprio.joint.torque)):
torque = sim_data.proprio.joint.torque[i]
velocity = sim_data.proprio.joint.vel[i]
power = abs(torque * velocity)
values.append(power)
dof_name = sim_data.proprio.joint.names[i]
logger.log(power, f'dof_power/{dof_name}', step=sim_data.n_step)
rms_power = np.sqrt(np.mean(np.square(values)))
metric_power = 1 - rms_power / self.scaling_factor
logger.log(rms_power, f'dof_power/rms', step=sim_data.n_step)
return metric_power