# Dataset を検索

Roboflowでは、ファイル名、検索クエリ、そしてクエリとフィルターを組み合わせて画像ファイルを検索し、特定の画像を見つけてデータをより深く理解できます。

* **特定のタグを持つ分割内の画像:**\
  `tag:factory split:train`\
  これはタグフィルターと分割フィルターを使用しています
* **semantic search と class フィルターを使って、欠落しているラベルを見つける**:\
  `person -class:helmet`\
  これは semantic search と class フィルターに対する反転フィルターを使用しています
* **ある class を持つすべての画像に特定のフィルターが必要な場合:**\
  `class:helmet AND NOT (tag:v1 OR tag:v2)`\
  これは class フィルター、boolean logic、そして tag フィルターを使用しています
* **注釈数が少ない幅広の画像を見つける:**\
  `min-width:1000 max-annotations:1`\
  これは最小幅フィルターと最大注釈数フィルターを使用しています

以下の [search filters](#search-filters)の全一覧と、下の例を参照してください

{% hint style="info" %}
これらの search filters とクエリはすべて組み合わせて使用できます
{% endhint %}

### Semantic Search

画像を説明することで検索できます。これらのクエリは、検索語に最も近い画像を検索し、オブジェクトがまだラベル付けされていない場合でも画像を見つけるのに役立ちます。

semantic search は、フィルターセレクタを使わずにテキストクエリを入力したときに行われます（例: `filename:`)

<figure><img src="https://3740591140-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:` フィルターまたはファイル名テキストボックスを使って検索でき、クエリが自動生成されます。

<figure><img src="https://3740591140-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>

### Dataset Split で検索

データセットの split（train、valid、test）で画像を検索します

<figure><img src="https://3740591140-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>

## Search Filters

利用可能なフィルターは次のとおりです:

* `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つ持つ画像を表示します。

### Boolean Logic

AND、OR、NOT、および括弧を使って複数のフィルターを組み合わせ、複雑なクエリを作成します。

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

### Inverted Filters

フィルターの前にマイナス記号を付けると、そのフィルターに一致する画像を除外します。

`class:helmet -class:vest`

### Numeric Class Filters

画像内のラベル付きアイテム数でフィルタします。

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

## API

また、Roboflow の [Search API](https://docs.roboflow.com/api-reference/images/search#rest-api).