Exporting Data

Everything Gaard produces can leave the platform. This guide covers the three export paths: CSV reports for analysis, datasets for machine learning, and annotated video for evidence.

CSV export

A CSV report is a spreadsheet-friendly snapshot of results, suited to reporting, auditing, and offline analysis. You can export from two places, depending on what you want:

• From the review workspace: exports the classifications matching your current filters and time range. Set up the view you want first (see Search & Filtering), then export.
• From the Labels view: exports the labels your team has recorded (see Labeling & Feedback).

1. Open the actions menu in the review workspace or the Labels view.

2. Select Generate a CSV report.

3. Confirm Generate in the dialog. The report is built server-side and the download starts automatically when it is ready.

Tip

Narrow your filters and time range before exporting from the review workspace. The CSV reflects exactly the results currently in view, so a tighter filter means a smaller, more relevant report.

Dataset export

A dataset packages labeled clips and their metadata into a single archive (tar format), ready to feed into a machine-learning workflow. Unlike a CSV (which is just tabular data) a dataset bundles the underlying material.

Dataset generation runs as a background job because it can take time to assemble.

1. In the Labels view, open the actions menu and select Generate a dataset.

2. Confirm Generate. A new job appears in the list and reports its progress as it runs.

3. When the job is Done, select its filename to download the archive.

Dataset jobs persist in the list, so you can start a large export, leave the page, and come back to download it once it has finished.

Downloading annotated video

The annotated video is the highlight clip for a classification with the model’s detections drawn on it as bounding boxes: the same footage you see in the review player. It is the most useful artifact to hand to a colleague or attach to an incident, because it shows what Gaard detected and where.

Retrieve it from the API with the classification’s classify_id:

curl

terminal

curl https://vision.gaard.ai/api/video/annotate/66436fc66d24ab9cf81140eb \
  -H "Authorization: Bearer $API_KEY" \
  -o annotated.mp4

Note

The response is always MP4 (x264), even if the returned file does not carry a .mp4 extension.

For the full endpoint reference, see Endpoints.

Next steps

Search & Filtering Build the exact view you want before exporting it to CSV.

Labeling & Feedback Label clips so they can be exported as a dataset.

Endpoints The API reference for annotated video and other endpoints.

Data Retention & GDPR How long data is kept and how erasure works.