تشخیص اشیا را روی تصاویر انجام می دهد.
API انتظار دارد یک مدل TFLite با فراداده مدل TFLite باشد. .
API از مدل هایی با یک تانسور ورودی تصویر و چهار تانسور خروجی پشتیبانی می کند. برای دقیق تر، در اینجا الزامات وجود دارد.
- تانسور تصویر ورودی (
kTfLiteUInt8
/kTfLiteFloat32
)- اندازه ورودی تصویر
[batch x height x width x channels]
. - استنتاج دسته ای پشتیبانی نمی شود (
batch
باید 1 باشد). - فقط ورودی های RGB پشتیبانی می شوند (
channels
باید 3 باشند). - اگر نوع
kTfLiteFloat32
باشد، برای عادی سازی ورودی، باید گزینه های Normalization به ابرداده متصل شوند.
- اندازه ورودی تصویر
DetectionPostProcess
باشند، یعنی:- تانسور مکان (
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
پیش فرض ایجاد می کند.
مولفه های
مدل بافر | یک ByteBuffer مستقیم یا یک MappedByteBuffer مدل تشخیص |
---|
پرتاب می کند
IllegalArgumentException | اگر بافر مدل یک ByteBuffer مستقیم یا یک MappedByteBuffer نباشد * در صورت وجود خطای داخلی، @ را IllegalStateException می کند |
---|---|
RuntimeException | اگر خطای نامشخص دیگری وجود داشته باشد |
عمومی استاتیک ObjectDetector createFromBufferAndOptions (گزینه های ByteBuffer modelBuffer، ObjectDetector.ObjectDetectorOptions )
یک نمونه ObjectDetector
با بافر مدل و ObjectDetector.ObjectDetectorOptions
ایجاد می کند.
مولفه های
مدل بافر | یک ByteBuffer مستقیم یا یک MappedByteBuffer مدل تشخیص |
---|---|
گزینه ها |
پرتاب می کند
IllegalArgumentException | اگر بافر مدل یک ByteBuffer مستقیم یا MappedByteBuffer نباشد |
---|---|
IllegalStateException | اگر یک خطای داخلی وجود داشته باشد |
RuntimeException | اگر خطای نامشخص دیگری وجود داشته باشد |
عمومی استاتیک ObjectDetector createFromFile (متن زمینه، رشته مدلPath)
یک نمونه ObjectDetector
از ObjectDetector.ObjectDetectorOptions
پیش فرض ایجاد می کند.
مولفه های
متن نوشته | |
---|---|
modelPath | مسیر به مدل تشخیص با ابرداده در دارایی ها |
پرتاب می کند
IOException | اگر هنگام بارگذاری مدل tflite خطای I/O رخ دهد |
---|---|
IllegalArgumentException | اگر آرگومان نامعتبر باشد |
IllegalStateException | اگر خطای داخلی وجود داشته باشد |
RuntimeException | اگر خطای نامشخص دیگری وجود داشته باشد |
عمومی استاتیک ObjectDetector createFromFile ( فایل modelFile)
یک نمونه ObjectDetector
از ObjectDetector.ObjectDetectorOptions
پیش فرض ایجاد می کند.
مولفه های
modelFile | نمونه File مدل تشخیص |
---|
پرتاب می کند
IOException | اگر هنگام بارگذاری مدل tflite خطای I/O رخ دهد |
---|---|
IllegalArgumentException | اگر آرگومان نامعتبر باشد |
IllegalStateException | اگر خطای داخلی وجود داشته باشد |
RuntimeException | اگر خطای نامشخص دیگری وجود داشته باشد |
عمومی استاتیک ObjectDetector createFromFileAndOptions (متن زمینه، رشته مدلPath، گزینه ObjectDetector.ObjectDetectorOptions )
یک نمونه ObjectDetector
از ObjectDetector.ObjectDetectorOptions
ایجاد می کند.
مولفه های
متن نوشته | |
---|---|
modelPath | مسیر به مدل تشخیص با ابرداده در دارایی ها |
گزینه ها |
پرتاب می کند
IOException | اگر هنگام بارگذاری مدل tflite خطای I/O رخ دهد |
---|---|
IllegalArgumentException | اگر آرگومان نامعتبر باشد |
IllegalStateException | اگر خطای داخلی وجود داشته باشد |
RuntimeException | اگر خطای نامشخص دیگری وجود داشته باشد |
عمومی استاتیک ObjectDetector createFromFileAndOptions (گزینه های File modelFile، ObjectDetector.ObjectDetectorOptions )
یک نمونه ObjectDetector
از ObjectDetector.ObjectDetectorOptions
ایجاد می کند.
مولفه های
modelFile | نمونه File مدل تشخیص |
---|---|
گزینه ها |
پرتاب می کند
IOException | اگر هنگام بارگذاری مدل tflite خطای I/O رخ دهد |
---|---|
IllegalArgumentException | اگر آرگومان نامعتبر باشد |
IllegalStateException | اگر خطای داخلی وجود داشته باشد |
RuntimeException | اگر خطای نامشخص دیگری وجود داشته باشد |
فهرست عمومی < تشخیص > شناسایی (تصویر MlImage )
تشخیص واقعی را در MlImage
ارائه شده انجام می دهد.
مولفه های
تصویر | یک شی MlImage که یک تصویر را نشان می دهد |
---|
پرتاب می کند
IllegalStateException | اگر خطای داخلی وجود داشته باشد |
---|---|
RuntimeException | اگر خطای نامشخص دیگری وجود داشته باشد |
IllegalArgumentException | اگر نوع ذخیره سازی یا فرمت تصویر پشتیبانی نمی شود |
فهرست عمومی < تشخیص > تشخیص (تصویر TensorImage ، گزینه های ImageProcessingOptions )
تشخیص واقعی را روی تصویر ارائه شده انجام می دهد.
ObjectDetector
از انواع فضای رنگی TensorImage
زیر پشتیبانی می کند:
ObjectDetector
از گزینه های زیر پشتیبانی می کند:
- چرخش تصویر (از طریق
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). پیشفرض آنImageProcessingOptions.Orientation.TOP_LEFT
است.
مولفه های
تصویر | یک شی UINT8 TensorImage که یک تصویر RGB یا YUV را نشان می دهد |
---|---|
گزینه ها | گزینه هایی برای پیکربندی نحوه پیش پردازش تصویر |
پرتاب می کند
IllegalStateException | اگر یک خطای داخلی وجود داشته باشد |
---|---|
RuntimeException | اگر خطای نامشخص دیگری وجود داشته باشد |
IllegalArgumentException | اگر نوع فضای رنگی تصویر پشتیبانی نشود |
فهرست عمومی < تشخیص > شناسایی (تصویر MlImage ، گزینه های ImageProcessingOptions )
تشخیص واقعی MlImage
ارائه شده را با ImageProcessingOptions
انجام می دهد.
ObjectDetector
از گزینه های زیر پشتیبانی می کند:
- چرخش تصویر (از طریق
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). پیشفرض آنImageProcessingOptions.Orientation.TOP_LEFT
است.MlImage.getRotation()
موثر نیست.
مولفه های
تصویر | یک شی MlImage که یک تصویر را نشان می دهد |
---|---|
گزینه ها | گزینه هایی برای پیکربندی نحوه پیش پردازش تصویر |
پرتاب می کند
IllegalStateException | اگر یک خطای داخلی وجود داشته باشد |
---|---|
RuntimeException | اگر خطای نامشخص دیگری وجود داشته باشد |
IllegalArgumentException | اگر نوع ذخیره سازی یا فرمت تصویر پشتیبانی نمی شود |
فهرست عمومی < تشخیص > تشخیص (تصویر TensorImage )
تشخیص واقعی را روی تصویر ارائه شده انجام می دهد.
ObjectDetector
از انواع فضای رنگی TensorImage
زیر پشتیبانی می کند:
مولفه های
تصویر | یک شی UINT8 TensorImage که یک تصویر RGB یا YUV را نشان می دهد |
---|
پرتاب می کند
IllegalStateException | اگر یک خطای داخلی وجود داشته باشد |
---|---|
RuntimeException | اگر خطای نامشخص دیگری وجود داشته باشد |
IllegalArgumentException | اگر نوع فضای رنگی تصویر پشتیبانی نشود |