SoftBank Robotics documentation What's new in NAOqi 2.8?

ALVisualSpaceHistory

NAOqi Vision - Overview | API


What it does

ALVisualSpaceHistory keeps track of the head movements of the robot to build a timestamped map of the head positions. This can be useful when exploring the environment to make the robot look in every direction.

How it works

ALVisualSpaceHistory is an ALExtractor that regularly queries the head angles of the robot and updates a grid containing the timestamp of the last time the head looked in a particular direction.

Visual grid data
The “visual space” denotes all the possible head positions of the robot. If we took snapshots of what the camera sees at different locations and stitched them together, we would obtain a “visual map”. ALVisualSpaceHistory does not store such a map but creates a grid by dividing it into small rectangular cells which contain the timestamp of the last time that the robot’s camera could see this area of the visual space.
Grid precision

The cell size is determined by the parameter grid precision which can be changed by calling ALVisualSpaceHistoryProxy::setGridPrecision.

This precision is the ratio of the camera field of view in radian divided by the field of view corresponding to one grid cell. If the precision is 2.0, then a grid cell represents a quarter of the camera field of view. A high grid precision gives a more accurate grid but also requires more processing time.

On every grid update the module pushes data to the ALMemory key VisualSpaceHistory/VisualGrid/Data.

Performances and limitations

If the robot moves more than its head, the grid must be manually reset by calling ALVisualSpaceHistoryProxy::resetGrid.

Indeed, the “visual grid” is build using only the head position, it becomes obsolete as soon as the FRAME_TORSO space moves with respect to the FRAME_WORLD (in case of displacement on the ground for example). For further details, see: Frames.