ObjectDetector

ObjectDetector คลาสสุดท้ายสาธารณะ

ดำเนินการตรวจจับวัตถุบนภาพ

API คาดว่าจะมีโมเดล TFLite พร้อมด้วย ข้อมูลเมตาของโมเดล TFLite .

API รองรับโมเดลที่มีเทนเซอร์อินพุตรูปภาพหนึ่งตัวและเทนเซอร์เอาท์พุตสี่ตัว เพื่อให้เจาะจงยิ่งขึ้น นี่คือข้อกำหนด

  • อินพุตอิมเมจเทนเซอร์ ( kTfLiteUInt8 / kTfLiteFloat32 )
    • อินพุตรูปภาพขนาด [batch x height x width x channels]
    • ไม่รองรับการอนุมานแบบแบตช์ ( batch ต้องเป็น 1)
    • รองรับเฉพาะอินพุต RGB ( channels ต้องเป็น 3)
    • หากประเภทเป็น kTfLiteFloat32 จำเป็นต้องแนบ NormalizationOptions กับข้อมูลเมตาเพื่อทำให้อินพุตเป็นมาตรฐาน
  • เทนเซอร์เอาท์พุตต้องเป็น 4 เอาท์พุตของ DetectionPostProcess op เช่น:
    • เทนเซอร์ตำแหน่ง ( kTfLiteFloat32 ):
      • เทนเซอร์ขนาด [1 x num_results x 4] อาร์เรย์ภายในที่แสดงถึงกล่องขอบเขตในรูปแบบ [บน ซ้าย ขวา ล่าง]
      • จำเป็นต้องแนบ BoundingBoxProperties กับข้อมูลเมตา และต้องระบุ type=BOUNDARIES และ coordinate_type=RATIO
    • คลาสเทนเซอร์ ( kTfLiteFloat32 ):
      • เทนเซอร์ขนาด [1 x num_results] แต่ละค่าแสดงถึงดัชนีจำนวนเต็มของคลาส
      • หากแนบแผนผังป้ายกำกับกับข้อมูลเมตาเป็นไฟล์ที่เกี่ยวข้อง TENSOR_VALUE_LABELS ก็จะใช้ในการแปลงค่าเทนเซอร์ให้เป็นป้ายกำกับ
    • คะแนนเทนเซอร์ ( kTfLiteFloat32 ):
      • เทนเซอร์ขนาด [1 x num_results] แต่ละค่าแสดงถึงคะแนนของวัตถุที่ตรวจพบ
    • จำนวนเทนเซอร์ตรวจจับ ( kTfLiteFloat32 ):
      • จำนวนเต็ม num_results เป็นเมตริกซ์ขนาด [1]

ตัวอย่างของโมเดลดังกล่าวมีอยู่ใน TensorFlow Hub .

คลาสที่ซ้อนกัน

ระดับ ObjectDetector.ObjectDetectorOptions ตัวเลือกสำหรับการตั้งค่า ObjectDetector

วิธีการสาธารณะ

ObjectDetector แบบคงที่
createFromBuffer ( ByteBuffer modelBuffer)
สร้างอินสแตนซ์ ObjectDetector ด้วยบัฟเฟอร์โมเดลและ ObjectDetector.ObjectDetectorOptions เริ่มต้น
ObjectDetector แบบคงที่
createFromBufferAndOptions (ตัวเลือก ByteBuffer modelBuffer, ObjectDetector.ObjectDetectorOptions )
สร้างอินสแตนซ์ ObjectDetector ด้วยบัฟเฟอร์โมเดลและ ObjectDetector.ObjectDetectorOptions
ObjectDetector แบบคงที่
createFromFile (บริบทบริบท สตริง modelPath)
สร้างอินสแตนซ์ ObjectDetector จาก ObjectDetector.ObjectDetectorOptions เริ่มต้น
ObjectDetector แบบคงที่
createFromFile ( ไฟล์ โมเดลไฟล์)
สร้างอินสแตนซ์ ObjectDetector จาก ObjectDetector.ObjectDetectorOptions เริ่มต้น
ObjectDetector แบบคงที่
createFromFileAndOptions (บริบทบริบท ตัวเลือก modelPath สตริง ตัว เลือก ObjectDetector.ObjectDetectorOptions )
สร้างอินสแตนซ์ ObjectDetector จาก ObjectDetector.ObjectDetectorOptions
ObjectDetector แบบคงที่
createFromFileAndOptions ( ตัวเลือก ไฟล์ modelFile, ObjectDetector.ObjectDetectorOptions )
สร้างอินสแตนซ์ ObjectDetector จาก ObjectDetector.ObjectDetectorOptions
รายการ < การตรวจจับ >
ตรวจจับ (ภาพ MlImage )
ดำเนินการตรวจจับจริงบน MlImage ที่ให้มา
รายการ < การตรวจจับ >
ตรวจจับ (รูปภาพ TensorImage , ตัวเลือก ImageProcessingOptions )
ทำการตรวจจับจริงบนภาพที่ให้มา
รายการ < การตรวจจับ >
ตรวจจับ (รูปภาพ MlImage , ตัวเลือก ImageProcessingOptions )
ดำเนินการตรวจจับจริงบน MlImage ที่ให้มาพร้อมกับ ImageProcessingOptions
รายการ < การตรวจจับ >
ตรวจจับ (ภาพ TensorImage )
ทำการตรวจจับจริงบนภาพที่ให้มา

