> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/roboflow/roboflow-ko/datasets/manage-datasets/dataset-search.md).

# Dataset 검색

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

* **특정 태그가 있는 split의 이미지:**\
  `tag:factory split:train`\
  이는 tag 필터와 split 필터를 사용합니다
* **semantic search와 class 필터를 사용해 누락된 라벨을 찾으세요**:\
  `person -class:helmet`\
  이는 semantic search와 class 필터에 대한 반전 필터를 사용합니다
* **class가 있는 모든 이미지에 특정 필터가 필요하다면:**\
  `class:helmet AND NOT (tag:v1 OR tag:v2)`\
  이는 class 필터, 불리언 로직, tag 필터를 사용합니다
* **주석 수가 적은 넓은 이미지를 찾으세요:**\
  `min-width:1000 max-annotations:1`\
  이는 최소 너비 필터와 최대 주석 수 필터를 사용합니다

전체 목록을 보려면 [검색 필터](#search-filters)와 아래 예시를 확인하세요

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

### Semantic Search

이미지를 설명하는 방식으로 검색할 수 있습니다. 이 쿼리는 검색어와 가장 관련이 높은 이미지를 검색하며, 객체가 아직 라벨링되지 않은 경우에도 이미지를 찾는 데 도움이 됩니다.

Semantic search는 어떤 필터 선택자도 없이 텍스트 쿼리를 입력할 때 발생합니다(예: `filename:`)

<figure><img src="/files/543d9892b3d86e0a7bd062f1fef2a446d3062bf8" alt=""><figcaption></figcaption></figure>

### 파일 이름으로 검색

다음을 사용해 파일 이름을 검색할 수 있습니다 `filename:` 필터 또는 파일 이름 입력란을 사용하면 쿼리가 자동으로 생성됩니다.

<figure><img src="/files/4388ee546318da318eb0cb25c5b5097bb21a0ed4" alt="" width="192"><figcaption></figcaption></figure>

### 데이터셋 split으로 검색

데이터셋 split(train, valid, test)으로 이미지를 검색합니다

<figure><img src="/files/9a10f464088db16c62c68b720edc0e3c61b44738" alt="" width="257"><figcaption></figcaption></figure>

이미지를 다른 split으로 다시 할당하려면 선택한 뒤(또는 검색에서 "Select all matching"을 선택한 뒤) 대량 작업 메뉴에서 "Change Dataset Split"을 클릭하세요. 대량 선택은 백그라운드에서 처리됩니다.

## 검색 필터

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

* `like-image:<IMAGE_ID>`: 이미지 콘텐츠를 기반으로 한 semantic search
* `tag` : 사용자가 제공한 태그로 필터링합니다.
* `filename` : 제공된 파일 이름과 일치하는 파일 이름을 검색합니다. 부분 일치를 실행하려면 쿼리의 시작과 끝에 \*를 사용하세요.
* `split` : 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).