Upload and Export Data
Download machine data to or upload data from your computer with the Viam CLI or data client API. Also, upload images to the cloud directly through the Viam mobile app.
Export data with the Viam CLI
Then, to export data from the data management service in the cloud:
Navigate to the DATA page in the Viam app.
Below the SEARCH button in the Filtering panel, click Copy Export Command to copy the export command to the clipboard.
Run the copied command in a terminal:
viam data export --org-ids=<org-id> --data-type=binary --mime-types=<mime types> --destination=.
This command uses the Viam CLI to download the data locally onto your computer based on the search criteria you select in the Viam app.
By default, the command creates a new directory named
datain the current directory and downloads the specified data. If you want to store the data in a different location, change the specified folder with the
Once the command has finished running and downloading the data, you can view and use the data locally.
Since data is downloaded in parallel, the order is not guaranteed. Sort your folder by filename in order to see them in chronological order.
You can see more information about exporting data in the Viam CLI documentation.
Manage data with the data client API
A set of methods using the data client API for managing data, including export, batch delete, tag, and upload functions, are provided in the Python SDK.
The following methods are supported by the data client API:
|Filter and download tabular data.
|Filter and download binary data.
|Download binary data by IDs.
|Delete tabular data older than a specified number of days.
|Filter and delete binary data.
|Filter and delete binary data by ids.
|Add tags to binary data by ids.
|Add tags to binary data by filter.
|Remove tags from binary data by ids.
|Remove tags from binary data by filter.
|Get tags from data by filter.
|Get a list of bounding box labels using a Filter.
|Get a connection to access a MongoDB Atlas Data federation instance.
|Upload binary data collected on your machine through a specific component and the relevant metadata to the Viam app.
|Upload tabular data collected on your machine through a specific component and the relevant metadata to the Viam app.
|Upload the contents of streaming binary data and the relevant metadata to the Viam app.
|Upload file data stored on your machine and the relevant metadata to the Viam app.
|Upload file data stored on your machine from the specified filepath and the relevant metadata to the Viam app.
|Add a bounding box to an image specified by its BinaryID.
|Removes a bounding box from an image specified by its BinaryID.
Click on the method name for more information.
Upload images with the Viam mobile app
Upload images as machine data straight from your phone, skipping the normal data capture and cloud synchronization process, through the Viam mobile app. This is useful if you want to capture images for training machine learning models on the go.
- Select Home on the mobile app, choose your organization, and select a location and machine.
- Click the menu button marked “…” in the upper right corner.
- Click Upload Images.
- Select each image you want to upload, and click Add.
As for metadata, these images are associated with the machine part you selected, and aren’t associated with a component or method.
For a comprehensive tutorial on using data capture and synchronization together with the ML model service, see Capture Data and Train a Model.
Have questions, or want to meet other people working on robots? Join our Community Discord.
Was this page helpful?
Glad to hear it! If you have any other feedback please let us know:
We're sorry about that. To help us improve, please tell us what we can do better: