VC1Transform¶
- class torchrl.envs.transforms.VC1Transform(in_keys, out_keys, model_name, del_keys: bool = True)[源文件]¶
VC1 转换类。
VC1 提供了预训练的 ResNet 权重,旨在促进机器人任务的视觉嵌入。这些模型使用 Ego4d 进行训练。
- 参阅论文
- VC1: 一种用于机器人操作的通用视觉表示 (Suraj Nair,
Aravind Rajeswaran, Vikash Kumar, Chelsea Finn, Abhinav Gupta) https://arxiv.org/abs/2203.12601
VC1Transform 以延迟方式创建:对象只有在查询其属性(spec 或 forward 方法)时才会初始化。这样做的原因是因为
_init()
方法需要访问父环境(如果存在)的某些属性:通过使类延迟初始化,我们可以确保以下代码片段按预期工作。示例
>>> transform = VC1Transform("default", in_keys=["pixels"]) >>> env.append_transform(transform) >>> # the forward method will first call _init which will look at env.observation_spec >>> env.reset()
- 参数:
in_keys (list of NestedKeys) – 输入键列表。如果留空,则假定为“pixels”键。
out_keys (list of NestedKeys, optional) – 输出键列表。如果留空,则假定为“VC1_vec”。
model_name (str) –
"large"
、"base"
或任何其他兼容的模型名称之一(更多信息请参阅 github 仓库)。默认为"default"
,它提供一个小型、未经训练的模型用于测试。del_keys (bool, optional) – 如果为
True
(默认),则输入键将从返回的 tensordict 中丢弃。
- forward(tensordict)¶
读取输入的 tensordict,并对选定的键应用转换。
- to(dest: Union[device, str, int, dtype])[源文件]¶
移动和/或转换参数和缓冲区。
可以按如下方式调用
- to(device=None, dtype=None, non_blocking=False)[源文件]
- to(dtype, non_blocking=False)[源文件]
- to(tensor, non_blocking=False)[源文件]
- to(memory_format=torch.channels_last)[源文件]
它的签名类似于
torch.Tensor.to()
,但只接受浮点数或复数dtype
。此外,此方法只会将浮点数或复数参数和缓冲区转换为dtype
(如果给定)。整数参数和缓冲区将被移动到device
(如果给定),但其 dtype 不会改变。当non_blocking
设置时,它会尝试尽可能与主机异步转换/移动,例如,将具有固定内存的 CPU 张量移动到 CUDA 设备。请参阅下面的示例。
注意
此方法会就地修改模块。
- 参数:
device (
torch.device
) – 此模块中参数和缓冲区所需的目标设备dtype (
torch.dtype
) – 此模块中参数和缓冲区所需的浮点数或复数 dtypetensor (torch.Tensor) – 张量,其 dtype 和 device 是此模块中所有参数和缓冲区所需的目标 dtype 和 device
memory_format (
torch.memory_format
) – 此模块中 4D 参数和缓冲区所需的内存格式(仅限关键字参数)
- 返回值:
self
- 返回类型:
Module
示例
>>> # xdoctest: +IGNORE_WANT("non-deterministic") >>> linear = nn.Linear(2, 2) >>> linear.weight Parameter containing: tensor([[ 0.1913, -0.3420], [-0.5113, -0.2325]]) >>> linear.to(torch.double) Linear(in_features=2, out_features=2, bias=True) >>> linear.weight Parameter containing: tensor([[ 0.1913, -0.3420], [-0.5113, -0.2325]], dtype=torch.float64) >>> # xdoctest: +REQUIRES(env:TORCH_DOCTEST_CUDA1) >>> gpu1 = torch.device("cuda:1") >>> linear.to(gpu1, dtype=torch.half, non_blocking=True) Linear(in_features=2, out_features=2, bias=True) >>> linear.weight Parameter containing: tensor([[ 0.1914, -0.3420], [-0.5112, -0.2324]], dtype=torch.float16, device='cuda:1') >>> cpu = torch.device("cpu") >>> linear.to(cpu) Linear(in_features=2, out_features=2, bias=True) >>> linear.weight Parameter containing: tensor([[ 0.1914, -0.3420], [-0.5112, -0.2324]], dtype=torch.float16) >>> linear = nn.Linear(2, 2, bias=None).to(torch.cdouble) >>> linear.weight Parameter containing: tensor([[ 0.3741+0.j, 0.2382+0.j], [ 0.5593+0.j, -0.4443+0.j]], dtype=torch.complex128) >>> linear(torch.ones(3, 2, dtype=torch.cdouble)) tensor([[0.6122+0.j, 0.1150+0.j], [0.6122+0.j, 0.1150+0.j], [0.6122+0.j, 0.1150+0.j]], dtype=torch.complex128)
- transform_observation_spec(observation_spec: TensorSpec) TensorSpec [源文件]¶
转换 observation spec,使结果 spec 与转换映射匹配。
- 参数:
observation_spec (TensorSpec) – 转换前的 spec
- 返回值:
转换后预期的 spec