Skip to main content

A program for plotting 3D scatter plots for use in Blender

Project description

Blendplot Travis CI Status Coverage Status Documentation Status

Blendplot is a command line application for generating 3D data plots for use in Blender.

$ blendplot abc.csv abc.obj period amplitude_Iband magnitude_Iband -c category 
Wrote plot file to abc.obj
Plotted 37099 points in 1.531214 seconds

An example of a model generated with Blendplot using data from the OGLE IV lmc survey

Installation

To install Blendplot from source you can run the following commands.

git clone https://github.com/ExcaliburZero/blender-astro-visualization.git
cd blender-astro-visualization
pip install ./

Usage

Blendplot allows you to generate a 3D data plot model by specifying a dataset file, the output model file (.obj), and the names of the three (x,y,z) columns you want to plot. Currently it only supports .csv input data files. The commad structure to run blendplot is as follows.

blendplot INPUT_FILE OUTPUT_FILE X Y Z

For example, to create a model from a data file data.csv using the columns height, weight, and cost and output to a file model.obj you would run the following command.

blendplot data.csv model.obj height weight cost

Once you have used the script to generate the model file, you can then import it into Blender by going to File > Import > Wavefront (.obj) and selecting the model file.

Importing the model file into Blender

Documentation

For futher in-depth information on how to use Blendplot, see the documentation at the link below.

Licensing

The source code for Blendplot is available under the MIT License, see LICENSE for more information.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

blendplot-1.0.0.tar.gz (6.5 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page