ImageSearcher

کلاس نهایی عمومی ImageSearcher

جستجوی شباهت را روی تصاویر انجام می دهد.

API انتظار دارد یک مدل TFLite با فراداده مدل TFLite اختیاری، اما به شدت توصیه شده باشد. .

  • تانسور تصویر ورودی ( kTfLiteUInt8 / kTfLiteFloat32 )
    • اندازه ورودی تصویر [batch x height x width x channels] .
    • استنتاج دسته ای پشتیبانی نمی شود ( batch باید 1 باشد).
    • فقط ورودی های RGB پشتیبانی می شوند ( channels باید 3 باشند).
    • اگر نوع kTfLiteFloat32 باشد، برای عادی سازی ورودی، باید گزینه های Normalization به ابرداده متصل شوند.
  • تانسور خروجی ( 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.

روش های عمومی

جستجوگر تصاویر ثابت
createFromBufferAndOptions (گزینه های ByteBuffer modelBuffer، ImageSearcher.ImageSearcherOptions )
یک نمونه ImageSearcher با بافر مدل و ImageSearcher.ImageSearcherOptions ایجاد می کند.
جستجوگر تصاویر ثابت
createFromBufferAndOptionsImpl ( ByteBuffer modelBuffer، ImageSearcher.ImageSearcherOptions گزینه ها، int indexFd)
جستجوگر تصاویر ثابت
createFromFileAndOptions (متن زمینه، رشته modelPath، گزینه ImageSearcher.ImageSearcherOptions )
یک نمونه ImageSearcher از ImageSearcher.ImageSearcherOptions ایجاد می کند.
جستجوگر تصاویر ثابت
createFromFileAndOptions (گزینه های File modelFile، ImageSearcher.ImageSearcherOptions )
یک نمونه ImageSearcher ایجاد می کند.
فهرست < نزدیکترین همسایه >
جستجو (تصویر TensorImage ، گزینه های ImageProcessingOptions )
استخراج تعبیه شده را روی TensorImage ارائه شده با ImageProcessingOptions انجام می دهد و به دنبال آن جستجوی نزدیکترین همسایه در فهرست انجام می شود.
فهرست < نزدیکترین همسایه >
جستجو (تصویر MlImage )
استخراج تعبیه شده را روی MlImage ارائه شده انجام می دهد و به دنبال آن جستجوی نزدیکترین همسایه در ایندکس انجام می شود.
فهرست < نزدیکترین همسایه >
جستجو (تصویر MlImage ، گزینه های ImageProcessingOptions )
استخراج تعبیه شده را روی MlImage ارائه شده با ImageProcessingOptions انجام می دهد و به دنبال آن جستجوی نزدیکترین همسایه در فهرست انجام می شود.
فهرست < نزدیکترین همسایه >
جستجو (تصویر TensorImage )
استخراج تعبیه شده را بر روی TensorImage ارائه شده انجام می دهد و به دنبال آن جستجوی نزدیکترین همسایه در فهرست انجام می شود.

روش های ارثی

روش های عمومی

Public Static ImageSearcher createFromBufferAndOptions (گزینه های ByteBuffer modelBuffer، ImageSearcher.ImageSearcherOptions )

یک نمونه ImageSearcher با بافر مدل و ImageSearcher.ImageSearcherOptions ایجاد می کند.

مولفه های
مدل بافر یک ByteBuffer مستقیم یا MappedByteBuffer مدل جستجو
گزینه ها
پرتاب می کند
IllegalArgumentException اگر بافر مدل یک ByteBuffer مستقیم یا MappedByteBuffer نباشد
IOException اگر هنگام بارگیری فایل فهرست، خطای I/O رخ دهد
IllegalStateException اگر یک خطای داخلی وجود داشته باشد
RuntimeException اگر خطای نامشخص دیگری وجود داشته باشد

Public Static ImageSearcher createFromBufferAndOptionsImpl ( ByteBuffer modelBuffer، ImageSearcher.ImageSearcherOptions گزینه ها، int indexFd)

مولفه های
مدل بافر
گزینه ها
indexFd

Public Static ImageSearcher createFromFileAndOptions (زمینه زمینه، رشته مدلPath، گزینه ImageSearcher.ImageSearcherOptions )

یک نمونه ImageSearcher از ImageSearcher.ImageSearcherOptions ایجاد می کند.

مولفه های
متن نوشته
modelPath مسیر مدل جستجو با ابرداده در دارایی ها
گزینه ها
پرتاب می کند
IOException اگر هنگام بارگیری مدل tflite یا فایل فهرست، خطای I/O رخ دهد
IllegalArgumentException اگر آرگومان نامعتبر باشد
IllegalStateException اگر یک خطای داخلی وجود داشته باشد
RuntimeException اگر خطای نامشخص دیگری وجود داشته باشد

Public Static ImageSearcher createFromFileAndOptions (گزینه های File modelFile، ImageSearcher.ImageSearcherOptions )

یک نمونه ImageSearcher ایجاد می کند.

مولفه های
modelFile مدل جستجو نمونه File
گزینه ها
پرتاب می کند
IOException اگر هنگام بارگیری مدل tflite یا فایل فهرست، خطای I/O رخ دهد
IllegalArgumentException اگر آرگومان نامعتبر باشد
IllegalStateException اگر یک خطای داخلی وجود داشته باشد
RuntimeException اگر خطای نامشخص دیگری وجود داشته باشد

فهرست عمومی < NearestNeighbor > جستجو (تصویر TensorImage ، گزینه های ImageProcessingOptions )

استخراج تعبیه شده را روی TensorImage ارائه شده با ImageProcessingOptions انجام می دهد و به دنبال آن جستجوی نزدیکترین همسایه در فهرست انجام می شود.

ImageSearcher از گزینه های زیر پشتیبانی می کند:

ImageSearcher از انواع فضای رنگی TensorImage زیر پشتیبانی می کند:

مولفه های
تصویر یک شی UINT8 TensorImage که یک تصویر RGB یا YUV را نشان می دهد
گزینه ها
پرتاب می کند
IllegalArgumentException اگر نوع فضای رنگی تصویر پشتیبانی نشود

فهرست عمومی < NearestNeighbor > جستجو (تصویر MlImage )

استخراج تعبیه شده را روی MlImage ارائه شده انجام می دهد و به دنبال آن جستجوی نزدیکترین همسایه در ایندکس انجام می شود.

مولفه های
تصویر یک شی MlImage که یک تصویر را نشان می دهد
پرتاب می کند
IllegalArgumentException اگر نوع ذخیره سازی یا فرمت تصویر پشتیبانی نمی شود

فهرست عمومی < NearestNeighbor > جستجو (تصویر MlImage ، گزینه های ImageProcessingOptions )

استخراج تعبیه شده را روی MlImage ارائه شده با ImageProcessingOptions انجام می دهد و به دنبال آن جستجوی نزدیکترین همسایه در فهرست انجام می شود.

ImageSearcher از گزینه های زیر پشتیبانی می کند:

مولفه های
تصویر یک شی MlImage که یک تصویر را نشان می دهد
گزینه ها گزینه هایی از جمله ROI و چرخش را پیکربندی می کند
پرتاب می کند
IllegalArgumentException اگر نوع ذخیره سازی یا فرمت تصویر پشتیبانی نمی شود

فهرست عمومی < NearestNeighbor > جستجو (تصویر TensorImage )

استخراج تعبیه شده را بر روی TensorImage ارائه شده انجام می دهد و به دنبال آن جستجوی نزدیکترین همسایه در فهرست انجام می شود.

ImageSearcher از انواع فضای رنگی TensorImage زیر پشتیبانی می کند:

مولفه های
تصویر یک شی UINT8 TensorImage که یک تصویر RGB یا YUV را نشان می دهد
پرتاب می کند
IllegalArgumentException اگر نوع فضای رنگی تصویر پشتیبانی نشود