Repository: ManimCommunity/manim
File: manim/mobject/geometry/line.py (Python)

Code before:

        .. manim:: GetValueExample
            :save_last_frame:

            class GetValueExample(Scene):
                def construct(self):
                    line1 = Line(LEFT+(1/3)*UP, RIGHT+(1/3)*DOWN)
                    line2 = Line(DOWN+(1/3)*RIGHT, UP+(1/3)*LEFT)

                    angle = Angle(line1, line2, radius=0.4)

                    value = DecimalNumber(angle.get_value(degrees=True), unit="^{\\circ}")
                    value.next_to(angle, UR)

                    self.add(line1, line2, angle, value)
        """

        if degrees:
            return self.angle_value / DEGREES
        return self.angle_value

    @staticmethod
    def from_three_points(
        A: np.array(), B: np.array(), C: np.array(), **kwargs
    ) -> Angle:
        """Create an instance of the :class:`Angle` class from three points.

        Parameters
        ----------
        A
            :class:Numpy.array()  -  End point of line 1
        B
            :class:Numpy.array()  -  Start point of lines 1 and 2
        C
            :class:Numpy.array()  -  End point of line 2
        **kwargs
            keyword arguments are passed to Angle constructor

        Returns
        -------
        : The Angle calculated from the three points

        Examples
        --------
        ::
            >>> A = np.array(UP)
            >>> B = np.array(ORIGIN)
            >>> C = np.array(RIGHT)
            >>> ang = Angle.from_three_points(A, B, C)
        """
        return Angle(Line(B, A), Line(B, C), **kwargs)

Review comment (suggestion):
```suggestion
        r"""The angle between the lines AB and BC.
        
        This constructs the angle :math:`\angle ABC`.
```

Suggestion for a slightly more concise one-line summary.

Code after:

        .. manim:: GetValueExample
            :save_last_frame:

            class GetValueExample(Scene):
                def construct(self):
                    line1 = Line(LEFT+(1/3)*UP, RIGHT+(1/3)*DOWN)
                    line2 = Line(DOWN+(1/3)*RIGHT, UP+(1/3)*LEFT)

                    angle = Angle(line1, line2, radius=0.4)

                    value = DecimalNumber(angle.get_value(degrees=True), unit="^{\\circ}")
                    value.next_to(angle, UR)

                    self.add(line1, line2, angle, value)
        """

        if degrees:
            return self.angle_value / DEGREES
        return self.angle_value

    @staticmethod
    def from_three_points(
        A: np.ndarray, B: np.ndarray, C: np.ndarray, **kwargs
    ) -> Angle:
        """The angle between the lines AB and BC.

        This constructs the angle :math:`\angle ABC`.

        Parameters
        ----------
        A
            The endpoint of the first angle leg
        B
            The vertex of the angle
        C
            The endpoint of the second angle leg

        **kwargs
            Further keyword arguments are passed to :class:`.Angle`

        Returns
        -------
        The Angle calculated from the three points

                    Angle(line1, line2, radius=0.5, quadrant=(-1,1), stroke_width=8),
                    Angle(line1, line2, radius=0.7, quadrant=(-1,-1), color=RED, other_angle=True),

        Examples
        --------
        .. manim:: AngleFromThreePointsExample