MultiThreadedEnv

torchrl.envs.MultiThreadedEnv(*args, **kwargs)

基于 EnvPool 的环境多线程执行。

GitHub: https://github.com/sail-sg/envpool

Paper: https://arxiv.org/abs/2206.10558

基于多线程的 ParallelEnv 的替代方案。它速度更快，因为它不需要生成新进程，但灵活性较差，因为它仅支持在 EnvPool 库中实现的环境。目前，仅支持同步执行模式，即批量大小等于 worker 数量，请参阅 https://envpool.readthedocs.io/en/latest/content/python_interface.html#batch-size。

参数:

• num_workers (int) – 要同时运行的环境数量。将与 ~.batch_size 的内容相同。

• env_name (str) – 要构建的环境名称。

关键字参数:

• create_env_kwargs (Dict[str, Any], optional) – 要传递给 envpool 环境构造器的 kwargs。

• categorical_action_encoding (bool, optional) – 如果为 True，分类规格将转换为 TorchRL 等效项 (torchrl.data.Categorical)，否则将使用 one-hot 编码 (torchrl.data.OneHot)。默认为 False。

• disable_env_checker (bool, optional) – 仅适用于 gym > 0.24。如果为 True（这些版本的默认值），则不会运行环境检查器。

• frame_skip (int, optional) – 如果提供，则指示要重复相同动作的步数。返回的观察将是序列的最后一个观察，而奖励将是跨步的奖励总和。

• device (torch.device, optional) – 如果提供，则数据要转换到的设备。默认为 torch.device("cpu")。

• allow_done_after_reset (bool, optional) – 如果为 True，则容忍环境在调用 reset() 后立即变为 done 状态。默认为 False。

示例

>>> env = MultiThreadedEnv(num_workers=3, env_name="Pendulum-v1")
>>> env.reset()
>>> env.rand_step()
>>> env.rollout(5)
>>> env.close()