Tortoise3D - Like 3D turtle graphics, but without the graphics part.

This Python package does not provide any graphical output!

It allows you to move a turtle (tortoise) in 3D space and query the coordinates to include it in your own scripts or modules.

A Tortoise3D instance keeps track of its position in world space and a local coordinate system. This local space may differ from the world coordinate system as a result of a rotation of the tortoise. The basic movement operations - e.g. forwardX() - move the tortoise by a user defined distance (by default this distance is 1). These basic movements always operate on the local coordinate system. A tortoise instance also maintains a simple stack, allowing you to push and pop the tortoise's state.

Example Usage:

Create the Tortoise3D instance, move it one unit in x direction, rotate it by 90 degrees around the y-axis and move it one unit in the new x direction. Save the tortoise position in the variables x, y and z.

>>> import tortoise3d
>>> tortoise = tortoise3d.Tortoise3D ()
>>> tortoise.forwardX ()
((0.0, 0.0, 0.0), (1.0, 0.0, 0.0))
>>> tortoise.radians (False)
>>> tortoise.rotateY (90)
>>> (_, (x, y, z)) = tortoise.forwardX ()


Tortoise3D is not available on PyPI. You need to manually download (or clone) it. After that, use the following commands to install it.

To install Tortoise3D for all users, run:

python install

To install it in your $HOME directory, run:

python install --user

More options are available. For more details see

python --help install


Documentation is available from within Python:

>>> import tortoise3d
>>> help (tortoise3d.tortoise3d)


Copyright 2008-2010, 2014 Stefan Goebel <tortoise3d at subtype dot de>

Tortoise3D is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Tortoise3D is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Tortoise3D. If not, see <>.