Oriented angles. #
THIS FILE IS SYNCHRONIZED WITH MATHLIB4. Any changes to this file require a corresponding PR to mathlib4.
This file defines oriented angles in real inner product spaces.
Main definitions #
orientation.oangle
is the oriented angle between two vectors with respect to an orientation.
Implementation notes #
The definitions here use the real.angle
type, angles modulo 2 * π
. For some purposes,
angles modulo π
are more convenient, because results are true for such angles with less
configuration dependence. Results that are only equalities modulo π
can be represented
modulo 2 * π
as equalities of (2 : ℤ) • θ
.
References #
- Evan Chen, Euclidean Geometry in Mathematical Olympiads.
The oriented angle from x
to y
, modulo 2 * π
. If either vector is 0, this is 0.
See inner_product_geometry.angle
for the corresponding unoriented angle definition.
Oriented angles are continuous when the vectors involved are nonzero.
If the first vector passed to oangle
is 0, the result is 0.
If the second vector passed to oangle
is 0, the result is 0.
If the two vectors passed to oangle
are the same, the result is 0.
If the angle between two vectors is nonzero, the first vector is nonzero.
If the angle between two vectors is nonzero, the second vector is nonzero.
If the angle between two vectors is nonzero, the vectors are not equal.
If the angle between two vectors is π
, the first vector is nonzero.
If the angle between two vectors is π
, the second vector is nonzero.
If the angle between two vectors is π
, the vectors are not equal.
If the angle between two vectors is π / 2
, the first vector is nonzero.
If the angle between two vectors is π / 2
, the second vector is nonzero.
If the angle between two vectors is π / 2
, the vectors are not equal.
If the angle between two vectors is -π / 2
, the first vector is nonzero.
If the angle between two vectors is -π / 2
, the second vector is nonzero.
If the angle between two vectors is -π / 2
, the vectors are not equal.
If the sign of the angle between two vectors is nonzero, the first vector is nonzero.
If the sign of the angle between two vectors is nonzero, the second vector is nonzero.
If the sign of the angle between two vectors is nonzero, the vectors are not equal.
If the sign of the angle between two vectors is positive, the first vector is nonzero.
If the sign of the angle between two vectors is positive, the second vector is nonzero.
If the sign of the angle between two vectors is positive, the vectors are not equal.
If the sign of the angle between two vectors is negative, the first vector is nonzero.
If the sign of the angle between two vectors is negative, the second vector is nonzero.
If the sign of the angle between two vectors is negative, the vectors are not equal.
Swapping the two vectors passed to oangle
negates the angle.
Adding the angles between two vectors in each order results in 0.
Negating the first vector passed to oangle
adds π
to the angle.
Negating the second vector passed to oangle
adds π
to the angle.
Negating the first vector passed to oangle
does not change twice the angle.
Negating the second vector passed to oangle
does not change twice the angle.
Negating both vectors passed to oangle
does not change the angle.
Negating the first vector produces the same angle as negating the second vector.
The angle between the negation of a nonzero vector and that vector is π
.
The angle between a nonzero vector and its negation is π
.
Twice the angle between the negation of a vector and that vector is 0.
Twice the angle between a vector and its negation is 0.
Adding the angles between two vectors in each order, with the first vector in each angle negated, results in 0.
Adding the angles between two vectors in each order, with the second vector in each angle negated, results in 0.
Multiplying the first vector passed to oangle
by a positive real does not change the
angle.
Multiplying the second vector passed to oangle
by a positive real does not change the
angle.
Multiplying the first vector passed to oangle
by a negative real produces the same angle
as negating that vector.
Multiplying the second vector passed to oangle
by a negative real produces the same angle
as negating that vector.
The angle between a nonnegative multiple of a vector and that vector is 0.
The angle between a vector and a nonnegative multiple of that vector is 0.
The angle between two nonnegative multiples of the same vector is 0.
Multiplying the first vector passed to oangle
by a nonzero real does not change twice the
angle.
Multiplying the second vector passed to oangle
by a nonzero real does not change twice the
angle.
Twice the angle between a multiple of a vector and that vector is 0.
Twice the angle between a vector and a multiple of that vector is 0.
Twice the angle between two multiples of a vector is 0.
If the spans of two vectors are equal, twice angles with those vectors on the left are equal.
If the spans of two vectors are equal, twice angles with those vectors on the right are equal.
If the spans of two pairs of vectors are equal, twice angles between those vectors are equal.
The oriented angle between two vectors is zero if and only if the angle with the vectors swapped is zero.
The oriented angle between two vectors is zero if and only if they are on the same ray.
The oriented angle between two vectors is π
if and only if the angle with the vectors
swapped is π
.
The oriented angle between two vectors is π
if and only they are nonzero and the first is
on the same ray as the negation of the second.
The oriented angle between two vectors is zero or π
if and only if those two vectors are
not linearly independent.
The oriented angle between two vectors is zero or π
if and only if the first vector is zero
or the second is a multiple of the first.
The oriented angle between two vectors is not zero or π
if and only if those two vectors
are linearly independent.
Two vectors are equal if and only if they have equal norms and zero angle between them.
Two vectors with equal norms are equal if and only if they have zero angle between them.
Two vectors with zero angle between them are equal if and only if they have equal norms.
Given three nonzero vectors, the angle between the first and the second plus the angle between the second and the third equals the angle between the first and the third.
Given three nonzero vectors, the angle between the second and the third plus the angle between the first and the second equals the angle between the first and the third.
Given three nonzero vectors, the angle between the first and the third minus the angle between the first and the second equals the angle between the second and the third.
Given three nonzero vectors, the angle between the first and the third minus the angle between the second and the third equals the angle between the first and the second.
Given three nonzero vectors, adding the angles between them in cyclic order results in 0.
Given three nonzero vectors, adding the angles between them in cyclic order, with the first vector in each angle negated, results in π. If the vectors add to 0, this is a version of the sum of the angles of a triangle.
Given three nonzero vectors, adding the angles between them in cyclic order, with the second vector in each angle negated, results in π. If the vectors add to 0, this is a version of the sum of the angles of a triangle.
The angle at the apex of an isosceles triangle is π
minus twice a base angle, oriented
vector angle form.
The angle between two vectors, with respect to an orientation given by orientation.map
with a linear isometric equivalence, equals the angle between those two vectors, transformed by
the inverse of that equivalence, with respect to the original orientation.
The oriented angle on an oriented real inner product space of dimension 2 can be evaluated in terms of a complex-number representation of the space.
Negating the orientation negates the value of oangle
.
The inner product of two vectors is the product of the norms and the cosine of the oriented angle between the vectors.
The cosine of the oriented angle between two nonzero vectors is the inner product divided by the product of the norms.
The cosine of the oriented angle between two nonzero vectors equals that of the unoriented angle.
The oriented angle between two nonzero vectors is plus or minus the unoriented angle.
The unoriented angle between two nonzero vectors is the absolute value of the oriented angle, converted to a real.
If the sign of the oriented angle between two vectors is zero, either one of the vectors is zero or the unoriented angle is 0 or π.
If two unoriented angles are equal, and the signs of the corresponding oriented angles are equal, then the oriented angles are equal (even in degenerate cases).
If the signs of two oriented angles between nonzero vectors are equal, the oriented angles are equal if and only if the unoriented angles are equal.
The oriented angle between two vectors equals the unoriented angle if the sign is positive.
The oriented angle between two vectors equals minus the unoriented angle if the sign is negative.
The oriented angle between two nonzero vectors is zero if and only if the unoriented angle is zero.
The oriented angle between two vectors is π
if and only if the unoriented angle is π
.
One of two vectors is zero or the oriented angle between them is plus or minus π / 2
if
and only if the inner product of those vectors is zero.
If the oriented angle between two vectors is π / 2
, the inner product of those vectors
is zero.
If the oriented angle between two vectors is π / 2
, the inner product of those vectors
(reversed) is zero.
If the oriented angle between two vectors is -π / 2
, the inner product of those vectors
is zero.
If the oriented angle between two vectors is -π / 2
, the inner product of those vectors
(reversed) is zero.
Negating the first vector passed to oangle
negates the sign of the angle.
Negating the second vector passed to oangle
negates the sign of the angle.
Multiplying the first vector passed to oangle
by a real multiplies the sign of the angle by
the sign of the real.
Multiplying the second vector passed to oangle
by a real multiplies the sign of the angle by
the sign of the real.
Auxiliary lemma for the proof of oangle_sign_smul_add_right
; not intended to be used
outside of that proof.
Adding a multiple of the first vector passed to oangle
to the second vector does not change
the sign of the angle.
Adding a multiple of the second vector passed to oangle
to the first vector does not change
the sign of the angle.
Subtracting a multiple of the first vector passed to oangle
from the second vector does
not change the sign of the angle.
Subtracting a multiple of the second vector passed to oangle
from the first vector does
not change the sign of the angle.
Adding the first vector passed to oangle
to the second vector does not change the sign of
the angle.
Adding the second vector passed to oangle
to the first vector does not change the sign of
the angle.
Subtracting the first vector passed to oangle
from the second vector does not change the
sign of the angle.
Subtracting the second vector passed to oangle
from the first vector does not change the
sign of the angle.
Subtracting the second vector passed to oangle
from a multiple of the first vector negates
the sign of the angle.
Subtracting the first vector passed to oangle
from a multiple of the second vector negates
the sign of the angle.
Subtracting the second vector passed to oangle
from the first vector negates the sign of
the angle.
Subtracting the first vector passed to oangle
from the second vector negates the sign of
the angle.
Subtracting the first vector passed to oangle
from the second vector then swapping the
vectors does not change the sign of the angle.
Subtracting the second vector passed to oangle
from the first vector then swapping the
vectors does not change the sign of the angle.
The sign of the angle between a vector, and a linear combination of that vector with a second vector, is the sign of the factor by which the second vector is multiplied in that combination multiplied by the sign of the angle between the two vectors.
The sign of the angle between a linear combination of two vectors and the second vector is the sign of the factor by which the first vector is multiplied in that combination multiplied by the sign of the angle between the two vectors.
The sign of the angle between two linear combinations of two vectors is the sign of the determinant of the factors in those combinations multiplied by the sign of the angle between the two vectors.
A base angle of an isosceles triangle is acute, oriented vector angle form.
A base angle of an isosceles triangle is acute, oriented vector angle form.