fuzzy_associative_memory 1.0.1 → 1.1.0

data/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog for fuzzy-associative-memory
+
+## 1.1, 26 July 2013
+* Fuzzy Linguistic Variables are hard to visualize, especially when they get complex. To remedy that, you can now instruct an FLV to shell out to your installed Gnuplot and plot itself. The images are saved in your system's tmpdir.
+
+## 1.0.1, 28 June 2013
+* Based on good feedback, revised the initializer for `Rule` to put the `natural_language` parameter at the end and make it optional. I realize this is a disruptive alteration to the API and I apologize for the code adjustments this will necessitate. (I had to pay the penance of refactoring a lot of my own code, if that helps.)
+
+## 1.0.0, 26 June 2013
+* Initial Gem release

data/README.md

@@ -44,6 +44,8 @@ To do (in descending importance, roughly):
 * Other shapes for fuzzy sets
 * Hedges ('very' and 'fairly')
 * Additional examples
+ 
+Watch the [changelog](http://github.com/cpowell/fuzzy-associative-memory/blob/master/CHANGELOG.md) for news.
 
 ## Gem installation
 

data/bin/hvac_system_example.rb

@@ -31,6 +31,8 @@ warm       = FuzzyAssociativeMemory::Triangle.new(65, 75, 85)  # 20 deg wide
 hot        = FuzzyAssociativeMemory::Trapezoid.new(80, 90, 90, 90) # 20 deg wide
 
 temperature_in.sets = [cold, cool, just_right, warm, hot]
+# Comment out if you don't have Gnuplot installed:
+temperature_in.gnuplot
 
 # The output side -- the consequent -- expressed as a number of fuzzy sets,
 # with each set representing a natural-language description. The 'resultant
@@ -44,6 +46,8 @@ fast   = FuzzyAssociativeMemory::Triangle.new(50, 70, 90)   # 40 CFM wide
 blast  = FuzzyAssociativeMemory::Triangle.new(70, 100, 130) # 60 CFM wide
 
 fan_speed.sets = [stop, slow, medium, fast, blast]
+# Comment out if you don't have Gnuplot installed:
+fan_speed.gnuplot
 
 # Natural-language marriage of the inputs to the outputs, e.g.
 # "If the temperature is cool, the fan motor speed should be slow."

data/bin/weapon_choice_example.rb

@@ -34,6 +34,8 @@ tgt_medium = FuzzyAssociativeMemory::Triangle.new(25, 150, 300)
 tgt_far    = FuzzyAssociativeMemory::Trapezoid.new(150, 300, 500, 650)
 
 target_dist.sets = [tgt_close, tgt_medium, tgt_far]
+# Comment out if you don't have Gnuplot installed:
+target_dist.gnuplot
 
 # Now for the second input (or antecedent): the amount of ammo left for this
 # particular weapon.
@@ -44,6 +46,8 @@ rkt_ammo_okay  = FuzzyAssociativeMemory::Triangle.new(0, 10, 30)
 rkt_ammo_loads = FuzzyAssociativeMemory::Trapezoid.new(10, 30, 40, 40)
 
 rocket_ammo_status.sets = [rkt_ammo_low, rkt_ammo_okay, rkt_ammo_loads]
+# Comment out if you don't have Gnuplot installed:
+rocket_ammo_status.gnuplot
 
 # The output side -- the consequent -- expressed as a number of fuzzy sets,
 # with each set representing a natural-language description. The 'resultant
@@ -55,6 +59,8 @@ desirable      = FuzzyAssociativeMemory::Triangle.new(30, 50, 70)
 very_desirable = FuzzyAssociativeMemory::Trapezoid.new(50, 80, 100, 100)
 
 desirability.sets = [undesirable, desirable, very_desirable]
+# Comment out if you don't have Gnuplot installed:
+desirability.gnuplot
 
 # Natural-language marriage of the inputs to the outputs, e.g.
 # "If the temperature is cool, the fan motor speed should be slow."

data/lib/fuzzy_associative_memory/linguistic_variable.rb

@@ -6,6 +6,8 @@
 # You can redistribute and/or modify this software only in accordance with
 # the terms found in the "LICENSE" file included with the library.
 #
+require 'tempfile'
+
 class FuzzyAssociativeMemory::LinguisticVariable
   attr_accessor :sets
   attr_reader :name
@@ -19,6 +21,79 @@ class FuzzyAssociativeMemory::LinguisticVariable
     @sets << set
   end
 
+  def gnuplot
+    return if @sets.empty?
+
+    datafile = Tempfile.new('fam_')
+    begin
+      @sets.each_with_index do |s, i|
+        if s.is_a? FuzzyAssociativeMemory::Triangle
+          datafile.puts "Set#{i} #{s.left} 0"
+          datafile.puts "Set#{i} #{s.center} 1"
+          datafile.puts "Set#{i} #{s.right} 0"
+        end
+
+        if s.is_a? FuzzyAssociativeMemory::Trapezoid
+          datafile.puts "Set#{i} #{s.left} 0"
+          datafile.puts "Set#{i} #{s.top_left} 1"
+          datafile.puts "Set#{i} #{s.top_right} 1"
+          datafile.puts "Set#{i} #{s.right} 0"
+        end
+
+        datafile.puts "\n\n"
+      end
+      datafile.close
+
+      min = @sets[0].left
+      max = @sets[0].right
+      @sets.each do |s|
+        min = s.left if s.left < min
+        max = s.right if s.right > max
+      end
+
+      fn = "#{Dir.tmpdir}/plot of #{name}.svg"
+
+      # set term dumb
+      commands = %Q(
+        set terminal svg
+        set autoscale
+        set xlabel 'value'
+        set ylabel 'membership'
+        set xtic auto
+        set ytic auto
+        set output "#{fn}"
+        set title "Fuzzy sets for #{name}"
+        set mytics 4
+        set mxtics 4
+        set size ratio 0.35
+        set grid x y
+        set xr [#{min}:#{max}]
+      )
+
+      #         plot "#{datafile.path}" using 2:3 notitle with linespoints lw 2
+
+      plotarr=[]
+      @sets.size.times do |i|
+        plotarr[i] = %Q("#{datafile.path}" index #{i} using 2:3 notitle with linespoints pt 5 lw 2)
+      end
+
+      commands += "  plot " + plotarr.join(', ') + "\n"
+      # puts commands
+
+      IO.popen("gnuplot", "w") do |io|
+        io.puts commands
+      end
+      puts "Plot saved in #{fn}"
+
+    rescue StandardError => e
+      puts "Unable to run Gnuplot because #{e.message}"
+    ensure
+      datafile.close
+      datafile.unlink
+    end
+
+  end
+
   def [](n)
     @sets[n]
   end

metadata

@@ -2,23 +2,17 @@
 name: fuzzy_associative_memory
 version: !ruby/object:Gem::Version
   prerelease:
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Chris Powell
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2013-06-26 00:00:00.000000000 Z
+date: 2013-07-26 00:00:00.000000000 Z
 dependencies: []
 description: |2
-      A Fuzzy Associative Memory (FAM for short) is a Fuzzy Logic tool for decision making. Fuzzy logic FAMs have a wide range of practical applications:
-
-      * Control systems, such as governing a fan to keep a room at the "just right" temperature
-      * Game AI, such as imbuing bots with human-like decision-making behavior
-      * Prediction systems, linking causes with effects
-
-      A Fuzzy Associative Memory uses Fuzzy Sets to establish a set of rules that are linguistic in nature. The linguistic rules, and the fuzzy sets they contain, are defined by a human "expert" (presumably, you). That is to say, the rules codify intelligence and map this knowledge from the human domain to the digital.
+      A Fuzzy Associative Memory (FAM for short) is a Fuzzy Logic tool for decision making. Fuzzy logic FAMs have a wide range of practical applications: Control systems, such as governing a fan to keep a room at the "just right" temperature; Game AI, such as imbuing bots with human-like decision-making behavior; Prediction systems, linking causes with effects. A FAM uses Fuzzy Sets to establish a set of rules that are linguistic in nature. The linguistic rules, and the fuzzy sets they contain, are defined by a human "expert" (presumably, you). The rules therefore codify intelligence and map this knowledge from the human domain to the digital.
 email: cpowell@prylis.com
 executables: []
 extensions: []
@@ -33,6 +27,7 @@ files:
 - lib/fuzzy_associative_memory/triangle.rb
 - bin/hvac_system_example.rb
 - bin/weapon_choice_example.rb
+- CHANGELOG.md
 - LICENSE
 - Rakefile
 - README.md