basis-processing 0.5.0 → 0.5.1

data/README

@@ -1,4 +1,8 @@
-Basis provides a set of classes for easily plotting and transforming arbitrary 2D coordinate systems by specifying their basis vectors in Ruby-Processing.
+**NOTE: Starting from version 0.5.1, Basis has been ported to Ruby 1.9.2, because of the kd-tree library dependency. There are no current plans of maintaining Basis compatibility with Ruby 1.8.x.**
+
+**Basis** provides a set of classes for easily plotting and transforming arbitrary 2D coordinate systems by specifying their basis vectors. Originally developed to work with Ruby-Processing, it now supports any class which supports Processing-like semantics.
+
+Starting from version 0.5.0, experimental support has been added for mouseover interactivity without (too much) extra effort on your part. This is still a work in progress, though.
 
 ## Installation
 
@@ -18,11 +22,6 @@ To use Basis functionality in your code, it is enough to:
 
 Here's some example code, which plots random points.
 
-	require 'rubygems'
-	Gem.clear_paths
-	ENV['GEM_HOME'] = '/home/avishek/jruby/jruby-1.6.3/lib/ruby/gems/1.8'
-	ENV['GEM_PATH'] = '/home/avishek/jruby/jruby-1.6.3/lib/ruby/gems/1.8'
-
 	require 'basis_processing'
 
 	class Demo < Processing::App
@@ -67,6 +66,7 @@ Here's some example code, which plots random points.
 			points.each do |p|
 				@screen.plot(p, :track => true) {|p| rect(p[:x], p[:y], 5, 5)}
 			end
+			@index = @screen.build
 		end
 	end
 
@@ -83,9 +83,34 @@ it will connect the point with the x-axis. If you omit `:bar => true` or don't s
 If you omit the block at the end of the call, Basis will plot the point using a circle. Use the block to customise how you wish to represent the point graphically.
 You can toggle the joining of the points with lines by setting the join attribute of Screen to on (joins points)/off (no joining). The default is false.
 
-Version 0.5.0 introduces experimental support for mouseover interactivity without extra effort on your part. To allow interactions to happen, you must specify ':track => true' while plotting a point, as in the line below:
+## Running the Code (with extra notes for versions >= 0.5.1)
+
+Running the code is as simple as typing:
+
+`rp5 run demo.rb`
+
+If you're not using the Gems-in-a-Jar approach, you might have to use:
+
+`rp5 run --jruby demo.rb`
+
+The reason for the `--jruby` switch is to force Ruby-Processing to use the installed version of JRuby, instead of it's own jruby-complete.jar
+
+Additionally, starting with version 0.5.1, you will have to specify the environment variable JRUBY_OPTS to force JRuby to use the 1.9 version of the interpreter, like so:
+
+`export JRUBY_OPTS=--1.9`
+
+## Notes on Interactivity
+
+Experimental support exists for mouseover interactivity without (too much) extra effort on your part. To allow interactions to happen, you must specify ':track => true' while plotting a point, as in the line below:
 
 	@screen.plot(p, :track => true) {|p| rect(p[:x], p[:y], 5, 5)}
 
-To actually enable interactivity, you must 'include' the Interactive module in your sketch class, as in the demonstration code above. Interactivity is a work in progress at the moment.
+To actually enable interactivity, you must do a few things:
+
+* 'include' the Interactive module in your sketch class, as in the demonstration code above.
+* Build the data sample index from the data, by calling `@index = @screen.build`.
+* `@highlight_block` specifies what to plot when the data point is hovered upon.
+* `@passive_block` specifies what to plot when the data point is **not** being hovered on.
+
+Interactivity is a work in progress at the moment; some of the above steps may change or be removed.
 

data/basis.gemspec

@@ -1,6 +1,7 @@
 spec = Gem::Specification.new do |s| 
   s.name = "basis-processing"
-  s.version = "0.5.0"
+  s.version = "0.5.1"
+  s.add_dependency('knnball', '>= 0.0.6')
   s.author = "Avishek Sen Gupta"
   s.email = "avishek.sen.gupta@gmail.com"
   s.homepage = "http://avishek.net/blog"

