Getting Started - 1. Asset Creation

This guide walks you through the asset creation process using an example.

We will use the following tool(s):

• RObotic Data EcOsystem Semantic Model (RODEOS) : RODEOS is a RoX semantic model generator based on a LLM. Given a technical documentation, it returns JSON data with already fill-in values. RODEOS can run locally, but we will use an online service at here
• DLR dataspace Web UI : We will use it to register a dataspace asset manually.

Overall, the JSON data from RODEOS becomes part of the asset metadata. Asset registering can also be done programmatically using dataspace API, but it is not covered here.

Preliminary Requirements

• The asset you want to register in the dataspace must already have an accessible URL.
• Identify what is my asset type?:
  • static_file: a single file (or a zip file for multiple)
  • container
    • "dockerfile": a Dockerfile
    • "source_archive": an archive that contains a Dockerfile (e.g., Github repo zip file)
    • "docker_archive": a docker image archive made by docker save
    • Currently, OCI Registry or OCI archive types are not supported
  • file_service: a service end-point that returns a file or static data
  • streaming_service: a service end-point that streams data

Video Guide

A quick and simple guide via a recorded video. Written instructions (same as the video) are also provided in the following sections.

Written Guide

Step 1. Semantic model

First, have your asset available via URL. In this example, we will use an open-source dataset SortScrew to create an asset.

Go to the online RODEOS service at https://dataspace-dev-wallet.base-x-ecosystem.org/rodeos.

Copy and paste the text description of your asset to have the semantic model automatically generated.

Check the generated values and enter any missing values.

Step 2. Asset Registration

Next, login to the DLR dataspace Web UI.

Click "My Assets" menu on the sidebar.

We need the access URL of the asset. In this case, we go back to the SortScrews repository and copy the download link.

In the dataspace UI "My Assets" page, paste this URL in the top text area and click "Add Asset" button.

In the pop-up modal menu, click the "include search engine metadata ... ".

In the below, click "import JSON" and paste your semantic model into the appeared box, and click Apply.

Enter the compulsory fields like filename and description, then select group-rox-only policy at the bottom.

Finally, create an asset