torch.utils.model_zoo

创建于: 2017年1月09日 | 最后更新于: 2025年6月11日

已移至 torch.hub。

torch.utils.model_zoo.load_url(url, model_dir=None, map_location=None, progress=True, check_hash=False, file_name=None, weights_only=False)

从给定的 URL 加载 Torch 序列化对象。

如果下载的文件是 zip 文件，它将被自动解压缩。

如果对象已存在于 model_dir 中，则将其反序列化并返回。 model_dir 的默认值为 <hub_dir>/checkpoints，其中 hub_dir 是由 get_dir() 返回的目录。

参数:

• url (str) – 要下载对象的 URL

• model_dir (str, optional) – 用于保存对象的目录

• map_location (optional) – 一个函数或字典，用于指定如何重新映射存储位置（参见 torch.load）

• progress (bool, optional) – 是否在 stderr 上显示进度条。默认值：True

• check_hash (bool, optional) – 如果为 True，URL 的文件名部分应遵循命名约定 filename-<sha256>.ext，其中 <sha256> 是文件内容 SHA256 哈希值的前八位或更多位数。哈希值用于确保名称的唯一性以及验证文件内容。默认值：False

• file_name (str, optional) – 下载文件的名称。如果未设置，将使用来自 url 的文件名。

• weights_only (bool, optional) – 如果为 True，则仅加载权重，不加载复杂的 pickling 对象。建议用于不受信任的来源。有关更多详细信息，请参阅 load()。

返回类型:

dict[str, Any]

示例

>>> state_dict = torch.hub.load_state_dict_from_url(
...     "https://s3.amazonaws.com/pytorch/models/resnet18-5c106cde.pth"
... )