skspatial.objects.Circle.from_points¶

classmethod Circle.from_points(point_a: Union[ndarray, Sequence], point_b: Union[ndarray, Sequence], point_c: Union[ndarray, Sequence], **kwargs) → Circle[source]¶

Instantiate a circle from three points.

Parameters

point_a, point_b, point_c: array_like: Three points defining the circle. The points must be 2D.
kwargs: dict, optional: Additional keywords passed to Points.are_collinear().

Returns

Circle: Circle containing the three input points.

Raises

ValueError: If the points are not 2D. If the points are collinear.

Examples

>>> from skspatial.objects import Circle

>>> Circle.from_points([-1, 0], [0, 1], [1, 0])
Circle(point=Point([-0.,  0.]), radius=1.0)

>>> Circle.from_points([1, 0, 0], [0, 1], [1, 0])
Traceback (most recent call last):
...
ValueError: The points must be 2D.

>>> Circle.from_points([0, 0], [1, 1], [2, 2])
Traceback (most recent call last):
...
ValueError: The points must not be collinear.