Recordings

A recording session includes everything related to a single recording session. Recording files, configuration files, media files, and the recording session's description.

If you head over to Recordings you will see a list of all the recordings sessions in the current project.

How-to list recordings

Console

Simply click the navigation path Recordings.

Cli

$ remotive cloud recordings list --project my-project [ | jq. ]

[
  {
    "sessionId": "13303517729834103000",
    "recordings": [
      "cycle04_chassie.zip",
      "cycle04_vehicle.zip"
    ],
    "displayName": "Turning Torso drive cycle - 2x CAN",
    "uploaded": "2023-03-09T19:38:53.373Z"
  }
]

Manage recording sessions

---

A recording session is created as soon as you upload a recording file.

Upload

When upploading a recording file a new recording session will be created. A RemotiveBroker recording session that outputs multiple recording files will belong to the same recording session.

If you upload another file, not recorded by RemotiveBroker, the seperate files will get seperate recording sessions.

RemotiveCloud support recording file upload of .blf, .asc, candump .log, .mdf, .csv.

How-to guide

Console

Drag and drop a recording file to the highlighted area. You can also click the drag and drop area or use the highlighted button in the top right corner to open a file selector.

Cli

Choose a valid recording file and use the upload command.

$ remotive cloud recordings upload  ~/recordings/cycle04_chassie.zip --project my-project

Due to some background processing and validation of the recording its not possible to return wether the upload was successful or not as a response. You can validate the upload by listing recordings and make sure that its valid and also listing with status processing to see if something went wrong.

$ remotive cloud recordings list --is-processing --project my-project

If something went wrong due to invalid file it can look something like this. Once in this state you need to remove the file

[
  {
    "fileName": "my-invalid-recording.zip",
    "displayName": "my-invalid-recording.zip",
    "metadata": {
      "error": true,
      "message": "(Error) invalid signature: 0x474e5089"
    },
    "sizeInBytes": 103443
  }
]

Automatch of signal database

In order to playback or visualize signals in RemotiveCloud, the recording need to be decoded by a signal database. When uploading your recording files, we will make a first match between your recordings and the signal databases available in the project.

If the match is above 70% (i.e. if 70% or more of the frames in a recording is available in a corresponding signal database) we will chose this database automatically for the specific file. If there is no match with 70% accurracy, you will get a suggestion of the best match. You can view the selected databases and the suggestions in the "files" tab in the Recording session. Read more about this at Manage recording files.

Import samples

If you do not have a recording of your own, RemotiveCloud offers a couple of sample recordings to get you started. All sample recordings offer VSS and Android signal transformations.

How-to guide

Console

Click the "import" button in the right corner and select which recording to import.

Cli

List the available sample recordings by using the following command.

$ remotive cloud samples list

Choose what recording to import and into which project you want it to be imported.

$ remotive cloud samples import --project TEXT RECORDING_SESSION

Delete

A user with the right permissions can delete a recording session. Deleting a recording session will remove all recording files, configuration files, media files, and notes from the project.

How-to delete recording

Console

Click the highlighted trash can icon to remove the recording session.

Cli

$ remotive cloud recordings delete my-recording-session \
  --project my-project

Copy

A user can copy a recording session into another project. All recording files, configuration files, media files, notes and assigned signal databases will be copied to the new project.

How-to copy a recording session

Console

Click the highlighted copy icon to copy the recording session. And select the destination project in the list.

Cli

$ remotive cloud recordings copy RECORDING_SESSION --from-project TEXT --to-project TEXT

View the recording session

Anyone in the project can access a recording session. In the recording session you will find the Playback tab, Visualize tab, Notes tab and Files Tab.

How-to see details

Console

Click on a recording session name or the arrow to enter the recording session.

Cli

$ remotive cloud recordings describe 13303517729834103000 --project my-project

