from_path_ends#
- classmethod Vector3d.from_path_ends(vectors: list | tuple | Vector3d, close: bool = False, steps: int = 100) Vector3d [source]#
Return vectors along the shortest path on the sphere between two or more consectutive vectors.
- Parameters:
- vectors
Two or more vectors to get paths between.
- close
Whether to append the first to the end of
vectors
in order to close the paths when more than two vectors are passed. Default is False.- steps
Number of vectors in the great circle about the normal vector between each two vectors before restricting the circle to the path between the two. Default is 100. More steps give a smoother path on the sphere.
- Returns:
paths
Vectors along the shortest path(s) between given vectors.
Notes
The vectors along the shortest path on the sphere between two vectors \(v_1\) and \(v_2\) are found by first getting the vectors \(v_i\) along the great circle about the vector normal to these two vectors, and then only keeping the part of the circle between the two vectors. Vectors within this part satisfy these two conditions
\[\begin{split}(v_1 \times v_i) \cdot (v_1 \times v_2) \geq 0,\\ (v_2 \times v_i) \cdot (v_2 \times v_1) \geq 0.\end{split}\]