Class: AsciiCharts::Chart
- Inherits:
-
Object
- Object
- AsciiCharts::Chart
- Defined in:
- lib/ascii_charts/chart.rb
Direct Known Subclasses
Constant Summary collapse
- DEFAULT_MAX_Y_VALS =
20
- DEFAULT_MIN_Y_VALS =
10
- INFINITY =
+1.0/0.0
- STEPS =
[1, 2, 5]
Instance Attribute Summary collapse
-
#data ⇒ Object
readonly
Returns the value of attribute data.
-
#options ⇒ Object
readonly
Returns the value of attribute options.
Instance Method Summary collapse
- #all_ints ⇒ Object
- #draw ⇒ Object
- #from_step(val) ⇒ Object
-
#initialize(data, options = {}) ⇒ Chart
constructor
data is a sorted array of [x, y] pairs.
- #lines ⇒ Object
- #max_xval_width ⇒ Object
- #max_yval ⇒ Object
- #max_yval_width ⇒ Object
- #min_yval ⇒ Object
- #nearest_step(val) ⇒ Object
- #next_step_down(val) ⇒ Object
- #next_step_up(val) ⇒ Object
-
#round_value(val) ⇒ Object
round to nearest step size, making sure we curtail precision to same order of magnitude as the step size to avoid 0.4 + 0.2 = 0.6000000000000001.
- #rounded_data ⇒ Object
- #scan_data ⇒ Object
- #scan_y_range ⇒ Object
- #series_to_points(arr_of_series) ⇒ Object
- #step_size ⇒ Object
- #to_step(num, order) ⇒ Object
- #to_string ⇒ Object
- #y_range ⇒ Object
Constructor Details
#initialize(data, options = {}) ⇒ Chart
data is a sorted array of [x, y] pairs
12 13 14 15 16 17 18 19 20 |
# File 'lib/ascii_charts/chart.rb', line 12 def initialize(data, ={}) if (data[0].length == 2) @data = data # treat as array of points else @data = series_to_points(data) # treat as array of series end @options = end |
Instance Attribute Details
#data ⇒ Object (readonly)
Returns the value of attribute data.
4 5 6 |
# File 'lib/ascii_charts/chart.rb', line 4 def data @data end |
#options ⇒ Object (readonly)
Returns the value of attribute options.
4 5 6 |
# File 'lib/ascii_charts/chart.rb', line 4 def @options end |
Instance Method Details
#all_ints ⇒ Object
158 159 160 161 162 163 |
# File 'lib/ascii_charts/chart.rb', line 158 def all_ints if !defined? @all_ints scan_data end @all_ints end |
#draw ⇒ Object
239 240 241 |
# File 'lib/ascii_charts/chart.rb', line 239 def draw lines.join("\n") end |
#from_step(val) ⇒ Object
84 85 86 87 88 89 90 91 92 |
# File 'lib/ascii_charts/chart.rb', line 84 def from_step(val) if 0 == val [0, 0] else order = Math.log10(val).floor.to_i num = (val / (10 ** order)) [num, order] end end |
#lines ⇒ Object
235 236 237 |
# File 'lib/ascii_charts/chart.rb', line 235 def lines raise "lines must be overridden" end |
#max_xval_width ⇒ Object
191 192 193 194 195 196 |
# File 'lib/ascii_charts/chart.rb', line 191 def max_xval_width if !defined? @max_xval_width scan_data end @max_xval_width end |
#max_yval ⇒ Object
144 145 146 147 148 149 |
# File 'lib/ascii_charts/chart.rb', line 144 def max_yval if !defined? @max_yval scan_data end @max_yval end |
#max_yval_width ⇒ Object
198 199 200 201 202 203 |
# File 'lib/ascii_charts/chart.rb', line 198 def max_yval_width if !defined? @max_yval_width scan_y_range end @max_yval_width end |
#min_yval ⇒ Object
151 152 153 154 155 156 |
# File 'lib/ascii_charts/chart.rb', line 151 def min_yval if !defined? @min_yval scan_data end @min_yval end |
#nearest_step(val) ⇒ Object
103 104 105 106 |
# File 'lib/ascii_charts/chart.rb', line 103 def nearest_step(val) num, order = self.from_step(val) self.to_step(2, order) ##@@ end |
#next_step_down(val) ⇒ Object
118 119 120 121 122 123 124 125 126 |
# File 'lib/ascii_charts/chart.rb', line 118 def next_step_down(val) num, order = self.from_step(val) next_index = STEPS.index(num.to_i) - 1 if -1 == next_index STEPS.size - 1 order -= 1 end self.to_step(STEPS[next_index], order) end |
#next_step_up(val) ⇒ Object
108 109 110 111 112 113 114 115 116 |
# File 'lib/ascii_charts/chart.rb', line 108 def next_step_up(val) num, order = self.from_step(val) next_index = STEPS.index(num.to_i) + 1 if STEPS.size == next_index next_index = 0 order += 1 end self.to_step(STEPS[next_index], order) end |
#round_value(val) ⇒ Object
round to nearest step size, making sure we curtail precision to same order of magnitude as the step size to avoid 0.4 + 0.2 = 0.6000000000000001
129 130 131 132 133 134 135 136 137 138 139 140 141 142 |
# File 'lib/ascii_charts/chart.rb', line 129 def round_value(val) remainder = val % self.step_size unprecised = if (remainder * 2) >= self.step_size (val - remainder) + self.step_size else val - remainder end if self.step_size < 1 precision = -Math.log10(self.step_size).floor (unprecised * (10 ** precision)).to_i.to_f / (10 ** precision) else unprecised end end |
#rounded_data ⇒ Object
34 35 36 37 38 39 40 41 42 43 44 |
# File 'lib/ascii_charts/chart.rb', line 34 def rounded_data @rounded_data ||= self.data.map do |point| point.each_with_index.map do |coord, i| if i == 0 coord else round_value(coord) end end end end |
#scan_data ⇒ Object
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 |
# File 'lib/ascii_charts/chart.rb', line 165 def scan_data @max_yval = 0 @min_yval = 0 @all_ints = true @max_xval_width = 1 self.data.each do |point| if (xw = point[0].to_s.length) > @max_xval_width @max_xval_width = xw end point[1..-1].each do |yval| if yval > @max_yval @max_yval = yval end if yval < @min_yval @min_yval = yval end if @all_ints && !yval.is_a?(Integer) @all_ints = false end end end end |
#scan_y_range ⇒ Object
205 206 207 208 209 210 211 212 213 |
# File 'lib/ascii_charts/chart.rb', line 205 def scan_y_range @max_yval_width = 1 self.y_range.each do |yval| if (yw = yval.to_s.length) > @max_yval_width @max_yval_width = yw end end end |
#series_to_points(arr_of_series) ⇒ Object
22 23 24 25 26 27 28 29 30 31 32 |
# File 'lib/ascii_charts/chart.rb', line 22 def series_to_points(arr_of_series) points = [] (0..(arr_of_series[0].length - 1)).each do |i| point = [] (0..(arr_of_series.length - 1)).each do |series| point.push(arr_of_series[series][i]) end points.push(point) end points end |
#step_size ⇒ Object
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 |
# File 'lib/ascii_charts/chart.rb', line 46 def step_size if !defined? @step_size if self.[:y_step_size] @step_size = self.[:y_step_size] else max_y_vals = self.[:max_y_vals] || DEFAULT_MAX_Y_VALS min_y_vals = self.[:max_y_vals] || DEFAULT_MIN_Y_VALS y_span = (self.max_yval - self.min_yval).to_f step_size = self.nearest_step( y_span.to_f / (self.data.size + 1) ) if @all_ints && (step_size < 1) step_size = 1 else while (y_span / step_size) < min_y_vals candidate_step_size = self.next_step_down(step_size) if @all_ints && (candidate_step_size < 1) ## don't go below one break end step_size = candidate_step_size end end #go up if we undershot, or were never over while (y_span / step_size) > max_y_vals step_size = self.next_step_up(step_size) end @step_size = step_size end if !@all_ints && @step_size.is_a?(Integer) @step_size = @step_size.to_f end end @step_size end |
#to_step(num, order) ⇒ Object
94 95 96 97 98 99 100 101 |
# File 'lib/ascii_charts/chart.rb', line 94 def to_step(num, order) s = num * (10 ** order) if order < 0 s.to_f else s end end |
#to_string ⇒ Object
243 244 245 |
# File 'lib/ascii_charts/chart.rb', line 243 def to_string draw end |
#y_range ⇒ Object
215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 |
# File 'lib/ascii_charts/chart.rb', line 215 def y_range if !defined? @y_range @y_range = [] first_y = self.round_value(self.min_yval) if first_y > self.min_yval first_y = first_y - self.step_size end last_y = self.round_value(self.max_yval) if last_y < self.max_yval last_y = last_y + self.step_size end current_y = first_y while current_y <= last_y @y_range << current_y current_y = self.round_value(current_y + self.step_size) ## to avoid fp arithmetic oddness end end @y_range end |