{
  "sessionId": "13303517729834103000",
  "recordings": [
    {
      "fileName": "cycle04_chassie.zip",
      "displayName": "cycle04_chassie.zip",
      "metadata": {
        "database": "Model3CAN2.dbc",
        "namespace": "ChassiBus"
      },
      "sizeInBytes": 14245975
    },
    {
      "fileName": "cycle04_vehicle.zip",
      "displayName": "cycle04_vehicle.zip",
      "metadata": {
        "database": "Model3CAN.dbc",
        "namespace": "VehicleBus"
      },
      "sizeInBytes": 10561391
    }
  ],
  "displayName": "Turning Torso drive cycle - 2x CAN",
  "uploaded": "2023-03-09T19:38:53.373Z",
  "description": "## Turning Torso drivecyle\nDrive around Malmö, dockan and MINC.\n\n#### Vehicle \n\nTesla Model Y\n\n#### Collected data\n\n###### Bussses\n\n- Chassis (CAN)\n- Vehicle (CAN)\n\n###### Video\n- Front facing camera",
  "mediaFiles": [
    {
      "fileName": "Remotive-Turning-Torso_Highres.mp4",
      "displayName": "Remotive-Turning-Torso_Highres.mp4",
      "mimeType": "video/mp4",
      "sizeInBytes": 338346895,
      "startTimeZoned": "2021-09-27T18:38:00.848Z"
    },
    {
      "fileName": "Remotive-Turning-Torso_Lowres.mp4",
      "displayName": "Remotive-Turning-Torso_Lowres.mp4",
      "mimeType": "video/mp4",
      "sizeInBytes": 17787770,
      "startTimeZoned": "2021-09-27T18:38:00.848Z"
    }
  ],
  "brokerConfigurations": [
    {
      "name": "configuration_hidden",
      "files": [
        {
          "name": "configuration_hidden/PERF_STEERING_ANGLE.lua",
          "mimeType": "application/x-www-form-urlencoded",
          "sizeInBytes": 495
        },
        {
          "name": "configuration_hidden/dbc/Model3CAN.dbc",
          "mimeType": "application/x-www-form-urlencoded",
          "sizeInBytes": 322430
        },
        {
          "name": "configuration_hidden/interfaces.json",
          "mimeType": "application/x-www-form-urlencoded",
          "sizeInBytes": 654
        },
        {
          "name": "configuration_hidden/scripts/PERF_STEERING_ANGLE_2HZ.lua",
          "mimeType": "application/x-www-form-urlencoded",
          "sizeInBytes": 1375
        },
        {
          "name": "configuration_hidden/vss_mapped.json",
          "mimeType": "application/x-www-form-urlencoded",
          "sizeInBytes": 406
        }
      ]
    },
    {
      "name": "configuration_model3",
      "files": [
        {
          "name": "configuration_model3/PERF_STEERING_ANGLE.lua",
          "mimeType": "application/x-www-form-urlencoded",
          "sizeInBytes": 495
        },
        {
          "name": "configuration_model3/dbc/Model3CAN.dbc",
          "mimeType": "application/x-www-form-urlencoded",
          "sizeInBytes": 322430
        },
        {
          "name": "configuration_model3/interfaces.json",
          "mimeType": "application/x-www-form-urlencoded",
          "sizeInBytes": 604
        },
        {
          "name": "configuration_model3/scripts/PERF_STEERING_ANGLE_2HZ.lua",
          "mimeType": "application/x-www-form-urlencoded",
          "sizeInBytes": 1375
        },
        {
          "name": "configuration_model3/vss_mapped.json",
          "mimeType": "application/x-www-form-urlencoded",
          "sizeInBytes": 406
        }
      ]
    }
  ]
}

Access notes

Inside a recording session you can find notes related to that recording session. Anyone in the project can view the notes. Only user with the right permission can edit them.

How-to guide

Console

Click the notes tab to view the notes related to the current recording session. Click the highlighted pen icon by the name to edit the recording session name, or the highlighted icon in the right corner to edit the notes.

Cli

Perhaps not applicable to the CLI but you can simply use the describe command and some jq parsing to get files.

Get recording file names

