Vision Events

आपके deployed computer vision models production में क्या देखते हैं, उसे रिकॉर्ड करें, खोजें, और विश्लेषण करें।

के बारे में

अवलोकन

Vision Events एक Roboflow डेटास्टोर है जो महत्वपूर्ण घटनाओं को कैप्चर कर सकता है, जैसे कि दोष का पता लगना या इन्वेंटरी की गिनती, साथ ही आपके तैनात कंप्यूटर विज़न मॉडल से प्राप्त दृश्य जानकारी। इससे आपको उत्पादन में आपका विज़न सिस्टम जो कुछ भी देखता है, उसका एक खोजने योग्य, फ़िल्टर करने योग्य इतिहास मिलता है।

Vision Event क्या है?

एक Vision Event एक टाइमस्टैम्प-सहित रिकॉर्ड है, जो तब बनाया जाता है जब कोई मॉडल किसी छवि को प्रोसेस करता है। प्रत्येक इवेंट वैकल्पिक रूप से निम्न कैप्चर कर सकता है:

छवियाँ: प्रोसेस की गई मूल छवियाँ और उनसे संबद्ध आउटपुट छवियाँ
पूर्वानुमान: मॉडल द्वारा लौटाए गए ऑब्जेक्ट डिटेक्शन, क्लासिफिकेशन, इंस्टेंस सेगमेंटेशन, या कीपॉइंट्स
स्रोत मेटाडेटा: किस डिवाइस, स्ट्रीम, या वर्कफ़्लो ने इवेंट जनरेट किया
कस्टम मेटाडेटा: आपके डोमेन के लिए आपके द्वारा परिभाषित की-वैल्यू जोड़े (जैसे line_number, shift, part_number)

प्रोग्रामेटिक पहुँच के लिए, देखें Vision Events API संदर्भ.

मुख्य अवधारणाएँ

उपयोग के मामले

एक उपयोग केस उन इवेंट्स को समूहित करता है जिनका उद्देश्य और कस्टम मेटाडेटा संरचना समान होती है। एक ही उपयोग केस के इवेंट्स आमतौर पर समान मेटाडेटा फ़ील्ड भेजते हैं, ताकि आप उन्हें एकसमान रूप से फ़िल्टर और क्वेरी कर सकें।

उदाहरण के लिए, "Defect Detection" उपयोग केस में हमेशा शामिल हो सकता है line_id, shift, और part_number भले ही इवेंट कई फ़ैक्ट्रियों या कैमरा स्थानों से आते हों। जब मेटाडेटा संरचना मूल रूप से अलग हो, तब अलग-अलग उपयोग केस बनाएं (जैसे "PPE Compliance" ट्रैक करता है zone और alert_type इसके बजाय)।

इस अनुभाग में

इवेंट भेजें - वर्कफ़्लो ब्लॉक, REST API, या एज डिवाइस बैकअप से इवेंट भेजें।
इवेंट्स क्वेरी करें - डैशबोर्ड में इवेंट्स फ़िल्टर करें, Agent से प्राकृतिक भाषा में पूछें, या API के माध्यम से क्वेरी करें।
प्रशिक्षण के लिए छवियाँ जोड़ें - कैप्चर की गई इवेंट छवियों को किसी प्रोजेक्ट में ले जाकर मॉडल को प्रशिक्षित करें।
ऑपरेटर फ़ीडबैक - टीम सदस्यों को इवेंट्स को सही, गलत, या अनिर्णीत के रूप में चिह्नित करने दें।
सारांश रिपोर्ट - अपने टीम को किसी उपयोग केस का नियमित सारांश ईमेल करें।
इवेंट्स हटाएँ - जिन इवेंट्स की अब आपको आवश्यकता नहीं है, उन्हें किसी उपयोग केस से हटाएँ।

HTTP API

