Publishing

Once you have a MCAP created from the Recording Service, you can upload it as a dataset to EdgeFirst Studios to auto-annotation and train additional models from. There are two methods to upload the MCAP to EdgeFirst Studio: download the MCAP from Raivin and use EdgeFirst Studio to create a snapshot, or use the EdgeFirst studio client on the Raivin device to directly upload the file from the Raivin to the Studio as a snapshot.

Warning

Uploading snapshots should not deduct funds from your EdgeFirst Studio account. However, creating datasets from snapshots, called restoring snapshots, will absolutely incur costs.

For the examples below, we will use the Raivin with a hostname of verdin-imx8mp-07130049 with a MCAP save directory of /media/DATA and the MCAP file to copy named verdin-imx8mp-07130049_2025_04_09_12_44_12.mcap. Here is the screenshot of the MCAP Recording page of such a device:

Pre-requisites

It is assumed you have followed the steps in the Recording Service page and have an MCAP file as well as working knowledge of the page.

You must have followed the steps in the EdgeFirst Studio Quick Start to create a user account, login to the account, and create an initial project. You will need the username and password for both publishing methods.

Most of the workflows below require working knowledge with SSH and command-line interfaces. It is recommended that you read and follow the steps on that page to confirm SSH connectivity with the Raivin.

Method 1: Download the MCAP from the Raivin and Publish to Studio

The first method is to download the MCAP from the Raivin. This can be accomplished in two ways:
- use the download button for the MCAP on the Recording Service page to download the MCAP to your PC via the Raivin's WebUI.
- use SCP to download the file to your PC via the command-line interface.

For our example above, you would click the second green "download" button from the top or run the following command on your PC:

scp torizon@verdin-imx8mp-07130049:/media/DATA/verdin-imx8mp-07130049_2025_04_09_12_44_12.mcap .

Once the MCAP file is downloaded to your PC, you can login to EdgeFirst Studio and use the EdgeFist Studio Snapshot page to upload the MCAP file to Studio.

Method 2: Publish the MCAP directly using the EdgeFirst Client

The second method is use the EdgeFirst studio client on the device to directly upload the MCAP to EdgeFirst Studios as a snapshot. This requires that you SSH into the device and run commands on the Linux shell of the Raivin.

First, you would need to use the SSH client to log into the device:

$ ssh torizon@verdin-imx8mp-07130049
Last login: Fri Apr 25 15:29:08 2025 from 10.10.20.3
torizon@verdin-imx8mp-07130049:~$

Confirm that the version of your EdgeFirst Client is 1.3.3 or higher:

torizon@verdin-imx8mp-07130049:~$ edgefirst-client -V
edgefirst-client 1.3.3
torizon@verdin-imx8mp-07130049:~$

From here, you should run a directory listing to see the files in the MCAP save directory:

torizon@verdin-imx8mp-07130049:~$ ls -l /media/DATA/
total 496109120
-rw-r--r-- 1 torizon torizon     14445456 Apr  4 18:20 verdin-imx8mp-07130049_2025_04_04_18_20_50.mcap
-rw-r--r-- 1 torizon torizon    228244643 Apr  8 12:53 verdin-imx8mp-07130049_2025_04_08_12_51_19.mcap
-rw-r--r-- 1 torizon torizon     66462206 Apr  9 12:44 verdin-imx8mp-07130049_2025_04_09_12_44_12.mcap
-rw-r--r-- 1 torizon torizon 507706576896 Apr 22 11:28 verdin-imx8mp-07130049_2025_04_18_01_24_06.mcap
torizon@verdin-imx8mp-07130049:~$

From here, we can run the EdgeFirst Client for the /media/DATA/verdin-imx8mp-07130049_2025_04_09_12_44_12.mcap file. Enter your username and password on the command-line in lieu of the XXXXXXXX.

torizon@verdin-imx8mp-07130049:~$ edgefirst-client --username XXXXXXXX --password XXXXXXXX create-snapshot /media/DATA/verdin-imx8mp-07130049_2025_04_09_12_44_12.mcap
[365] available: verdin-imx8mp-07130049_2025_04_09_12_44_12.mcap
torizon@verdin-imx8mp-07130049:~$

The output line shows the the snapshot for the file was created, is available to be restored, and has snapshot ID of 365. We can confirm that the snapshot is created by using the EdgeFirst client to list the snapshots.

torizon@verdin-imx8mp-07130049:~$ edgefirst-client --username XXXXXXXX --password XXXXXXXX snapshots
[331] available: dataset_cards
[364] available: verdin-imx8mp-07130049_2025_04_04_18_20_50.mcap
[365] available: verdin-imx8mp-07130049_2025_04_09_12_44_12.mcap
torizon@verdin-imx8mp-07130049:~$

We can see that the newly created snapshot is in this list.

We can also confirm the snapshot on the EdgeFirst Studio Snapshot screen.

Next Steps

Once the MCAP is uploaded as a snapshot to EdgeFirst Studio, you can restore the snapshot into the initial project you created as part of the Studio Quickstart.

Warning

Restoring a snapshot into a dataset will accrue costs from your EdgeFirst Studio account.