Skip to main content

Request MPS Using the Desktop Companion App

Overview​

This page provides information about how academic research partners who have access to the Aria Research Kit (ARK) can request Machine Perception Services (MPS) using the Desktop Companion App. The Desktop Companion app is available on Windows, MacOS and Linux.

Try the MPS CLI or Aria Studio!

We recommend using the MPS CLI or Aria Studio to submit requests as they contain additional capabilities, such as resumable uploads and Multi-SLAM MPS

Desktop App recording tools page

How to Request MPS​

To request MPS processing on Aria VRS files:

  1. Go to the Recordings section of the Desktop App and select VRS Tools
  2. Select Request MPS in the Recordings toolbar
  3. Select the VRS file from the native file explorer
  4. Select what types of MPS you'd like to request
  5. Select Upload
  6. Your file's progress and the downloadable MPS outputs will become visible under Remote Uploads
    • It may take several minutes for your file to appear in the Uploads tab, especially if it is large

Once your data has been successfully processed, you can download the derived data zip file, from the Recordings toolbar. Please refer to the MPS Loader APIs on how to load the output in Python/C++ and Python visualization, C++ Visualization guides. on how to run the rich visualization tools to visualize all the MPS outputs.

Status Types​

How long it takes for a file to progress from one state to the next will depend on how big the file is and how many other requests are being processed at that time.

  • Unrequested: This type of derived data was not requested
  • Waiting: MPS request has been received and is in the queue for processing
  • Processing: This data is currently being processed
  • Complete: Data Processing is Complete, you can now download your files
  • Error:
    • VRS file did not have the data required for processing, please use a Supported Recording Profile.
    • An error occurred while processing data with a supported recording profile.
      • There are many variables that can impact MPS output. For Trajectory data you can download the summary.json file to get more information. See MPS Trajectory Documentation for more information.
      • If you've checked your recording profile and that is not the issue and you are unable to debug the issue using summary.json, please emailAriaOps@meta.comwith a bug report. Make sure you include the Transaction ID in your report and summary.json if you have one. Screenshots and screen recordings are always welcome.