Preliminary code for plotting data in Blender.
###What this project hopes to achieve?
Show various ways in which the Blender Python API, called bpy, can be used to generate meshes, shaders and vector graphics.
These examples are intended to help you code your own visualizations, and can be used on their own or as part of the sci_viz module.
###Useful code snippets
These are tagged depending on if they are visible in a render or only in the 3d viewport. Where it makes sense, examples of both are given.
Scatter plots
- 1d array to point cloud, takes array of
(x,y,z)tuples and generates vertices (non render) - 1d array to point cloud no color, takes array of
(x,y,z)tuples and generates single color dots (small icospheres)(renderable) - 1d array to point cloud with colors, takes array of
((x,y,z),(r,g,b,a))tuples and generates colored dots (renderable) - 1d array to points in 3d grid (nnz height), takes array of
(x,y,z)tuples and generates vertices (non render)
Line plots
- 1d array to polyline, takes array of
(x,y,z)tuples and generates, edge based mesh (non render)
3D surface plot
- 1d array to 3D mesh, takes flat array of
(x,y,z)tuples and generates a mesh (renderable) - 1d array to 3D mesh, z depends on x and y, takes flat array of
(x,y,z)tuples and generates a mesh (renderable) - Automatic height to gradient colour map for 3d mesh data, takes the world or local bounds of the object and creates a shader automatically with a colour ramp (renderable)
Node scripting
- mini node connection grammar, simplifies connecting existing nodes. example grammar:
"Node.001|Color > MixRGB.002|0". Full grammar specs are in the file.
General obj utility scripts
- bounding box tools, provides
mix, max and distancefor an object, calculated in world or local coordinates
The sci_viz module
The sci_viz module can be placed inside the blender scripts folder like ../scripts/modules/sci_viz , to conveniently import the various utilities.
For example if you need to make a series of node links then add these lines to the top of your python script and you can use the node mini grammar to connect nodes.
import sci_viz
from sci_viz.node_tools import make_link
Here's a broad collection curated recipes. (still work in progress): https://github.com/zeffii/BlenderPythonRecipes/wiki
###Useful addons