Search a Dataset

Use text-based search queries and set filters to better understand datasets in Roboflow.

You can search for image files in Roboflow by file name, a search query, and mix and match queries and filters to find specific images and better understand your data.

• Images in a split with a certain tag: tag:factory split:train This uses a tag filter and a split filter

• Find missing labels by using semantic search and a class filter: person -class:helmet This uses semantic search and an inverted filter on a class filter

• If all images with a class need a certain filter: class:helmet AND NOT (tag:v1 OR tag:v2) This uses a class filter, boolean logic, and tag filters

• Find wide images with a low number of annotations: min-width:1000 max-annotations:1 This uses a minimum width filter and a max annotation count filter

See the full list of search filters, as well as examples below

You can combine all of these search filters and queries together

Semantic Search

You can search for images by describing them. These queries will search for images most closely related to your search terms and can help you find images even when objects are not currently labeled.

Semantic search happens when you enter a text query without any filter selectors (ex: filename:)

Search by File Name

You can search for file names using the filename: filter or the file name textbox, which will create the query for you.

Search by Dataset Split

Search images by the dataset split (train, valid, test)

Search Filters

Here are the filters available:

• like-image:<IMAGE_ID>: Semantic search based on image content

• tag : Filter by user-provided tags.

• filename : Runs a search for file names that match the provided file name. Use * at the beginning and end of a query to run a partial match.

• split : Filters by split (train, test, valid).

• job:<JOB_ID> : Shows images with the provided job ID.

• min-width:X : Shows images with a width greater than X.

• max-width:X : Shows images with a width less than X.

• min-height:X : Shows images with a height greater than X.

• max-height:X : Shows images with a height less than X.

• min-annotations:X : Filters images with more than the specified number of annotations.

• max-annotations:X : Shows images with fewer than the specified number of annotations.

• class:CLASS: Shows images that have at least 1 annotation with the provided label.

Boolean Logic

Use AND, OR, NOT, and parentheses to combine multiple filters to form complex queries.

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

Inverted Filters

Add a minus sign before the filter to exclude images matching the filter.

class:helmet -class:vest

Numeric Class Filters

Filter by the number of labeled items in an image.

class:helmet=3 class:vest>=4

API

You can also search your dataset and images on Roboflow via our Search API.