ValueEstimatorBase¶
- class torchrl.objectives.value.ValueEstimatorBase(*args, **kwargs)[源代码]¶
值函数模块的抽象父类。
其
ValueFunctionBase.forward()
方法将计算值(由值网络给出)和值估计(由值估计器给出)以及优势,并将这些值写入输出 tensordict。如果只需要值估计,则应改用
ValueFunctionBase.value_estimate()
。- default_keys¶
别名:
_AcceptedKeys
- abstract forward(tensordict: TensorDictBase, *, params: TensorDictBase | None = None, target_params: TensorDictBase | None = None) TensorDictBase [源代码]¶
根据 tensordict 中的数据计算优势估计。
如果提供了函数式模块,则可以将包含参数(以及相关的目标参数)的嵌套 TensorDict 传递给模块。
- 参数:
tensordict (TensorDictBase) – 包含数据(观察键、
"action"
、("next", "reward")
、("next", "done")
、("next", "terminated")
和环境返回的"next"
tensordict 状态)的 TensorDict,用于计算值估计和 TD 估计。传递给此模块的数据应结构化为[*B, T, *F]
,其中B
是批次大小,T
是时间维度,F
是特征维度。tensordict 的形状必须为[*B, T]
。- 关键字参数:
params (TensorDictBase, optional) – 包含要传递给函数式值网络模块的参数的嵌套 TensorDict。
target_params (TensorDictBase, optional) – 包含要传递给函数式值网络模块的目标参数的嵌套 TensorDict。
device (torch.device, optional) – 将实例化缓冲区的位置。默认为
torch.get_default_device()
。
- 返回:
一个更新的 TensorDict,其中包含构造函数中定义的 advantage 和 value_error 键。
- value_estimate(tensordict, target_params: TensorDictBase | None = None, next_value: torch.Tensor | None = None, **kwargs)[源代码]¶
获取值估计,通常用作值网络的 target 值。
如果状态值键存在于
tensordict.get(("next", self.tensor_keys.value))
下,则将使用此值,而无需递归调用值网络。- 参数:
tensordict (TensorDictBase) – 包含要读取的数据的 tensordict。
target_params (TensorDictBase, optional) – 包含要传递给函数式值网络模块的目标参数的嵌套 TensorDict。
next_value (torch.Tensor, optional) – 下一个状态或状态-动作对的值。与
target_params
互斥。**kwargs – 要传递给值网络的关键字参数。
返回:一个对应于状态值的张量。