RELATIVE_POSE_FUSION_STATUS Class Reference

Report how the motion given to Camera.ingest_motion_prior() was used for the current image. More...

Detailed Description

Report how the motion given to Camera.ingest_motion_prior() was used for the current image.

Enumerator
OFF The motion prior is not used: no sample has been accepted through Camera.ingest_motion_prior() yet in this session, or the session does not run POSITIONAL_TRACKING_MODE.GEN_3.
OK The motion prior was used for this image.
MISSING No motion prior was received for this image, only the images were used. Occasional values are expected and harmless.
OUT_OF_SYNC A motion prior was available but did not cover this image's time interval, so the pose was estimated from the images alone. Occasional occurrences are harmless. Also reported when a gap leaves too much of the interval uncovered (one missed sample is tolerated, a hole several samples long is not), or when the samples are not chained: a sample whose RelativePoseData.start_timestamp is not the RelativePoseData.end_timestamp of the previous one. Reported on every frame means either the samples are not chained, or the two clocks do not agree: check that your timestamps come from the same time reference as Camera.get_timestamp() with TIME_REFERENCE.IMAGE, in nanoseconds.
REJECTED The motion prior disagreed with what the images show and was discarded for this image. Persistent values usually mean a wrong mounting transform, a wrong sign convention, or an uncertainty that is set too low.
DEFERRED The motion prior for this image had not arrived yet, because the source is slower than the camera or its samples arrive after the image: it was not applied to this image, but it is used to correct the trajectory over a longer stretch once it arrives. Expected on most images with such a source.