Understand Auto Recover Camera Pose
Auto Recover Camera Pose is closely related to the manual Recover Camera Pose operation (see Use Recover Camera Pose). A monitoring process checks to see if individual cameras appear to have calibration issues (based on their Centroid Connectivity score – see Examine the main health metrics), and automatically starts and stops collecting data to use in the recovery process. Any resulting change in calibration is assessed prior to an update being made, including whether the data collected appears to sufficiently cover the camera under assessment.
Auto Recover Camera Pose can heal individual cameras if objects are being tracked and are moving.
Note
If you decide that a particular camera needs healing, it is almost always better to use the manual Recover Camera Pose as this gives you closer control over what data is to be collected and has fewer restrictions than Auto Recover Camera Pose as to the data that can be used to heal the camera.
Understand automatic recovery of moved cameras
When Enable Auto Recover Camera Pose is selected, the system detects cameras that have low centroid connectivity scores (below 25%) and may place them under consideration for recovery.
Important
For Auto Recover Camera Pose to work, at least 50% of the enabled objects must currently be tracked by the cameras.
For this reason, disable any objects that are not currently being tracked.
For successful automatic recovery of moved cameras, ensure that your system meets the following criteria:
- At least 50% of the enabled objects must currently be tracked by the cameras (see above note).
- The cameras’ internal parameters (focal length, radial distortion, etc) do not change.
- The cameras have achieved a stable operating temperature before calibration and before starting tracking.
- Objects are being successfully tracked and the majority of cameras are showing no problems via the camera calibration health metrics (Understand the System Health Report)
If the above criteria are met, the system attempts to recover the position of the camera. It collects data for a short time and if there is sufficient coverage in the Cameras view and the system can find a solution, it applies a new calibration for this camera. This causes the system calibration file to be re-saved to the following default location:
C:\ProgramData\Vicon\Calibrations\LatestCalibration.xcp
System Health Report
The System Health Report has a dedicated Auto Recover Camera Pose section that provides information on:
- Whether the feature is active
- Which cameras are currently under consideration (ie,. may require healing)
- The history of which cameras have had Auto Recover Camera Pose attempted and how many of those attempts were successful
For more information, see Understand the System Health Report.
Deactivate Auto Recover Camera Pose
In some situations, you may need to deactivate Auto Recover Camera Pose, for example, for systems where there is no overhead for the additional processing required, and in some cases where large numbers of moving centroids are generated from non-object sources (eg, reflections from participants' clothing). In this latter case, some other mitigation is often available (eg, by reducing the strobe intensity of the cameras), but in extreme cases it may be better to deactivate Auto Recover Camera Pose, and to manually heal cameras with Recover Camera Pose instead.
To turn off Auto Recover Camera Pose:
Do one of the following:
-
In the Processing panel, go to the Camera Healing section and clear Enable Auto Recover Camera Pose.
Or
-
In the System Health Report, go to the Auto Recover Camera Pose section and clear the check box.