PR #276 introduced the function compute_forward_vector() and it's alias compute_head_direction_vector() to movement. Given that the existing polar coordinates example written by @sfmig already makes use of head/forward vectors (and derivates thereof), this might be a straightforward place to show off the new functions, while simultaneously helping users learn about vectors and polar coordinates in movement more broadly.
Note that due to the fact that @sfmig's original implementation computes "head_vector" slightly differently than compute_forward_vector(), implementing the new function here may require us to make fairly comprehensive changes to the example code - not only at the point that the head-vector itself is computed, but also in its downstream analyses (see discussion here). We can consider whether it is ultimately worth editing this example to use the new functions, or whether it might be worth creating a new, dedicated example once we have implemented more heading and navigation-related functions down the line.
PR #276 introduced the function
compute_forward_vector()and it's aliascompute_head_direction_vector()tomovement. Given that the existing polar coordinates example written by @sfmig already makes use of head/forward vectors (and derivates thereof), this might be a straightforward place to show off the new functions, while simultaneously helping users learn about vectors and polar coordinates inmovementmore broadly.Note that due to the fact that @sfmig's original implementation computes "head_vector" slightly differently than
compute_forward_vector(), implementing the new function here may require us to make fairly comprehensive changes to the example code - not only at the point that the head-vector itself is computed, but also in its downstream analyses (see discussion here). We can consider whether it is ultimately worth editing this example to use the new functions, or whether it might be worth creating a new, dedicated example once we have implemented more heading and navigation-related functions down the line.