File: stack.rb

package info (click to toggle)
ruby-rubyvis 0.6.1%2Bdfsg1-2
  • links: PTS, VCS
  • area: main
  • in suites: buster, stretch
  • size: 1,808 kB
  • ctags: 679
  • sloc: ruby: 11,114; makefile: 2
file content (307 lines) | stat: -rw-r--r-- 9,856 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
module Rubyvis
  class Layout
    # Alias for Rubyvis::Layout::Stack 
    def self.Stack
      Rubyvis::Layout::Stack
    end
    
    # Implements a layout for stacked visualizations, ranging from simple
    # stacked bar charts to more elaborate "streamgraphs" composed of stacked
    # areas. Stack layouts uses length as a visual encoding, as opposed to
    # position, as the layers do not share an aligned axis.
    #
    # <p>Marks can be stacked vertically or horizontally. For example,
    #
    #   vis.add(Rubyvis::Layout::Stack)
    #     .layers([[1, 1.2, 1.7, 1.5, 1.7],
    #              [.5, 1, .8, 1.1, 1.3],
    #              [.2, .5, .8, .9, 1]])
    #     .x(lambda { index * 35})
    #     .y(lambda {|d| d * 40})
    #   .layer.add(Rubyvis::Area)
    #
    # specifies a vertically-stacked area chart, using the default "bottom-left"
    # orientation with "zero" offset. This visualization can be easily changed into
    # a streamgraph using the "wiggle" offset, which attempts to minimize change in
    # slope weighted by layer thickness. See the offset property for more
    # supported streamgraph algorithms.
    #
    # <p>In the simplest case, the layer data can be specified as a two-dimensional
    # array of numbers. The <tt>x</tt> and <tt>y</tt> psuedo-properties are used to
    # define the thickness of each layer at the given position, respectively; in
    # the above example of the "bottom-left" orientation, the <tt>x</tt> and
    # <tt>y</tt> psuedo-properties are equivalent to the <tt>left</tt> and
    # <tt>height</tt> properties that you might use if you implemented a stacked
    # area by hand.
    #
    # <p>The advantage of using the stack layout is that the baseline, i.e., the
    # <tt>bottom</tt> property is computed automatically using the specified offset
    # algorithm. In addition, the order of layers can be computed using a built-in
    # algorithm via the <tt>order</tt> property.
    #
    # <p>With the exception of the "expand" <tt>offset</tt>, the stack layout does
    # not perform any automatic scaling of data; the values returned from
    # <tt>x</tt> and <tt>y</tt> specify pixel sizes. To simplify scaling math, use
    # this layout in conjunction with Rubyvis::Scale.linea} or similar.
    #
    # <p>In other cases, the <tt>values</tt> psuedo-property can be used to define
    # the data more flexibly. As with a typical panel &amp; area, the
    # <tt>layers</tt> property corresponds to the data in the enclosing panel,
    # while the <tt>values</tt> psuedo-property corresponds to the data for the
    # area within the panel. For example, given an array of data values:
    #
    #   crimea = [
    #   { date: "4/1854", wounds: 0, other: 110, disease: 110 },
    #   { date: "5/1854", wounds: 0, other: 95, disease: 105 },
    #   { date: "6/1854", wounds: 0, other: 40, disease: 95 },
    #   ...
    #
    # and a corresponding array of series names:
    #
    #   causes = [:wounds, :other, :disease]
    #
    # Separate layers can be defined for each cause like so:
    #
    #   vis.add(pv.Layout.Stack)
    #     .layers(causes)
    #     .values(crimea)
    #     .x(lambda {|d| x.scale(d[:date]})
    #     .y(lambda {|d,dp| y.scale(d[dp])})
    #   .layer.add(pv.Area)
    #
    # As with the panel &amp; area case, the datum that is passed to the
    # psuedo-properties <tt>x</tt> and <tt>y</tt> are the values (an element in
    # <tt>crimea</tt>); the second argument is the layer data (a string in
    # <tt>causes</tt>). Additional arguments specify the data of enclosing panels, if any.
    class Stack < Rubyvis::Layout
      @properties=Layout.properties.dup
      attr_accessor_dsl :orient,:offset, :order, :layers
      attr_accessor :_x, :_y, :_values, :prop

      def self.defaults
        Stack.new.mark_extend(Layout.defaults).
          orient("bottom-left").
          offset("zero").
          layers([[]])
      end
      
      # Constructs a new, empty stack layout. Layouts are not typically constructed
      # directly; instead, they are added to an existing panel via
      # Rubyvis::Mark.add
      def initialize
        super
        @none=lambda {nil}
        @prop = {"t"=> @none, "l"=> @none, "r"=> @none, "b"=> @none, "w"=> @none, "h"=> @none}
        @values=nil
        @_x=lambda {0}
        @_y=lambda {0}
        @_values=Rubyvis.identity
      end
      def x(f)
        @_x=Rubyvis.functor(f)
        return self
      end
      def y(f)
        @_y=Rubyvis.functor(f)
        return self
      end
      def values(f=nil)
        if f.nil?
          return @values
        else
          @_values=Rubyvis.functor(f)
          return self
        end
      end
      
      
      def proxy(name)
        that=self
        return lambda {
          a=that.prop[name].js_call(self, self.parent.index, self.index);
          puts "proxy(#{name}): #{a}" if $DEBUG
          a
        }
      end
      
      def build_implied(s)
        # puts "Build stack" if $DEBUG
        layout_build_implied(s)
        data = s.layers
        n = data.size
        m = nil
        orient = s.orient
        if orient =~/^(top|bottom)\b/
          horizontal=true
        else
          horizontal=false
        end
        h = self.parent.send(horizontal ? "height" : "width")
        x = []
        y = []
        dy = []
        
        #
        # Iterate over the data, evaluating the values, x and y functions. The
        # context in which the x and y psuedo-properties are evaluated is a
        # pseudo-mark that is a grandchild of this layout.
        #
        stack = Rubyvis::Mark.stack
        
        o = OpenStruct.new({:parent=> OpenStruct.new({:parent=> self})})
        stack.unshift(nil)
        values = []
        n.times {|i|
          dy[i] = []
          y[i] = []
          o.parent.index = i
          stack[0] = data[i]
          values[i] = self._values.js_apply(o.parent, stack)
          m = values[i].size if (i==0) 
          stack.unshift(nil)
          m.times {|j|
            stack[0] = values[i][j]
            o.index = j
            x[j] = self._x.js_apply(o, stack) if i==0
            dy[i][j] = self._y.js_apply(o, stack)
          }
          stack.shift()
        }
        stack.shift()
        
        # order
        _index=nil
        case s.order
        when "inside-out"
          
          max  = dy.map {|v| Rubyvis.max_index(v) }          
          _map  = Rubyvis.range(n).sort {|a,b| max[a] <=> max[b]}
          
          sums = dy.map {|v| Rubyvis.sum(v)}
          top = 0
          bottom = 0
          tops = []
          bottoms = []
          
          n.times {|i|
            j = _map[i]
            if (top < bottom) 
              top += sums[j];
              tops.push(j);
            else
              bottom += sums[j];
              bottoms.push(j);
            end
          }
          
          _index = bottoms.reverse+tops

        when "reverse"
          _index = Rubyvis.range(n - 1, -1, -1)
        else
          _index = Rubyvis.range(n)
        end
        
        #/* offset */
        case (s.offset) 
        when "silohouette"
          m.times {|j|
            o = 0;
            n.times {|i| 
              o += dy[i][j]
            }
            y[_index[0]][j] = (h - o) / 2.0;
          }
        
        when "wiggle"
          o = 0;
          n.times {|i|  o += dy[i][0] }
          
          y[_index[0]][0] = o = (h - o) / 2.0
          
          (1...m).each  {|j|
            s1 = 0
            s2 = 0
            dx = x[j] - x[j - 1]
            n.times {|i| s1 += dy[i][j]}
            n.times {|i|
              
              s3 = (dy[_index[i]][j] - dy[_index[i]][j - 1]) / (2.0 * dx)
              i.times {|k|
                s3 += (dy[_index[k]][j] - dy[_index[k]][j - 1]) / dx.to_f
              }
              s2 += s3 * dy[_index[i]][j]
            }
            o -= (s1!=0) ? s2 / s1.to_f * dx : 0
            y[_index[0]][j] = o
            
          }
        when "expand"
          m.times {|j|
            y[_index[0]][j] = 0
            
            k = 0
            n.times {|i| k += dy[i][j]}
            if (k!=0) 
              k = h / k.to_f
              n.times {|i| dy[i][j] *= k}
            else 
              k = h / n.to_f
              n.times {|i| dy[i][j] = k}
            end
          }
        else
          m.times {|j| y[_index[0]][j] = 0}
        end
        
        # Propagate the offset to the other series. */
        m.times {|j|
        o = y[_index[0]][j]
          (1...n).each {|i|
            
            o += dy[_index[i - 1]][j]
            y[_index[i]][j] = o
          }
        }
        
        # /* Find the property definitions for dynamic substitution. */
        
        i = orient.index("-")
        pdy = horizontal ? "h" : "w"
        px = i < 0 ? (horizontal ? "l" : "b") : orient[i + 1,1]
        py = orient[0,1]
        
        
        @values=values
        @prop.each {|k,v|
          @prop[k]=@none
        }
        # puts "stack: x:#{px}, y:#{py}, dy:#{pdy}" if $DEBUG
        @prop[px] =lambda {|i1,j| x[j]}
        @prop[py] =lambda {|i1,j| y[i1][j]}
        @prop[pdy]=lambda {|i1,j| dy[i1][j]}  
      end
      
      def layer
        that=self
        value = Rubyvis::Mark.new().data(lambda {  that.values[self.parent.index] }).top(proxy("t")).left(proxy("l")).right(proxy("r")).
          bottom(proxy("b")).
        width(proxy("w")).
        height(proxy("h"))
        
        class << value # :nodoc:
          def that=(v)
            @that = v
          end
          def add(type)
            that  = @that
            that.add( Rubyvis.Panel ).data(lambda { that.layers() }).add(type).mark_extend( self )
          end
        end
        
        value.that=self
        return value
      end
    end
  end
end