ImageSearcher

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

ทำการค้นหาความคล้ายคลึงกันบนรูปภาพ

API คาดว่าจะมีโมเดล TFLite พร้อมด้วย ข้อมูลเมตาของโมเดล TFLite ที่ไม่บังคับ แต่แนะนำอย่างยิ่ง .

  • อินพุตอิมเมจเทนเซอร์ ( kTfLiteUInt8 / kTfLiteFloat32 )
    • อินพุตรูปภาพขนาด [batch x height x width x channels]
    • ไม่รองรับการอนุมานแบบแบตช์ ( batch ต้องเป็น 1)
    • รองรับเฉพาะอินพุต RGB ( channels ต้องเป็น 3)
    • หากประเภทเป็น kTfLiteFloat32 จำเป็นต้องแนบ NormalizationOptions กับข้อมูลเมตาเพื่อทำให้อินพุตเป็นมาตรฐาน
  • เทนเซอร์เอาท์พุต ( kTfLiteUInt8 / kTfLiteFloat32 )
    • ส่วนประกอบ N ที่สอดคล้องกับมิติ N ของเวกเตอร์คุณลักษณะที่ส่งคืนสำหรับเลเยอร์เอาต์พุตนี้
    • 2 หรือ 4 มิติ เช่น [1 x N] หรือ [1 x 1 x 1 x N]

TODO(b/180502532): เพิ่มตัวชี้ไปที่โมเดลตัวอย่าง

TODO(b/222671076): เพิ่มวิธีการสร้างจากโรงงานโดยไม่มีตัวเลือก เช่น `createFromFile` เมื่อรองรับรูปแบบไฟล์เดียว (ไฟล์ดัชนีที่บรรจุในโมเดล)

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

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

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

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

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

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

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

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

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

ImageSearcher แบบคงที่สาธารณะ createFromBufferAndOptionsImpl ( ByteBuffer modelBuffer, ตัวเลือก ImageSearcher.ImageSearcherOptions , int indexFd)

พารามิเตอร์
modelBuffer
ตัวเลือก
ดัชนีFd

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

สร้างอินสแตนซ์ ImageSearcher จาก ImageSearcher.ImageSearcherOptions

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

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

สร้างอินสแตนซ์ ImageSearcher

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

รายการ สาธารณะ < NearestNeighbor > ค้นหา (รูปภาพ TensorImage , ตัวเลือก ImageProcessingOptions )

ดำเนินการแยกการฝังบน TensorImage ที่มี ImageProcessingOptions ที่ให้มา ตามด้วยการค้นหาเพื่อนบ้านที่ใกล้ที่สุดในดัชนี

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

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

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

รายการ สาธารณะ < NearestNeighbor > ค้นหา (ภาพ MlImage )

ดำเนินการแยกการฝังบน MlImage ที่ให้มา ตามด้วยการค้นหาเพื่อนบ้านที่ใกล้ที่สุดในดัชนี

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

รายการ สาธารณะ < NearestNeighbor > ค้นหา (รูปภาพ MlImage , ตัวเลือก ImageProcessingOptions )

ดำเนินการแยกการฝังบน MlImage ที่มี ImageProcessingOptions ที่ให้มา ตามด้วยการค้นหาเพื่อนบ้านที่ใกล้ที่สุดในดัชนี

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

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

รายการ สาธารณะ < NearestNeighbor > ค้นหา (รูปภาพ TensorImage )

ดำเนินการแยกการฝังบน TensorImage ที่ให้มา ตามด้วยการค้นหาเพื่อนบ้านที่ใกล้ที่สุดในดัชนี

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

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