🚀 UPerNetモデルカード
UPerNetは、画像セグメンテーションに特化したモデルです。このREADMEでは、学習済みモデルの読み込み方法、モデルの初期化パラメータ、使用するデータセットについて説明します。
🚀 クイックスタート
学習済みモデルの読み込み

- 必要なライブラリをインストールします。
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-convnext-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-convnext-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-convnext_large",
"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
}
📚 ドキュメント
データセット
データセット名: ADE20K
その他の情報
- ライブラリ: https://github.com/qubvel/segmentation_models.pytorch
- ドキュメント: https://smp.readthedocs.io/en/latest/
このモデルは、PytorchModelHubMixinを使用してモデルハブにアップロードされています。
📄 ライセンス
このプロジェクトはMITライセンスの下で公開されています。