wads 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ced90f1073417f101cc5688139f63c6437814a7bf96249b54344ad3a72f5a0fc
-  data.tar.gz: '08fafccb767210d6f3653ee9ab6c33ca01962b4bd71503c54a3afcca83efcd9f'
+  metadata.gz: a1cf7ab7c4229f57f2bb4691819c5a4282a3fd0f7703e5caa6c93e49aeb35053
+  data.tar.gz: a1f0e971db1ea5064e44fef39c31767125f844b8ab3ef87eeaf09e3e92f27ad1
 SHA512:
-  metadata.gz: 2daa8f10e3cabab4c8824f5f070b5b9f5b124b5c90910b6bd9d0a75c8775e8ed1285ed4cb2a019a08320f27c735065789a2401e60b2098731d6e7d915073868d
-  data.tar.gz: 235bd6b70e43ef6f8714ea6406598a49747f5846495193d5193d089acf09b30ef80ff5dbf91733c6eb6e0e08468f34b192735262900b31b89d4caf71b41a1648
+  metadata.gz: 315790b3c8fe99525c3ad78eaa90eecd17fadd09a2a3e16a13ba82cb61ea5279472c57ada6e88021e9c6649236bb598aad0a46a1954928a1c37dc8dbf8b45b5e
+  data.tar.gz: 89de4f997dcef2e1b9e25062af443d6994d7ee4070d89dab21f06cb492ed3d106f837a9c3bdf85d7ba7e6522d30a039694982d939d49dd41b7da30c2637299ea

data/CHANGELOG.md

@@ -1,5 +1,19 @@
-## [Unreleased]
-
 ## [0.1.0] - 2021-08-23
 
 - Initial release
+
+## [0.1.1] - 2021-08-29
+
+- Added graph data structure and corresponding display widgets
+
+## [0.1.2] - 2021-08-30
+
+- Fixed bugs with data structures. Added convenience methods to manage child widgets
+
+## [0.1.3] - 2021-09-30
+
+- Improvements to graph display including user ability to change focus node
+
+## [0.2.0] - 2021-10-05
+
+- Breaking change in order to refactor, including standardizing order of widget constructor args

data/README.md

@@ -2,6 +2,18 @@
 
 A number of Ruby Gosu-based (W)idgets (a)nd (D)ata (S)tructures for your applications.
 
