Vismach is a simulator to show 3D previews of a physical machine. Vismach.py is a python library to draw objects in the simulation window. It is located in /usr/share/pyshare (can't find it on git - was it removed?). The simultion itself needs a further a script in which following things are described using the functions defined in vismach.py:
The scripts are located in /usr/bin. At the moment are more simulations available:
Details about the functions have to be found out from vismach.py. One can see the funtions in use in the scripts named above. Classes defined in vismach.py
The comfortable way to generate a machine for a simulation is using CAD and export .obj or .stl files for each axis consisting the geometry, then read it in your script using the class AsciiOBJ or AsciiSTL. The use of the classes can be seen in the scaragui script located in /usr/bin. For first experiments one might just have a look at 5axisgui, where geometry ist generated with simple boxes.
Here are some screenshots:
vismach can be used to verify motions that don't show up in AXIS preview, such as custom kinematics or m-codes
this screenshot shows a "virtual rotary table" using the C-axis
Another example on what one can do with LinuxCNC (ex Enhanced Machine Controller) and Vismach help.