Data Portal
MSA uses the Data Portal to exchange sensor data and results.
- Access the Data Portal by completing the demo page
- Data and results are associated with a Platform, Instance, and Log
- Data Portal interactions can be automated via the API
Access
Credentials to use the Data Portal are provided upon submission of the form on the demo page.
Coworkers have shared visibility of all logs.
Data Portal terminology
- Platform: a configuration of hardware and software (a type of robot)
- Instance: one particular instance of a Platform (a robot)
- Log: sensor data associated with one session
Platform vs. Instance
The Roomba i3 is a platform. The Roomba you have at home is an instance.
Instances of a platform are nominally all the same, but this is often not strictly true due to manufacturing tolerances, slightly different versions of hardware, minor software differences, etc.
Logs
A log is all the sensor data recorded during one session.
Each log has some associated data:
| Field | Description |
|---|---|
| Date | When the log was created |
| Name | The account name who created the log |
| Log Name | The system-generated unique name for the log |
| Label | A comment provided when the log was created |
| Robot | <Platform>.<Instance> |
| Status | The current status, see Log status |
Each log has a unique URL; the log’s webpage contains:
- A collection of files; more can be added before the log is submitted for analysis
- A collection of notes, which can be added to by you and MSA
- Analysis results available for download (calibrations, pose trajectories, reports, etc)
Log status
| Status | Locked? | Description |
|---|---|---|
| Log Created | Unlocked | The log has been created; files can be added |
| Queued | Locked | Processing has not started |
| In Progress | Locked | Processing and human review is underway |
| Complete | Locked | The analysis was successful; a download is available |
| Failed | Locked | The analysis failed; an error note is available |
| Cancelled | Locked | The analysis was cancelled; no downloads are available |
Data Portal instructions
Create an instance
- Log in to the Data Portal with your MSA-provided credentials
- Click “Manage Robots”
- If necessary, create a new platform
- Create a new instance associated with the appropriate platform
Upload sensor data
- Log in to the Data Portal with your MSA-provided credentials
- Click “Dashboard”
- Enter a log label, which we recommend include a human-readable note about who operated the system during the data collection, where the data was collected, and any other helpful notes
- Select the system instance that collected this log
- Click “Create Log”
- Select and upload all sensor data for the log
- Click “Submit” after all uploads have completed to start the analysis
Result notification
You will be notified by email when a result is available. The email includes a link to the log record, where you can review MSA-provided notes and download the result.