Report how the motion given to Camera.ingest_motion_prior() was used for the current image. More...
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. |