วิธีการสืบทอด

วิธีการสาธารณะ

ObjectDetector แบบคงที่สาธารณะ createFromBuffer ( ByteBuffer modelBuffer)

สร้างอินสแตนซ์ ObjectDetector ด้วยบัฟเฟอร์โมเดลและ ObjectDetector.ObjectDetectorOptions เริ่มต้น

พารามิเตอร์
modelBuffer ByteBuffer โดยตรงหรือ MappedByteBuffer ของโมเดลการตรวจจับ
ขว้าง
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย หากบัฟเฟอร์โมเดลไม่ใช่ ByteBuffer โดยตรงหรือ MappedByteBuffer * @throws IllegalStateException หากมีข้อผิดพลาดภายใน
RuntimeException หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น

ObjectDetector แบบคงที่สาธารณะ createFromBufferAndOptions (ตัวเลือก ByteBuffer modelBuffer, ObjectDetector.ObjectDetectorOptions )

สร้างอินสแตนซ์ ObjectDetector ด้วยบัฟเฟอร์โมเดลและ ObjectDetector.ObjectDetectorOptions

พารามิเตอร์
modelBuffer ByteBuffer โดยตรงหรือ MappedByteBuffer ของโมเดลการตรวจจับ
ตัวเลือก
ขว้าง
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย หากบัฟเฟอร์โมเดลไม่ใช่ ByteBuffer โดยตรงหรือ MappedByteBuffer
IllegalStateException หากมีข้อผิดพลาดภายใน
RuntimeException หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น

ObjectDetector แบบคงที่สาธารณะ createFromFile (บริบทบริบท, String modelPath)

สร้างอินสแตนซ์ ObjectDetector จาก ObjectDetector.ObjectDetectorOptions เริ่มต้น

พารามิเตอร์
บริบท
โมเดลพาธ เส้นทางไปยังโมเดลการตรวจจับพร้อมข้อมูลเมตาในเนื้อหา
ขว้าง
IOข้อยกเว้น หากมีข้อผิดพลาด I/O เกิดขึ้นเมื่อโหลดโมเดล tflite
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย ถ้าอาร์กิวเมนต์ไม่ถูกต้อง
IllegalStateException หากมีข้อผิดพลาดภายใน
RuntimeException หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น

ObjectDetector แบบคงที่สาธารณะ createFromFile ( ไฟล์ modelFile)

สร้างอินสแตนซ์ ObjectDetector จาก ObjectDetector.ObjectDetectorOptions เริ่มต้น

พารามิเตอร์
modelFile อินสแตนซ์ File โมเดลการตรวจจับ
ขว้าง
IOข้อยกเว้น หากมีข้อผิดพลาด I/O เกิดขึ้นเมื่อโหลดโมเดล tflite
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย ถ้าอาร์กิวเมนต์ไม่ถูกต้อง
IllegalStateException หากมีข้อผิดพลาดภายใน
RuntimeException หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น

