WorkLink Scenarios: Precision 3D Object Alignment
Precision 3D Object Alignment is a feature that significantly improves the accuracy of aligning to real world objects. Obtaining two additional angles can improve alignment such that the mean deviation is less than 3mm which is more than 2x more accurate than before.
Step-by-Step Instructions
-
Enable Precision 3D Object Alignment in Settings:
- Open the WorkLink App.
- While viewing the list of scenarios, tap on the Settings icon (⛭) in the upper-right corner of the screen.
- Toggle on the Precision 3D Object Alignment option to enable this feature. Note that enabling this feature will disable Active Tracking on mobile devices.
- In case you want to use 25 segments instead of 9, be sure Object Tracking Debug is enabled as well, so you can turn on Increase Precision Alignment Segments in debug mode while aligning.
- Exit the Settings menu to return to the Scenario List.
-
Load a Scenario with AR Object Trackers
- From the Scenario List, load a scenario that includes at least one AR object tracker.
-
Start Alignment
- During content placement, select any AR object tracker to start the alignment process.
- When the real-world object is initially aligned, the app will prompt you to obtain more angles to improve alignment.
-
Precision Alignment Segments
- The angle capture sphere has 25 areas or segments.
-
Obtain Additional Angles
- It is highly recommended to capture two additional angles that are furthest away from the center for optimal accuracy. Ideally use angles from which you will view the content throughout the scenario for optimal perceived accuracy.
- If you do not need additional angles and are satisfied with the initial alignment, tap on Skip.
- For each additional angle, use the sphere gizmo to guide you. Tap on the screen to confirm each angle. Hold still while capturing the additional angle. Each section of the sphere will turn green as you capture an angle.
- Usually 1 or 2 additional angles should be sufficient. Use angles that are furthest away from the center for optimal accuracy.
- It is not needed to capture all angles, you can confirm after you're satisfied with the accuracy you perceive.
- If the last angle does not improve alignment based on your visual inspection, tap on Remove Last to discard it.
- To restart the alignment process from the beginning, tap on Start Over.
-
Finish Alignment
- Once you are satisfied with the alignment, tap on Confirm to finalize the placement of the AR content.
FAQ
Q: Why doesn't my precision alignment seem to get better?
The WorkLink App provides debugging tools to help diagnose alignment issues. Several factors may affect precision alignment.
Understanding Precision Alignment
With the February 2025 release of WorkLink (2.31.0), a notification displays:
Matching Measurements: X, Recommended: 3.
- Matching measurements = the total amount of measurements the algorithm is using to come to a better precision alignment result.
- Recommended = 3, we recommend confirming precision alignment after capturing at least 3 matching measurements.
Precision alignment captures multiple SLAM position measurements and adds them to a measurement pool. An algorithm evaluates these positions and selects plausible ones to average them into a more accurate SLAM position, improving tracking precision.
Compared to single-measurement tracking, precision alignment helps reduce axis-based offsets, which commonly occur when confirming an object tracking angle, placing an object’s position from a single viewpoint in SLAM. These offsets become noticeable when viewing the object from a different angle.
Common Reasons for Precision Alignment Issues
1. False Positives (Incorrect Tracking Data)
- Cause: If inlier ratio values are set too low during authoring, the tracking algorithm may recognize incorrect features as part of the object, leading to unstable positioning.
- Symptoms: The object appears to "fly around" irratically or shift unpredictably.
-
Mitigation:
- Use the app’s debugging tools with active tracking to observe false positives.
- Increase the inlier ratio threshold to prevent incorrect matches while ensuring it is not too high, which could prevent tracking altogether.
2. Object Movement Between Measurements
- Cause: If the tracked object is moved between precision alignment measurements, SLAM positions will vary significantly, and previous valid positions will be discarded.
-
Mitigation:
- Keep the object stationary while capturing measurements.
3. Poor SLAM Conditions
Unstable SLAM tracking can cause misalignment and inconsistent measurements. Potential causes include:
Issue | Description |
---|---|
Poor lighting | Too dark or overly bright conditions. |
Lack of visual features | Plain surfaces (like a white featureless floor) or highly uniform areas. |
Reflective surfaces | Reflective/glass materials can be problematic for SLAM tracking, as it can confuse the reflective surface with the reflected features, creating incorrect depth assessment. |
Motion blur | Fast movements affecting SLAM tracking stability. |
Occlusions | Objects blocking key reference points. Ensuring the camera captures enough environmental details can help, for example by showing it the areas you will be using the AR experience in, so additional reference points can be gathered. |
Repetitive textures | Identical patterns (e.g., repetitive carpet patterns) can confuse the tracking system. |
Environmental changes | Moving objects (e.g., tracking near a window on a moving train) or shifting lighting (e.g., changing shadows). |
-
Mitigation:
- Ensure the device has clear, well-lit, and feature-rich surroundings for tracking.
- Minimize sudden movements and occlusions.
- If necessary, reposition the camera to include more environmental reference points.
Q: What is SLAM?
A: Simultaneous Localization and Mapping: SLAM in AR refers to a technology that enables real-time tracking of a device's position and orientation while simultaneously constructing a map of the environment, allowing for accurate placement of virtual objects in the real world.
Q: What is the inlier ratio?
A: The inlier ratio in object tracking is a percentage-based match that compares a line model, generated from a 3D model, with hard contrast lines in the video feed. This comparison is used to measure the success of object tracking.