MultiAgentNetBase

class torchrl.modules.MultiAgentNetBase(*, n_agents: int, centralized: bool | None = None, share_params: bool | None = None, agent_dim: int | None = None, vmap_randomness: str = 'different', **kwargs)

多智能体网络的基本类。

注意

要使用 torch.nn.init 模块初始化 MARL 模块参数，请参阅 get_stateful_net() 和 from_stateful_net() 方法。

forward(*inputs: Tuple[Tensor]) → Tensor

定义每次调用时执行的计算。

应由所有子类覆盖。

注意

虽然前向传递的步骤需要在此函数中定义，但应随后调用 Module 实例，而不是此函数，因为前者会处理已注册的钩子，而后者会静默地忽略它们。

from_stateful_net(stateful_net: Module)

给定网络的状态版本填充参数。

有关如何收集网络的状态版本的详细信息，请参阅 get_stateful_net()。

参数:

stateful_net (nn.Module) – 应从中收集参数的状态网络。

get_stateful_net(copy: bool = True)

返回网络的状态版本。

这可用于初始化参数。

此类网络通常无法开箱即用，需要 vmap 调用才能执行。

参数:

copy (bool, 可选) – 如果为 True，则会创建网络的深拷贝。默认为 True。

如果参数就地修改（推荐），则无需将参数复制回 MARL 模块。有关如何使用已就地重新初始化的参数重新填充 MARL 模型的详细信息，请参阅 from_stateful_net()。

示例

>>> from torchrl.modules import MultiAgentMLP
>>> import torch
>>> n_agents = 6
>>> n_agent_inputs=3
>>> n_agent_outputs=2
>>> batch = 64
>>> obs = torch.zeros(batch, n_agents, n_agent_inputs)
>>> mlp = MultiAgentMLP(
...     n_agent_inputs=n_agent_inputs,
...     n_agent_outputs=n_agent_outputs,
...     n_agents=n_agents,
...     centralized=False,
...     share_params=False,
...     depth=2,
... )
>>> snet = mlp.get_stateful_net()
>>> def init(module):
...     if hasattr(module, "weight"):
...         torch.nn.init.kaiming_normal_(module.weight)
>>> snet.apply(init)
>>> # If the module has been updated out-of-place (not the case here) we can reset the params
>>> mlp.from_stateful_net(snet)

reset_parameters()

重置模型的参数。