wait_for_fixation_end() doesn't return what it is expected in libeyetribe.py (EDIT: Documentation issue)

[kismari]

Reading the documentation, this function must return "time, startpos, endpos" but, instead of that, it returns clock.get_time(), spos

[esdalmaijer]

Thanks for the report! That's actually an error in the documentation, sorry! The function should return ending time and position. The starting and ending position should be roughly the same, hence only one of them is returned. (In fact, the point of the detection is that the current gaze position hasn't drifted too far from the starting position.)

Note that these wait_for_* functions are to implement gaze contingent functionality, and thus they're not as precise as offline analyses would be. (Hence you only get the rough position of the fixation, and not the higher detail info on what happened during the fixation.)