Vision Events API आपको आपके कंप्यूटर विज़न परिनियोजनों से संरचित इवेंट रिकॉर्ड करने, फिर उन्हें क्वेरी और विश्लेषण करने देता है। इवेंट्स में छवियाँ, डिटेक्शन एनोटेशन, कस्टम मेटाडेटा, और गुणवत्ता जाँच, इन्वेंटरी काउंट, सुरक्षा अलर्ट, और अन्य के लिए प्रकार-विशिष्ट डेटा शामिल हो सकता है।

Vision Events API के साथ, आप यह कर सकते हैं:

प्रमाणीकरण

सभी Vision Events एंडपॉइंट्स आपके Roboflow API key के साथ Bearer token प्रमाणीकरण का उपयोग करते हैं:

Authorization: Bearer YOUR_API_KEY

Vision Events एंडपॉइंट्स के लिए विशिष्ट स्कोप्ड API key अनुमतियाँ आवश्यक हैं:

रीड ऑपरेशन्स (क्वेरी, सूची, स्कीमा): vision-events:read या device:read
राइट ऑपरेशन्स (बनाएँ, बैच, अपलोड): vision-events:write या device:update

उपयोग के मामले

प्रत्येक vision event एक उपयोग केस से संबद्ध होता है। उपयोग केस कैसे बनाएं और प्रबंधित करें, यह जानने के लिए देखें उपयोग केस दस्तावेज़ीकरण.

आप यह भी कर सकते हैं मौजूदा उपयोग केस सूचीबद्ध करें जिनमें API के माध्यम से रिकॉर्ड किए गए इवेंट्स हैं।

इवेंट प्रकार

API पाँच इवेंट प्रकारों का समर्थन करता है, प्रत्येक के अपने eventData स्कीमा के साथ:

इवेंट प्रकार

विवरण

quality_check

QA और निरीक्षण परिणाम

inventory_count

इन्वेंटरी माप

safety_alert

सुरक्षा घटनाएँ और अलर्ट

custom

मुक्त-रूप इवेंट डेटा

operator_feedback

मॉडल पूर्वानुमानों पर मानव प्रतिक्रिया

डेटा प्रतिधारण

इवेंट्स को एक कॉन्फ़िगर करने योग्य लुकबैक विंडो के लिए संग्रहीत किया जाता है (डिफ़ॉल्ट: 14 दिन)। lookbackDays मान क्वेरी प्रतिक्रियाओं में लौटाया जाता है, ताकि आपको अपने वर्कस्पेस के लिए प्रभावी प्रतिधारण अवधि पता रहे।

Python SDK

Roboflow Python SDK वर्कस्पेस Workspace ऑब्जेक्ट पर विज़न इवेंट्स के साथ काम करने के लिए विधियाँ प्रदान करता है। आप इवेंट्स बना सकते हैं, फ़िल्टर और पेजिनेशन के साथ उन्हें क्वेरी कर सकते हैं, छवियाँ अपलोड कर सकते हैं, और उपयोग केस प्रबंधित कर सकते हैं।

इवेंट स्कीमा, फ़िल्टरिंग विकल्पों, और प्रतिक्रिया प्रारूपों पर पूरी जानकारी के लिए, देखें Vision Events REST API दस्तावेज़ीकरण.

त्वरित शुरुआत

import roboflow

roboflow.login()

rf = roboflow.Roboflow()
ws = rf.workspace()

# एक उपयोग केस बनाएं
result = ws.create_vision_event_use_case("manufacturing-qa")
use_case_id = result["id"]

# एक छवि अपलोड करें
img = ws.upload_vision_event_image("photo.jpg")

# अपलोड की गई छवि के साथ एक इवेंट बनाएं
ws.write_vision_event({
    "eventId": "c3d4e5f6-a1b2-4c3d-8e5f-6a7b8c9d0e1f",
    "eventType": "quality_check",
    "useCaseId": use_case_id,
    "timestamp": "2024-01-15T10:30:00Z",
    "images": [{"sourceId": img["sourceId"]}],
    "eventData": {"result": "pass"},
})

# इवेंट्स क्वेरी करें
for page in ws.query_all_vision_events(use_case_id):
    for evt in page:
        print(evt["eventId"], evt["eventType"])