openalea.phenomenal.calibration.chessboard.compass_position

openalea.phenomenal.calibration.chessboard.compass_position(rotation, south_rotation, clockwise=True, intercardinal=False)

Find the cardinal position of a rotated object

Parameters:

• rotation – the (positive) rotation angle

• south_rotation – the (positive) rotation angle that position the object the southest

• clockwise – is the object rotating clockwise ? (default True)

• intercardinal – should the intercardinal position be returned ?

Returns:

(str) the cardinal position (one of ‘North’, ‘South’, ‘East’ or ‘West’) of the object, or if intercadinal = True the intercardinal position (one of ‘NorthEast’, ‘SouthEast’, ‘SouthWest’ or ‘NorthWest’)