# Search a Dataset

Roboflow에서 파일 이름, 검색 쿼리로 이미지 파일을 검색할 수 있으며 쿼리와 필터를 조합하여 특정 이미지를 찾고 데이터에 대해 더 잘 이해할 수 있습니다.

* **특정 태그가 있는 분할의 이미지:**\
  `tag:factory split:train`\
  이는 태그 필터와 분할 필터를 사용합니다
* **시맨틱 검색과 클래스 필터를 사용하여 누락된 라벨을 찾으세요**:\
  `person -class:helmet`\
  이는 시맨틱 검색과 클래스 필터에 대한 반전된 필터를 사용합니다
* **클래스가 있는 모든 이미지에 특정 필터가 필요하다면:**\
  `class:helmet AND NOT (tag:v1 OR tag:v2)`\
  이는 클래스 필터, 불리언 논리 및 태그 필터를 사용합니다
* **라벨 수가 적은 와이드 이미지 찾기:**\
  `min-width:1000 max-annotations:1`\
  이는 최소 너비 필터와 최대 어노테이션 수 필터를 사용합니다

전체 목록 보기: [검색 필터](#search-filters), 및 아래의 예제들

{% hint style="info" %}
이 모든 검색 필터와 쿼리를 함께 결합할 수 있습니다
{% endhint %}

### 시맨틱 검색

이미지를 설명하여 검색할 수 있습니다. 이러한 쿼리는 검색어와 가장 관련 있는 이미지를 찾으며 객체에 현재 라벨이 없어도 이미지를 찾는 데 도움이 됩니다.

시맨틱 검색은 필터 선택자 없이 텍스트 쿼리를 입력할 때 발생합니다(예: `filename:`)

<figure><img src="https://3958014485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2Fgit-blob-252e7735b8f04fdeb7b567c8a73c783ba42c7ba0%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### 파일 이름으로 검색

다음 필터나 파일 이름 텍스트박스를 사용해 파일 이름을 검색할 수 있으며, 텍스트박스는 쿼리를 생성합니다. `filename:` filter 또는 파일 이름 텍스트박스를 사용하면 쿼리가 생성됩니다.

<figure><img src="https://3958014485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2Fgit-blob-007ef7663b94243be3a88de95df3a6fe6345bf5f%2Fimage.png?alt=media" alt="" width="192"><figcaption></figcaption></figure>

### 데이터셋 분할로 검색

데이터셋 분할(train, valid, test)별로 이미지를 검색합니다

<figure><img src="https://3958014485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2Fgit-blob-42804a6e68a1551a7f23c0fe1746da8231fb5b02%2Fimage.png?alt=media" alt="" width="257"><figcaption></figcaption></figure>

## 검색 필터

사용 가능한 필터는 다음과 같습니다:

* `like-image:<IMAGE_ID>`: 이미지 내용 기반의 시맨틱 검색
* `tag` : 사용자 제공 태그로 필터링합니다.
* `filename` : 제공된 파일 이름과 일치하는 파일 이름을 검색합니다. 부분 일치를 실행하려면 쿼리의 시작과 끝에 \*를 사용하세요.
* `split` : 분할(train, test, valid)로 필터링합니다.
* `job:<JOB_ID>` : 제공된 job ID를 가진 이미지를 표시합니다.
* `min-width:X` : 너비가 X보다 큰 이미지를 표시합니다.
* `max-width:X` : 너비가 X보다 작은 이미지를 표시합니다.
* `min-height:X` : 높이가 X보다 큰 이미지를 표시합니다.
* `max-height:X` : 높이가 X보다 작은 이미지를 표시합니다.
* `min-annotations:X` : 지정된 수보다 많은 어노테이션을 가진 이미지를 필터링합니다.
* `max-annotations:X` : 지정된 수보다 적은 어노테이션을 가진 이미지를 표시합니다.
* `class:CLASS`: 제공된 라벨을 가진 최소 1개의 어노테이션이 있는 이미지를 표시합니다.

### 불리언 논리

AND, OR, NOT 및 괄호를 사용하여 여러 필터를 결합해 복잡한 쿼리를 구성하세요.

`class:helmet AND NOT (tag:v1 OR tag:v2)`

### 반전된 필터

필터 앞에 마이너스 기호를 추가하여 필터와 일치하는 이미지를 제외합니다.

`class:helmet -class:vest`

### 숫자형 클래스 필터

이미지 내 라벨된 항목 수로 필터링합니다.

`class:helmet=3 class:vest>=4`

## API

또한 Roboflow의 [Search API](https://docs.roboflow.com/api-reference/images/search#rest-api).