🚀 UPerNetモデルカード
UPerNetは画像セグメンテーションに特化したモデルで、segmentation - models - pytorch
ライブラリを利用して構築されています。このモデルは事前学習済みの重みを持ち、簡単に推論を行うことができます。
🚀 クイックスタート
学習済みモデルの読み込み

- 必要なライブラリをインストールします。
pip install -U segmentation_models_pytorch albumentations
- 推論を実行します。
import torch
import requests
import numpy as np
import albumentations as A
import segmentation_models_pytorch as smp
from PIL import Image
device = "cuda" if torch.cuda.is_available() else "cpu"
checkpoint = "smp-hub/upernet-swin-large"
model = smp.from_pretrained(checkpoint).eval().to(device)
preprocessing = A.Compose.from_pretrained(checkpoint)
url = "https://huggingface.co/datasets/hf-internal-testing/fixtures_ade20k/resolve/main/ADE_val_00000001.jpg"
image = Image.open(requests.get(url, stream=True).raw)
np_image = np.array(image)
normalized_image = preprocessing(image=np_image)["image"]
input_tensor = torch.as_tensor(normalized_image)
input_tensor = input_tensor.permute(2, 0, 1).unsqueeze(0)
input_tensor = input_tensor.to(device)
with torch.no_grad():
output_mask = model(input_tensor)
mask = mask.argmax(1).cpu().numpy()
💻 使用例
基本的な使用法
import torch
import requests
import numpy as np
import albumentations as A
import segmentation_models_pytorch as smp
from PIL import Image
device = "cuda" if torch.cuda.is_available() else "cpu"
checkpoint = "smp-hub/upernet-swin-large"
model = smp.from_pretrained(checkpoint).eval().to(device)
preprocessing = A.Compose.from_pretrained(checkpoint)
url = "https://huggingface.co/datasets/hf-internal-testing/fixtures_ade20k/resolve/main/ADE_val_00000001.jpg"
image = Image.open(requests.get(url, stream=True).raw)
np_image = np.array(image)
normalized_image = preprocessing(image=np_image)["image"]
input_tensor = torch.as_tensor(normalized_image)
input_tensor = input_tensor.permute(2, 0, 1).unsqueeze(0)
input_tensor = input_tensor.to(device)
with torch.no_grad():
output_mask = model(input_tensor)
mask = mask.argmax(1).cpu().numpy()
🔧 技術詳細
モデルの初期化パラメータ
model_init_params = {
"encoder_name": "tu-swin_large_patch4_window12_384",
"encoder_depth": 5,
"encoder_weights": None,
"decoder_channels": 512,
"decoder_use_norm": "batchnorm",
"in_channels": 3,
"classes": 150,
"activation": None,
"upsampling": 4,
"aux_params": None,
"img_size": 512
}
データセット
データセット名: ADE20K
📚 詳細ドキュメント
- ライブラリ: https://github.com/qubvel/segmentation_models.pytorch
- ドキュメント: https://smp.readthedocs.io/en/latest/
このモデルはPytorchModelHubMixinを使用してHubに公開されています。
📄 ライセンス
このプロジェクトはMITライセンスの下で公開されています。