इमेज मेटाडेटा

Metadata आपको अपने Roboflow workspace में छवियों के साथ कस्टम की-वैल्यू जोड़े संलग्न करने देता है। Metadata का उपयोग अपने चित्रों के साथ संरचित जानकारी संग्रहीत करने के लिए करें — जैसे कैप्चर शर्तें, डिवाइस आइडेंटिफायर्स, गुणवत्ता स्कोर, या किसी भी डोमेन-विशिष्ट गुण — और फिर उन गुणों के आसपास अपने डेटा को खोजें, फ़िल्टर करें और व्यवस्थित करें।

अवलोकन

प्रत्येक छवि में किसी भी संख्या में metadata प्रविष्टियाँ हो सकती हैं। एक प्रविष्टि एक key (एक नाम जैसे camera_id) जो कि एक के साथ जोड़ा जाता है value (एक string, number, या boolean).

Value type	Examples
String	location: "warehouse-3", shift: "night"
Number	temperature: 72.5, quality_score: 95
Boolean	reviewed: true, is_night: false

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

• कैप्चर संदर्भ — कैमरा ID, GPS निर्देशांक, मौसम, प्रकाश की स्थिति रिकॉर्ड करें

• गुणवत्ता ट्रैकिंग — confidence स्कोर, समीक्षा स्थिति, annotator IDs संलग्न करें

• डेटा स्लाइसिंग — लक्षित प्रशिक्षण सेट बनाने के लिए किसी भी गुण के आधार पर अपने डेटासेट को फ़िल्टर करें

• बाहरी सिस्टम लिंकिंग — ऐसे पहचानकर्ता संग्रहीत करें जो छवियों को आपके आंतरिक उपकरणों से जोड़ते हैं

Metadata जोड़ना

आप वेब UI, Python SDK, REST API, या S3 Bucket Mirror के माध्यम से स्वचालित रूप से छवियों में metadata जोड़ सकते हैं।

वेब एप्लिकेशन

1

एक छवि खोलें

अपने प्रोजेक्ट में किसी भी छवि को खोलें।

2

Key और value डालें

Metadata सेक्शन में, पहले इनपुट में एक key दूसरे इनपुट में एक value डालें।

3

जोड़ें

दबाएँ Enter सहेजने के लिए या Add पर क्लिक करें

Values को स्वतः प्रकार के अनुसार पार्स किया जाता है:

डाला गया मान	स्टोर किया गया रूप
front	"front" (string)
95	95 (number)
3.14	3.14 (number)
true / false	true / false (boolean)

Annotation Tool का metadata संपादक

Python SDK

जब किसी छवि को अपलोड करते समय एक metadata डिक्शनरी पास करें:

import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
project = rf.workspace("your-workspace").project("your-project")

project.upload(
    image_path="image.jpg",
    metadata={
        "camera_id": "cam001",
        "location": "warehouse-3",
        "temperature": 72.5,
        "is_night": False
    }
)

REST API

अपलोड के दौरान metadata जोड़ें

एक metadata field (JSON-stringified) को multipart form data में शामिल करें जब छवि अपलोड कर रहे हों:

curl -X POST "https://api.roboflow.com/dataset/your-dataset/upload?api_key=YOUR_API_KEY" \
  -F "name=image.jpg" \
  -F "split=train" \
  -F "[email protected]" \
  -F 'metadata={"camera_id":"cam001","temperature":72.5}'

S3 Bucket Mirror

जब आप Bucket Mirror का उपयोग S3 बकेट से छवियाँ सिंक करने के लिए करते हैं, तो आप प्रत्येक छवि के समान बेस नाम के साथ एक .json फाइल प्रत्येक छवि के साथ रखकर metadata संलग्न कर सकते हैं:

my-bucket/
  images/
    photo_001.jpg
    photo_001.json      # photo_001.jpg के लिए metadata
    photo_002.jpg
    photo_002.json      # photo_002.jpg के लिए metadata

JSON फ़ाइल में आपकी metadata key-value जोड़ों के रूप में होती है:

{
    "camera_id": "cam001",
    "location": "warehouse-3",
    "capture": { "temperature": 72.5, "humidity": 45 }
}

Nested objects स्वतः dot notation का उपयोग करके flatten कर दिए जाते हैं उपरोक्त उदाहरण से उत्पन्न होता है:

Key	Value
camera_id	"cam001"
location	"warehouse-3"
capture.temperature	72.5
capture.humidity	45

Metadata फ़ाइल सीमाएँ

• अधिकतम फ़ाइल आकार: 256 KB

• वैध JSON होना चाहिए

• null और undefined मूल्य फ़िल्टर कर दिए जाते हैं

अपडेट रणनीतियाँ

Bucket Mirror विभिन्न रणनीतियों का समर्थन करता है कि सिंक की गई metadata उस metadata के साथ कैसे इंटरैक्ट करती है जिसे आपने UI में मैन्युफ़ैक्चर्ड या API के माध्यम से सेट किया है:

रणनीति	व्यवहार
mergeBucketWins (डिफ़ॉल्ट)	दोनों स्रोतों को मर्ज करता है। की संघर्ष होने पर, बकेट का मान विजयी होता है।
mergeUserWins	दोनों स्रोतों को मर्ज करता है। की संघर्ष होने पर, उपयोगकर्ता द्वारा सेट किया गया मान विजयी होता है।
overwrite	बकेट metadata पूरी तरह से सभी मौजूदा metadata को प्रतिस्थापित कर देता है।
untilFirstChange	जब तक उपयोगकर्ता मैन्युअल रूप से metadata संपादित नहीं करता, तब तक बकेट से सिंक करता है, फिर अपडेट करना बंद कर देता है।
append	केवल बकेट से नए की जोड़ता है। कभी भी मौजूदा कीज़ को ओवरराइट नहीं करता।

Metadata द्वारा खोज

Metadata को index किया जाता है और खोज के लिए उपलब्ध है Asset Library. खोज बार का उपयोग metadata मानों द्वारा छवियों को फ़िल्टर करने के लिए करें:

metadata.camera_id:"cam001"
metadata.quality_score>80
metadata.reviewed:true

आप अन्य खोज फ़िल्टरों के साथ metadata फ़िल्टरों को जोड़ सकते हैं:

metadata.location:"warehouse-3" AND class:forklift

Asset Library आपके workspace में मौजूद चीज़ों के आधार पर metadata कीज़ और मानों के लिए autocomplete भी प्रदान करता है।

Key नामकरण नियम

Metadata कीज़ को निम्न नियमों का पालन करना चाहिए:

नियमन	विवरण
अनुमत वर्ण	अक्षर (a-z, A-Z), संख्या (0-9), अंडरस्कोर (_), डॉट (.)
पहला वर्ण	एक अक्षर, संख्या, या अंडरस्कोर होना चाहिए
निषिद्ध वर्ण	फॉरवर्ड स्लैशेज़ (/) की अनुमति नहीं है

वैध कीज़: camera_id, capture.temperature, _internal_ref, v2_score

अमान्य कीज़: camera/id (शामिल है /), .starts_with_dot (dot से शुरू होता है .), has spaces (स्पेस शामिल है)

Metadata बनाम Tags

दोनों metadata और tags आपको छवियों को व्यवस्थित करने में मदद करते हैं, लेकिन वे अलग उद्देश्यों की सेवा करते हैं:

	Tags	Metadata
संरचना	सरल लेबल	की-वैल्यू जोड़े
मूल्य	कोई मूल्य नहीं, सिर्फ़ एक नाम	String, number, या boolean
सबसे अच्छा उपयोग के लिए	श्रेनीकरण, वर्कफ़्लो स्थिति	संरचित गुण, माप
उदाहरण	reviewed, v2, needs-annotation	temperature: 72.5, camera_id: "cam001"

आप एक ही छवि पर दोनों का उपयोग कर सकते हैं। उदाहरण के लिए, किसी छवि को टैग करें reviewed और साथ ही इसे स्टोर भी करें reviewer: "alice" और confidence: 0.95 को metadata के रूप में।