$ remotive cloud recordings describe the-session-id --project turning-torso-demo \
   | jq -r '.recordings[].fileName'
cycle04_chassie.zip
cycle04_vehicle.zip

Get broker configuration names

$ remotive cloud recordings describe the-session-id --project turning-torso-demo \
   | jq -r '.brokerConfigurations[].name'
configuration_hidden
configuration_model3

Access files

Inside a recording session you can find all files related to that recording session. This is where you can edit, download our delete the recording files. Anyone in the project can view the related file

How-to guide

Console

Click the highlighted files tab to view all files related to the current recording session.

Cli

Perhaps not applicable to the CLI but you can simply use the describe command and some jq parsing to get files.

Get recording file names

$ remotive cloud recordings describe the-session-id --project turning-torso-demo \
   | jq -r '.recordings[].fileName'
cycle04_chassie.zip
cycle04_vehicle.zip

Get broker configuration names

$ remotive cloud recordings describe the-session-id --project turning-torso-demo \
   | jq -r '.brokerConfigurations[].name'
configuration_hidden
configuration_model3

Manage recording files

---

Recording files are managed in the files tab in the recording session.

Edit

Recordings files can be edited by users with the right permission in the project.

You can edit which signal database is used to decode the recording and change what namespace to use for the specific recording file. The namespace is the relation between the recording file and the signal database.

When uploading recording files, RemotiveCloud will autoselect the signal database that matches best to the recording file. The autoselection will be made if the match is more than 70% (i.e. if 70% or more of the frames in a recording is available in a corresponding signal database) and will be marked with a green label and the match percentage.

If the match is below 70% for a specific recording file you will need to select signal database manually. However, you will get a suggestions for the signal database that is the best match, based on the signal databases in the project. These files will be clearly marked that they need specific action. You can either choose one of the signal databases with the best match percentage or upload a new signal database that might be a better match.

To enter the edit mode, clicking the pen icon.

Use the Find match button to see what signal database that is the best match for the recording file. You can always change what signal database to use, even if it has been auto-selected for the specific recording file. If you select a database that is not the best match, it will be marked with a label saying "set by user" in the overview, otherwise the label will show the match percentage.

If you upload a new signal database, after you have uploaded a recording, just click the Find match again to add this new database to the calculations for best match.

Delete

Recording files can be deleted by a user with the right permissions.

How-to guide

Console

Click the highlighted trash can icon to remove the recording file

Cli

$ remotive cloud recordings delete-recording-file cycle04_vehicle.zip
--project my-project
--recording-session the-recording-session

Download

Recording files can be downloaded by a user with the right permissions.

How-to guide

Console

Click the highlighted download icon to download the recording file

Cli

$ remotive cloud recordings download-recording-file cycle04_vehicle.zip
--recording-session the-recording-session
--project my-project

Manage media files

---

Media files can be uploaded by anyone in the project. We support the most common formats for videos, images and archives. Media files are managed in the files tab in the recording session.

Media files are not yet supported in CLI.

Upload

How-to guide

Drag and drop or click the drag and drop area to upload a media file.

Delete

How-to guide

Click the highlighted trash can icon to remove the media file

Manage signal transformations / configurations files

---

Signal transformations / configuration files are used to modify a recording's signal output without modifying the actual recorded data. The files are managed in the files tab in the recording session. Read more about signal transformations here.

Upload

Signal transformations / configuration files can be uploaded by anyone in the project.

How-to guide

Drag and drop or click the drag and drop area to upload a file.

Not yet supported in CLI

Delete

Signal transformations / configuration files can be deleted by a user with the right permissions.

How-to guide

Console

Click the highlighted trash can icon to remove the file

Cli

$ remotive cloud recordings delete-configuration configuration_hidden
--recording-session the-recording-session
--project my-project

Download

Signal transformations / configurations can be downloaded as a zip file.

Details

Console

Click the download button next to the delete button on the configuration directory

Cli

$ remotive cloud recordings download-configuration configuration-hidden
--recording-session the-recording-session
--project my-project