이미지에 대한 유사성 검색을 수행합니다.
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 인스턴스를 생성합니다. |
정적 이미지 검색기 | createFromBufferAndOptionsImpl ( ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions 옵션, int indexFd) |
정적 이미지 검색기 | createFromFileAndOptions (컨텍스트 컨텍스트, 문자열 modelPath, ImageSearcher.ImageSearcherOptions 옵션) ImageSearcher.ImageSearcherOptions 에서 ImageSearcher 인스턴스를 만듭니다. |
정적 이미지 검색기 | createFromFileAndOptions ( 파일 모델파일, ImageSearcher.ImageSearcherOptions 옵션) ImageSearcher 인스턴스를 만듭니다. |
목록 < 가장 가까운 이웃 > | 검색 ( TensorImage 이미지, ImageProcessingOptions 옵션) ImageProcessingOptions 사용하여 제공된 TensorImage 에서 임베딩 추출을 수행한 다음 인덱스에서 최근접 이웃 검색을 수행합니다. |
목록 < 가장 가까운 이웃 > | |
목록 < 가장 가까운 이웃 > | 검색 ( MlImage 이미지, ImageProcessingOptions 옵션) ImageProcessingOptions 사용하여 제공된 MlImage 에서 임베딩 추출을 수행한 후 인덱스에서 최근접 검색을 수행합니다. |
목록 < 가장 가까운 이웃 > |
상속된 메서드
공개 방법
공개 정적 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
다음 옵션을 지원합니다.
- 관심 영역(ROI)(
ImageProcessingOptions.Builder.setRoi(Rect)
통해) 기본값은 전체 이미지입니다. - 이미지 회전(
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
을 통해). 기본값은ImageProcessingOptions.Orientation.TOP_LEFT
입니다.
ImageSearcher
다음 TensorImage
색상 공간 유형을 지원합니다.
매개변수
영상 | RGB 또는 YUV 이미지를 나타내는 UINT8 TensorImage 객체 |
---|---|
옵션 |
던지기
IllegalArgumentException | 이미지의 색상 공간 유형이 지원되지 않는 경우 |
---|
공개 목록 < NearestNeighbor > 검색 ( MlImage 이미지)
제공된 MlImage
에서 임베딩 추출을 수행한 후 인덱스에서 최근접 이웃 검색을 수행합니다.
매개변수
영상 | 이미지를 나타내는 MlImage 객체 |
---|
던지기
IllegalArgumentException | 이미지의 저장 유형이나 형식이 지원되지 않는 경우 |
---|
공개 목록 < NearestNeighbor > 검색 ( MlImage 이미지, ImageProcessingOptions 옵션)
ImageProcessingOptions
사용하여 제공된 MlImage
에서 임베딩 추출을 수행한 후 인덱스에서 최근접 검색을 수행합니다.
ImageSearcher
다음 옵션을 지원합니다.
- 관심 영역(ROI)(
ImageProcessingOptions.Builder.setRoi(Rect)
통해) 기본값은 전체 이미지입니다. - 이미지 회전(
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
을 통해). 기본값은ImageProcessingOptions.Orientation.TOP_LEFT
입니다.MlImage.getRotation()
이 효과적이지 않습니다.
매개변수
영상 | 이미지를 나타내는 MlImage 객체 |
---|---|
옵션 | ROI 및 회전을 포함한 옵션 구성 |
던지기
IllegalArgumentException | 이미지의 저장 유형이나 형식이 지원되지 않는 경우 |
---|
공개 목록 < NearestNeighbor > 검색 ( TensorImage 이미지)
제공된 TensorImage
에서 임베딩 추출을 수행한 후 인덱스에서 최근접 이웃 검색을 수행합니다.
ImageSearcher
다음 TensorImage
색상 공간 유형을 지원합니다.
매개변수
영상 | RGB 또는 YUV 이미지를 나타내는 UINT8 TensorImage 객체 |
---|
던지기
IllegalArgumentException | 이미지의 색상 공간 유형이 지원되지 않는 경우 |
---|