ObjectDetector แบบคงที่สาธารณะ createFromFileAndOptions (บริบทบริบท ตัวเลือก modelPath สตริง ตัว เลือก ObjectDetector.ObjectDetectorOptions )

สร้างอินสแตนซ์ ObjectDetector จาก ObjectDetector.ObjectDetectorOptions

พารามิเตอร์
บริบท
โมเดลพาธ เส้นทางไปยังโมเดลการตรวจจับพร้อมข้อมูลเมตาในเนื้อหา
ตัวเลือก
ขว้าง
IOข้อยกเว้น หากมีข้อผิดพลาด I/O เกิดขึ้นเมื่อโหลดโมเดล tflite
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย ถ้าอาร์กิวเมนต์ไม่ถูกต้อง
IllegalStateException หากมีข้อผิดพลาดภายใน
RuntimeException หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น

ObjectDetector แบบคงที่สาธารณะ createFromFileAndOptions (ตัวเลือก ไฟล์ modelFile, ObjectDetector.ObjectDetectorOptions )

สร้างอินสแตนซ์ ObjectDetector จาก ObjectDetector.ObjectDetectorOptions

พารามิเตอร์
modelFile อินสแตนซ์ File โมเดลการตรวจจับ
ตัวเลือก
ขว้าง
IOข้อยกเว้น หากมีข้อผิดพลาด I/O เกิดขึ้นเมื่อโหลดโมเดล tflite
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย ถ้าอาร์กิวเมนต์ไม่ถูกต้อง
IllegalStateException หากมีข้อผิดพลาดภายใน
RuntimeException หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น

รายการ สาธารณะ < การตรวจจับ > ตรวจจับ (ภาพ MlImage )

ดำเนินการตรวจจับจริงบน MlImage ที่ให้มา

พารามิเตอร์
ภาพ วัตถุ MlImage ที่แสดงถึงรูปภาพ
ขว้าง
IllegalStateException หากมีข้อผิดพลาดภายใน
RuntimeException หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย หากไม่รองรับประเภทการจัดเก็บหรือรูปแบบของรูปภาพ

รายการ สาธารณะ < การตรวจจับ > ตรวจจับ (รูปภาพ TensorImage , ตัวเลือก ImageProcessingOptions )

ทำการตรวจจับจริงบนภาพที่ให้มา

ObjectDetector รองรับประเภทพื้นที่สี TensorImage ต่อไปนี้:

ObjectDetector รองรับตัวเลือกต่อไปนี้:

พารามิเตอร์
ภาพ วัตถุ UINT8 TensorImage ที่แสดงภาพ RGB หรือ YUV
ตัวเลือก ตัวเลือกในการกำหนดค่าวิธีประมวลผลภาพล่วงหน้า
ขว้าง
IllegalStateException หากมีข้อผิดพลาดภายใน
RuntimeException หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย หากไม่รองรับประเภทปริภูมิสีของรูปภาพ

รายการ สาธารณะ < การตรวจจับ > ตรวจจับ (รูปภาพ MlImage , ตัวเลือก ImageProcessingOptions )

ดำเนินการตรวจจับจริงบน MlImage ที่ให้มาพร้อมกับ ImageProcessingOptions

ObjectDetector รองรับตัวเลือกต่อไปนี้:

พารามิเตอร์
ภาพ วัตถุ MlImage ที่แสดงถึงรูปภาพ
ตัวเลือก ตัวเลือกในการกำหนดค่าวิธีประมวลผลภาพล่วงหน้า
ขว้าง
IllegalStateException หากมีข้อผิดพลาดภายใน
RuntimeException หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย หากไม่รองรับประเภทการจัดเก็บหรือรูปแบบของรูปภาพ

รายการ สาธารณะ < การตรวจจับ > ตรวจจับ (ภาพ TensorImage )

ทำการตรวจจับจริงบนภาพที่ให้มา

ObjectDetector รองรับประเภทพื้นที่สี TensorImage ต่อไปนี้:

พารามิเตอร์
ภาพ วัตถุ UINT8 TensorImage ที่แสดงภาพ RGB หรือ YUV
ขว้าง
IllegalStateException หากมีข้อผิดพลาดภายใน
RuntimeException หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย หากไม่รองรับประเภทปริภูมิสีของรูปภาพ