Skip to main content

Data Management

The Data Management page is the central place for all datasets on the platform and provides search, filtering, preview, and batch actions. Datasets are the input of annotation tasks; annotation, quality checks, and export happen on the Annotation Tasks, Data QC, and Dataset Export pages respectively.

Data Management page (administrator, test environment)

Prerequisites​

ItemDescription
Menu entryData → Data
Route/dataset
Required permission“Dataset List”
Related permissions“Dataset Annotation” (start annotation), “Dataset Compute / Preprocess” (compute operations such as updating metadata), “Dataset Export” (open the export page)
Effective rulesAdministrators are not limited by module permissions and have Read & write on everything; other roles follow the role default template, and user-level overrides take precedence over role defaults; modules with no configuration are set to Deny

See Module Permissions for how to configure module permissions.

Data Browsing​

Data Scope​

The project selector at the top of the page sets the data scope of the list. The three options differ as follows.

ScopeVisible datasetsApplicable roles
All projectsDatasets in every project the current account can accessAdministrator; a project manager sees their own projects and public projects
Specific projectOnly datasets in the selected projectAll roles
Personal SpacePrivate datasets uploaded by the current accountAll roles

When the data volume is large, selecting a project first reduces the amount of data returned by a single query.

Search and Filtering​

Filter conditions are written to URL query parameters, so a link that carries filters can be shared directly. Active Robot, Label, and Uploader filters appear as chips above the list and can be removed one by one.

FilterDescription
Data NameMatches by name, with fuzzy matching
RobotFilters by the robot that captured the data
LabelFilters by data tag
UploaderFilters by the uploading account
ProjectFilters by project, with multi-select
CollectorFilters by collector, with multi-select
Collection taskFilters by the source collection task
Duration rangeFilters by a data duration interval in seconds
Marker textSearches the annotation text content

Advanced Search expanded

List Fields​

FieldDescription
ThumbnailDataset preview image
NameDataset name; click to open the details
SizeDisk space used by the files
DurationData duration
Upload TimeIngestion time, sortable
StatusWhether an annotation task is assigned and whether annotation is complete
LabelData classification tag

The pagination control at the bottom of the list shows the page size and total count. When no row is selected, the bottom shows the total storage space of the current filter result.

Data Preview​

Click a dataset name or thumbnail to open the details, which show basic information, robot information, annotation statistics, and linked tasks, and play online content in the browser.

Data typeSupported formatsPlayback support
VideoMP4, AVI, MOVPlay, pause, speed control
AudioMP3, WAVPlay, waveform display
MCAPMCAP3D scene rendering, marker inspection

Studio data playback

Data Maintenance​

Batch Actions​

Select the target datasets in the list before acting. The bottom action bar offers the following actions.

ActionEffectConstraint
RenameRenames datasets in bulkConfirmed one by one
StatisticsShows annotation statistics for the selected dataRead-only
AnnotateCreates an annotation task from the selected dataRequires “Dataset Annotation”
LabelAdds or removes data tags in bulkRequires “Dataset Annotation”
UpdateRe-extracts metadata or re-runs preprocessingRequires “Dataset Compute / Preprocess”
DeleteSoft-deletes the selected dataDeleted items go to Trash and can be restored
ImportImports the selected data into a projectRequires project membership
RobotLinks or unlinks a robotUsed for data provenance
warning

If the selected rows include open shared datasets, the batch action is rejected with the message “Selected items include open shared data (view/export only); secondary editing is not allowed”. Such datasets can only be viewed and exported.

Dataset batch actions

Statistics​

Click “Statistics” at the bottom to see summary metrics for the selected datasets. The definitions are as follows.

MetricMeaning
Total dataNumber of selected datasets
Total data durationCombined duration of the selected datasets
Total annotationsNumber of annotation entries
Total qualified annotationsAnnotation entries that passed review and are not marked invalid
Average annotations per datasetTotal annotations ÷ total data
Total annotation durationCombined duration covered by annotations
Average annotation duration per datasetTotal annotation duration ÷ total data
Total invalid dataNumber of datasets marked invalid
Qualified check rateQualified checks ÷ total checks
Invalid collectionAnnotations marked invalid due to problems in the collection step
Semantic errors, uncorrected / correctedCounts of uncorrected and corrected annotations with semantic errors

Annotation statistics

Metadata Update​

Re-extract metadata when a file duration or size is wrong, metadata extraction failed after upload, or a file was modified by an external tool.

Path: select the dataset → “Update” at the bottom → choose metadata update → confirm. The dialog shows the processing status per item.

StatusMeaningNext action
PendingQueued and waiting for processingNone
ProcessingReading the file and extracting metadataWait for completion
CompletedMetadata updated successfullyNone
FailedCorrupted file or wrong formatPermanent errors are not retried automatically; fix the file and submit again

Accidental Deletion Recovery​

Deletion is a soft delete; data goes to Trash and can be restored. A restore keeps the original annotations, linked annotation tasks, data tags and metadata, and operation and access logs.

When a file with the same name as a deleted dataset is uploaded again, the system detects the same-name record and offers two options.

OptionResultUse case
Restore existing datasetKeeps all history, including annotations and task linksThe original data was deleted by mistake
Create new datasetIgnores history and creates a fresh recordThe original data should be discarded

Troubleshooting​

SymptomPossible causeAction
Target data is not foundWrong project scope, no access permission, a keyword that is too narrow, or the data was deletedSwitch the project scope; check Trash to see whether it was deleted; loosen the keyword or use Advanced Search
The list loads slowlyScope set to All projects, filters that are too broad, a large page size, or an unstable networkSelect a specific project; add filters; reduce Items Per Page
A batch action partially failsAn individual file is corrupted, a dataset has no annotation data, or open shared data is includedCheck the per-item error messages in the dialog and retry failed items individually
Metadata update failsA corrupted file or an unsupported formatFix the file and submit again; permanent errors are not retried automatically
PagePurpose
Annotation TasksTask status, task details, batch annotation
Data UploadUpload new data and convert video and audio to MCAP
Dataset ExportExport annotation results for training
Data QCAutomatic quality check rules for ROS recordings
TrashRestore deleted data