graphkit-vtk 0.1.1 → 0.2.1

data/VERSION

@@ -1 +1 @@
-0.1.1
+0.2.1

data/graphkit-vtk.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "graphkit-vtk"
-  s.version = "0.1.1"
+  s.version = "0.2.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Edmund Highcock"]
-  s.date = "2012-12-28"
+  s.date = "2012-12-30"
   s.description = "An extension allowing graphkits to be rendered using the Visualization Toolkit. Uses the RubyPython gem to access the Python bindings for VTK."
   s.email = "edmundhighcock@sourceforge.net"
   s.extra_rdoc_files = [
@@ -33,7 +33,7 @@ Gem::Specification.new do |s|
   s.homepage = "http://github.com/edmundhighcock/graphkit-vtk"
   s.licenses = ["GPLv3"]
   s.require_paths = ["lib"]
-  s.rubygems_version = "1.8.24"
+  s.rubygems_version = "1.8.23"
   s.summary = "An extension allowing graphkits to be rendered using the Visualization Toolkit."
 
   if s.respond_to? :specification_version then

data/lib/graphkit-vtk.rb

@@ -34,6 +34,86 @@ class GraphKit
 
 	end
 	
+	# This module contains methods for rendering GraphKits
+	# using the Visualization Toolkit (VTK). It uses the 
+	# Python interface to VTK via the RubyPython bridge
+	# (see rubygems.org/gems/rubypython).
+	#
+	# It should work with vtk and vtk-python installed
+	# on any Linux distro. 
+	#
+	# If you want to use it on a supercomputer you will
+	# almost certainly have to build Python and VTK yourself.
+	#
+	# The instructions below have been tested on Hector but
+	# can be easily adapted to work anywhere. 
+	#
+	# First you need to configure your system to use the GNU
+	# compilers and with dynamic linking enabled. The instructions
+	# for configuring your system for installing CodeRunner should
+	# work well. See the CodeRunner wiki (coderunner.sourceforge.net).
+	#
+	# Choose a directory to install everything: <tt>myprefix</tt>.
+	#
+	# Download the source for Python 2.x (2.7 works as of Dec 2012),
+	# extract it and build it (with shared libraries) as follows.
+	#   $ cd Python-2.7.3
+	#   $ ./configure  --prefix=<myprefix> --enable-shared LDFLAGS="-Wl,-rpath <myprefix/lib"
+	#   $ make && make install
+	#
+	# Download the VTK source (tested with VTK 5.10) and extract it.
+	#
+	# Make a directory at the same level as the VTK source folder, 
+	# e.g. VTK-bin. Make sure CMake is available (e.g. module load CMake).
+	# Configure like this:
+	# 	1. $ cd VTK-bin
+	# 	2. $ ccmake -i ../VTK5.10.1   # (replace with appropriate folder)
+	#
+	# You will now enter the CMake interactive configuration. Press 'c' to 
+	# run the initial configuration. Press 't' to get to the advanced options.
+	# Make sure the settings below are as follows
+	# 	CMAKE_INSTALL_PREFIX <myprefix>
+	# 	VTK_WRAP_PYTHON on
+	#		VTK_USE_RENDERING on
+	# 	VTK_USE_X off
+	#		VTK_OPENGL_HAS_OSMESA on
+	#
+	#	The last two settings mean that VTK won't try to pop up windows when 
+	#	it is rendering: instead it will write them straight to file. 
+	#	OSMESA stands for Off Screen Mesa, where Mesa is the open source
+	#	graphics library. 
+	#
+	#	Press 'c' to update the configuration. 
+	#	Now update the following settings:
+	#		PYTHON_EXECUTABLE <myprefix>/bin/python
+	#		PYTHON_INCLUDE_DIR <myprefix>/include/python2.x
+	#		PYTHON_LIBRARY <myprefix>/lib/libpython2.x.so
+	#		VTK_USE_OFFSCREEN on
+	#		
+	#
+	# Here is the funky bit: we don't want to use the standard hardware-enabled
+	# OpenGL libraries because we want to render offscreen. The standard OpenGL
+	# conflicts with OSMESA and makes SEGFAULTS (yuk). Instead we can have OSMESA
+	# replace all their functionality by setting
+	# 	OPENGL_glu_LIBRARY
+	# 	OPENGL_gl_LIBRARY
+	# to the same value as
+	# 	OSMESA_LIBRARY
+	#
+	# This will of course not be as fast, but that's OK because we are going
+	# to parallelise over the supercomputer when we write our rendering scripts!
+	#
+	# Press 'c' to configure once more, and 'g' to generate the makefiles.
+	# Now build
+	# 	$ make     # This will take about 40 mins.
+	# 	$ make install
+	#
+	# Finally we need to setup python: add these lines to your .bashrc
+	# 	export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<myprefix>/lib/vtk-5.10/
+	# 	export PYTHONPATH=$PYTHONPATH:<myprefix>/lib/python2.7/site-packages/
+	# 	export PATH=<myprefix>/bin:$PATH
+	module VTK
+	
 	# This method returns a VTKObjectGroup object, which 
 	# contains references to the VTK/Python objects 
 	# which are necessary to plot the graph. 
@@ -43,7 +123,7 @@ class GraphKit
 		temp_write = false
 		unless filename
 			temp_write = true
-			filename = (Time.now.to_i).to_s + rand(10000).to_s + ".tmp.vtk"
+			filename = (Time.now.to_i).to_s + rand(1000000).to_s + ".tmp.vtk"
 			to_vtk_legacy_fast(file_name: filename)
 		end
 
@@ -68,12 +148,23 @@ class GraphKit
 		mapper.SetInput(output)
 		mapper.SetScalarRange(scalar_range)
 
+		look_up_table = vtk.vtkLookupTable
+		look_up_table.SetNumberOfColors(64)
+		look_up_table.SetHueRange(0.0, 0.667)
+		mapper.SetLookupTable(look_up_table)
+		mapper.SetScalarModeToDefault
+		#mapper.CreateDefaultLookupTable
+		mapper.ScalarVisibilityOn
+		#mapper.SelectColorArray('myvals')
+
+
 		vtk_og.actor = actor = vtk.vtkActor
 		actor.SetMapper(mapper)
+		actor.VisibilityOn
 
 		vtk_og.renderer = renderer = vtk.vtkRenderer
 		renderer.AddActor(actor)
-		renderer.SetBackground(0,0,0)
+		#renderer.SetBackground(0,0,0)
 
 		vtk_og.renderer_window = renderer_window = vtk.vtkRenderWindow
 		renderer_window.SetSize(640,480)
@@ -83,9 +174,9 @@ class GraphKit
 		render_large.SetInput(vtk_og.renderer)
 		render_large.SetMagnification(4)
 
-		#vtk_og.interactor =  interactor = vtk.vtkRenderWindowInteractor
-		#interactor.SetRenderWindow(renderer_window)
-		#interactor.Initialize
+		vtk_og.interactor =  interactor = vtk.vtkRenderWindowInteractor
+		interactor.SetRenderWindow(renderer_window)
+		interactor.Initialize
 		#interactor.Start
 
 		return vtk_og
@@ -131,6 +222,9 @@ class GraphKit
 
 
 
+	end #module VTK
+
+	include VTK
 
 
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: graphkit-vtk
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-12-28 00:00:00.000000000 Z
+date: 2012-12-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: graphkit
@@ -143,7 +143,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3330358015702513800
+      hash: -3523229928342679442
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -152,7 +152,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
 summary: An extension allowing graphkits to be rendered using the Visualization Toolkit.