+The user guide and examples can be found at https://www.rubydoesitagain.com
+
+Wads (Widgets and Data Structures) is intended to help you quickly build native Ruby applications using the Gosu gem.
+GUI widgets, such as tables and buttons, are provided to simplify building graphical applications.
+Widgets in wads can be used independently within your Gosu app, or you can use wads as a holistic GUI framework.
+Wads includes basic features found in many GUI toolkits including The use of themes and a layout manager.
+
+One of the motivations for creating wads is to making data analysis, games, and productivity applications using Ruby easier to do.
+Data structures are included that can be used for statistical analysis or graph-based applications.
+The samples provided illustrate both use cases (Stocks - stats) and Star Wars character interactions (graphs).
+
+![alt Screenshot](https://github.com/dbroemme/ruby-wads/blob/main/media/WadsScreenshot.png?raw=true)
 ## Installation
 
 Add this line to your application’s Gemfile:
@@ -9,7 +21,7 @@ Add this line to your application’s Gemfile:
 ```
 gem 'wads'
 ```
-And the run bundle install.
+And then run bundle install.
 
 ## Sample Application
 
@@ -20,8 +32,56 @@ git clone https://github.com/dbroemme/ruby-wads.git
 cd ruby-wads
 ./bin/setup
 ./run
-./run-sample-app -s -g
+./run-sample-app -s
 ```
 
 This will run the sample NASDAQ stocks analysis that features the use of the 
 Stats class, and a table Gosu widget used to display the results of the analysis.
+
+![alt Screenshot](https://github.com/dbroemme/ruby-wads/blob/main/media/StocksSample.png?raw=true)
+
+
+You can also see the graph capabilities by running the Star Wars analysis example.
+This uses a data set that captures all character interactions within Episode 4.
+
+```
+./run-sample-app -j
+```
+
+There is also a sample Graph display using the following command.
+```
+./run-sample-app -g
+```
+Note that you can construct graphs in one of two ways. The first approach uses Nodes directly.
+```
+root = Node.new("a")
+b = root.add("b")
+b.add("d")
+b.add("e").add("f")
+root.add("c")
+Graph.new(root)
+```
+The second approach uses an overarching Graph object. 
+```
+g = Graph.new 
+g.add("a")
+g.add("b")
+g.add("c")
+g.add("d")
+g.add("e")
+g.add("f")
+g.connect("a", "b")
+g.connect("a", "c")
+g.connect("b", "d")
+g.connect("b", "e")
+g.connect("e", "f")
+```
+
+Currently, the Graph object is used by the Graph Widget for display. For the code above, this appears by default as follows:
+
+![alt Screenshot](https://github.com/dbroemme/ruby-wads/blob/main/media/SampleGraph.png?raw=true)
+
+## References
+
+The Star Wars data set is courtesy of:
+Gabasova, E. (2016). Star Wars social network. DOI: https://doi.org/10.5281/zenodo.1411479.

data/data/sample_graph.csv

@@ -0,0 +1,11 @@
+N,A,color=COLOR_YELLOW
+N,B,color=COLOR_GREEN
+N,C,color=COLOR_BLUE
+N,D,color=COLOR_RED
+N,E,color=COLOR_PURPLE
+N,F,color=COLOR_GRAY
+C,A,B
+C,A,C
+C,B,D
+C,B,E
+C,E,F

data/data/starwars-episode-4-interactions.json

@@ -0,0 +1,336 @@
+{
+  "nodes": [
+    {
+      "name": "C-3PO",
+      "value": 42,
+      "colour": "#FFD700"
+    },
+    {
+      "name": "LUKE",
+      "value": 88,
+      "colour": "#3881e5"
+    },
+    {
+      "name": "DARTH VADER",
+      "value": 25,
+      "colour": "#000000"
+    },
+    {
+      "name": "CAMIE",
+      "value": 3,
+      "colour": "#808080"
+    },
+    {
+      "name": "BIGGS",
+      "value": 18,
+      "colour": "#808080"
+    },
+    {
+      "name": "LEIA",
+      "value": 25,
+      "colour": "#DCDCDC"
+    },
+    {
+      "name": "BERU",
+      "value": 5,
+      "colour": "#808080"
+    },
+    {
+      "name": "OWEN",
+      "value": 6,
+      "colour": "#808080"
+    },
+    {
+      "name": "OBI-WAN",
+      "value": 22,
+      "colour": "#48D1CC"
+    },
+    {
+      "name": "MOTTI",
+      "value": 3,
+      "colour": "#808080"
+    },
+    {
+      "name": "TARKIN",
+      "value": 12,
+      "colour": "#808080"
+    },
+    {
+      "name": "HAN",
+      "value": 44,
+      "colour": "#ff9400"
+    },
+    {
+      "name": "GREEDO",
+      "value": 2,
+      "colour": "#808080"
+    },
+    {
+      "name": "JABBA",
+      "value": 2,
+      "colour": "#808080"
+    },
+    {
+      "name": "DODONNA",
+      "value": 3,
+      "colour": "#808080"
+    },
+    {
+      "name": "GOLD LEADER",
+      "value": 14,
+      "colour": "#808080"
+    },
+    {
+      "name": "WEDGE",
+      "value": 15,
+      "colour": "#808080"
+    },
+    {
+      "name": "RED LEADER",
+      "value": 33,
+      "colour": "#808080"
+    },
+    {
+      "name": "RED TEN",
+      "value": 8,
+      "colour": "#808080"
+    },
+    {
+      "name": "GOLD FIVE",
+      "value": 8,
+      "colour": "#808080"
+    }
+  ],
+  "links": [
+    {
+      "source": 3,
+      "target": 1,
+      "value": 2
+    },
+    {
+      "source": 4,
+      "target": 3,
+      "value": 2
+    },
+    {
+      "source": 4,
+      "target": 1,
+      "value": 4
+    },
+    {
+      "source": 2,
+      "target": 5,
+      "value": 1
+    },
+    {
+      "source": 6,
+      "target": 1,
+      "value": 3
+    },
+    {
+      "source": 6,
+      "target": 7,
+      "value": 3
+    },
+    {
+      "source": 6,
+      "target": 0,
+      "value": 2
+    },
+    {
+      "source": 1,
+      "target": 7,
+      "value": 3
+    },
+    {
+      "source": 0,
+      "target": 1,
+      "value": 18
+    },
+    {
+      "source": 0,
+      "target": 7,
+      "value": 2
+    },
+    {
+      "source": 0,
+      "target": 5,
+      "value": 6
+    },
+    {
+      "source": 5,
+      "target": 1,
+      "value": 17
+    },
+    {
+      "source": 6,
+      "target": 5,
+      "value": 1
+    },
+    {
+      "source": 1,
+      "target": 8,
+      "value": 19
+    },
+    {
+      "source": 0,
+      "target": 8,
+      "value": 6
+    },
+    {
+      "source": 5,
+      "target": 8,
+      "value": 1
+    },
+    {
+      "source": 9,
+      "target": 10,
+      "value": 2
+    },
+    {
+      "source": 2,
+      "target": 9,
+      "value": 1
+    },
+    {
+      "source": 2,
+      "target": 10,
+      "value": 7
+    },
+    {
+      "source": 11,
+      "target": 8,
+      "value": 9
+    },
+    {
+      "source": 11,
+      "target": 1,
+      "value": 26
+    },
+    {
+      "source": 12,
+      "target": 11,
+      "value": 1
+    },
+    {
+      "source": 11,
+      "target": 13,
+      "value": 1
+    },
+    {
+      "source": 0,
+      "target": 11,
+      "value": 6
+    },
+    {
+      "source": 5,
+      "target": 9,
+      "value": 1
+    },
+    {
+      "source": 5,
+      "target": 10,
+      "value": 1
+    },
+    {
+      "source": 11,
+      "target": 5,
+      "value": 13
+    },
+    {
+      "source": 2,
+      "target": 8,
+      "value": 1
+    },
+    {
+      "source": 14,
+      "target": 15,
+      "value": 1
+    },
+    {
+      "source": 14,
+      "target": 16,
+      "value": 1
+    },
+    {
+      "source": 14,
+      "target": 1,
+      "value": 1
+    },
+    {
+      "source": 15,
+      "target": 16,
+      "value": 1
+    },
+    {
+      "source": 15,
+      "target": 1,
+      "value": 1
+    },
+    {
+      "source": 1,
+      "target": 16,
+      "value": 2
+    },
+    {
+      "source": 4,
+      "target": 5,
+      "value": 1
+    },
+    {
+      "source": 5,
+      "target": 17,
+      "value": 1
+    },
+    {
+      "source": 1,
+      "target": 17,
+      "value": 3
+    },
+    {
+      "source": 4,
+      "target": 17,
+      "value": 3
+    },
+    {
+      "source": 4,
+      "target": 0,
+      "value": 1
+    },
+    {
+      "source": 0,
+      "target": 17,
+      "value": 1
+    },
+    {
+      "source": 17,
+      "target": 16,
+      "value": 3
+    },
+    {
+      "source": 15,
+      "target": 17,
+      "value": 1
+    },
+    {
+      "source": 4,
+      "target": 16,
+      "value": 2
+    },
+    {
+      "source": 17,
+      "target": 18,
+      "value": 1
+    },
+    {
+      "source": 4,
+      "target": 15,
+      "value": 1
+    },
+    {
+      "source": 1,
+      "target": 18,
+      "value": 1
+    }
+  ]
+}

data/lib/wads/app.rb

@@ -1,199 +1,57 @@
 require 'gosu'
-require_relative 'data_structures'
 require_relative 'widgets'
-require_relative 'version'
 
-include Wads
-
-class WadsSampleApp < Gosu::Window
-    
-    STOCKS_DATA_FILE = "./data/NASDAQ.csv"
-    LOTTERY_DATA_FILE = "./data/Pick4_12_21_2020.txt"
-
-    def initialize
-        super(800, 600)
-        self.caption = "Wads Sample App"
-        @font = Gosu::Font.new(32)
-        @title_font = Gosu::Font.new(38)
-        @version_font = Gosu::Font.new(22)
-        @small_font = Gosu::Font.new(22)
-        @banner_image = Gosu::Image.new("./media/Banner.png")
-        @display_widget = nil
-    end 
+module Wads
+    #
+    # The WadsApp class provides a simple starting point to quickly build a native
+    # Ruby application using Gosu as an underlying library. It provides all the necessary
+    # hooks to get started. All you need to do is supply the parent Wads widget using
+    # the set_display(widget) method. See one of the Wads samples for example usage.
+    #
+    class WadsApp < Gosu::Window
+        def initialize(width, height, caption, widget)
+            super(width, height)
+            self.caption = caption
+            @update_count = 0
+            WadsConfig.instance.set_window(self)
+            set_display(widget) 
+            WadsConfig.instance.set_log_level("info")
+        end 
 
-    def parse_opts_and_run 
-        # Make help the default output if no args are specified
-        if ARGV.length == 0
-            ARGV[0] = "-h"
+        #
+        # This method must be invoked with any Wads::Widget instance. It then handles
+        # delegating all events and drawing all child widgets.
+        #
+        def set_display(widget) 
+            @main_widget = widget 
         end
 
-        opts = SampleAppCommand.new.parse.run
-        if opts[:stocks]
-            stats = process_stock_data
-            if opts[:gui]
-                @display_widget = SampleStocksDisplay.new(@small_font, stats)
-                show
-            else 
-                stats.report(Date::DAYNAMES[1..5])
-            end
-        
-        elsif opts[:lottery] 
-            process_lottery_data
-        else
-            puts " "
-            puts "Select one of the following sample analysis options"
-            puts "-s   Run sample stocks analysis"
-            puts "-l   Run sample analysis of lottery numbers"
-            puts " "
-            exit
+        def get_display
+            @main_widget
         end
 
-    end
-
-    def update 
-        # TODO
-    end 
+        def update
+            @main_widget.update(@update_count, mouse_x, mouse_y)
+            @update_count = @update_count + 1
+        end 
     
-    def draw
-        draw_banner
-        @display_widget.draw
-    end 
-
-    def draw_banner 
-        @banner_image.draw(1,1,1,0.9,0.9)
-        @title_font.draw_text("Wads Sample App", 10, 20, 2, 1, 1, Gosu::Color::WHITE)
-        @version_font.draw_text("Version #{Wads::VERSION}", 13, 54, 2, 1, 1, Gosu::Color::WHITE)
-    end
-
-    def button_down id
-        close if id == Gosu::KbEscape
-        # Delegate button events to the primary display widget
-        result = @display_widget.button_down id, mouse_x, mouse_y
-        if result.close_widget
-            close
+        def draw
+            @main_widget.draw
         end
-    end
-
-    def process_stock_data 
-        # The data file comes from https://finance.yahoo.com
-        # The format of this file is as follows:
-        #
-        # Date,Open,High,Low,Close,Adj Close,Volume
-        # 2000-01-03,4186.189941,4192.189941,3989.709961,4131.149902,4131.149902,1510070000
-        # 2000-01-04,4020.000000,4073.250000,3898.229980,3901.689941,3901.689941,1511840000
-        # ...
-        # 2020-12-30,12906.509766,12924.929688,12857.759766,12870.000000,12870.000000,5292210000
-        # 2020-12-31,12877.089844,12902.070313,12821.230469,12888.280273,12888.280273,4771390000
-        
-        stats = Stats.new("NASDAQ")
-        previous_close = nil
-        
-        puts "Read the data file #{STOCKS_DATA_FILE}"
-        File.readlines(STOCKS_DATA_FILE).each do |line|
-            line = line.chomp  # remove the carriage return
-
-            # Ignore header and any empty lines, process numeric data lines
-            if line.length > 0 and line[0].match(/[0-9]/)
-                values = line.split(",")
-                date = Date.strptime(values[0], "%Y-%m-%d")
-                weekday = Date::DAYNAMES[date.wday]
-
-                open_value = values[1].to_f
-                close_value = values[4].to_f
 
-                if previous_close.nil?
-                    # Just use the first day to set the baseline
-                    previous_close = close_value
-                else 
-                    change_from_previous_close = close_value - previous_close
-                    change_intraday = close_value - open_value
-                    change_overnight = open_value - previous_close
-                    
-                    change_percent = change_from_previous_close / previous_close
-
-                    stats.add(weekday, change_percent)
-                    stats.add("#{weekday} prev close", change_from_previous_close)
-                    stats.add("#{weekday} intraday", change_intraday)
-                    stats.add("#{weekday} overnight", change_overnight)
-
-                    previous_close = close_value
+        def button_down id
+            close if id == Gosu::KbEscape
+            # Delegate button events to the primary display widget
+            result = @main_widget.button_down id, mouse_x, mouse_y
+            if not result.nil? and result.is_a? WidgetResult
+                if result.close_widget
+                    close
                 end
             end
         end
-
-        stats
-    end
-
-    def process_lottery_data
-        puts "The lottery example has not been implemented yet"
-        puts "however the data is available in the data directory,"
-        puts "and the same pattern used in the stocks example can"
-        puts "be applied here."
-    end
-end
-
-class SampleStocksDisplay < Widget
-    attr_accessor :stats
-
-    def initialize(font, stats)
-        super(10, 100, COLOR_HEADER_BRIGHT_BLUE)
-        set_dimensions(780, 500)
-        set_font(font)
-        add_child(Document.new(sample_content, x + 5, y + 5, @width, @height, @font))
-        @exit_button = Button.new("Exit", 380, bottom_edge - 30, @font)
-        add_child(@exit_button)
-
-        @stats = stats
-        @data_table = SingleSelectTable.new(@x + 5, @y + 100,    # top left corner
-                                            770, 200,            # width, height
-            ["Day", "Min", "Avg", "StdDev", "Max", "p10", "p90"], # column headers
-                                            @font, COLOR_WHITE)   # font and text color
-        @data_table.selected_color = COLOR_LIGHT_GRAY
-        Date::DAYNAMES[1..5].each do |day|
-            min = format_percent(@stats.min(day))
-            avg = format_percent(@stats.average(day))
-            std = format_percent(@stats.std_dev(day))
-            max = format_percent(@stats.max(day))
-            p10 = format_percent(@stats.percentile(day, 0.1))
-            p90 = format_percent(@stats.percentile(day, 0.90))
-            @data_table.add_row([day, min, avg, std, max, p10, p90], COLOR_HEADER_BRIGHT_BLUE)
-        end
-        add_child(@data_table)
-        @selection_text = nil
-    end 
-
-    def format_percent(val)
-        "#{(val * 100).round(3)}%"
-    end
-
-    def sample_content
-        <<~HEREDOC
-          This sample stock analysis uses NASDAQ data from https://finance.yahoo.com looking
-          at closing data through the years 2000 to 2020. The percent gain or loss is broken
-          down per day, as shown in the table below.
-        HEREDOC
-    end
-
-    def render 
-        if @selection_text
-            @selection_text.draw 
+    
+        def button_up id
+            @main_widget.button_up id, mouse_x, mouse_y
         end
     end 
-
-    def button_down id, mouse_x, mouse_y
-        if id == Gosu::MsLeft
-            if @exit_button.contains_click(mouse_x, mouse_y)
-                return WidgetResult.new(true)
-            elsif @data_table.contains_click(mouse_x, mouse_y)
-                val = @data_table.set_selected_row(mouse_y, 0)
-                if val.nil?
-                    # nothing to do
-                else
-                    @selection_text = Text.new("You selected #{val}, a great day!",
-                                               x + 5, y + 400, @font)
-                end    
-            end 
-        end 
-        WidgetResult.new(false)
-    end 
-end
+end