{"reference_analysis":{"checked_at":"2026-10-08","provider":"FiftyOne / Voxel51","about_url":"https://voxel51.com/about","source_access":{"en":"Official documentation read on 2026-10-08. No API was called; proposed checks and examples are our analysis.","zh-TW":"於 2026-10-08 讀取官方文件。未呼叫 API；建議檢查與範例為本站分析。"},"selection_basis":{"en":"Ten documented interfaces, operations or tools selected by integration task; not an official ranking or ten separate SDKs.","zh-TW":"依整合任務挑選十個文件記載的介面、操作或工具；不是官方排名或十個獨立 SDK。"},"about":[{"label":{"en":"Origins","zh-TW":"起源"},"value":{"en":"Voxel51 states it was founded in 2018 by Jason Corso and Brian Moore at the University of Michigan.","zh-TW":"Voxel51 自述於 2018 年由密西根大學的 Jason Corso 與 Brian Moore 創立。"}},{"label":{"en":"Mission","zh-TW":"使命"},"value":{"en":"The company focuses on making visual and multimodal data easier to understand and improve for AI development.","zh-TW":"公司著重讓視覺與多模態資料更易理解及改善，用於 AI 開發。"}},{"label":{"en":"Product context","zh-TW":"產品脈絡"},"value":{"en":"FiftyOne documentation distinguishes open-source and Enterprise capabilities across curation, annotation and evaluation.","zh-TW":"FiftyOne 文件區分資料整理、標註及評估中的開源與 Enterprise 功能。"}},{"label":{"en":"Our fit assessment","zh-TW":"本站適配評估"},"value":{"en":"Useful as an inspection-data evaluation workbench; it does not by itself certify model accuracy or replace deployment software.","zh-TW":"適合評估作為巡檢資料驗證工作台；本身不認證模型準確率，也不取代部署軟體。"}}],"items":[{"id":"import","name":"Dataset import","kind":"Python data API","url":"https://docs.voxel51.com/user_guide/import_datasets.html","audience":{"en":"Data engineer / ML team","zh-TW":"資料工程／ML 團隊"},"capability":{"en":"Import media and labels from supported dataset formats.","zh-TW":"從支援資料集格式匯入媒體及標籤。"},"io":{"en":"Media paths, format and labels → dataset samples","zh-TW":"媒體路徑、格式及標籤 → 資料集樣本"},"runtime":{"en":"FiftyOne Python process, database and media storage.","zh-TW":"FiftyOne Python 程序、資料庫及媒體儲存。"},"constraint":{"en":"A valid label file does not guarantee readable media or correct class ordering.","zh-TW":"有效標籤檔不保證媒體可讀或類別順序正確。"},"validation":{"en":"Compare source count, sample IDs, class map and one known box after import.","zh-TW":"匯入後比較來源筆數、樣本 ID、類別對應及已知框線。"}},{"id":"views","name":"Dataset views","kind":"Query API","url":"https://docs.voxel51.com/user_guide/using_views.html","audience":{"en":"ML analyst / QA","zh-TW":"ML 分析／QA"},"capability":{"en":"Filter, select and organize samples through dataset views.","zh-TW":"以資料集視圖篩選、選取及整理樣本。"},"io":{"en":"View expression → selected samples and labels","zh-TW":"視圖運算式 → 選定樣本及標籤"},"runtime":{"en":"Query over the FiftyOne dataset.","zh-TW":"對 FiftyOne 資料集進行查詢。"},"constraint":{"en":"Filtering labels and filtering whole samples have different effects.","zh-TW":"篩選標籤與篩選整筆樣本效果不同。"},"validation":{"en":"Use a three-sample fixture and verify IDs before exporting a view.","zh-TW":"以三筆樣本測試，匯出視圖前核對 ID。"}},{"id":"aggregate","name":"Aggregations","kind":"Statistics API","url":"https://docs.voxel51.com/user_guide/using_aggregations.html","audience":{"en":"Data quality / product analyst","zh-TW":"資料品質／產品分析"},"capability":{"en":"Count samples, field values and label distributions.","zh-TW":"計算樣本、欄位值及標籤分布。"},"io":{"en":"Dataset/view and field → aggregate values","zh-TW":"資料集／視圖及欄位 → 彙總值"},"runtime":{"en":"Dataset query execution.","zh-TW":"資料集查詢執行。"},"constraint":{"en":"Sample count differs from detection count and non-null field count.","zh-TW":"樣本數、偵測數與非空欄位數不同。"},"validation":{"en":"Hand-count a fixture with missing and empty labels; compare each denominator.","zh-TW":"人工計算含缺漏及空標籤樣本，比較各分母。"}},{"id":"app","name":"Interactive App","kind":"Visual inspection tool","url":"https://docs.voxel51.com/user_guide/app.html","audience":{"en":"Annotation QA / domain expert","zh-TW":"標註 QA／領域專家"},"capability":{"en":"Inspect media, labels and filtered views in the App.","zh-TW":"於 App 檢視媒體、標籤及篩選視圖。"},"io":{"en":"Dataset/view → interactive visual inspection","zh-TW":"資料集／視圖 → 互動視覺檢查"},"runtime":{"en":"Browser plus running FiftyOne service.","zh-TW":"瀏覽器與執行中的 FiftyOne 服務。"},"constraint":{"en":"A visually plausible gallery is not a quantitative evaluation.","zh-TW":"看似合理的圖庫不等於量化評估。"},"validation":{"en":"Verify overlays on known examples and that UI filters match exported sample IDs.","zh-TW":"以已知範例驗證框線，確認介面篩選與匯出 ID 相符。"}},{"id":"evaluation","name":"Detection evaluation","kind":"Evaluation API","url":"https://docs.voxel51.com/user_guide/evaluation/detections.html","audience":{"en":"ML validation / inspection lead","zh-TW":"ML 驗證／巡檢主管"},"capability":{"en":"Compare detections with ground truth using explicit matching rules.","zh-TW":"以明確匹配規則比較偵測與真值。"},"io":{"en":"Predictions, truth and IoU rules → matches and metrics","zh-TW":"預測、真值及 IoU 規則 → 匹配及指標"},"runtime":{"en":"FiftyOne evaluation on selected dataset/view.","zh-TW":"在選定資料集／視圖上執行 FiftyOne 評估。"},"constraint":{"en":"IoU threshold, classwise matching and dataset split change results.","zh-TW":"IoU 門檻、依類別匹配與資料切分會改變結果。"},"validation":{"en":"Use one true positive, false positive and false negative; verify counts and locked protocol.","zh-TW":"使用各一筆真陽性、偽陽性及偽陰性，核對計數及固定協定。"}},{"id":"similarity","name":"Similarity search","kind":"Embedding index","url":"https://docs.voxel51.com/user_guide/similarity.html","audience":{"en":"Data curator / active-learning team","zh-TW":"資料整理／主動學習團隊"},"capability":{"en":"Find similar samples using embeddings and a similarity backend.","zh-TW":"以 embeddings 與相似度後端尋找相似樣本。"},"io":{"en":"Query and embedding index → ranked sample references","zh-TW":"查詢及 embedding 索引 → 排序樣本引用"},"runtime":{"en":"Embedding computation plus configured index backend.","zh-TW":"Embedding 計算與設定索引後端。"},"constraint":{"en":"Rank reflects the embedding model; proximity is not ground-truth equivalence.","zh-TW":"排序反映 embedding 模型，鄰近不等於真值相同。"},"validation":{"en":"Check known near-duplicates and distinct examples; preserve index/model identity.","zh-TW":"檢查已知近重複及不同樣本，保留索引／模型識別。"}},{"id":"cvat","name":"CVAT annotation bridge","kind":"Annotation integration","url":"https://docs.voxel51.com/integrations/cvat.html","audience":{"en":"Data annotation / ML integrator","zh-TW":"資料標註／ML 整合者"},"capability":{"en":"Send annotation work to CVAT and merge returned labels.","zh-TW":"將標註工作送至 CVAT 並合併回傳標籤。"},"io":{"en":"Selected samples and schema → annotation run and merged labels","zh-TW":"選定樣本及 schema → 標註作業及合併標籤"},"runtime":{"en":"FiftyOne and separately configured CVAT server.","zh-TW":"FiftyOne 與另行設定的 CVAT 伺服器。"},"constraint":{"en":"Label IDs and unexpected label types require explicit merge policy.","zh-TW":"標籤 ID 與未預期類型需明確合併政策。"},"validation":{"en":"Round-trip edits without cleanup first; verify IDs and permitted additions/deletions.","zh-TW":"先不清理遠端作業進行來回編輯，核對 ID 與允許新增／刪除。"}},{"id":"export","name":"Dataset/view export","kind":"Export API","url":"https://docs.voxel51.com/user_guide/export_datasets.html","audience":{"en":"ML training / dataset delivery","zh-TW":"ML 訓練／資料集交付"},"capability":{"en":"Export selected datasets, views and label fields in supported formats.","zh-TW":"以支援格式匯出資料集、視圖及標籤欄位。"},"io":{"en":"View, label field and format → exported dataset","zh-TW":"視圖、標籤欄位及格式 → 匯出資料集"},"runtime":{"en":"Local or configured export destination.","zh-TW":"本地或設定匯出目的地。"},"constraint":{"en":"Media can be copied, linked, omitted or moved; move changes the source layout.","zh-TW":"媒體可複製、連結、略過或移動；移動會變更來源配置。"},"validation":{"en":"Use copy or labels-only for a trial; verify no unexpected source changes.","zh-TW":"試行採複製或僅標籤，確認來源未遭未預期變更。"}},{"id":"models","name":"Model Zoo","kind":"Model catalogue","url":"https://docs.voxel51.com/model_zoo/index.html","audience":{"en":"ML prototype / model evaluator","zh-TW":"ML 原型／模型評估者"},"capability":{"en":"Discover supported models for dataset workflows.","zh-TW":"尋找支援資料集工作流程的模型。"},"io":{"en":"Chosen model and supported inputs → model-specific outputs","zh-TW":"選定模型及支援輸入 → 模型特定輸出"},"runtime":{"en":"Depends on selected model dependencies and hardware.","zh-TW":"依選定模型依賴及硬體而定。"},"constraint":{"en":"Catalogue inclusion does not establish commercial rights or target-hardware speed.","zh-TW":"列入型錄不代表商用權利或目標硬體速度已確立。"},"validation":{"en":"Review each model license, download size, input preprocessing and label map.","zh-TW":"逐一核對模型授權、下載大小、前處理與標籤對應。"}},{"id":"plugins","name":"Plugin ecosystem","kind":"Extension tooling","url":"https://docs.voxel51.com/plugins/index.html","audience":{"en":"Platform developer / workflow designer","zh-TW":"平台開發者／流程設計者"},"capability":{"en":"Extend FiftyOne with documented plugins and operators.","zh-TW":"以文件記載的 plugins 及 operators 擴充 FiftyOne。"},"io":{"en":"Extension configuration → workflow or UI capability","zh-TW":"擴充設定 → 工作流程或介面能力"},"runtime":{"en":"FiftyOne extension environment.","zh-TW":"FiftyOne 擴充環境。"},"constraint":{"en":"Plugin code and dependencies need review; edition and version compatibility vary.","zh-TW":"需審查 plugin 程式及依賴，版本與方案相容性不同。"},"validation":{"en":"Pin an extension revision and test permissions and changes on a disposable dataset.","zh-TW":"固定擴充修訂版，在可丟棄資料集測試權限與變更。"}}],"supporting_references":[{"id":"install","name":"Installation","url":"https://docs.voxel51.com/installation/index.html","audience":{"en":"Platform owner: supported environment and dependency requirements.","zh-TW":"平台負責人：支援環境與依賴需求。"},"validation":{"en":"Pin software/database versions and media locations; test backup before upgrades.","zh-TW":"固定軟體／資料庫版本及媒體位置，升級前測試備份。"}},{"id":"brain","name":"FiftyOne Brain","url":"https://docs.voxel51.com/brain/index.html","audience":{"en":"Data scientist: understand embedding, uniqueness and analysis runs.","zh-TW":"資料科學家：了解 embedding、獨特性及分析作業。"},"validation":{"en":"Record the model, index backend and run key; do not equate a heuristic score with defect severity.","zh-TW":"記錄模型、索引後端及作業鍵，不把啟發式分數等同缺陷嚴重度。"}},{"id":"primary-docs","name":"Primary developer documentation","url":"https://docs.voxel51.com/","audience":{"en":"Engineers choosing the supported API and installed version.","zh-TW":"選擇支援 API 與安裝版本的工程師。"},"validation":{"en":"Match the operation and version to the specific references above before implementation. The illustrative output is an internal application contract.","zh-TW":"實作前將操作與版本對應至上述具體文件；示意輸出是內部應用契約。"}}]},"content_coverage":{"reference_guide":true,"developer_starter":false,"expected_results":true,"integration_test":"not-run","updated_at":"2026-10-08"},"developer_starter":{"version":"1.0.0","verification":"illustrative-contract-only;live-provider-not-run","filename":"FiftyOne-expected-results.json","format":"json-example","scope":{"en":"Illustrative detection-evaluation report for a fixed holdout view; no model or database was run.","zh-TW":"固定保留視圖的偵測評估報告示意，未執行模型或資料庫。"},"setup":{"en":"Provide known ground truth and predictions under separate fields. Fix split, class matching and IoU threshold. JSON values below are designed fixtures, not measured accuracy.","zh-TW":"在不同欄位提供已知真值及預測，固定資料切分、類別匹配與 IoU 門檻。以下 JSON 數值為設計樣本，不是實測準確率。"},"code":"{\n  \"schema_version\": \"1.0.0\",\n  \"provider\": \"FiftyOne\",\n  \"status\": \"ok\",\n  \"example\": true,\n  \"contract_origin\": \"Smart Tools illustrative internal contract; not a provider response\",\n  \"input\": {\n    \"view_ref\": \"example-holdout\",\n    \"samples\": 3,\n    \"truth_field\": \"ground_truth\",\n    \"prediction_field\": \"predictions\",\n    \"iou_threshold\": 0.5,\n    \"classwise\": true\n  },\n  \"data\": {\n    \"counts\": {\n      \"true_positive\": 1,\n      \"false_positive\": 1,\n      \"false_negative\": 1\n    },\n    \"precision\": 0.5,\n    \"recall\": 0.5,\n    \"review_sample_refs\": [\n      \"example-fp\",\n      \"example-fn\"\n    ],\n    \"metrics_origin\": \"illustrative_fixture\"\n  },\n  \"error\": null\n}","decisions":[[{"en":"Input requirements","zh-TW":"輸入條件"},{"en":"Use stable sample IDs, compatible box geometry, known truth labels and separate predictions.","zh-TW":"使用穩定樣本 ID、相容框線幾何、已知真值標籤與獨立預測。"}],[{"en":"Expected success","zh-TW":"預期成功"},{"en":"Return protocol, selected sample set, matched counts and review references; these example numbers are not a benchmark.","zh-TW":"回傳協定、選定樣本集、匹配計數及覆核引用；本例數字不是效能基準。"}],[{"en":"Expected empty","zh-TW":"預期空值"},{"en":"A valid query with zero samples returns ok and sample_count=0; precision/recall are null, never a fabricated perfect score.","zh-TW":"有效查詢無樣本時回傳 ok 與 sample_count=0；precision／recall 為 null，不捏造滿分。"}],[{"en":"Expected failure","zh-TW":"預期失敗"},{"en":"Missing prediction fields, unreadable media or incompatible geometry produce an explicit error rather than excluding rows silently.","zh-TW":"缺少預測欄位、媒體無法讀取或幾何不相容需明確錯誤，不默默排除資料。"}],[{"en":"Acceptance","zh-TW":"驗收"},{"en":"For the three-fixture example require TP=1, FP=1, FN=1 and precision=recall=0.5; preserve a distinct empty-view case.","zh-TW":"三筆示例要求 TP=1、FP=1、FN=1，precision=recall=0.5；另保留空視圖情境。"}],[{"en":"Limitations","zh-TW":"限制"},{"en":"No API/model execution or measured industrial accuracy; small fixture arithmetic cannot demonstrate production quality.","zh-TW":"未執行 API／模型或量測工業準確率；小樣本算術不能證明正式品質。"}],[{"en":"Data and runtime","zh-TW":"資料與執行環境"},{"en":"Record database, media paths and selected model/index backends; external annotation or model integrations can transfer data.","zh-TW":"記錄資料庫、媒體路徑及模型／索引後端，外部標註或模型整合可能傳輸資料。"}]],"expected_results":[{"scenario":{"en":"Known evaluation","zh-TW":"已知評估"},"input":{"en":"Three samples constructed as TP, FP and FN.","zh-TW":"三筆分別設計為 TP、FP、FN 的樣本。"},"output":{"en":"ok; TP=1, FP=1, FN=1; precision=recall=0.5.","zh-TW":"ok；TP=1、FP=1、FN=1；precision=recall=0.5。"},"acceptance":{"en":"Counts reconcile with individual sample references.","zh-TW":"計數與各筆樣本引用相符。"}},{"scenario":{"en":"Empty view","zh-TW":"空視圖"},"input":{"en":"Valid filter selects no samples.","zh-TW":"有效篩選未選出樣本。"},"output":{"en":"ok; sample_count=0; metrics=null.","zh-TW":"ok；sample_count=0；metrics=null。"},"acceptance":{"en":"No divide-by-zero or 100% score claim.","zh-TW":"不除以零，也不宣稱 100%。"}},{"scenario":{"en":"Missing predictions","zh-TW":"缺少預測"},"input":{"en":"Required prediction field is absent.","zh-TW":"必要預測欄位不存在。"},"output":{"en":"error; data=null; missing_prediction_field.","zh-TW":"error；data=null；missing_prediction_field。"},"acceptance":{"en":"Not confused with a completed inference containing zero detections.","zh-TW":"不與已完成但零偵測的推論混淆。"}},{"scenario":{"en":"Threshold change","zh-TW":"門檻變更"},"input":{"en":"Repeat fixture with a stricter IoU threshold.","zh-TW":"以更嚴格 IoU 門檻重算樣本。"},"output":{"en":"New evaluation identity and explicitly changed matching counts.","zh-TW":"新的評估識別，明確記錄改變的匹配計數。"},"acceptance":{"en":"Do not compare runs as if their protocols were identical.","zh-TW":"不可將不同協定當相同比較。"}}]},"schema_version":"1.0.0","type":"development-proposal","product_id":"industrial-api:FiftyOne","name":"FiftyOne","provider":"Voxel51","url":"https://smart-tools.ai/product/FiftyOne","localized_urls":{"en":"https://smart-tools.ai/product/FiftyOne","zh-TW":"https://smart-tools.ai/zh-tw/product/FiftyOne"},"category":"vision","capability_id":"cap:computer-vision","technology_hub":"https://smart-tools.ai/industrial-ai/computer-vision","interface_kind":"SDK","deployment":"local","official_documentation":"https://docs.voxel51.com/","sources":["https://docs.voxel51.com/","https://voxel51.com/about","https://docs.voxel51.com/user_guide/import_datasets.html","https://docs.voxel51.com/user_guide/using_views.html","https://docs.voxel51.com/user_guide/using_aggregations.html","https://docs.voxel51.com/user_guide/app.html","https://docs.voxel51.com/user_guide/evaluation/detections.html","https://docs.voxel51.com/user_guide/similarity.html","https://docs.voxel51.com/integrations/cvat.html","https://docs.voxel51.com/user_guide/export_datasets.html","https://docs.voxel51.com/model_zoo/index.html","https://docs.voxel51.com/plugins/index.html","https://docs.voxel51.com/installation/index.html","https://docs.voxel51.com/brain/index.html"],"source_review":{"level":"P1","status":"official-source-reviewed","checked_at":"2026-10-08"},"provider_summary":{"en":"Explore visual datasets, annotations and model predictions.","zh-TW":"檢視視覺資料集、標註與模型預測。"},"proposed_product":{"en":"Dataset quality review","zh-TW":"巡檢資料集品質檢查"},"feasibility":{"tier":"integration","rationale":{"en":"Validate runtime, schemas or hardware together before estimating a deployable product.","zh-TW":"估算可交付產品前，需共同驗證執行環境、資料結構或硬體。"},"basis":"development-judgment;not-traffic-ranked"},"proposed_inputs":{"en":"A small authorized image dataset, task definition and reference annotations.","zh-TW":"少量經授權影像、任務定義與參考標註。"},"proposed_deliverable":{"en":"A reviewable result with image references, labels or annotation state; keep original files.","zh-TW":"可審核的影像引用、標籤或標註狀態；保留原始檔案。"},"acceptance_criterion":{"en":"Compare the supported operation against a labeled sample; report errors and missing results separately.","zh-TW":"用已標註樣本比對支援的操作；錯誤與缺漏結果分開呈現。"},"dependencies":{"en":"Dataset access, image rights and a supported model or annotation project.","zh-TW":"資料集存取、影像使用權與支援的模型或標註專案。"},"integration_condition":null,"proposed_adapter_envelope":{"provider":"Voxel51","operation":"chosen-documented-operation","source_url":"https://docs.voxel51.com/","captured_at":"ISO-8601 timestamp","status":"ok|pending|unknown|failed","data":"provider response mapped by the team","evidence":"source references","errors":"explicit error details"},"adapter_envelope_status":"proposed-internal-contract;not-a-provider-response","development_status":"concept-specification","integration_test":"not-run","pricing_status":"provider-terms-review-required","estimate_status":"requires-access-and-sample-validation","traffic_status":"not-measured-in-this-assessment","measurement_events":["product_view","product_to_docs","product_to_spec","bridge_to_industrial_ai"]}