data/lib/demo.rb

@@ -1,8 +1,3 @@
-require 'rubygems'
-Gem.clear_paths
-ENV['GEM_HOME'] = '/home/avishek/jruby/jruby-1.6.3/lib/ruby/gems/1.8'
-ENV['GEM_PATH'] = '/home/avishek/jruby/jruby-1.6.3/lib/ruby/gems/1.8'
-
 require 'basis_processing'
 
 class Demo < Processing::App
@@ -47,6 +42,7 @@ class Demo < Processing::App
 		points.each do |p|
 			@screen.plot(p, :track => true) {|p| rect(p[:x], p[:y], 5, 5)}
 		end
+		@index = @screen.build
 	end
 end
 

data/lib/interactive.rb

@@ -1,16 +1,20 @@
 module Interactive
-	attr :screen, :basis
+	attr :screen, :basis, :index
 
 	def mouseMoved(p)
 		p = {:x => p.getX(), :y => p.getY()}
 		@old_points ||= []
-		@points_to_highlight = []
-		index = @screen.points.index do |i|
-			onscreen_point = @screen.transformed(i)
-			(p[:x] - onscreen_point[:x]).abs < 4.0 && (p[:y] - onscreen_point[:y]).abs < 4.0
+		@points_to_highlight ||= []
+		original_point = @screen.original(p)
+		closest_point = @index.nearest([original_point[:x], original_point[:y]])
+		closest = @screen.points[closest_point[:id]]
+		distance = (closest[:x] - original_point[:x])**2 + (closest[:y] - original_point[:y])**2
+		if distance > 1.0
+			@points_to_highlight = []
+			redraw
+			return
 		end
-		return if index == nil
-		@points_to_highlight = [{:x => @screen.points[index][:x], :y => @screen.points[index][:y]}]
+		@points_to_highlight = [closest]
 		redraw
 	end
 

data/lib/screen.rb

@@ -1,4 +1,5 @@
 require 'transform'
+require 'knnball'
 
 class Screen
 	attr_accessor :points
@@ -14,10 +15,16 @@ class Screen
 		@basis = basis
 		join = false
 		@points = []
+		@data = []
+	end
+
+	def build
+		KnnBall.build(@data)
 	end
 
 	def plot(point, options = {:bar => false, :track => false}, &block)
 		@points << point if options[:track]
+		@data << {:id => @points.count - 1, :point => [point[:x], point[:y]]}
 		p = transformed(point)
 		standard_x_axis_point = @transform.apply(@basis.standard_basis({:x => point[:x], :y => 0}))
 		if (block)

metadata

@@ -1,32 +1,34 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: basis-processing
-version: !ruby/object:Gem::Version 
-  hash: 11
+version: !ruby/object:Gem::Version
+  version: 0.5.1
   prerelease: 
-  segments: 
-  - 0
-  - 5
-  - 0
-  version: 0.5.0
 platform: ruby
-authors: 
+authors:
 - Avishek Sen Gupta
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-10-05 00:00:00 Z
-dependencies: []
-
-description: Basis provides a set of classes for easily plotting and transforming arbitrary 2D coordinate systems by specifying their basis vectors in Ruby-Processing.
+date: 2011-10-06 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: knnball
+  requirement: &8267900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.0.6
+  type: :runtime
+  prerelease: false
+  version_requirements: *8267900
+description: Basis provides a set of classes for easily plotting and transforming
+  arbitrary 2D coordinate systems by specifying their basis vectors in Ruby-Processing.
 email: avishek.sen.gupta@gmail.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - .gitignore
 - README
 - basis.gemspec
@@ -40,36 +42,27 @@ files:
 - lib/transform.rb
 homepage: http://avishek.net/blog
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.7.2
+rubygems_version: 1.8.6
 signing_key: 
 specification_version: 3
-summary: Basis provides a set of classes for easily plotting and transforming arbitrary 2D coordinate systems by specifying their basis vectors in Ruby-Processing.
+summary: Basis provides a set of classes for easily plotting and transforming arbitrary
+  2D coordinate systems by specifying their basis vectors in Ruby-Processing.
 test_files: []
-