From 5bca9aafede4a9f9c122f932656fbbb841e62169 Mon Sep 17 00:00:00 2001
From: d_ricottone <dominic.ricottone@gmail.com>
Date: Sat, 15 Jul 2017 23:00:05 -0400
Subject: [PATCH] Initial commit

---
 readme.txt      |  31 +++++++++++++
 unicode_hist.py | 118 ++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 149 insertions(+)
 create mode 100644 readme.txt
 create mode 100644 unicode_hist.py

diff --git a/readme.txt b/readme.txt
new file mode 100644
index 0000000..f2a9cc2
--- /dev/null
+++ b/readme.txt
@@ -0,0 +1,31 @@
+syntax:
+    unicode_hist.hist(list_object [, number_bins])
+
+     *  list_object can be any list-like object (lists, tuples, etc.)
+     *  number_bins can be any numeric type (default is 1)
+
+
+example output:
+
+>>> unicode_hist.test()
+│                  17                        
+│                   █                        
+│                   █                        
+│                   █                        
+│                   █                        
+│                   █                        
+│                   █                        
+│          10  10   █  10          10        
+│           █   █   █   █           █        
+│           █   █   █   █           █       8
+│           █   █   █   █   7       █   7   █
+│   6   6   █   █   █   █   █       █   █   █
+│   █   █   █   █   █   █   █       █   █   █
+│   █   █   █   █   █   █   █   4   █   █   █
+│   █   █   █   █   █   █   █   █   █   █   █
+│   █   █   █   █   █   █   █   █   █   █   █
+│   █   █   █   █   █   █   █   █   █   █   █
+┼────────────────────────────────────────────
+    8  16  24  32  40  48  56  64  72  80  88
+                              Average = 48.63
+             Excluded outliers: 1, 2, 2, 3, 6
diff --git a/unicode_hist.py b/unicode_hist.py
new file mode 100644
index 0000000..466ebf0
--- /dev/null
+++ b/unicode_hist.py
@@ -0,0 +1,118 @@
+def _bin_iter (avg, bin_width, num_bins):
+    bin_ = int(avg - (bin_width * (num_bins // 2)))
+    a = 0
+    while a < num_bins:
+        yield bin_
+        bin_ = bin_ + bin_width
+        a = a + 1
+
+def hist (args, bin_num=1):
+    """ Creates a formatted unicode histogram.
+        Requires a set of numeric values in a list-like object.
+        Optionally set number of bins.
+        By default, throws all values into a single bin histogram. """
+
+    avg = sum(args)/len(args)
+    bin_num = int(bin_num)
+
+    # a single bin
+    if bin_num == 1:
+        hist_height = len(args)
+        print(u'\u2502' + ' {:>3}'.format(hist_height))
+        hist_height = hist_height - 1
+        while hist_height > 0:
+            print(u'\u2502' + '   ' + u'\u2588')
+            hist_height = hist_height - 1
+        print('{:{}<5}\n'.format(u'\u253c', u'\u2500')
+              + '  all\n'
+              + '  Avg. = {:.2f}'.format(avg))
+        return
+        
+    # histogram design
+    avg = sum(args)/len(args)
+
+    ordered = sorted(args)
+    range_ = ordered[-1] - ordered[0]
+    bin_width = range_ // bin_num
+    if bin_width == 0:
+        bin_width = 1
+
+
+
+    # collect histogram data
+    bin_labels = []
+    bin_freq = []
+    outliers = []
+    for bin_ in _bin_iter(avg, bin_width, bin_num):
+        bin_labels.append(str(bin_))
+        
+        freq = 0
+        x = 0
+        while x < len(ordered):
+            if (ordered[x] < bin_):
+                x = x + 1
+            elif (ordered[x] >= bin_) and (ordered[x] < bin_ + bin_width):
+                ordered.pop(x)
+                freq = freq + 1
+            else:
+                break
+        bin_freq.append(freq)
+
+    for unbinned in ordered:
+        outliers.append(unbinned)
+
+    # draw histogram
+    hist_width = (bin_num * 4) + 1
+    hist_height = max(bin_freq)
+
+    y_val = max(bin_freq)
+    while y_val > 0:
+        row = u'\u2502'
+        for x_val in range(bin_num):
+            if bin_freq[x_val] == y_val:
+                cell_val = str(y_val)
+            elif bin_freq[x_val] > y_val:
+                cell_val = u'\u2588'
+            else:
+                cell_val = ''
+            row = row + ' {:>3}'.format(cell_val)
+        print(row)
+        y_val = y_val - 1
+
+    # draw histogram labels
+    hist_width = (bin_num * 4) + 1
+    horizontal_line = '{corner:{line}<{length}}'.format(corner = u'\u253c',
+                                                        line = u'\u2500',
+                                                        length = hist_width)
+    print(horizontal_line)
+    
+    labels = ' '
+    for label in bin_labels:
+        labels = labels + ' {:>3}'.format(label)
+    print(labels)
+
+    # draw histogram details as applicable
+    if hist_width > 15:
+        details_width = hist_width
+    else:
+        details_width = 15
+        
+    print('{text:>{length}} {average:<.2f}'.format(text = 'Average =',
+                                                   length = details_width - 6,
+                                                   average = avg))
+
+    if outliers != []:
+        string = ', '.join(str(outlier) for outlier in outliers)
+        string = 'Excluded outliers: ' + string
+        print('{text:>{length}}'.format(text = string, length = details_width))
+
+    return
+
+def test ():
+    import random
+    i = 0
+    lst = []
+    while i < 100:
+        lst.append(random.randrange(1,101))
+        i = i + 1
+    hist(lst, 11.0)
-- 
2.45.2