# Dataset 검색

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

* **특정 태그가 있는 분할의 이미지:**\
  `tag:factory split:train`\
  이것은 태그 필터와 split 필터를 사용합니다
* **semantic search와 class 필터를 사용하여 누락된 레이블을 찾습니다**:\
  `person -class:helmet`\
  이것은 semantic search와 class 필터에 대한 반전 필터를 사용합니다
* **클래스가 있는 모든 이미지에 특정 필터가 필요하다면:**\
  `class:helmet AND NOT (tag:v1 OR tag:v2)`\
  이것은 class 필터, 불리언 논리, 그리고 태그 필터를 사용합니다
* **어노테이션 수가 적은 넓은 이미지를 찾습니다:**\
  `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>

## 검색 필터

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

* `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 필터

이미지에 레이블이 지정된 항목 수로 필터링합니다.

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

## API

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.roboflow.com/roboflow/roboflow-ko/datasets/manage-datasets/dataset-search.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
