Upload your first scene
When uploading raw data to the Kognic Platform, you need to do so in the form of a scene. A scene is a collection of data from different sources, such as images, point clouds, and other sensor data.
This guide will walk you through the process of uploading your first scene, either in 2D (camera only) or 3D (camera and LiDAR/RADAR).
You have successfully followed the Quickstart guide and have the kognic-io library installed. For users with access to multiple workspaces you need to specify a workspace to upload data too.
To upload a 2D scene, you need to have the raw images available on your local machine (or create a callback for remote data). It is a two-step process:
- Build the scene object in Python
- Upload the scene object to the Kognic Platform
Below follows examples for a few different cases.
To upload a 2D/3D scene, you need to have the raw images and point clouds available on your local machine (or create a callback for remote data). In addition you need to have calibration data available. It is a three-step process:
- Build the scene object in Python, referencing the calibration from the previous step
- Upload the scene object to the Kognic Platform
Below follows examples for a few different cases.
Multiple point clouds is also supported, but not shown in the examples above since that requires a bit more data. See the Motion compensation section for more details.
We have exemplar code and a tutorial for uploading scenes using Zenseact Open Dataset (ZOD) data, including 2D, 3D, and aggregated 3D scenes. Check out the guide document and exemplar code here!
If you have the ZOD data downloaded, and have Kognic API credentials, the examples will run out of the box to create functional scenes!
To use the below install koginc io version >2.5.1
The model and method used for creating a scene this way is slightly different from the above. All scenes are considered sequences and there is no need to use a specific model for different scene types.
To use this feature need to have configured a data integration .
If you have your data in a kognic supported format on bucket that you have set up a data integration for, then there is no need for you to download you data locally to then upload it to kognic. Instead it's sufficent to point out the files in your bucket.
To use this feature need to have configured a data integration .
If you have your data in a kognic supported format on bucket that you have set up a data integration for, then there is no need for you to download you data locally to then upload it to kognic. Instead it's sufficent to point out the files in your bucket.
This model also allows you to upload imu data, which is expected as a json file containing the following format: