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.ImageSearcher옵션 ImageSearcher 설정 옵션.

공개 방법

정적 이미지 검색기
createFromBufferAndOptions ( ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions 옵션)
모델 버퍼와 ImageSearcher.ImageSearcherOptions 사용하여 ImageSearcher 인스턴스를 생성합니다.
정적 이미지 검색기
정적 이미지 검색기
createFromFileAndOptions (컨텍스트 컨텍스트, 문자열 modelPath, ImageSearcher.ImageSearcherOptions 옵션)
ImageSearcher.ImageSearcherOptions 에서 ImageSearcher 인스턴스를 만듭니다.
정적 이미지 검색기
createFromFileAndOptions ( 파일 모델파일, ImageSearcher.ImageSearcherOptions 옵션)
ImageSearcher 인스턴스를 만듭니다.
목록 < 가장 가까운 이웃 >
검색 ( TensorImage 이미지, ImageProcessingOptions 옵션)
ImageProcessingOptions 사용하여 제공된 TensorImage 에서 임베딩 추출을 수행한 다음 인덱스에서 최근접 이웃 검색을 수행합니다.
목록 < 가장 가까운 이웃 >
검색 ( MlImage 이미지)
제공된 MlImage 에서 임베딩 추출을 수행한 후 인덱스에서 최근접 이웃 검색을 수행합니다.
목록 < 가장 가까운 이웃 >
검색 ( MlImage 이미지, ImageProcessingOptions 옵션)
ImageProcessingOptions 사용하여 제공된 MlImage 에서 임베딩 추출을 수행한 후 인덱스에서 최근접 검색을 수행합니다.
목록 < 가장 가까운 이웃 >
검색 ( TensorImage 이미지)
제공된 TensorImage 에서 임베딩 추출을 수행한 후 인덱스에서 최근접 이웃 검색을 수행합니다.

상속된 메서드

공개 방법

공개 정적 ImageSearcher createFromBufferAndOptions ( ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions 옵션)

모델 버퍼와 ImageSearcher.ImageSearcherOptions 사용하여 ImageSearcher 인스턴스를 생성합니다.

매개변수
모델버퍼 검색 모델의 직접 ByteBuffer 또는 MappedByteBuffer
옵션
던지기
IllegalArgumentException 모델 버퍼가 직접 ByteBuffer 또는 MappedByteBuffer 가 아닌 경우
IO예외 인덱스 파일을 로드할 때 I/O 오류가 발생하는 경우
IllegalStateException 내부 오류가 있는 경우
런타임예외 달리 명시되지 않은 오류가 있는 경우

공개 정적 ImageSearcher createFromBufferAndOptionsImpl ( ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions 옵션, int indexFd)

매개변수
모델버퍼
옵션
indexFd

공개 정적 ImageSearcher createFromFileAndOptions (컨텍스트 컨텍스트, 문자열 modelPath, ImageSearcher.ImageSearcherOptions 옵션)

ImageSearcher.ImageSearcherOptions 에서 ImageSearcher 인스턴스를 만듭니다.

매개변수
문맥
모델경로 자산의 메타데이터가 있는 검색 모델의 경로
옵션
던지기
IO예외 tflite 모델이나 인덱스 파일을 로드할 때 I/O 오류가 발생하는 경우
IllegalArgumentException 인수가 유효하지 않은 경우
IllegalStateException 내부 오류가 있는 경우
런타임예외 달리 명시되지 않은 오류가 있는 경우

공개 정적 ImageSearcher createFromFileAndOptions ( 파일 모델파일, ImageSearcher.ImageSearcherOptions 옵션)

ImageSearcher 인스턴스를 만듭니다.

매개변수
모델파일 검색 모델 File 인스턴스
옵션
던지기
IO예외 tflite 모델이나 인덱스 파일을 로드할 때 I/O 오류가 발생하는 경우
IllegalArgumentException 인수가 유효하지 않은 경우
IllegalStateException 내부 오류가 있는 경우
런타임예외 달리 명시되지 않은 오류가 있는 경우

공개 목록 < NearestNeighbor > 검색 ( TensorImage 이미지, ImageProcessingOptions 옵션)

ImageProcessingOptions 사용하여 제공된 TensorImage 에서 임베딩 추출을 수행한 다음 인덱스에서 최근접 이웃 검색을 수행합니다.

ImageSearcher 다음 옵션을 지원합니다.

ImageSearcher 다음 TensorImage 색상 공간 유형을 지원합니다.

매개변수
영상 RGB 또는 YUV 이미지를 나타내는 UINT8 TensorImage 객체
옵션
던지기
IllegalArgumentException 이미지의 색상 공간 유형이 지원되지 않는 경우

공개 목록 < NearestNeighbor > 검색 ( MlImage 이미지)

제공된 MlImage 에서 임베딩 추출을 수행한 후 인덱스에서 최근접 이웃 검색을 수행합니다.

매개변수
영상 이미지를 나타내는 MlImage 객체
던지기
IllegalArgumentException 이미지의 저장 유형이나 형식이 지원되지 않는 경우

공개 목록 < NearestNeighbor > 검색 ( MlImage 이미지, ImageProcessingOptions 옵션)

ImageProcessingOptions 사용하여 제공된 MlImage 에서 임베딩 추출을 수행한 후 인덱스에서 최근접 검색을 수행합니다.

ImageSearcher 다음 옵션을 지원합니다.

매개변수
영상 이미지를 나타내는 MlImage 객체
옵션 ROI 및 회전을 포함한 옵션 구성
던지기
IllegalArgumentException 이미지의 저장 유형이나 형식이 지원되지 않는 경우

공개 목록 < NearestNeighbor > 검색 ( TensorImage 이미지)

제공된 TensorImage 에서 임베딩 추출을 수행한 후 인덱스에서 최근접 이웃 검색을 수행합니다.

ImageSearcher 다음 TensorImage 색상 공간 유형을 지원합니다.

매개변수
영상 RGB 또는 YUV 이미지를 나타내는 UINT8 TensorImage 객체
던지기
IllegalArgumentException 이미지의 색상 공간 유형이 지원되지 않는 경우