Public | Automated Build

Last pushed: a year ago
Short Description
Adds tutorial notebook and related support files to blender-mayavi-jupyter.
Full Description

Equation-to-Object Instructions

A description of a process for turning mathematical expressions into physical objects using Python and 3D printing.

From this to this to this

This project aims to provide a toolkit and a tutorial which will enable any moderately technical user to turn a mathematical equation into a 3D printed physical object.

Want to skip to the end? The example from the tutorial is available at The Intricate Geometries shop at Shapeways

WORK IN PROGRESS: These instructions are not yet complete

Docker Images:

  • jupyter-simple: A simple setup with Jupyter notebook and scientific Python libraries.
  • mayavi-jupyter: Adds Enthought's Mayavi to jupyter-simple, with an SSH server so that the user can use X11 to view the Mayavi GUI.
  • blender-mayavi-jupyter: Adds Blender to mayavi-jupyter for mesh modification.
  • equation-to-object: Adds tutorial notebook and related support files to blender-mayavi-jupyter.

WARNING: Do not run these images on a server, they are not secure. Run them only on a VM (as with Docker Toolbox on Windows or OS X) which is not accessible from a wider network.

Prerequisites

Setup Instructions

  • Install the applications from the prerequisites list.
  • Download and run the shell script start_notebook.sh.
    • The script will start a download of a Docker image; this download is very large (~3.7GB) and could take a long time, up to an hour on low bandwidth.
    • once the download is complete, the script should automatically start a Docker container based on the image, SSH into it, launch a Jupyter iPython Notebook server, and open your browser to the notebook server's home page.
    • This is all a horrible kludge, expect to do some troubleshooting.
  • Once your browser opens to the home page of the Jupyter iPython notebook server, navigate to the Equation To Object Instructions notebook in the examples directory, and open it. Follow the instructions in the notebook.

To preview the Equation To Object Instructions notebook on GitHub in a non-executable form, including more detailed instructions, go to Equation_To_Object_Instructions.

Shutting Down:

To stop the notebook server, close and halt all open notebooks (File > Close and Halt), then, in the terminal window where jupyter is running, type Control-C. When it asks if you want to stop the server, type y and hit enter. To stop the container, type "docker ps" to find the name of the running container, then type "docker stop <container name>". To stop the Docker virtual machine, type "docker-machine stop default".

To start up again later, just run start_notebook.sh again. There will be messages in Terminal about things already existing, but you can ignore them.

Docker Pull Command
Owner
jjpr
Source Repository