`skimage.transform._geometric:EssentialMatrixTransform.from_estimate`

source: /dev/scikit-image/src/skimage/transform/_geometric.py :859

Summary

Estimate essential matrix using 8-point algorithm.

Extended Summary

The 8-point algorithm requires at least 8 corresponding point pairs for a well-conditioned solution, otherwise the over-determined solution is estimated.

Parameters

src : array_like of shape (N, 2): Source coordinates.
dst : array_like of shape (N, 2): Destination coordinates.

Returns

tf : Self or :class:`~.FailedEstimation`

An instance of the transformation if the estimation succeeded. Otherwise, we return a special FailedEstimation object to signal a failed estimation. Testing the truth value of the failed estimation object will return False. E.g.

tf = EssentialMatrixTransform.from_estimate(...)
if not tf:
    raise RuntimeError(f"Failed estimation: {tf}")

Raises

: ValueError: If src has fewer than 8 rows.

Aliases

skimage.transform.EssentialMatrixTransform.from_estimate