3D Data Transformation

​

Overview

The 3D Data Transformation Script demonstrates how to convert 3D coordinate data from one reference frame to another, following the standard used within our system. This script is designed to transform data into the same reference frame found in the downloaded CSV files, ensuring consistency and compatibility across different datasets.

​

Key Features

• Rotation and Translation: Transform data from the camera reference frame to the Uplift reference frame using customizable rotations and translations.
• CSV File Input and Output: Work with 3D data stored in CSV files, where the script reads the input, applies transformations, and outputs the transformed data to a new CSV file.

​

Data differences to the CSV Download from the Web app

This API provides raw, untransformed 3D data in the primary camera coordinate frame to ensure maximum flexibility and accuracy across different usecases. The CSV export applies transformations such as OpenGL rotation and left hip centering specifically for visualization, but not all clients require these changes.

Different clients may have different needs when working with the data. By providing raw data in the primary camera coordinate frame, each client can apply transformations suited to their own rendering pipeline or analytical framework rather than having to undo predefined adjustments. This also preserves data integrity and prevents potential data loss that could occur from applying transformations before distribution.

Some clients may also prefer different reference frames, such as foot-centered instead of left-hip-centered. If the API imposed a specific transformation, it could create unnecessary complexity for users who need a different structure. Additionally, reference points like the left hip can be noisy due to tracking inconsistencies, making it unreliable as a fixed transformation for all use cases. Providing raw data in the primary camera coordinate frame ensures that clients can choose the most stable and meaningful reference frame for their application.

For those who need the CSV-style transformations, we provide scripts that apply the same adjustments.

​

Learn More

For detailed instructions on setting up and running the script, including how to customize the transformations, explore the full documentation available in the script’s repository.