Introduction

To understand why Myo exists and what problems it solves, see Why MyoSapiens?.

Key Concepts

Assets

Assets are files exchanged with the platform. You upload assets (like C3D files and markersets) and the platform creates output assets (like joint angles) when jobs complete.

Each asset has:

• A unique ID for referencing it in API calls
• A purpose indicating what type of file it is
• A status showing whether it's ready to use
• Metadata like filename, size, and checksum

The SDK automatically detects the purpose from file extensions. See the File Formats guide for supported formats and purposes.

Jobs

Jobs are processing tasks that run on our cloud infrastructure. When you want to retarget motion data to a character, you create a retarget job.

Job types:

• retarget - Map motion capture data onto a character skeleton

Job statuses:

• QUEUED - Waiting to be processed
• RUNNING - Currently being processed
• SUCCEEDED - Completed successfully with output
• FAILED - Something went wrong
• CANCELED - Job was canceled

The SDK provides a convenient wait() method that polls until a job completes. See the Retargeting Tutorial for a complete example of job management.

Retarget job parameters:

• Required: C3D file and markerset XML (via asset IDs or S3 keys)
• Optional: Character selection, scaling options, subject measurements

See the Retarget Parameters guide for complete parameter documentation.

Output Format

Retarget jobs produce .npz files (NumPy compressed archive) containing standardized joint angles and joint names. See the File Formats guide for complete details on the output format and how to use it.

Next Steps

• Install the SDK to start using MyoSapiens
• Set up your account at dev.myolab.ai
• Follow the Retargeting Tutorial for a complete walkthrough
• Learn more about Why Myo? and our approach to motion processing