ดำเนินการจัดหมวดหมู่ภาพ
API คาดว่าจะมีโมเดล TFLite พร้อมด้วย ข้อมูลเมตาของโมเดล TFLite ที่ไม่บังคับ แต่แนะนำอย่างยิ่ง .
API รองรับโมเดลที่มีเทนเซอร์อินพุตรูปภาพหนึ่งตัวและเทนเซอร์เอาท์พุตการจำแนกประเภทหนึ่งตัว เพื่อให้เจาะจงยิ่งขึ้น นี่คือข้อกำหนด
- อินพุตอิมเมจเทนเซอร์ (
kTfLiteUInt8
/kTfLiteFloat32
)- อินพุตรูปภาพขนาด
[batch x height x width x channels]
- ไม่รองรับการอนุมานแบบแบตช์ (
batch
ต้องเป็น 1) - รองรับเฉพาะอินพุต RGB (
channels
ต้องเป็น 3) - หากประเภทเป็น
kTfLiteFloat32
จำเป็นต้องแนบ NormalizationOptions กับข้อมูลเมตาเพื่อทำให้อินพุตเป็นมาตรฐาน
- อินพุตรูปภาพขนาด
kTfLiteUInt8
/ kTfLiteFloat32
)- มีคลาส
N
2 หรือ 4 มิติ เช่น[1 x N]
หรือ[1 x 1 x 1 x N]
- จำเป็นต้องบรรจุไฟล์ป้ายกำกับลงในข้อมูลเมตา ดู ตัวอย่างการสร้างข้อมูลเมตาสำหรับตัวแยกประเภทรูปภาพ หากไม่มีการบรรจุไฟล์ป้ายกำกับ ระบบจะใช้ดัชนีเป็นป้ายกำกับในผลลัพธ์
ตัวอย่างของโมเดลดังกล่าวมีอยู่ใน TensorFlow Hub .
คลาสที่ซ้อนกัน
ระดับ | ImageClassifier.ImageClassifierOptions | ตัวเลือกสำหรับการตั้งค่า ImageClassifier |
วิธีการสาธารณะ
วิธีการสืบทอด
วิธีการสาธารณะ
รายการ สาธารณะ < การจำแนกประเภท > จัดประเภท (ภาพ TensorImage )
ดำเนินการจัดหมวดหมู่ตามจริงบน TensorImage
ที่ให้มา
ImageClassifier
รองรับประเภทพื้นที่สี TensorImage
ต่อไปนี้:
พารามิเตอร์
ภาพ | วัตถุ UINT8 TensorImage ที่แสดงภาพ RGB หรือ YUV |
---|
ขว้าง
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | หากไม่รองรับประเภทปริภูมิสีของรูปภาพ |
---|
รายการ สาธารณะ < การจำแนกประเภท > จัดประเภท (รูปภาพ TensorImage , ตัวเลือก ImageProcessingOptions )
ดำเนินการจัดหมวดหมู่ตามจริงบน TensorImage
ที่ให้มาพร้อมกับ ImageProcessingOptions
ImageClassifier
รองรับตัวเลือกต่อไปนี้:
- ภูมิภาคที่สนใจ (ROI) (ผ่าน
ImageProcessingOptions.Builder.setRoi(Rect)
) โดยค่าเริ่มต้นจะเป็นทั้งภาพ - การหมุนภาพ (ผ่าน
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
) โดยค่าเริ่มต้นจะเป็นImageProcessingOptions.Orientation.TOP_LEFT
ImageClassifier
รองรับประเภทพื้นที่สี TensorImage
ต่อไปนี้:
พารามิเตอร์
ภาพ | วัตถุ UINT8 TensorImage ที่แสดงภาพ RGB หรือ YUV |
---|---|
ตัวเลือก |
ขว้าง
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | หากไม่รองรับประเภทปริภูมิสีของรูปภาพ |
---|
รายการ สาธารณะ < การจำแนกประเภท > จัดประเภท (ภาพ MlImage )
ดำเนินการจัดหมวดหมู่จริงบน MlImage
ที่ให้มา
พารามิเตอร์
ภาพ | วัตถุ MlImage ที่แสดงถึงรูปภาพ |
---|
ขว้าง
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | หากไม่รองรับประเภทการจัดเก็บหรือรูปแบบของรูปภาพ |
---|
รายการ สาธารณะ < การจัดหมวด หมู่ > จัดประเภท (รูปภาพ MlImage , ตัวเลือก ImageProcessingOptions )
ดำเนินการจัดหมวดหมู่จริงบน MlImage
ที่ให้มาพร้อมกับ ImageProcessingOptions
ImageClassifier
รองรับตัวเลือกต่อไปนี้:
- ภูมิภาคที่สนใจ (ROI) (ผ่าน
ImageProcessingOptions.Builder.setRoi(Rect)
) โดยค่าเริ่มต้นจะเป็นทั้งภาพ - การหมุนภาพ (ผ่าน
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
) โดยค่าเริ่มต้นจะเป็นImageProcessingOptions.Orientation.TOP_LEFT
MlImage.getRotation()
ไม่มีประสิทธิผล
พารามิเตอร์
ภาพ | วัตถุ MlImage ที่แสดงถึงรูปภาพ |
---|---|
ตัวเลือก | กำหนดค่าตัวเลือกรวมถึง ROI และการหมุน |
ขว้าง
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | หากไม่รองรับประเภทการจัดเก็บหรือรูปแบบของรูปภาพ |
---|
ImageClassifier แบบคงที่สาธารณะ createFromBuffer ( ByteBuffer modelBuffer)
สร้างอินสแตนซ์ ImageClassifier
ด้วยบัฟเฟอร์โมเดลและ ImageClassifier.ImageClassifierOptions
ดีฟอลต์
พารามิเตอร์
modelBuffer | ByteBuffer โดยตรงหรือ MappedByteBuffer ของโมเดลการจัดหมวดหมู่ |
---|
ขว้าง
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | หากบัฟเฟอร์โมเดลไม่ใช่ ByteBuffer โดยตรงหรือ MappedByteBuffer |
---|---|
IllegalStateException | หากมีข้อผิดพลาดภายใน |
RuntimeException | หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น |
ImageClassifier แบบคงที่สาธารณะ createFromBufferAndOptions (ตัวเลือก ByteBuffer modelBuffer, ImageClassifier.ImageClassifierOptions )
สร้างอินสแตนซ์ ImageClassifier
ด้วยบัฟเฟอร์โมเดลและ ImageClassifier.ImageClassifierOptions
พารามิเตอร์
modelBuffer | ByteBuffer โดยตรงหรือ MappedByteBuffer ของโมเดลการจัดหมวดหมู่ |
---|---|
ตัวเลือก |
ขว้าง
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | หากบัฟเฟอร์โมเดลไม่ใช่ ByteBuffer โดยตรงหรือ MappedByteBuffer |
---|---|
IllegalStateException | หากมีข้อผิดพลาดภายใน |
RuntimeException | หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น |
ImageClassifier แบบคงที่สาธารณะ createFromFile (บริบทบริบท, String modelPath)
สร้างอินสแตนซ์ ImageClassifier
จาก ImageClassifier.ImageClassifierOptions
ดีฟอลต์
พารามิเตอร์
บริบท | |
---|---|
โมเดลพาธ | เส้นทางของโมเดลการจัดหมวดหมู่พร้อมข้อมูลเมตาในเนื้อหา |
ขว้าง
IOข้อยกเว้น | หากมีข้อผิดพลาด I/O เกิดขึ้นเมื่อโหลดโมเดล tflite |
---|---|
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | ถ้าอาร์กิวเมนต์ไม่ถูกต้อง |
IllegalStateException | หากมีข้อผิดพลาดภายใน |
RuntimeException | หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น |
ImageClassifier แบบคงที่สาธารณะ createFromFile ( ไฟล์ modelFile)
สร้างอินสแตนซ์ ImageClassifier
จาก ImageClassifier.ImageClassifierOptions
ดีฟอลต์
พารามิเตอร์
modelFile | ตัวอย่าง File แบบจำลองการจำแนกประเภท |
---|
ขว้าง
IOข้อยกเว้น | หากมีข้อผิดพลาด I/O เกิดขึ้นเมื่อโหลดโมเดล tflite |
---|---|
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | ถ้าอาร์กิวเมนต์ไม่ถูกต้อง |
IllegalStateException | หากมีข้อผิดพลาดภายใน |
RuntimeException | หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น |
ImageClassifier แบบคงที่สาธารณะ createFromFileAndOptions (บริบทบริบท, สตริง modelPath, ตัวเลือก ImageClassifier.ImageClassifierOptions )
สร้างอิน ImageClassifier
จาก ImageClassifier.ImageClassifierOptions
พารามิเตอร์
บริบท | |
---|---|
โมเดลพาธ | เส้นทางของโมเดลการจัดหมวดหมู่พร้อมข้อมูลเมตาในเนื้อหา |
ตัวเลือก |
ขว้าง
IOข้อยกเว้น | หากมีข้อผิดพลาด I/O เกิดขึ้นเมื่อโหลดโมเดล tflite |
---|---|
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | ถ้าอาร์กิวเมนต์ไม่ถูกต้อง |
IllegalStateException | หากมีข้อผิดพลาดภายใน |
RuntimeException | หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น |
ImageClassifier แบบคงที่สาธารณะ createFromFileAndOptions (ตัวเลือก ไฟล์ modelFile, ImageClassifier.ImageClassifierOptions )
สร้าง ImageClassifier
พารามิเตอร์
modelFile | ตัวอย่าง File แบบจำลองการจำแนกประเภท |
---|---|
ตัวเลือก |
ขว้าง
IOข้อยกเว้น | หากมีข้อผิดพลาด I/O เกิดขึ้นเมื่อโหลดโมเดล tflite |
---|---|
ข้อยกเว้นอาร์กิวเมนต์ที่ผิดกฎหมาย | ถ้าอาร์กิวเมนต์ไม่ถูกต้อง |
IllegalStateException | หากมีข้อผิดพลาดภายใน |
RuntimeException | หากมีข้อผิดพลาดที่ไม่ได้ระบุเป็นอย่างอื่น |