模型概述
模型特點
模型能力
使用案例
🚀 高質量任意分割模型 (SAM-HQ)
SAM-HQ 是對任意分割模型 (SAM) 的增強版本,能根據點或框等輸入提示生成更高質量的對象掩碼。在處理複雜結構的對象時,它顯著提升了掩碼質量,同時保留了 SAM 原有的可提示設計、效率和零樣本泛化能力。
🚀 快速開始
SAM-HQ(高質量任意分割模型)是任意分割模型(SAM)的增強版本,可根據點或框等輸入提示生成更高質量的對象掩碼。SAM 在包含 1100 萬張圖像和 11 億個掩碼的數據集上進行訓練,但在許多情況下,其掩碼預測質量欠佳,尤其是處理具有複雜結構的對象時。SAM-HQ 以最小的額外參數和計算成本解決了這些限制。
該模型即使對於具有複雜邊界和細結構的對象(原始 SAM 模型通常難以處理),也能出色地生成高質量的分割掩碼。SAM-HQ 在顯著提高掩碼質量的同時,保留了 SAM 原有的可提示設計、效率和零樣本泛化能力。
✨ 主要特性
SAM-HQ 在保留 SAM 預訓練權重的基礎上,對原始 SAM 架構進行了兩項關鍵創新:
- 高質量輸出令牌:注入到 SAM 掩碼解碼器中的可學習令牌,負責預測高質量掩碼。與 SAM 的原始輸出令牌不同,此令牌及其關聯的 MLP 層經過專門訓練,以生成高度準確的分割掩碼。
- 全局 - 局部特徵融合:SAM-HQ 不是僅在掩碼解碼器特徵上應用 HQ 輸出令牌,而是首先將這些特徵與早期和最終的 ViT 特徵融合,以改善掩碼細節。這結合了高級語義上下文和低級邊界信息,實現更準確的分割。
SAM-HQ 在精心策劃的 44K 細粒度掩碼數據集(HQSeg - 44K)上進行訓練,該數據集來自多個來源,具有極其準確的註釋。訓練過程在 8 個 GPU 上僅需 4 小時,與原始 SAM 模型相比,引入的額外參數不到 0.5%。
該模型在 10 個不同的分割數據集上進行了評估,涵蓋不同的下游任務,其中 8 個數據集採用零樣本遷移協議進行評估。結果表明,SAM-HQ 可以生成比原始 SAM 模型明顯更好的掩碼,同時保持其零樣本泛化能力。
SAM-HQ 解決了原始 SAM 模型的兩個關鍵問題:
- 掩碼邊界粗糙,常常忽略細對象結構。
- 在具有挑戰性的情況下,預測錯誤、掩碼斷裂或出現較大誤差。
這些改進使 SAM-HQ 對於需要高精度圖像掩碼的應用特別有價值,例如自動註釋和圖像/視頻編輯任務。
💻 使用示例
基礎用法
from PIL import Image
import requests
from transformers import SamHQModel, SamHQProcessor
model = SamHQModel.from_pretrained("syscv-community/sam-hq-vit-base")
processor = SamHQProcessor.from_pretrained("syscv-community/sam-hq-vit-base")
img_url = "https://raw.githubusercontent.com/SysCV/sam-hq/refs/heads/main/demo/input_imgs/example1.png"
raw_image = Image.open(requests.get(img_url, stream=True).raw).convert("RGB")
input_boxes = [[[306, 132, 925, 893]]] # Bounding box for the image
inputs = processor(raw_image, input_boxes=input_boxes, return_tensors="pt").to("cuda")
outputs = model(**inputs)
masks = processor.image_processor.post_process_masks(outputs.pred_masks.cpu(), inputs["original_sizes"].cpu(), inputs["reshaped_input_sizes"].cpu())
scores = outputs.iou_scores
在生成掩碼的其他參數中,您可以傳遞感興趣對象近似位置的二維位置、包圍感興趣對象的邊界框(格式應為邊界框右上角和左下角的 x、y 座標)、分割掩碼。撰寫本文時,根據官方倉庫,官方模型不支持將文本作為輸入。有關更多詳細信息,請參閱此筆記本,其中展示瞭如何使用該模型,並配有可視化示例!
高級用法
from transformers import pipeline
generator = pipeline("mask-generation", model="syscv-community/sam-hq-vit-base", device=0, points_per_batch=256)
image_url = "https://raw.githubusercontent.com/SysCV/sam-hq/refs/heads/main/demo/input_imgs/example1.png"
outputs = generator(image_url, points_per_batch=256)
現在顯示圖像:
import matplotlib.pyplot as plt
from PIL import Image
import numpy as np
def show_mask(mask, ax, random_color=False):
if random_color:
color = np.concatenate([np.random.random(3), np.array([0.6])], axis=0)
else:
color = np.array([30 / 255, 144 / 255, 255 / 255, 0.6])
h, w = mask.shape[-2:]
mask_image = mask.reshape(h, w, 1) * color.reshape(1, 1, -1)
ax.imshow(mask_image)
plt.imshow(np.array(raw_image))
ax = plt.gca()
for mask in outputs["masks"]:
show_mask(mask, ax=ax, random_color=True)
plt.axis("off")
plt.show()
帶可視化的完整示例
import numpy as np
import matplotlib.pyplot as plt
def show_mask(mask, ax, random_color=False):
if random_color:
color = np.concatenate([np.random.random(3), np.array([0.6])], axis=0)
else:
color = np.array([30/255, 144/255, 255/255, 0.6])
h, w = mask.shape[-2:]
mask_image = mask.reshape(h, w, 1) * color.reshape(1, 1, -1)
ax.imshow(mask_image)
def show_box(box, ax):
x0, y0 = box[0], box[1]
w, h = box[2] - box[0], box[3] - box[1]
ax.add_patch(plt.Rectangle((x0, y0), w, h, edgecolor='green', facecolor=(0,0,0,0), lw=2))
def show_boxes_on_image(raw_image, boxes):
plt.figure(figsize=(10,10))
plt.imshow(raw_image)
for box in boxes:
show_box(box, plt.gca())
plt.axis('on')
plt.show()
def show_points_on_image(raw_image, input_points, input_labels=None):
plt.figure(figsize=(10,10))
plt.imshow(raw_image)
input_points = np.array(input_points)
if input_labels is None:
labels = np.ones_like(input_points[:, 0])
else:
labels = np.array(input_labels)
show_points(input_points, labels, plt.gca())
plt.axis('on')
plt.show()
def show_points_and_boxes_on_image(raw_image, boxes, input_points, input_labels=None):
plt.figure(figsize=(10,10))
plt.imshow(raw_image)
input_points = np.array(input_points)
if input_labels is None:
labels = np.ones_like(input_points[:, 0])
else:
labels = np.array(input_labels)
show_points(input_points, labels, plt.gca())
for box in boxes:
show_box(box, plt.gca())
plt.axis('on')
plt.show()
def show_points_and_boxes_on_image(raw_image, boxes, input_points, input_labels=None):
plt.figure(figsize=(10,10))
plt.imshow(raw_image)
input_points = np.array(input_points)
if input_labels is None:
labels = np.ones_like(input_points[:, 0])
else:
labels = np.array(input_labels)
show_points(input_points, labels, plt.gca())
for box in boxes:
show_box(box, plt.gca())
plt.axis('on')
plt.show()
def show_points(coords, labels, ax, marker_size=375):
pos_points = coords[labels==1]
neg_points = coords[labels==0]
ax.scatter(pos_points[:, 0], pos_points[:, 1], color='green', marker='*', s=marker_size, edgecolor='white', linewidth=1.25)
ax.scatter(neg_points[:, 0], neg_points[:, 1], color='red', marker='*', s=marker_size, edgecolor='white', linewidth=1.25)
def show_masks_on_image(raw_image, masks, scores):
if len(masks.shape) == 4:
masks = masks.squeeze()
if scores.shape[0] == 1:
scores = scores.squeeze()
nb_predictions = scores.shape[-1]
fig, axes = plt.subplots(1, nb_predictions, figsize=(15, 15))
for i, (mask, score) in enumerate(zip(masks, scores)):
mask = mask.cpu().detach()
axes[i].imshow(np.array(raw_image))
show_mask(mask, axes[i])
axes[i].title.set_text(f"Mask {i+1}, Score: {score.item():.3f}")
axes[i].axis("off")
plt.show()
def show_masks_on_single_image(raw_image, masks, scores):
if len(masks.shape) == 4:
masks = masks.squeeze()
if scores.shape[0] == 1:
scores = scores.squeeze()
# Convert image to numpy array if it's not already
image_np = np.array(raw_image)
# Create a figure
fig, ax = plt.subplots(figsize=(8, 8))
ax.imshow(image_np)
# Overlay all masks on the same image
for i, (mask, score) in enumerate(zip(masks, scores)):
mask = mask.cpu().detach().numpy() # Convert to NumPy
show_mask(mask, ax) # Assuming `show_mask` properly overlays the mask
ax.set_title(f"Overlayed Masks with Scores")
ax.axis("off")
plt.show()
import torch
from transformers import SamHQModel, SamHQProcessor
device = "cuda" if torch.cuda.is_available() else "cpu"
model = SamHQModel.from_pretrained("syscv-community/sam-hq-vit-base").to(device)
processor = SamHQProcessor.from_pretrained("syscv-community/sam-hq-vit-base")
from PIL import Image
import requests
img_url = "https://raw.githubusercontent.com/SysCV/sam-hq/refs/heads/main/demo/input_imgs/example1.png"
raw_image = Image.open(requests.get(img_url, stream=True).raw).convert("RGB")
plt.imshow(raw_image)
inputs = processor(raw_image, return_tensors="pt").to(device)
image_embeddings, intermediate_embeddings = model.get_image_embeddings(inputs["pixel_values"])
input_boxes = [[[306, 132, 925, 893]]]
show_boxes_on_image(raw_image, input_boxes[0])
inputs.pop("pixel_values", None)
inputs.update({"image_embeddings": image_embeddings})
inputs.update({"intermediate_embeddings": intermediate_embeddings})
with torch.no_grad():
outputs = model(**inputs)
masks = processor.image_processor.post_process_masks(outputs.pred_masks.cpu(), inputs["original_sizes"].cpu(), inputs["reshaped_input_sizes"].cpu())
scores = outputs.iou_scores
show_masks_on_single_image(raw_image, masks[0], scores)
show_masks_on_image(raw_image, masks[0], scores)
📄 許可證
本項目採用 Apache - 2.0 許可證。
📚 引用
@misc{ke2023segmenthighquality,
title={Segment Anything in High Quality},
author={Lei Ke and Mingqiao Ye and Martin Danelljan and Yifan Liu and Yu-Wing Tai and Chi-Keung Tang and Fisher Yu},
year={2023},
eprint={2306.01567},
archivePrefix={arXiv},
primaryClass={cs.CV},
url={https://arxiv.org/abs/2306.01567},
}











