Sam Vit Base

🚀 基於Transformers.js的SAM模型

本項目將 facebook/sam-vit-base 模型轉換為ONNX權重，以兼容Transformers.js庫，可在Web環境中運行圖像分割任務。

🚀 快速開始

安裝依賴

如果你還未安裝 Transformers.js JavaScript庫，可以通過以下命令從 NPM 進行安裝：

npm i @huggingface/transformers

💻 使用示例

基礎用法

以下示例展示瞭如何使用 Xenova/sam-vit-base 模型進行掩碼生成：

import { SamModel, AutoProcessor, RawImage } from "@huggingface/transformers";

// 加載模型和處理器
const model = await SamModel.from_pretrained("Xenova/sam-vit-base");
const processor = await AutoProcessor.from_pretrained("Xenova/sam-vit-base");

// 準備圖像和輸入點
const img_url = "https://huggingface.co/datasets/Xenova/transformers.js-docs/resolve/main/corgi.jpg";
const raw_image = await RawImage.read(img_url);
const input_points = [[[340, 250]]];

// 處理輸入並進行掩碼生成
const inputs = await processor(raw_image, { input_points });
const outputs = await model(inputs);

// 後處理掩碼
const masks = await processor.post_process_masks(outputs.pred_masks, inputs.original_sizes, inputs.reshaped_input_sizes);
console.log(masks);
// [
//   Tensor {
//     dims: [ 1, 3, 410, 614 ],
//     type: 'bool',
//     data: Uint8Array(755220) [ ... ],
//     size: 755220
//   }
// ]
const scores = outputs.iou_scores;
console.log(scores);
// Tensor {
//   dims: [ 1, 1, 3 ],
//   type: 'float32',
//   data: Float32Array(3) [
//     0.9466127157211304,
//     0.9890615344047546,
//     0.8316894769668579
//   ],
//   size: 3
// }

高級用法

你可以使用以下代碼將生成的掩碼可視化：

const image = RawImage.fromTensor(masks[0][0].mul(255));
image.save('mask.png');

生成的掩碼可視化效果如下：

接下來，選擇IoU分數最高的通道（在本例中為第二個通道，即綠色通道），將其與原始圖像相交，即可得到主體的分割圖像：

📚 詳細文檔

在線演示

我們還提供了一個在線演示，你可以點擊 這裡 進行嘗試。

在線演示的視頻展示如下：

🔧 技術細節

注意事項

⚠️ 重要提示

目前為ONNX權重單獨創建倉庫是一種臨時解決方案，直到WebML得到更廣泛的應用。如果你想讓你的模型適用於Web環境，我們建議使用 🤗 Optimum 將模型轉換為ONNX格式，並按照本倉庫的結構進行組織（將ONNX權重放在名為 onnx 的子文件夾中）。

模型信息