From 58a0e0b893c5b1229bee723ce695384d5b137096 Mon Sep 17 00:00:00 2001
From: Daniel Goldfarb <dgoldfarb.github@gmail.com>
Date: Wed, 24 Aug 2022 19:15:44 -0400
Subject: [PATCH 01/22] fix linestyle validator

---
 src/mplfinance/plotting.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/mplfinance/plotting.py b/src/mplfinance/plotting.py
index b3d4f341..0b446d3a 100644
--- a/src/mplfinance/plotting.py
+++ b/src/mplfinance/plotting.py
@@ -1165,7 +1165,7 @@ def _auto_secondary_y( panels, panid, ylo, yhi ):
 
 def _valid_addplot_kwargs():
 
-    valid_linestyles = ('-','solid','--','dashed','-.','dashdot','.','dotted',None,' ','')
+    valid_linestyles = ('-','solid','--','dashed','-.','dashdot',':','dotted',None,' ','')
     valid_types = ('line','scatter','bar', 'ohlc', 'candle','step')
     valid_stepwheres = ('pre','post','mid')
     valid_edgecolors = ('face', 'none', None)

From f06987df4a2db23b2d77abc6f0aaf5f59177b797 Mon Sep 17 00:00:00 2001
From: Animesh Sahu <animeshsahu19@yahoo.com>
Date: Sat, 1 Oct 2022 20:19:55 +0530
Subject: [PATCH 02/22] Change maximum panels to 32 in docs & examples, in
 regards to completion of #377

---
 examples/panels.ipynb | 2 +-
 markdown/subplots.md  | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/examples/panels.ipynb b/examples/panels.ipynb
index 75c9164c..3212577f 100644
--- a/examples/panels.ipynb
+++ b/examples/panels.ipynb
@@ -17,7 +17,7 @@
     "![sample_subplot](data/sample_subplot.png)\n",
     "\n",
     "### Features and Basic Terminology\n",
-    "* Panels are identified by their \"Panel ID\", an integer ranging from 0 to 9.\n",
+    "* Panels are identified by their \"Panel ID\", an integer ranging from 0 to 31.\n",
     "* Panel ID's are always numbered from top to bottom, thus:\n",
     "  - Panel 0 is always the uppermost panel, Panel 1 is just below that, and so on.\n",
     "* The \"*main panel*\" is the panel where candlesticks/ohlc data are plotted.\n",
diff --git a/markdown/subplots.md b/markdown/subplots.md
index 0a7fa5b8..0a43f04c 100644
--- a/markdown/subplots.md
+++ b/markdown/subplots.md
@@ -17,10 +17,10 @@
 * The Panels Method attains its simplicity, in part, by having certain limitations.<br>These limitiations are:
    - Subplots are always stacked vertically.
    - All subplots share the same x-axis.
-   - There is a maximum of 10 subplots.
+   - There is a maximum of 32 subplots.
 * The Panels Method is adequate to plot:
   - ohlc, candlesticks, etc.
-  - with volume, and 
+  - with volume, and
   - with one or more studies/indicators, such as:
     - MACD, DMI, RSI, Bollinger, Accumulation/Distribution Oscillator, Commodity Channel Index, Etc.
 * [**See here for a tutorial and details on implementing the mplfinance Panels Method for subplots.**](https://github.com/matplotlib/mplfinance/blob/master/examples/panels.ipynb)

From 59b42e8efddaa919e9782e97092dc99dab1df2f7 Mon Sep 17 00:00:00 2001
From: nijek <nikolai.kotsifas@gmail.com>
Date: Sun, 9 Oct 2022 09:47:58 -0300
Subject: [PATCH 03/22] mpf now accepts alpha parameter as list for [hvat]lines
 so it is possible to set a different alpha for each line.

---
 src/mplfinance/_utils.py | 195 ++++++++++++++++++++-------------------
 1 file changed, 99 insertions(+), 96 deletions(-)

diff --git a/src/mplfinance/_utils.py b/src/mplfinance/_utils.py
index 447a52ea..5d555ffa 100644
--- a/src/mplfinance/_utils.py
+++ b/src/mplfinance/_utils.py
@@ -9,7 +9,7 @@
 
 from itertools import cycle
 
-from matplotlib             import colors as mcolors
+from matplotlib import colors as mcolors, pyplot as plt
 from matplotlib.patches     import Ellipse
 from matplotlib.collections import LineCollection, PolyCollection, PatchCollection
 
@@ -83,7 +83,7 @@ def _check_and_convert_xlim_configuration(data, config):
             xlim = [ _date_to_mdate(dt) for dt in xlim]
         else:
             xlim = [ _date_to_iloc_extrapolate(data.index.to_series(),dt) for dt in xlim]
-        
+
     return xlim
 
 
@@ -109,7 +109,7 @@ def _construct_mpf_collections(ptype,dates,xdates,opens,highs,lows,closes,volume
             dates, highs, lows, volumes, config['pnf_params'], closes, marketcolors=style['marketcolors'])
     else:
         raise TypeError('Unknown ptype="',str(ptype),'"')
-     
+
     return collections
 
 
@@ -140,7 +140,7 @@ def combine_adjacent(arr):
     Returns
     -------
     output: new summed array
-    indexes: indexes indicating the first 
+    indexes: indexes indicating the first
              element summed for each group in arr
     """
     output, indexes = [], []
@@ -153,7 +153,7 @@ def combine_adjacent(arr):
         output.append(sum(arr[:index]))
         indexes.append(curr_i)
         curr_i += index
-        
+
         for _ in range(index):
             arr.pop(0)
     return output, indexes
@@ -190,7 +190,7 @@ def _updown_colors(upcolor,downcolor,opens,closes,use_prev_close=False):
     if not use_prev_close:
         return [ cmap[opn < cls] for opn,cls in zip(opens,closes) ]
     else:
-        first = cmap[opens[0] < closes[0]] 
+        first = cmap[opens[0] < closes[0]]
         _list = [ cmap[pre < cls] for cls,pre in zip(closes[1:], closes) ]
         return [first] + _list
 
@@ -208,8 +208,8 @@ def _make_updown_color_list(key,marketcolors,opens,closes,overrides=None):
                 ups[ix]   = mco[key][ 'up' ]
                 downs[ix] = mco[key]['down']
     return [ups[ix] if opens[ix] < closes[ix] else downs[ix] for ix in range(length)]
-       
-                
+
+
 def _updownhollow_colors(upcolor,downcolor,hollowcolor,opens,closes):
     if upcolor == downcolor:
         return upcolor
@@ -221,7 +221,7 @@ def _updownhollow_colors(upcolor,downcolor,hollowcolor,opens,closes):
 
 
 def _date_to_iloc(dtseries,date):
-    '''Convert a `date` to a location, given a date series w/a datetime index. 
+    '''Convert a `date` to a location, given a date series w/a datetime index.
        If `date` does not exactly match a date in the series then interpolate between two dates.
        If `date` is outside the range of dates in the series, then raise an exception
       .
@@ -258,7 +258,7 @@ def _date_to_iloc_linear(dtseries,date,trace=False):
     i1 = 0.0
     i2 = len(dtseries) - 1.0
     if trace: print('i1,i2=',i1,i2)
-    
+
     slope   = (i2 - i1) / (d2 - d1)
     yitrcpt1 = i1 - (slope*d1)
     if trace: print('slope,yitrcpt=',slope,yitrcpt1)
@@ -268,7 +268,7 @@ def _date_to_iloc_linear(dtseries,date,trace=False):
         print('WARNING: yintercepts NOT equal!!!(',yitrcpt1,yitrcpt2,')')
         yitrcpt = (yitrcpt1 + yitrcpt2) / 2.0
     else:
-        yitrcpt = yitrcpt1 
+        yitrcpt = yitrcpt1
     return (slope * _date_to_mdate(date)) + yitrcpt
 
 def _date_to_iloc_5_7ths(dtseries,date,direction,trace=False):
@@ -288,14 +288,14 @@ def _date_to_iloc_5_7ths(dtseries,date,direction,trace=False):
         return loc_5_7ths
 
 def _date_to_iloc_extrapolate(dtseries,date):
-    '''Convert a `date` to a location, given a date series w/a datetime index. 
+    '''Convert a `date` to a location, given a date series w/a datetime index.
        If `date` does not exactly match a date in the series then interpolate between two dates.
        If `date` is outside the range of dates in the series, then extrapolate:
        Extrapolation results in increased error as the distance of the extrapolation increases.
        We have two methods to extrapolate:
        (1) Determine a linear equation based on the data provided in `dtseries`,
            and use that equation to calculate the location for the date.
-       (2) Multiply by 5/7 the number of days between the edge date of dtseries and the 
+       (2) Multiply by 5/7 the number of days between the edge date of dtseries and the
            date for which we are requesting a location.
            THIS ASSUMES DAILY data AND a 5 DAY TRADING WEEK.
        Empirical observation (scratch_pad/date_to_iloc_extrapolation.ipynb) shows that
@@ -348,7 +348,7 @@ def _date_to_mdate(date):
 
 def _convert_segment_dates(segments,dtindex):
     '''
-    Convert line segment dates to matplotlib dates 
+    Convert line segment dates to matplotlib dates
     Inputted segment dates may be: pandas-parseable date-time string, pandas timestamp,
                                    or a python datetime or date, or (if dtindex is not None) integer index
     A "segment" is a "sequence of lines",
@@ -363,7 +363,7 @@ def _convert_segment_dates(segments,dtindex):
         new_line = []
         for dt,value in line:
             if dtindex is not None:
-                date = _date_to_iloc(dtseries,dt)  
+                date = _date_to_iloc(dtseries,dt)
             else:
                 date = _date_to_mdate(dt)
             if date is None:
@@ -374,14 +374,14 @@ def _convert_segment_dates(segments,dtindex):
 
 def _valid_renko_kwargs():
     '''
-    Construct and return the "valid renko kwargs table" for the mplfinance.plot(type='renko') 
-    function. A valid kwargs table is a `dict` of `dict`s. The keys of the outer dict are 
-    the valid key-words for the function.  The value for each key is a dict containing 3 
+    Construct and return the "valid renko kwargs table" for the mplfinance.plot(type='renko')
+    function. A valid kwargs table is a `dict` of `dict`s. The keys of the outer dict are
+    the valid key-words for the function.  The value for each key is a dict containing 3
     specific keys: "Default", "Description" and "Validator" with the following values:
         "Default"      - The default value for the kwarg if none is specified.
         "Description"  - The description for the kwarg.
         "Validator"    - A function that takes the caller specified value for the kwarg,
-                         and validates that it is the correct type, and (for kwargs with 
+                         and validates that it is the correct type, and (for kwargs with
                          a limited set of allowed values) may also validate that the
                          kwarg value is one of the allowed values.
     '''
@@ -404,14 +404,14 @@ def _valid_renko_kwargs():
 
 def _valid_pnf_kwargs():
     '''
-    Construct and return the "valid pnf kwargs table" for the mplfinance.plot(type='pnf') 
-    function. A valid kwargs table is a `dict` of `dict`s. The keys of the outer dict are 
-    the valid key-words for the function.  The value for each key is a dict containing 3 
+    Construct and return the "valid pnf kwargs table" for the mplfinance.plot(type='pnf')
+    function. A valid kwargs table is a `dict` of `dict`s. The keys of the outer dict are
+    the valid key-words for the function.  The value for each key is a dict containing 3
     specific keys: "Default", "Description" and "Validator" with the following values:
         "Default"      - The default value for the kwarg if none is specified.
         "Description"  - The description for the kwarg.
         "Validator"    - A function that takes the caller specified value for the kwarg,
-                         and validates that it is the correct type, and (for kwargs with 
+                         and validates that it is the correct type, and (for kwargs with
                          a limited set of allowed values) may also validate that the
                          kwarg value is one of the allowed values.
     '''
@@ -438,16 +438,17 @@ def _valid_pnf_kwargs():
 
 
 def _valid_lines_kwargs():
+
     '''
-    Construct and return the "valid lines (hlines,vlines,alines,tlines) kwargs table" 
+    Construct and return the "valid lines (hlines,vlines,alines,tlines) kwargs table"
     for the mplfinance.plot() `[h|v|a|t]lines=` kwarg functions.
-    A valid kwargs table is a `dict` of `dict`s. The keys of the outer dict are 
-    the valid key-words for the function.  The value for each key is a dict containing 3 
+    A valid kwargs table is a `dict` of `dict`s. The keys of the outer dict are
+    the valid key-words for the function.  The value for each key is a dict containing 3
     specific keys: "Default", "Description" and "Validator" with the following values:
         "Default"      - The default value for the kwarg if none is specified.
         "Description"  - The description for the kwarg.
         "Validator"    - A function that takes the caller specified value for the kwarg,
-                         and validates that it is the correct type, and (for kwargs with 
+                         and validates that it is the correct type, and (for kwargs with
                          a limited set of allowed values) may also validate that the
                          kwarg value is one of the allowed values.
     '''
@@ -496,7 +497,7 @@ def _valid_lines_kwargs():
                         'Description' : 'line style of [hvat]lines (or sequence of line styles, if each line to have a different linestyle)',
                         'Validator'   : lambda value: value is None or value in valid_linestyles or
                                             all([v in valid_linestyles for v in value]) },
-      
+
         'linewidths': { 'Default'     : None,
                         'Description' : 'line width of [hvat]lines (or sequence of line widths, if each line to have a different width)',
                         'Validator'   : lambda value: value is None
@@ -504,9 +505,11 @@ def _valid_lines_kwargs():
                                                       or all([isinstance(v,(float,int)) for v in value]) },
 
         'alpha'     : { 'Default'     : 1.0,
-                        'Description' : 'Opacity of [hvat]lines.  float from 0.0 to 1.0 '+
-                                        ' (1.0 means fully opaque; 0.0 means transparent.',
-                        'Validator'   : lambda value: isinstance(value,(float,int)) },
+                        'Description' : 'Opacity of [hvat]lines (or sequence of opacities,'
+                        + 'if each line is to have a different opacity)'
+                        + 'float from 0.0 to 1.0 '+' (1.0 means fully opaque; 0.0 means transparent.',
+                        'Validator'   : lambda value: isinstance(value,(float,int))
+                                        or all([isinstance(v, (float, int)) for v in value])    },
 
 
         'tline_use' : { 'Default'     : 'close',
@@ -549,7 +552,7 @@ def _construct_ohlc_collections(dates, opens, highs, lows, closes, marketcolors=
 
     Returns
     -------
-    ret : list 
+    ret : list
         a list or tuple of matplotlib collections to be added to the axes
     """
 
@@ -629,7 +632,7 @@ def _construct_candlestick_collections(dates, opens, highs, lows, closes, market
     ret : list
         (lineCollection, barCollection)
     """
-    
+
     _check_input(opens, highs, lows, closes)
 
     if marketcolors is None:
@@ -649,10 +652,10 @@ def _construct_candlestick_collections(dates, opens, highs, lows, closes, market
 
     rangeSegLow   = [((date, low), (date, min(open,close)))
                      for date, low, open, close in zip(dates, lows, opens, closes)]
-    
+
     rangeSegHigh  = [((date, high), (date, max(open,close)))
                      for date, high, open, close in zip(dates, highs, opens, closes)]
-                      
+
     rangeSegments = rangeSegLow + rangeSegHigh
 
     alpha  = marketcolors['alpha']
@@ -685,7 +688,7 @@ def _construct_candlestick_collections(dates, opens, highs, lows, closes, market
 def _construct_hollow_candlestick_collections(dates, opens, highs, lows, closes, marketcolors=None, config=None):
     """Represent today's open to close as a "bar" line (candle body)
     and high low range as a vertical line (candle wick)
-     
+
     If config['type']=='hollow_and_filled' (hollow and filled candles) then candle edge and
     wick color depend on PREVIOUS close to today's close (up or down), and the center of the
     candle body (hollow or filled) depends on the today's open to close (up or down).
@@ -712,7 +715,7 @@ def _construct_hollow_candlestick_collections(dates, opens, highs, lows, closes,
     ret : list
         (lineCollection, barCollection)
     """
-    
+
     _check_input(opens, highs, lows, closes)
 
     if marketcolors is None:
@@ -732,23 +735,23 @@ def _construct_hollow_candlestick_collections(dates, opens, highs, lows, closes,
 
     rangeSegLow   = [((date, low), (date, min(open,close)))
                      for date, low, open, close in zip(dates, lows, opens, closes)]
-    
+
     rangeSegHigh  = [((date, high), (date, max(open,close)))
                      for date, high, open, close in zip(dates, highs, opens, closes)]
-                      
+
     rangeSegments = rangeSegLow + rangeSegHigh
 
     alpha  = marketcolors['alpha']
 
     uc     = mcolors.to_rgba(marketcolors['candle'][ 'up' ], alpha)
     dc     = mcolors.to_rgba(marketcolors['candle']['down'], alpha)
-   
+
     hc = mcolors.to_rgba(marketcolors['hollow']) if 'hollow' in marketcolors else (0,0,0,0)
-    
+
     colors = _updownhollow_colors(uc, dc, hc, opens, closes)  # for candle body.
 
     edgecolor = _updown_colors(uc, dc, opens, closes, use_prev_close=True)
-    
+
     wickcolor = _updown_colors(uc, dc, opens, closes, use_prev_close=True)
 
     # For hollow candles, we scale the candle linewidth up a little:
@@ -778,19 +781,19 @@ def _construct_renko_collections(dates, highs, lows, volumes, config_renko_param
     ---------------------
     In the first part of the algorithm, we populate the cdiff array
     along with adjusting the dates and volumes arrays into the new_dates and
-    new_volumes arrays. A single date includes a range from no bricks to many 
-    bricks, if a date has no bricks it shall not be included in new_dates, 
-    and if it has n bricks then it will be included n times. Volumes use a 
+    new_volumes arrays. A single date includes a range from no bricks to many
+    bricks, if a date has no bricks it shall not be included in new_dates,
+    and if it has n bricks then it will be included n times. Volumes use a
     volume cache to save volume amounts for dates that do not have any bricks
     before adding the cache to the next date that has at least one brick.
-    We populate the cdiff array with each close values difference from the 
+    We populate the cdiff array with each close values difference from the
     previously created brick divided by the brick size.
 
     In the second part of the algorithm, we iterate through the values in cdiff
-    and add 1s or -1s to the bricks array depending on whether the value is 
+    and add 1s or -1s to the bricks array depending on whether the value is
     positive or negative. Every time there is a trend change (ex. previous brick is
     an upbrick, current brick is a down brick) we draw one less brick to account
-    for the price having to move the previous bricks amount before creating a 
+    for the price having to move the previous bricks amount before creating a
     brick in the opposite direction.
 
     In the final part of the algorithm, we enumerate through the bricks array and
@@ -801,7 +804,7 @@ def _construct_renko_collections(dates, highs, lows, volumes, config_renko_param
     Useful sources:
     https://avilpage.com/2018/01/how-to-plot-renko-charts-with-python.html
     https://school.stockcharts.com/doku.php?id=chart_analysis:renko
-    
+
     Parameters
     ----------
     dates : sequence
@@ -825,10 +828,10 @@ def _construct_renko_collections(dates, highs, lows, volumes, config_renko_param
     renko_params = _process_kwargs(config_renko_params, _valid_renko_kwargs())
     if marketcolors is None:
         marketcolors = _get_mpfstyle('classic')['marketcolors']
-    
+
     brick_size = renko_params['brick_size']
     atr_length = renko_params['atr_length']
-    
+
 
     if brick_size == 'atr':
         if atr_length == 'total':
@@ -849,7 +852,7 @@ def _construct_renko_collections(dates, highs, lows, volumes, config_renko_param
     dc     = mcolors.to_rgba(marketcolors['candle']['down'], alpha)
     euc    = mcolors.to_rgba(marketcolors['edge'][ 'up' ], 1.0)
     edc    = mcolors.to_rgba(marketcolors['edge']['down'], 1.0)
-    
+
     cdiff = [] # holds the differences between each close and the previously created brick / the brick size
     prev_close_brick = closes[0]
     volume_cache = 0 # holds the volumes for the dates that were skipped
@@ -876,7 +879,7 @@ def _construct_renko_collections(dates, highs, lows, volumes, config_renko_param
     last_diff_sign = 0 # direction the bricks were last going in -1 -> down, 1 -> up
     dates_volumes_index = 0 # keeps track of the index of the current date/volume
     for diff in cdiff:
-        
+
         curr_diff_sign = diff/abs(diff)
         if last_diff_sign != 0 and curr_diff_sign != last_diff_sign:
             last_diff_sign = curr_diff_sign
@@ -889,7 +892,7 @@ def _construct_renko_collections(dates, highs, lows, volumes, config_renko_param
                 new_volumes.pop(dates_volumes_index)
             continue
         last_diff_sign = curr_diff_sign
-    
+
         if diff > 0:
             bricks.extend([1]*abs(diff))
         else:
@@ -911,7 +914,7 @@ def _construct_renko_collections(dates, highs, lows, volumes, config_renko_param
 
         curr_price += (brick_size * number)
         brick_values.append(curr_price)
-        
+
         x, y = index, curr_price
 
         verts.append((
@@ -943,41 +946,41 @@ def _construct_pointnfig_collections(dates, highs, lows, volumes, config_pointnf
     ---------------------
     In the first part of the algorithm, we populate the boxes array
     along with adjusting the dates and volumes arrays into the new_dates and
-    new_volumes arrays. A single date includes a range from no boxes to many 
-    boxes, if a date has no boxes it shall not be included in new_dates, 
-    and if it has n boxes then it will be included n times. Volumes use a 
+    new_volumes arrays. A single date includes a range from no boxes to many
+    boxes, if a date has no boxes it shall not be included in new_dates,
+    and if it has n boxes then it will be included n times. Volumes use a
     volume cache to save volume amounts for dates that do not have any boxes
     before adding the cache to the next date that has at least one box.
-    We populate the boxes array with each close values difference from the 
+    We populate the boxes array with each close values difference from the
     previously created brick divided by the box size.
 
     The second part of the algorithm has a series of step. First we combine the
     adjacent like signed values in the boxes array (ex. [-1, -2, 3, -4] -> [-3, 3, -4]).
-    Next we subtract 1 from the absolute value of each element in boxes except the 
+    Next we subtract 1 from the absolute value of each element in boxes except the
     first to ensure every time there is a trend change (ex. previous box is
-    an X, current brick is a O) we draw one less box to account for the price 
-    having to move the previous box's amount before creating a box in the 
-    opposite direction. During this same step we also combine like signed elements 
-    and associated volume/date data ignoring any zero values that are created by 
-    subtracting 1 from the box value. Next we recreate the box array utilizing a 
-    rolling_change and volume_cache to store and sum the changes that don't break 
+    an X, current brick is a O) we draw one less box to account for the price
+    having to move the previous box's amount before creating a box in the
+    opposite direction. During this same step we also combine like signed elements
+    and associated volume/date data ignoring any zero values that are created by
+    subtracting 1 from the box value. Next we recreate the box array utilizing a
+    rolling_change and volume_cache to store and sum the changes that don't break
     the reversal threshold.
 
     Lastly, we enumerate through the boxes to populate the line_seg and circle_patches
-    arrays. line_seg holds the / and \ line segments that make up an X and 
+    arrays. line_seg holds the / and \ line segments that make up an X and
     circle_patches holds matplotlib.patches Ellipse objects for each O. We start
-    by filling an x and y array each iteration which contain the x and y 
+    by filling an x and y array each iteration which contain the x and y
     coordinates for each box in the column. Then for each coordinate pair in
-    x, y we add to either the line_seg array or the circle_patches array 
-    depending on the value of sign for the current column (1 indicates 
-    line_seg, -1 indicates circle_patches). The height of the boxes take 
-    into account padding which separates each box by a small margin in 
+    x, y we add to either the line_seg array or the circle_patches array
+    depending on the value of sign for the current column (1 indicates
+    line_seg, -1 indicates circle_patches). The height of the boxes take
+    into account padding which separates each box by a small margin in
     order to increase readability.
 
     Useful sources:
     https://stackoverflow.com/questions/8750648/point-and-figure-chart-with-matplotlib
     https://www.investopedia.com/articles/technical/03/081303.asp
-    
+
     Parameters
     ----------
     dates : sequence
@@ -1001,7 +1004,7 @@ def _construct_pointnfig_collections(dates, highs, lows, volumes, config_pointnf
     pointnfig_params = _process_kwargs(config_pointnfig_params, _valid_pnf_kwargs())
     if marketcolors is None:
         marketcolors = _get_mpfstyle('classic')['marketcolors']
-    
+
     box_size = pointnfig_params['box_size']
     atr_length = pointnfig_params['atr_length']
     reversal = pointnfig_params['reversal']
@@ -1021,7 +1024,7 @@ def _construct_pointnfig_collections(dates, highs, lows, volumes, config_pointnf
 
     if reversal < 1 or reversal > 9:
         raise ValueError("Specified reversal must be an integer in the range [1,9]")
-    
+
     alpha  = marketcolors['alpha']
 
     uc     = mcolors.to_rgba(marketcolors['ohlc'][ 'up' ], alpha)
@@ -1032,7 +1035,7 @@ def _construct_pointnfig_collections(dates, highs, lows, volumes, config_pointnf
     prev_close_box = closes[0] # represents the value of the last box in the previous column
     volume_cache = 0 # holds the volumes for the dates that were skipped
     temp_volumes, temp_dates = [], [] # holds the temp adjusted volumes and dates respectively
-    
+
     for i in range(len(closes)-1):
         box_diff = int((closes[i+1] - prev_close_box) / box_size)
         if box_diff == 0:
@@ -1050,7 +1053,7 @@ def _construct_pointnfig_collections(dates, highs, lows, volumes, config_pointnf
     # combine adjacent similarly signed differences
     boxes, indexes = combine_adjacent(boxes)
     new_volumes, new_dates = coalesce_volume_dates(temp_volumes, temp_dates, indexes)
-    
+
     adjusted_boxes = [boxes[0]]
     temp_volumes, temp_dates = [new_volumes[0]], [new_dates[0]]
     volume_cache = 0
@@ -1086,7 +1089,7 @@ def _construct_pointnfig_collections(dates, highs, lows, volumes, config_pointnf
     boxes = [adjusted_boxes[0]]
     new_volumes = [temp_volumes[0]]
     new_dates = [temp_dates[0]]
-    
+
     rolling_change = 0
     volume_cache = 0
     biggest_difference = 0 # only used for the last column
@@ -1094,11 +1097,11 @@ def _construct_pointnfig_collections(dates, highs, lows, volumes, config_pointnf
     #Clean data to account for reversal size (added to allow overriding the default reversal of 1)
     for i in range(1, len(adjusted_boxes)):
 
-        # Add to rolling_change and volume_cache which stores the box and volume values 
+        # Add to rolling_change and volume_cache which stores the box and volume values
         rolling_change += adjusted_boxes[i]
         volume_cache += temp_volumes[i]
 
-        # if rolling_change is the same sign as the previous box and the abs value is bigger than the 
+        # if rolling_change is the same sign as the previous box and the abs value is bigger than the
         # abs value of biggest_difference then we should replace biggest_difference with rolling_change
         if rolling_change*boxes[-1] > 0 and abs(rolling_change) > abs(biggest_difference):
             biggest_difference = rolling_change
@@ -1116,14 +1119,14 @@ def _construct_pointnfig_collections(dates, highs, lows, volumes, config_pointnf
                 boxes.append(rolling_change)
                 new_volumes.append(volume_cache)
                 new_dates.append(temp_dates[i])
-            
+
             # reset rolling_change and volume_cache once we've used them
             rolling_change = 0
             volume_cache = 0
-            
+
             # reset biggest_difference as we start from the beginning every time there is a reversal
             biggest_difference = 0
-    
+
     # Adjust the last box column if the left over rolling_change is the same sign as the column
     boxes[-1] += biggest_difference
     new_volumes[-1] += volume_cache
@@ -1138,33 +1141,33 @@ def _construct_pointnfig_collections(dates, highs, lows, volumes, config_pointnf
 
         sign = (difference / abs(difference)) # -1 or 1
         start_iteration = 0 if sign > 0 else 1
-        
+
         x = [index] * (diff)
         y = [curr_price + (i * box_size * sign) for i in range(start_iteration, diff+start_iteration)]
 
         curr_price += (box_size * sign * (diff))
         box_values.append( y )
-        
+
         for i in range(len(x)): # x and y have the same length
             height = box_size * 0.85
             width = 0.6
             if height < 0.5:
                 width = height
-            
+
             padding = (box_size * 0.075)
             if sign == 1: # X
                 line_seg.append([(x[i]-width/2, y[i] + padding), (x[i]+width/2, y[i]+height + padding)]) # create / part of the X
                 line_seg.append([(x[i]-width/2, y[i]+height+padding), (x[i]+width/2, y[i]+padding)]) # create \ part of the X
             else: # O
                 circle_patches.append(Ellipse((x[i], y[i]-(height/2) - padding), width, height))
-    
+
     useAA = 0,    # use tuple here
-    lw = 0.5        
+    lw = 0.5
 
     cirCollection = PatchCollection(circle_patches)
     cirCollection.set_facecolor([tfc] * len(circle_patches))
     cirCollection.set_edgecolor([dc] * len(circle_patches))
-    
+
     xCollection = LineCollection(line_seg,
                                  colors=[uc] * len(line_seg),
                                  linewidths=lw,
@@ -1182,7 +1185,7 @@ def _construct_aline_collections(alines, dtix=None):
     ----------
     alines : sequence
         sequences of segments, which are sequences of lines,
-        which are sequences of two or more points ( date[time], price ) or (x,y) 
+        which are sequences of two or more points ( date[time], price ) or (x,y)
 
         date[time] may be (a) pandas.to_datetime parseable string,
                           (b) pandas Timestamp, or
@@ -1269,7 +1272,7 @@ def _construct_hline_collections(hlines,minx,maxx):
 
     #print('hconfig=',hconfig)
     #print('hlines=',hlines)
-    
+
     lines = []
     if not isinstance(hlines,(list,tuple)):
         hlines = [hlines,] # may be a single price value
@@ -1332,7 +1335,7 @@ def _construct_vline_collections(vlines,dtix,miny,maxy):
 
     #print('vconfig=',vconfig)
     #print('vlines=',vlines)
-    
+
     if not isinstance(vlines,(list,tuple)):
         vlines = [vlines,]
 
@@ -1416,7 +1419,7 @@ def _tline_lsq(dfslice,tline_use):
         https://mmas.github.io/least-squares-fitting-numpy-scipy
         '''
         si = dfslice[tline_use].mean(axis=1)
-        s  = si.dropna() 
+        s  = si.dropna()
         if len(s) < 2:
             err = 'NOT enough data for Least Squares'
             if (len(si) > 2):
@@ -1453,7 +1456,7 @@ def _tline_lsq(dfslice,tline_use):
         alines.append((p1,p2))
 
     del tconfig['alines']
-    alines = dict(alines=alines,**tconfig) 
+    alines = dict(alines=alines,**tconfig)
     alines['tlines'] = None
 
     return _construct_aline_collections(alines, dtix)
@@ -1471,7 +1474,7 @@ class IntegerIndexDateTimeFormatter(Formatter):
     you would otherwise plot on that axis.  Construct this formatter
     by providing the arrange of datetimes (as matplotlib floats). When
     the formatter receives an integer in the range, it will look up the
-    datetime and format it.  
+    datetime and format it.
 
     """
     def __init__(self, dates, fmt='%b %d, %H:%M'):
@@ -1485,7 +1488,7 @@ def __call__(self, x, pos=0):
         # not sure what 'pos' is for: see
         # https://matplotlib.org/gallery/ticks_and_spines/date_index_formatter.html
         ix = int(np.round(x))
-         
+
         if ix >= self.len or ix < 0:
             date = None
             dateformat = ''

From c09265f2f375e2d584c565ab09557e7bec2c0dd5 Mon Sep 17 00:00:00 2001
From: nijek <nikolai.kotsifas@gmail.com>
Date: Sun, 9 Oct 2022 10:25:39 -0300
Subject: [PATCH 04/22]  mpf now accepts alpha parameter as list for
 [hvat]lines so it is possible to set a different alpha for each line. I also
 imported matplotlib.pyplot as plt to solve a unresolved reference on function
 _mscatter(x,y,ax=None, m=None, **kw)

---
 src/mplfinance/_utils.py | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/src/mplfinance/_utils.py b/src/mplfinance/_utils.py
index 5d555ffa..a4f80dfc 100644
--- a/src/mplfinance/_utils.py
+++ b/src/mplfinance/_utils.py
@@ -438,7 +438,6 @@ def _valid_pnf_kwargs():
 
 
 def _valid_lines_kwargs():
-
     '''
     Construct and return the "valid lines (hlines,vlines,alines,tlines) kwargs table"
     for the mplfinance.plot() `[h|v|a|t]lines=` kwarg functions.
@@ -504,12 +503,12 @@ def _valid_lines_kwargs():
                                                       or isinstance(value,(float,int))
                                                       or all([isinstance(v,(float,int)) for v in value]) },
 
-        'alpha'     : { 'Default'     : 1.0,
-                        'Description' : 'Opacity of [hvat]lines (or sequence of opacities,'
-                        + 'if each line is to have a different opacity)'
-                        + 'float from 0.0 to 1.0 '+' (1.0 means fully opaque; 0.0 means transparent.',
-                        'Validator'   : lambda value: isinstance(value,(float,int))
-                                        or all([isinstance(v, (float, int)) for v in value])    },
+        'alpha': {'Default': 1.0,
+                  'Description': 'Opacity of [hvat]lines (or sequence of opacities,'
+                                 + 'if each line is to have a different opacity)'
+                                 + 'float from 0.0 to 1.0 ' + ' (1.0 means fully opaque; 0.0 means transparent.',
+                  'Validator': lambda value: isinstance(value, (float, int))
+                                             or all([isinstance(v, (float, int)) for v in value])},
 
 
         'tline_use' : { 'Default'     : 'close',

From 75b41f65a06fa6f87e44eb57166c04fb0bd4d80b Mon Sep 17 00:00:00 2001
From: Daniel Goldfarb <dgoldfarb.github@gmail.com>
Date: Thu, 13 Oct 2022 17:11:02 -0400
Subject: [PATCH 05/22] Update _version.py

---
 src/mplfinance/_version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/mplfinance/_version.py b/src/mplfinance/_version.py
index 9bca395f..44439d7d 100644
--- a/src/mplfinance/_version.py
+++ b/src/mplfinance/_version.py
@@ -1,4 +1,4 @@
-version_info = (0, 12, 9, 'beta', 1)
+version_info = (0, 12, 9, 'beta', 2)
 
 _specifier_ = {'alpha': 'a','beta': 'b','candidate': 'rc','final': ''}
 

From 47e4c0c7a8acdb91f4a1bca5f43f12ffc54c45b9 Mon Sep 17 00:00:00 2001
From: andrewrgarcia <andrewrgarcia@ufl.edu>
Date: Wed, 19 Oct 2022 14:40:19 -0400
Subject: [PATCH 06/22] start dev: exponential mav for Issue #506

---
 src/mplfinance/plotting.py | 39 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/src/mplfinance/plotting.py b/src/mplfinance/plotting.py
index b3d4f341..6f6884d6 100644
--- a/src/mplfinance/plotting.py
+++ b/src/mplfinance/plotting.py
@@ -1147,6 +1147,45 @@ def _plot_mav(ax,config,xdates,prices,apmav=None,apwidth=None):
             mavp_list.append(mavprices)
     return mavp_list
 
+
+def _plot_ema(ax,config,xdates,prices,apmav=None,apwidth=None):
+    '''ema: exponential moving average'''
+    style = config['style']
+    if apmav is not None:
+        mavgs = apmav
+    else:
+        mavgs = config['ema']
+    mavp_list = []
+    if mavgs is not None:
+        shift = None
+        if isinstance(mavgs,dict):
+            shift = mavgs['shift']
+            mavgs = mavgs['period']
+        if isinstance(mavgs,int):
+            mavgs = mavgs,      # convert to tuple
+        if len(mavgs) > 7:
+            mavgs = mavgs[0:7]  # take at most 7
+     
+        if style['mavcolors'] is not None:
+            mavc = cycle(style['mavcolors'])
+        else:
+            mavc = None
+
+        for idx,mav in enumerate(mavgs):
+            # mean = pd.Series(prices).rolling(mav).mean()
+            mean = pd.Series(prices).ewm(span=mav,adjust=False).mean()
+            if shift is not None:
+                mean = mean.shift(periods=shift[idx])
+            mavprices = mean.values
+            lw = config['_width_config']['line_width']
+            if mavc:
+                ax.plot(xdates, mavprices, linewidth=lw, color=next(mavc))
+            else:
+                ax.plot(xdates, mavprices, linewidth=lw)
+            mavp_list.append(mavprices)
+    return mavp_list
+
+
 def _auto_secondary_y( panels, panid, ylo, yhi ):
     # If mag(nitude) for this panel is not yet set, then set it
     # here, as this is the first ydata to be plotted on this panel:

From 0cba1ce4b52a152e3838ce58063d7bc76f91d49b Mon Sep 17 00:00:00 2001
From: andrewrgarcia <andrewrgarcia@ufl.edu>
Date: Thu, 20 Oct 2022 16:05:13 -0400
Subject: [PATCH 07/22] add ema label in _valid_plot_kwargs(); _mav_validator
 also because ema has the same data-types as mav

---
 src/mplfinance/plotting.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/mplfinance/plotting.py b/src/mplfinance/plotting.py
index 6f6884d6..c8bcb406 100644
--- a/src/mplfinance/plotting.py
+++ b/src/mplfinance/plotting.py
@@ -119,6 +119,10 @@ def _valid_plot_kwargs():
         'mav'                       : { 'Default'     : None,
                                         'Description' : 'Moving Average window size(s); (int or tuple of ints)',
                                         'Validator'   : _mav_validator },
+
+        'ema'                       : { 'Default'     : None,
+                                        'Description' : 'Exponential Moving Average window size(s); (int or tuple of ints)',
+                                        'Validator'   : _mav_validator },
         
         'renko_params'              : { 'Default'     : dict(),
                                         'Description' : 'dict of renko parameters; call `mpf.kwarg_help("renko_params")`',

From 95f0e332daa3e7260dbfc31775ff77a4242eefdf Mon Sep 17 00:00:00 2001
From: andrewrgarcia <andrewrgarcia@ufl.edu>
Date: Fri, 21 Oct 2022 14:45:16 -0400
Subject: [PATCH 08/22] made suggested changes and tested new ema option
 against baseline

---
 src/mplfinance/plotting.py     | 1348 +++++++++++++++++---------------
 tests/test_ema.py              |   85 ++
 tests/test_images/test_ema.png |  Bin 0 -> 57100 bytes
 3 files changed, 794 insertions(+), 639 deletions(-)
 create mode 100644 tests/test_ema.py
 create mode 100644 tests/test_images/test_ema.png

diff --git a/src/mplfinance/plotting.py b/src/mplfinance/plotting.py
index c8bcb406..a04e9c65 100644
--- a/src/mplfinance/plotting.py
+++ b/src/mplfinance/plotting.py
@@ -1,10 +1,10 @@
-import matplotlib.dates  as mdates
+import matplotlib.dates as mdates
 import matplotlib.pyplot as plt
 import matplotlib.colors as mcolors
-import matplotlib.axes   as mpl_axes
+import matplotlib.axes as mpl_axes
 import matplotlib.figure as mpl_fig
 import pandas as pd
-import numpy  as np
+import numpy as np
 import copy
 import io
 import os
@@ -14,7 +14,7 @@
 
 from itertools import cycle
 #from pandas.plotting import register_matplotlib_converters
-#register_matplotlib_converters()
+# register_matplotlib_converters()
 
 from mplfinance._utils import _construct_aline_collections
 from mplfinance._utils import _construct_hline_collections
@@ -51,7 +51,8 @@
 
 VALID_PMOVE_TYPES = ['renko', 'pnf']
 
-DEFAULT_FIGRATIO = (8.00,5.75)
+DEFAULT_FIGRATIO = (8.00, 5.75)
+
 
 def with_rc_context(func):
     '''
@@ -64,24 +65,26 @@ def decorator(*args, **kwargs):
             return func(*args, **kwargs)
     return decorator
 
+
 def _warn_no_xgaps_deprecated(value):
-    warnings.warn('\n\n ================================================================= '+
-                  '\n\n   WARNING: `no_xgaps` is /deprecated/:'+
-                  '\n     Default value is now `no_xgaps=True`'+
-                  '\n     However, to set `no_xgaps=False` and silence this warning,'+
-                  '\n     use instead: `show_nontrading=True`.'+
+    warnings.warn('\n\n ================================================================= ' +
+                  '\n\n   WARNING: `no_xgaps` is /deprecated/:' +
+                  '\n     Default value is now `no_xgaps=True`' +
+                  '\n     However, to set `no_xgaps=False` and silence this warning,' +
+                  '\n     use instead: `show_nontrading=True`.' +
                   '\n\n ================================================================ ',
                   category=DeprecationWarning)
-    return isinstance(value,bool)
+    return isinstance(value, bool)
+
 
 def _warn_set_ylim_deprecated(value):
-    warnings.warn('\n\n ================================================================= '+
-                  '\n\n   WARNING: `set_ylim=(ymin,ymax)` kwarg '+
-                    '\n             has been replaced with: '+
-                    '\n            `ylim=(ymin,ymax)`.'+
+    warnings.warn('\n\n ================================================================= ' +
+                  '\n\n   WARNING: `set_ylim=(ymin,ymax)` kwarg ' +
+                  '\n             has been replaced with: ' +
+                  '\n            `ylim=(ymin,ymax)`.' +
                   '\n\n ================================================================ ',
                   category=DeprecationWarning)
-    return isinstance(value,bool)
+    return isinstance(value, bool)
 
 
 def _valid_plot_kwargs():
@@ -98,297 +101,299 @@ def _valid_plot_kwargs():
     '''
 
     vkwargs = {
-        'columns'                   : { 'Default'     : None, # use default names: ('Open', 'High', 'Low', 'Close', 'Volume')
-                                        'Description' : ('Column names to be used when plotting the data.'+
-                                                         ' Default: ("Open", "High", "Low", "Close", "Volume")'),
-                                        'Validator'   : lambda value: isinstance(value, (tuple, list))
-                                                                   and len(value) == 5
-                                                                   and all(isinstance(c, str) for c in value) },
-        'type'                      : { 'Default'     : 'ohlc',
-                                        'Description' : 'Plot type: '+str(_get_valid_plot_types()),
-                                        'Validator'   : lambda value: value in _get_valid_plot_types() },
- 
-        'style'                     : { 'Default'     : None,
-                                        'Description' : 'plot style; see `mpf.available_styles()`',
-                                        'Validator'   : _styles._valid_mpf_style },
- 
-        'volume'                    : { 'Default'     : False,
-                                        'Description' : 'Plot volume: True, False, or set to Axes object on which to plot.',
-                                        'Validator'   : lambda value: isinstance(value,bool) or isinstance(value,mpl_axes.Axes) },
- 
-        'mav'                       : { 'Default'     : None,
-                                        'Description' : 'Moving Average window size(s); (int or tuple of ints)',
-                                        'Validator'   : _mav_validator },
-
-        'ema'                       : { 'Default'     : None,
-                                        'Description' : 'Exponential Moving Average window size(s); (int or tuple of ints)',
-                                        'Validator'   : _mav_validator },
-        
-        'renko_params'              : { 'Default'     : dict(),
-                                        'Description' : 'dict of renko parameters; call `mpf.kwarg_help("renko_params")`',
-                                        'Validator'   : lambda value: isinstance(value,dict) },
-
-        'pnf_params'                : { 'Default'     : dict(),
-                                        'Description' : 'dict of point-and-figure parameters; call `mpf.kwarg_help("pnf_params")`',
-                                        'Validator'   : lambda value: isinstance(value,dict) },
- 
-        'study'                     : { 'Default'     : None,
-                                        'Description' : 'kwarg not implemented',
-                                        'Validator'   : lambda value: _kwarg_not_implemented(value) }, 
- 
-        'marketcolor_overrides'     : { 'Default'     : None, 
-                                        'Description' : 'sequence of color objects to override market colors.'+
-                                                        'sequence must be same length as ohlc(v) DataFrame. Each'+
-                                                        'color object may be a color, marketcolor object, or None.',
-                                        'Validator'   : _mco_validator },
- 
-        'mco_faceonly'              : { 'Default'     : False, # If True: Override only the face of the candle
-                                        'Description' : 'True/False marketcolor_overrides only apply to face of candle.',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
- 
-        'no_xgaps'                  : { 'Default'     : True,  # None means follow default logic below:
-                                        'Description' : 'deprecated',
-                                        'Validator'   : lambda value: _warn_no_xgaps_deprecated(value) },
- 
-        'show_nontrading'           : { 'Default'     : False, 
-                                        'Description' : 'True/False show spaces for non-trading days/periods',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
- 
-        'figscale'                  : { 'Default'     : None, # scale base figure size up or down.
-                                        'Description' : 'Scale figure size up (if > 1) or down (if < 1)',
-                                        'Validator'   : lambda value: isinstance(value,float) or isinstance(value,int) },
- 
-        'figratio'                  : { 'Default'     : None, # aspect ratio; scaled to 8.0 height
-                                        'Description' : 'Aspect ratio of the figure. Default: (8.00,5.75)',
-                                        'Validator'   : lambda value: isinstance(value,(tuple,list))
-                                                                      and len(value) == 2
-                                                                      and isinstance(value[0],(float,int))
-                                                                      and isinstance(value[1],(float,int)) },
- 
-        'figsize'                   : { 'Default'     : None,  # figure size; overrides figratio and figscale
-                                        'Description' : ('Figure size: overrides both figscale and figratio,'+
-                                                        ' else defaults to figratio*figscale'),
-                                        'Validator'   : lambda value: isinstance(value,(tuple,list))
-                                                                      and len(value) == 2
-                                                                      and isinstance(value[0],(float,int))
-                                                                      and isinstance(value[1],(float,int)) },
-
-        'fontscale'                 : { 'Default'     : None, # scale all fonts up or down
-                                        'Description' : 'Scale font sizes up (if > 1) or down (if < 1)',
-                                        'Validator'   : lambda value: isinstance(value,float) or isinstance(value,int) },
- 
-        'linecolor'                 : { 'Default'     : None, # line color in line plot
-                                        'Description' : 'Line color for `type=line`',
-                                        'Validator'   : lambda value: mcolors.is_color_like(value) },
-
-        'title'                     : { 'Default'     : None, # Figure Title
-                                        'Description' : 'Figure Title (see also `axtitle`)',
-                                        'Validator'   : lambda value: isinstance(value,(str,dict)) },
- 
-        'axtitle'                   : { 'Default'     : None, # Axes Title (subplot title)
-                                        'Description' : 'Axes Title (subplot title)',
-                                        'Validator'   : lambda value: isinstance(value,(str,dict)) },
- 
-        'ylabel'                    : { 'Default'     : 'Price', # y-axis label
-                                        'Description' : 'label for y-axis of main plot',
-                                        'Validator'   : lambda value: isinstance(value,str) },
- 
-        'ylabel_lower'              : { 'Default'     : None, # y-axis label default logic below
-                                        'Description' : 'label for y-axis of volume',
-                                        'Validator'   : lambda value: isinstance(value,str) },
- 
-        'addplot'                   : { 'Default'     : None, 
-                                        'Description' : 'addplot object or sequence of addplot objects (from `mpf.make_addplot()`)',
-                                        'Validator'   : lambda value: isinstance(value,dict) or (isinstance(value,list) and all([isinstance(d,dict) for d in value])) },
- 
-        'savefig'                   : { 'Default'     : None, 
-                                        'Description' : 'file name, or BytesIO, or dict with key `fname` plus other keys allowed as '+
-                                                        ' kwargs to matplotlib `Figure.savefig()`',
-                                        'Validator'   : lambda value: isinstance(value,dict) or isinstance(value,str) or isinstance(value, io.BytesIO) or isinstance(value, os.PathLike) },
- 
-        'block'                     : { 'Default'     : None, 
-                                        'Description' : 'True/False wait for figure to be closed before returning',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
- 
-        'returnfig'                 : { 'Default'     : False, 
-                                        'Description' : 'return Figure and list of Axes objects created by mplfinance;'+
-                                                        ' user must display plot when ready, usually by calling `mpf.show()`',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
-
-        'return_calculated_values'  : { 'Default'     : None,
-                                        'Description' : 'set to a variable containing an empty dict; `mpf.plot()` will fill'+
-                                                        ' the dict with various mplfinance calculated values',
-                                        'Validator'   : lambda value: isinstance(value, dict) and len(value) == 0},
-
-        'set_ylim'                  : { 'Default'     : None,
-                                        'Description' : 'deprecated',
-                                        'Validator'   : lambda value: _warn_set_ylim_deprecated(value) },
- 
-        'ylim'                      : { 'Default'     : None,
-                                        'Description' : 'Limits for y-axis as tuple (min,max), i.e. (bottom,top)',
-                                        'Validator'   : lambda value: isinstance(value, (list,tuple)) and len(value) == 2 
-                                                                      and all([isinstance(v,(int,float)) for v in value])},
- 
-        'xlim'                      : { 'Default'     : None,
-                                        'Description' : 'Limits for x-axis as tuple (min,max), i.e. (left,right)',
-                                        'Validator'   : lambda value: _xlim_validator(value) },
- 
-        'set_ylim_panelB'           : { 'Default'     : None,
-                                        'Description' : 'deprecated',
-                                        'Validator'   : lambda value: _warn_set_ylim_deprecated(value) },
- 
-        'hlines'                    : { 'Default'     : None, 
-                                        'Description' : 'Draw one or more HORIZONTAL LINES across entire plot, by'+
-                                                        ' specifying a price, or sequence of prices.  May also be a dict'+
-                                                        ' with key `hlines` specifying a price or sequence of prices, plus'+
-                                                        ' one or more of the following keys: `colors`, `linestyle`,'+
-                                                        ' `linewidths`, `alpha`.',
-                                        'Validator'   : lambda value: _hlines_validator(value) },
- 
-        'vlines'                    : { 'Default'     : None, 
-                                        'Description' : 'Draw one or more VERTICAL LINES across entire plot, by'+
-                                                        ' specifying a date[time], or sequence of date[time].  May also'+
-                                                        ' be a dict with key `vlines` specifying a date[time] or sequence'+
-                                                        ' of date[time], plus one or more of the following keys:'+
-                                                        ' `colors`, `linestyle`, `linewidths`, `alpha`.',
-                                        'Validator'   : lambda value: _vlines_validator(value) },
-
-        'alines'                    : { 'Default'     : None, 
-                                        'Description' : 'Draw one or more ARBITRARY LINES anywhere on the plot, by'+
-                                                        ' specifying a sequence of two or more date/price pairs, or by'+
-                                                        ' specifying a sequence of sequences of two or more date/price pairs.'+
-                                                        ' May also be a dict with key `alines` (as date/price pairs described above),'+
-                                                        ' plus one or more of the following keys:'+
-                                                        ' `colors`, `linestyle`, `linewidths`, `alpha`.',
-                                        'Validator'   : lambda value: _alines_validator(value) },
- 
-        'tlines'                    : { 'Default'     : None, 
-                                        'Description' : 'Draw one or more TREND LINES by specifying one or more pairs of date[times]'+
-                                                        ' between which each trend line should be drawn.  May also be a dict with key'+
-                                                        ' `tlines` as just described, plus one or more of the following keys:'+
-                                                        ' `colors`, `linestyle`, `linewidths`, `alpha`, `tline_use`,`tline_method`.',
-                                        'Validator'   : lambda value: _tlines_validator(value) },
-       
-        'panel_ratios'              : { 'Default'     : None,
-                                        'Description' : 'sequence of numbers indicating relative sizes of panels; sequence len'+
-                                                        ' must be same as number of panels, or len 2 where first entry is for'+
-                                                        ' main panel, and second entry is for all other panels',
-                                        'Validator'   : lambda value: isinstance(value,(tuple,list)) and len(value) <= 32 and
-                                                                      all([isinstance(v,(int,float)) for v in value]) },
-
-        'main_panel'                : { 'Default'     : 0,
-                                        'Description' : 'integer - which panel is the main panel for `.plot()`',
-                                        'Validator'   : lambda value: _valid_panel_id(value) },
-
-        'volume_panel'              : { 'Default'     : 1,
-                                        'Description' : 'integer - which panel is the volume panel',
-                                        'Validator'   : lambda value: _valid_panel_id(value) },
-
-        'num_panels'                : { 'Default'     : None,
-                                        'Description' : 'total number of panels',
-                                        'Validator'   : lambda value: isinstance(value,int) and value in range(1,32+1) },
-
-        'datetime_format'           : { 'Default'     : None,
-                                        'Description' : 'x-axis tick format as valid `strftime()` format string',
-                                        'Validator'   : lambda value: isinstance(value,str) },
-
-        'xrotation'                 : { 'Default'     : 45,
-                                        'Description' : 'Angle (degrees) for x-axis tick labels; 90=vertical',
-                                        'Validator'   : lambda value: isinstance(value,(int,float)) },
-
-        'axisoff'                   : { 'Default'     : False,
-                                        'Description' : '`axisoff=True` means do NOT display any axis.',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
-
-        'closefig'                  : { 'Default'     : 'auto',
-                                        'Description' : 'True|False close the Figure before returning',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
-
-        'fill_between'              : { 'Default'     : None,
-                                        'Description' : 'fill between specification as y-value, or sequence of'+
-                                                        ' y-values, or dict containing key "y1" plus any additional'+
-                                                        ' kwargs for `fill_between()`',
-                                        'Validator'   : _fill_between_validator },
-
-        'tight_layout'              : { 'Default'     : False,
-                                        'Description' : 'True|False implement tight layout (minimal padding around Figure)'+
-                                                        ' (see also `scale_padding` kwarg)',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
-
-        'scale_padding'             : { 'Default'     : 1.0,   # Issue#193 
-                                        'Description' : 'Increase, > 1.0, or decrease, < 1.0, padding around figure.'+
-                                                        ' May also be a dict containing one or more of the following keys:'+
-                                                        ' "top", "bottom", "left", "right", to individual scale padding'+
-                                                        ' on each side of Figure.',
-                                        'Validator'   : lambda value: _scale_padding_validator(value) },
-
-        'width_adjuster_version'    : { 'Default'     : 'v1',
-                                        'Description' : 'specify version of object width adjustment algorithm: "v0" or "v1"'+
-                                                        ' (See also "widths" tutorial in mplfinance examples folder).',
-                                        'Validator'   : lambda value: value in ('v0', 'v1') },
-
-        'scale_width_adjustment'    : { 'Default'     : None,
-                                        'Description' : 'scale width of plot objects wider, > 1.0, or narrower, < 1.0'+
-                                                        ' may also be a dict to scale individual widths.'+
-                                                        ' (See also "widths" tutorial in mplfinance examples folder).',
-                                        'Validator'   : lambda value: isinstance(value,dict) and len(value) > 0 },
-
-        'update_width_config'       : { 'Default'     : None,
-                                        'Description' : 'dict - update individual items in width configuration.'+
-                                                        ' (See also "widths" tutorial in mplfinance examples folder).',
-                                        'Validator'   : lambda value: isinstance(value,dict) and len(value) > 0 },
-
-        'return_width_config'       : { 'Default'     : None,
-                                        'Description' : 'empty dict variable to be filled with width configuration settings.',
-                                        'Validator'   : lambda value: isinstance(value,dict) and len(value)==0 },
-
-        'saxbelow'                  : { 'Default'     : True,  # Issue#115 Comment#639446764
-                                        'Description' : 'set the volume Axes below (behind) all other Axes objects',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
-        
-        'ax'                        : { 'Default'     : None,
-                                        'Description' : 'Matplotlib Axes object on which to plot',
-                                        'Validator'   : lambda value: isinstance(value,mpl_axes.Axes) },
-
-        'volume_exponent'           : { 'Default'     : None,
-                                        'Description' : 'integer exponent on the volume axis'+
-                                                        ' (or set to "legacy" for old mplfinance style)',
-                                        'Validator'   : lambda value: isinstance(value,int) or value == 'legacy'},
-
-        'tz_localize'               : { 'Default'     : True,
-                                        'Description' : 'True|False localize the times in the DatetimeIndex',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
-
-        'yscale'                    : { 'Default'     : None,
-                                        'Description' : 'y-axis scale: "linear", "log", "symlog", or "logit"',
-                                        'Validator'   : lambda value: _yscale_validator(value) },
-
-        'volume_yscale'             : { 'Default'     : None,
-                                        'Description' : 'Volume y-axis scale: "linear", "log", "symlog", or "logit"',
-                                        'Validator'   : lambda value: _yscale_validator(value) },
-
-        'volume_ylim'               : { 'Default'     : None,
-                                        'Description' : 'Volume y-axis limits as tuple (min,max), i.e. (bottom,top)',
-                                        'Validator'   : lambda value: isinstance(value, (list,tuple)) and len(value) == 2
-                                                        and all([isinstance(v,(int,float)) for v in value])},
-
-        'volume_alpha'              : { 'Default'     : 1,  # alpha of Volume bars
-                                        'Description' : 'opacity for Volume bar: 0.0 (transparent) to 1.0 (opaque)',
-                                        'Validator'   : lambda value: isinstance(value,(int,float)) or
-                                                        all([isinstance(v,(int,float)) for v in value]) },
-
-        'warn_too_much_data'        : { 'Default'     : 599,
-                                        'Description' : 'Tolerance for data amount in plot. Default=599 rows.'+
-                                                        ' Values greater than \'warn_too_much_data\' will trigger a warning.',
-                                        'Validator'   : lambda value: isinstance(value,int) },
+        'columns': {'Default': None,  # use default names: ('Open', 'High', 'Low', 'Close', 'Volume')
+                    'Description': ('Column names to be used when plotting the data.' +
+                                    ' Default: ("Open", "High", "Low", "Close", "Volume")'),
+                    'Validator': lambda value: isinstance(value, (tuple, list))
+                    and len(value) == 5
+                    and all(isinstance(c, str) for c in value)},
+        'type': {'Default': 'ohlc',
+                 'Description': 'Plot type: '+str(_get_valid_plot_types()),
+                 'Validator': lambda value: value in _get_valid_plot_types()},
+
+        'style': {'Default': None,
+                  'Description': 'plot style; see `mpf.available_styles()`',
+                  'Validator': _styles._valid_mpf_style},
+
+        'volume': {'Default': False,
+                   'Description': 'Plot volume: True, False, or set to Axes object on which to plot.',
+                   'Validator': lambda value: isinstance(value, bool) or isinstance(value, mpl_axes.Axes)},
+
+        'mav': {'Default': None,
+                'Description': 'Moving Average window size(s); (int or tuple of ints)',
+                'Validator': _mav_validator},
+
+        'ema': {'Default': None,
+                'Description': 'Exponential Moving Average window size(s); (int or tuple of ints)',
+                'Validator': _mav_validator},
+
+        'renko_params': {'Default': dict(),
+                         'Description': 'dict of renko parameters; call `mpf.kwarg_help("renko_params")`',
+                         'Validator': lambda value: isinstance(value, dict)},
+
+        'pnf_params': {'Default': dict(),
+                       'Description': 'dict of point-and-figure parameters; call `mpf.kwarg_help("pnf_params")`',
+                       'Validator': lambda value: isinstance(value, dict)},
+
+        'study': {'Default': None,
+                  'Description': 'kwarg not implemented',
+                  'Validator': lambda value: _kwarg_not_implemented(value)},
+
+        'marketcolor_overrides': {'Default': None,
+                                  'Description': 'sequence of color objects to override market colors.' +
+                                  'sequence must be same length as ohlc(v) DataFrame. Each' +
+                                  'color object may be a color, marketcolor object, or None.',
+                                  'Validator': _mco_validator},
+
+        'mco_faceonly': {'Default': False,  # If True: Override only the face of the candle
+                         'Description': 'True/False marketcolor_overrides only apply to face of candle.',
+                         'Validator': lambda value: isinstance(value, bool)},
+
+        'no_xgaps': {'Default': True,  # None means follow default logic below:
+                     'Description': 'deprecated',
+                     'Validator': lambda value: _warn_no_xgaps_deprecated(value)},
+
+        'show_nontrading': {'Default': False,
+                            'Description': 'True/False show spaces for non-trading days/periods',
+                            'Validator': lambda value: isinstance(value, bool)},
+
+        'figscale': {'Default': None,  # scale base figure size up or down.
+                     'Description': 'Scale figure size up (if > 1) or down (if < 1)',
+                     'Validator': lambda value: isinstance(value, float) or isinstance(value, int)},
+
+        'figratio': {'Default': None,  # aspect ratio; scaled to 8.0 height
+                     'Description': 'Aspect ratio of the figure. Default: (8.00,5.75)',
+                     'Validator': lambda value: isinstance(value, (tuple, list))
+                     and len(value) == 2
+                     and isinstance(value[0], (float, int))
+                     and isinstance(value[1], (float, int))},
+
+        'figsize': {'Default': None,  # figure size; overrides figratio and figscale
+                    'Description': ('Figure size: overrides both figscale and figratio,' +
+                                    ' else defaults to figratio*figscale'),
+                    'Validator': lambda value: isinstance(value, (tuple, list))
+                    and len(value) == 2
+                    and isinstance(value[0], (float, int))
+                    and isinstance(value[1], (float, int))},
+
+        'fontscale': {'Default': None,  # scale all fonts up or down
+                      'Description': 'Scale font sizes up (if > 1) or down (if < 1)',
+                      'Validator': lambda value: isinstance(value, float) or isinstance(value, int)},
+
+        'linecolor': {'Default': None,  # line color in line plot
+                      'Description': 'Line color for `type=line`',
+                      'Validator': lambda value: mcolors.is_color_like(value)},
+
+        'title': {'Default': None,  # Figure Title
+                  'Description': 'Figure Title (see also `axtitle`)',
+                  'Validator': lambda value: isinstance(value, (str, dict))},
+
+        'axtitle': {'Default': None,  # Axes Title (subplot title)
+                    'Description': 'Axes Title (subplot title)',
+                    'Validator': lambda value: isinstance(value, (str, dict))},
+
+        'ylabel': {'Default': 'Price',  # y-axis label
+                   'Description': 'label for y-axis of main plot',
+                   'Validator': lambda value: isinstance(value, str)},
+
+        'ylabel_lower': {'Default': None,  # y-axis label default logic below
+                         'Description': 'label for y-axis of volume',
+                         'Validator': lambda value: isinstance(value, str)},
+
+        'addplot': {'Default': None,
+                    'Description': 'addplot object or sequence of addplot objects (from `mpf.make_addplot()`)',
+                    'Validator': lambda value: isinstance(value, dict) or (isinstance(value, list) and all([isinstance(d, dict) for d in value]))},
+
+        'savefig': {'Default': None,
+                    'Description': 'file name, or BytesIO, or dict with key `fname` plus other keys allowed as ' +
+                    ' kwargs to matplotlib `Figure.savefig()`',
+                    'Validator': lambda value: isinstance(value, dict) or isinstance(value, str) or isinstance(value, io.BytesIO) or isinstance(value, os.PathLike)},
+
+        'block': {'Default': None,
+                  'Description': 'True/False wait for figure to be closed before returning',
+                  'Validator': lambda value: isinstance(value, bool)},
+
+        'returnfig': {'Default': False,
+                      'Description': 'return Figure and list of Axes objects created by mplfinance;' +
+                      ' user must display plot when ready, usually by calling `mpf.show()`',
+                      'Validator': lambda value: isinstance(value, bool)},
+
+        'return_calculated_values': {'Default': None,
+                                     'Description': 'set to a variable containing an empty dict; `mpf.plot()` will fill' +
+                                     ' the dict with various mplfinance calculated values',
+                                     'Validator': lambda value: isinstance(value, dict) and len(value) == 0},
+
+        'set_ylim': {'Default': None,
+                     'Description': 'deprecated',
+                     'Validator': lambda value: _warn_set_ylim_deprecated(value)},
+
+        'ylim': {'Default': None,
+                 'Description': 'Limits for y-axis as tuple (min,max), i.e. (bottom,top)',
+                 'Validator': lambda value: isinstance(value, (list, tuple)) and len(value) == 2
+                 and all([isinstance(v, (int, float)) for v in value])},
+
+        'xlim': {'Default': None,
+                 'Description': 'Limits for x-axis as tuple (min,max), i.e. (left,right)',
+                 'Validator': lambda value: _xlim_validator(value)},
+
+        'set_ylim_panelB': {'Default': None,
+                            'Description': 'deprecated',
+                            'Validator': lambda value: _warn_set_ylim_deprecated(value)},
+
+        'hlines': {'Default': None,
+                   'Description': 'Draw one or more HORIZONTAL LINES across entire plot, by' +
+                   ' specifying a price, or sequence of prices.  May also be a dict' +
+                   ' with key `hlines` specifying a price or sequence of prices, plus' +
+                   ' one or more of the following keys: `colors`, `linestyle`,' +
+                   ' `linewidths`, `alpha`.',
+                   'Validator': lambda value: _hlines_validator(value)},
+
+        'vlines': {'Default': None,
+                   'Description': 'Draw one or more VERTICAL LINES across entire plot, by' +
+                   ' specifying a date[time], or sequence of date[time].  May also' +
+                   ' be a dict with key `vlines` specifying a date[time] or sequence' +
+                   ' of date[time], plus one or more of the following keys:' +
+                   ' `colors`, `linestyle`, `linewidths`, `alpha`.',
+                   'Validator': lambda value: _vlines_validator(value)},
+
+        'alines': {'Default': None,
+                   'Description': 'Draw one or more ARBITRARY LINES anywhere on the plot, by' +
+                   ' specifying a sequence of two or more date/price pairs, or by' +
+                   ' specifying a sequence of sequences of two or more date/price pairs.' +
+                   ' May also be a dict with key `alines` (as date/price pairs described above),' +
+                   ' plus one or more of the following keys:' +
+                   ' `colors`, `linestyle`, `linewidths`, `alpha`.',
+                   'Validator': lambda value: _alines_validator(value)},
+
+        'tlines': {'Default': None,
+                   'Description': 'Draw one or more TREND LINES by specifying one or more pairs of date[times]' +
+                   ' between which each trend line should be drawn.  May also be a dict with key' +
+                   ' `tlines` as just described, plus one or more of the following keys:' +
+                   ' `colors`, `linestyle`, `linewidths`, `alpha`, `tline_use`,`tline_method`.',
+                   'Validator': lambda value: _tlines_validator(value)},
+
+        'panel_ratios': {'Default': None,
+                         'Description': 'sequence of numbers indicating relative sizes of panels; sequence len' +
+                         ' must be same as number of panels, or len 2 where first entry is for' +
+                         ' main panel, and second entry is for all other panels',
+                         'Validator': lambda value: isinstance(value, (tuple, list)) and len(value) <= 32 and
+                         all([isinstance(v, (int, float)) for v in value])},
+
+        'main_panel': {'Default': 0,
+                       'Description': 'integer - which panel is the main panel for `.plot()`',
+                       'Validator': lambda value: _valid_panel_id(value)},
+
+        'volume_panel': {'Default': 1,
+                         'Description': 'integer - which panel is the volume panel',
+                         'Validator': lambda value: _valid_panel_id(value)},
+
+        'num_panels': {'Default': None,
+                       'Description': 'total number of panels',
+                       'Validator': lambda value: isinstance(value, int) and value in range(1, 32+1)},
+
+        'datetime_format': {'Default': None,
+                            'Description': 'x-axis tick format as valid `strftime()` format string',
+                            'Validator': lambda value: isinstance(value, str)},
+
+        'xrotation': {'Default': 45,
+                      'Description': 'Angle (degrees) for x-axis tick labels; 90=vertical',
+                      'Validator': lambda value: isinstance(value, (int, float))},
+
+        'axisoff': {'Default': False,
+                    'Description': '`axisoff=True` means do NOT display any axis.',
+                    'Validator': lambda value: isinstance(value, bool)},
+
+        'closefig': {'Default': 'auto',
+                     'Description': 'True|False close the Figure before returning',
+                     'Validator': lambda value: isinstance(value, bool)},
+
+        'fill_between': {'Default': None,
+                         'Description': 'fill between specification as y-value, or sequence of' +
+                         ' y-values, or dict containing key "y1" plus any additional' +
+                         ' kwargs for `fill_between()`',
+                         'Validator': _fill_between_validator},
+
+        'tight_layout': {'Default': False,
+                         'Description': 'True|False implement tight layout (minimal padding around Figure)' +
+                         ' (see also `scale_padding` kwarg)',
+                         'Validator': lambda value: isinstance(value, bool)},
+
+        'scale_padding': {'Default': 1.0,   # Issue#193
+                          'Description': 'Increase, > 1.0, or decrease, < 1.0, padding around figure.' +
+                          ' May also be a dict containing one or more of the following keys:' +
+                          ' "top", "bottom", "left", "right", to individual scale padding' +
+                          ' on each side of Figure.',
+                          'Validator': lambda value: _scale_padding_validator(value)},
+
+        'width_adjuster_version': {'Default': 'v1',
+                                   'Description': 'specify version of object width adjustment algorithm: "v0" or "v1"' +
+                                   ' (See also "widths" tutorial in mplfinance examples folder).',
+                                   'Validator': lambda value: value in ('v0', 'v1')},
+
+        'scale_width_adjustment': {'Default': None,
+                                   'Description': 'scale width of plot objects wider, > 1.0, or narrower, < 1.0' +
+                                   ' may also be a dict to scale individual widths.' +
+                                   ' (See also "widths" tutorial in mplfinance examples folder).',
+                                   'Validator': lambda value: isinstance(value, dict) and len(value) > 0},
+
+        'update_width_config': {'Default': None,
+                                'Description': 'dict - update individual items in width configuration.' +
+                                ' (See also "widths" tutorial in mplfinance examples folder).',
+                                'Validator': lambda value: isinstance(value, dict) and len(value) > 0},
+
+        'return_width_config': {'Default': None,
+                                'Description': 'empty dict variable to be filled with width configuration settings.',
+                                'Validator': lambda value: isinstance(value, dict) and len(value) == 0},
+
+        'saxbelow': {'Default': True,  # Issue#115 Comment#639446764
+                     'Description': 'set the volume Axes below (behind) all other Axes objects',
+                     'Validator': lambda value: isinstance(value, bool)},
+
+        'ax': {'Default': None,
+               'Description': 'Matplotlib Axes object on which to plot',
+               'Validator': lambda value: isinstance(value, mpl_axes.Axes)},
+
+        'volume_exponent': {'Default': None,
+                            'Description': 'integer exponent on the volume axis' +
+                            ' (or set to "legacy" for old mplfinance style)',
+                            'Validator': lambda value: isinstance(value, int) or value == 'legacy'},
+
+        'tz_localize': {'Default': True,
+                        'Description': 'True|False localize the times in the DatetimeIndex',
+                        'Validator': lambda value: isinstance(value, bool)},
+
+        'yscale': {'Default': None,
+                   'Description': 'y-axis scale: "linear", "log", "symlog", or "logit"',
+                   'Validator': lambda value: _yscale_validator(value)},
+
+        'volume_yscale': {'Default': None,
+                          'Description': 'Volume y-axis scale: "linear", "log", "symlog", or "logit"',
+                          'Validator': lambda value: _yscale_validator(value)},
+
+        'volume_ylim': {'Default': None,
+                        'Description': 'Volume y-axis limits as tuple (min,max), i.e. (bottom,top)',
+                        'Validator': lambda value: isinstance(value, (list, tuple)) and len(value) == 2
+                        and all([isinstance(v, (int, float)) for v in value])},
+
+        'volume_alpha': {'Default': 1,  # alpha of Volume bars
+                         'Description': 'opacity for Volume bar: 0.0 (transparent) to 1.0 (opaque)',
+                         'Validator': lambda value: isinstance(value, (int, float)) or
+                         all([isinstance(v, (int, float)) for v in value])},
+
+        'warn_too_much_data': {'Default': 599,
+                               'Description': 'Tolerance for data amount in plot. Default=599 rows.' +
+                               ' Values greater than \'warn_too_much_data\' will trigger a warning.',
+                               'Validator': lambda value: isinstance(value, int)},
     }
 
     _validate_vkwargs_dict(vkwargs)
 
     return vkwargs
 
-###@with_rc_context
-def plot( data, **kwargs ):
+# @with_rc_context
+
+
+def plot(data, **kwargs):
     """
     Given a Pandas DataFrame containing columns Open,High,Low,Close and optionally Volume
     with a DatetimeIndex, plot the data.
@@ -402,61 +407,66 @@ def plot( data, **kwargs ):
 
     # translate alias types:
     config['type'] = _get_valid_plot_types(config['type'])
-    
-    dates,opens,highs,lows,closes,volumes = _check_and_prepare_data(data, config)
+
+    dates, opens, highs, lows, closes, volumes = _check_and_prepare_data(
+        data, config)
 
     config['xlim'] = _check_and_convert_xlim_configuration(data, config)
 
     if config['type'] in VALID_PMOVE_TYPES and config['addplot'] is not None:
-        err = "`addplot` is not supported for `type='" + config['type'] +"'`"
+        err = "`addplot` is not supported for `type='" + config['type'] + "'`"
         raise ValueError(err)
 
     if config['marketcolor_overrides'] is not None:
         if len(config['marketcolor_overrides']) != len(dates):
-            raise ValueError('`marketcolor_overrides` must be same length as dataframe.')
+            raise ValueError(
+                '`marketcolor_overrides` must be same length as dataframe.')
 
     external_axes_mode = _check_for_external_axes(config)
 
     if external_axes_mode:
         if config['figscale'] is not None:
-            warnings.warn('\n\n ================================================================= '+
-                          '\n\n   WARNING: `figscale` has NO effect in External Axes Mode.'+
+            warnings.warn('\n\n ================================================================= ' +
+                          '\n\n   WARNING: `figscale` has NO effect in External Axes Mode.' +
                           '\n\n ================================================================ ',
                           category=UserWarning)
         if config['figratio'] is not None:
-            warnings.warn('\n\n ================================================================= '+
-                          '\n\n   WARNING: `figratio` has NO effect in External Axes Mode.'+
+            warnings.warn('\n\n ================================================================= ' +
+                          '\n\n   WARNING: `figratio` has NO effect in External Axes Mode.' +
                           '\n\n ================================================================ ',
                           category=UserWarning)
         if config['figsize'] is not None:
-            warnings.warn('\n\n ================================================================= '+
-                          '\n\n   WARNING: `figsize` has NO effect in External Axes Mode.'+
+            warnings.warn('\n\n ================================================================= ' +
+                          '\n\n   WARNING: `figsize` has NO effect in External Axes Mode.' +
                           '\n\n ================================================================ ',
                           category=UserWarning)
     else:
-        if config['figscale'] is None: config['figscale'] = 1.0
-        if config['figratio'] is None: config['figratio'] = DEFAULT_FIGRATIO
+        if config['figscale'] is None:
+            config['figscale'] = 1.0
+        if config['figratio'] is None:
+            config['figratio'] = DEFAULT_FIGRATIO
 
     style = config['style']
 
-    if external_axes_mode and hasattr(config['ax'],'mpfstyle') and style is None:
+    if external_axes_mode and hasattr(config['ax'], 'mpfstyle') and style is None:
         style = config['ax'].mpfstyle
     elif style is None:
         style = 'default'
 
-    if isinstance(style,str):
+    if isinstance(style, str):
         style = _styles._get_mpfstyle(style)
 
     config['style'] = style
 
-    if isinstance(style,dict):
-        if not external_axes_mode: _styles._apply_mpfstyle(style)
+    if isinstance(style, dict):
+        if not external_axes_mode:
+            _styles._apply_mpfstyle(style)
     else:
         raise TypeError('style should be a `dict`; why is it not?')
 
     if not external_axes_mode:
         fig = plt.figure()
-        _adjust_figsize(fig,config)
+        _adjust_figsize(fig, config)
     else:
         fig = None
 
@@ -467,29 +477,31 @@ def plot( data, **kwargs ):
 
     if external_axes_mode:
         panels = None
-        axA1   = config['ax']
+        axA1 = config['ax']
         axA1.set_axisbelow(config['saxbelow'])
         if config['volume']:
             volumeAxes = config['volume']
             volumeAxes.set_axisbelow(config['saxbelow'])
     else:
         panels = _build_panels(fig, config)
-        axA1 = panels.at[config['main_panel'],'axes'][0]
+        axA1 = panels.at[config['main_panel'], 'axes'][0]
         if config['volume']:
             if config['volume_panel'] == config['main_panel']:
                 # ohlc and volume on same panel: move volume to secondary axes:
-                volumeAxes = panels.at[config['volume_panel'],'axes'][1]
-                volumeAxes.set_zorder(axA1.get_zorder()-0.1) # Make sure ohlc is above volume
-                axA1.patch.set_visible(False)                # Let volume show through
-                panels.at[config['main_panel'],'used2nd'] = True
+                volumeAxes = panels.at[config['volume_panel'], 'axes'][1]
+                # Make sure ohlc is above volume
+                volumeAxes.set_zorder(axA1.get_zorder()-0.1)
+                # Let volume show through
+                axA1.patch.set_visible(False)
+                panels.at[config['main_panel'], 'used2nd'] = True
             else:
-                volumeAxes = panels.at[config['volume_panel'],'axes'][0]
+                volumeAxes = panels.at[config['volume_panel'], 'axes'][0]
         else:
             volumeAxes = None
 
     fmtstring = _determine_format_string(dates, config['datetime_format'])
 
-    ptype = config['type'] 
+    ptype = config['type']
 
     if config['show_nontrading']:
         formatter = mdates.DateFormatter(fmtstring)
@@ -502,7 +514,7 @@ def plot( data, **kwargs ):
     config['_width_config'] = _determine_width_config(xdates, config)
 
     rwc = config['return_width_config']
-    if isinstance(rwc,dict) and len(rwc)==0:
+    if isinstance(rwc, dict) and len(rwc) == 0:
         config['return_width_config'].update(config['_width_config'])
 
     collections = None
@@ -510,19 +522,20 @@ def plot( data, **kwargs ):
         lw = config['_width_config']['line_width']
         axA1.plot(xdates, closes, color=config['linecolor'], linewidth=lw)
     else:
-        collections =_construct_mpf_collections(ptype,dates,xdates,opens,highs,lows,closes,volumes,config,style)
+        collections = _construct_mpf_collections(
+            ptype, dates, xdates, opens, highs, lows, closes, volumes, config, style)
 
     if ptype in VALID_PMOVE_TYPES:
         collections, calculated_values = collections
-        volumes       = calculated_values['volumes']
-        pmove_dates   = calculated_values['dates']
-        pmove_values  = calculated_values['values']
-        if all([isinstance(v,(list,tuple)) for v in pmove_values]):
+        volumes = calculated_values['volumes']
+        pmove_dates = calculated_values['dates']
+        pmove_values = calculated_values['values']
+        if all([isinstance(v, (list, tuple)) for v in pmove_values]):
             pmove_avgvals = [sum(v)/len(v) for v in pmove_values]
         else:
             pmove_avgvals = pmove_values
-        pmove_size    = calculated_values['size']
-        pmove_counts  = calculated_values['counts'] if 'counts' in calculated_values else None
+        pmove_size = calculated_values['size']
+        pmove_counts = calculated_values['counts'] if 'counts' in calculated_values else None
         formatter = IntegerIndexDateTimeFormatter(pmove_dates, fmtstring)
         xdates = np.arange(len(pmove_dates))
 
@@ -531,26 +544,29 @@ def plot( data, **kwargs ):
             axA1.add_collection(collection)
 
     if ptype in VALID_PMOVE_TYPES:
-        mavprices = _plot_mav(axA1,config,xdates,pmove_avgvals)
+        mavprices = _plot_mav(axA1, config, xdates, pmove_avgvals)
+        emaprices = _plot_ema(axA1, config, xdates, pmove_avgvals)
+
     else:
-        mavprices = _plot_mav(axA1,config,xdates,closes)
+        mavprices = _plot_mav(axA1, config, xdates, closes)
+        emaprices = _plot_ema(axA1, config, xdates, closes)
 
     avg_dist_between_points = (xdates[-1] - xdates[0]) / float(len(xdates))
     if not config['tight_layout']:
-        minx = xdates[0]  - avg_dist_between_points
+        minx = xdates[0] - avg_dist_between_points
         maxx = xdates[-1] + avg_dist_between_points
     else:
-        minx = xdates[0]  - (0.45 * avg_dist_between_points)
+        minx = xdates[0] - (0.45 * avg_dist_between_points)
         maxx = xdates[-1] + (0.45 * avg_dist_between_points)
 
     if len(xdates) == 1:  # kludge special case
         minx = minx - 0.75
         maxx = maxx + 0.75
     if ptype not in VALID_PMOVE_TYPES:
-        _lows  = lows
+        _lows = lows
         _highs = highs
     else:
-        _lows  = pmove_avgvals
+        _lows = pmove_avgvals
         _highs = [value+pmove_size for value in pmove_avgvals]
 
     miny = np.nanmin(_lows)
@@ -562,43 +578,54 @@ def plot( data, **kwargs ):
         ydelta = 0.01 * (maxy-miny)
         if miny > 0.0:
             # don't let it go negative:
-            setminy = max(0.9*miny,miny-ydelta)
+            setminy = max(0.9*miny, miny-ydelta)
         else:
             setminy = miny-ydelta
-        axA1.set_ylim(setminy,maxy+ydelta)
+        axA1.set_ylim(setminy, maxy+ydelta)
 
     if config['xlim'] is not None:
         axA1.set_xlim(config['xlim'][0], config['xlim'][1])
     elif config['tight_layout']:
-        axA1.set_xlim(minx,maxx)
+        axA1.set_xlim(minx, maxx)
 
     if (config['ylim'] is None and
         config['xlim'] is None and
-        not config['tight_layout']):
+            not config['tight_layout']):
         corners = (minx, miny), (maxx, maxy)
         axA1.update_datalim(corners)
 
     if config['return_calculated_values'] is not None:
         retdict = config['return_calculated_values']
         if ptype == 'renko':
-            retdict['renko_bricks' ] = pmove_values
-            retdict['renko_dates'  ] = mdates.num2date(pmove_dates)
-            retdict['renko_size'   ] = pmove_size
+            retdict['renko_bricks'] = pmove_values
+            retdict['renko_dates'] = mdates.num2date(pmove_dates)
+            retdict['renko_size'] = pmove_size
             retdict['renko_volumes'] = volumes if config['volume'] else None
         elif ptype == 'pnf':
-            retdict['pnf_dates'    ] = mdates.num2date(pmove_dates)
-            retdict['pnf_counts'   ] = pmove_counts
-            retdict['pnf_values'   ] = pmove_values
-            retdict['pnf_avgvals'  ] = pmove_avgvals
-            retdict['pnf_size'     ] = pmove_size
-            retdict['pnf_volumes'  ] = volumes if config['volume'] else None
+            retdict['pnf_dates'] = mdates.num2date(pmove_dates)
+            retdict['pnf_counts'] = pmove_counts
+            retdict['pnf_values'] = pmove_values
+            retdict['pnf_avgvals'] = pmove_avgvals
+            retdict['pnf_size'] = pmove_size
+            retdict['pnf_volumes'] = volumes if config['volume'] else None
         if config['mav'] is not None:
             mav = config['mav']
             if len(mav) != len(mavprices):
-                warnings.warn('len(mav)='+str(len(mav))+' BUT len(mavprices)='+str(len(mavprices)))
+                warnings.warn('len(mav)='+str(len(mav)) +
+                              ' BUT len(mavprices)='+str(len(mavprices)))
             else:
-                for jj in range(0,len(mav)):     
+                for jj in range(0, len(mav)):
                     retdict['mav' + str(mav[jj])] = mavprices[jj]
+
+        if config['ema'] is not None:
+            ema = config['ema']
+            if len(ema) != len(emaprices):
+                warnings.warn('len(ema)='+str(len(ema)) +
+                              ' BUT len(emaprices)='+str(len(emaprices)))
+            else:
+                for jj in range(0, len(ema)):
+                    retdict['ema' + str(ema[jj])] = emaprices[jj]
+
         retdict['minx'] = minx
         retdict['maxx'] = maxx
         retdict['miny'] = miny
@@ -614,58 +641,63 @@ def plot( data, **kwargs ):
         dtix = None
 
     line_collections = []
-    line_collections.append(_construct_aline_collections(config['alines'], dtix))
-    line_collections.append(_construct_hline_collections(config['hlines'], minx, maxx))
-    line_collections.append(_construct_vline_collections(config['vlines'], dtix, miny, maxy))
+    line_collections.append(
+        _construct_aline_collections(config['alines'], dtix))
+    line_collections.append(
+        _construct_hline_collections(config['hlines'], minx, maxx))
+    line_collections.append(_construct_vline_collections(
+        config['vlines'], dtix, miny, maxy))
     tlines = config['tlines']
-    if isinstance(tlines,(list,tuple)) and all([isinstance(item,dict) for item in tlines]):
+    if isinstance(tlines, (list, tuple)) and all([isinstance(item, dict) for item in tlines]):
         pass
     else:
-        tlines = [tlines,]
+        tlines = [tlines, ]
     for tline_item in tlines:
-        line_collections.append(_construct_tline_collections(tline_item, dtix, dates, opens, highs, lows, closes))
-     
+        line_collections.append(_construct_tline_collections(
+            tline_item, dtix, dates, opens, highs, lows, closes))
+
     for collection in line_collections:
         if collection is not None:
             axA1.add_collection(collection)
 
     datalen = len(xdates)
     if config['volume']:
-        vup,vdown = style['marketcolors']['volume'].values()
+        vup, vdown = style['marketcolors']['volume'].values()
         #-- print('vup,vdown=',vup,vdown)
-        vcolors = _updown_colors(vup, vdown, opens, closes, use_prev_close=style['marketcolors']['vcdopcod'])
+        vcolors = _updown_colors(
+            vup, vdown, opens, closes, use_prev_close=style['marketcolors']['vcdopcod'])
         #-- print('len(vcolors),len(opens),len(closes)=',len(vcolors),len(opens),len(closes))
         #-- print('vcolors=',vcolors)
 
-        w  = config['_width_config']['volume_width']
+        w = config['_width_config']['volume_width']
         lw = config['_width_config']['volume_linewidth']
 
-        adjc = _adjust_color_brightness(vcolors,0.90)
+        adjc = _adjust_color_brightness(vcolors, 0.90)
         valp = config['volume_alpha']
-        volumeAxes.bar(xdates,volumes,width=w,linewidth=lw,color=vcolors,ec=adjc,alpha=valp)
+        volumeAxes.bar(xdates, volumes, width=w, linewidth=lw,
+                       color=vcolors, ec=adjc, alpha=valp)
         if config['volume_ylim'] is not None:
             vymin = config['volume_ylim'][0]
             vymax = config['volume_ylim'][1]
         else:
             vymin = 0.3 * np.nanmin(volumes)
             vymax = 1.1 * np.nanmax(volumes)
-        volumeAxes.set_ylim(vymin,vymax)
+        volumeAxes.set_ylim(vymin, vymax)
 
     xrotation = config['xrotation']
     if not external_axes_mode:
-        _set_ticks_on_bottom_panel_only(panels,formatter,rotation=xrotation)
+        _set_ticks_on_bottom_panel_only(panels, formatter, rotation=xrotation)
     else:
-        axA1.tick_params(axis='x',rotation=xrotation)
+        axA1.tick_params(axis='x', rotation=xrotation)
         axA1.xaxis.set_major_formatter(formatter)
 
     ysd = config['yscale']
-    if isinstance(ysd,dict):
+    if isinstance(ysd, dict):
         yscale = ysd['yscale']
-        del      ysd['yscale']
-        axA1.set_yscale(yscale,**ysd)
-    elif isinstance(ysd,str):
+        del ysd['yscale']
+        axA1.set_yscale(yscale, **ysd)
+    elif isinstance(ysd, str):
         axA1.set_yscale(ysd)
- 
 
     addplot = config['addplot']
     if addplot is not None and ptype not in VALID_PMOVE_TYPES:
@@ -679,59 +711,67 @@ def plot( data, **kwargs ):
             # If addplot['secondary_y'] == 'auto', then: If the addplot['data']
             # is out of the Order of Magnitude Range, then use secondary_y.
 
-            lo = math.log(max(math.fabs(np.nanmin(lows)),1e-7),10) - 0.5
-            hi = math.log(max(math.fabs(np.nanmax(highs)),1e-7),10) + 0.5
+            lo = math.log(max(math.fabs(np.nanmin(lows)), 1e-7), 10) - 0.5
+            hi = math.log(max(math.fabs(np.nanmax(highs)), 1e-7), 10) + 0.5
 
             panels['mag'] = [None]*len(panels)  # create 'mag'nitude column
 
-            panels.at[config['main_panel'],'mag'] = {'lo':lo,'hi':hi} # update main panel magnitude range
+            panels.at[config['main_panel'], 'mag'] = {
+                'lo': lo, 'hi': hi}  # update main panel magnitude range
 
             if config['volume']:
-                lo = math.log(max(math.fabs(np.nanmin(volumes)),1e-7),10) - 0.5
-                hi = math.log(max(math.fabs(np.nanmax(volumes)),1e-7),10) + 0.5
-                panels.at[config['volume_panel'],'mag'] = {'lo':lo,'hi':hi}
+                lo = math.log(
+                    max(math.fabs(np.nanmin(volumes)), 1e-7), 10) - 0.5
+                hi = math.log(
+                    max(math.fabs(np.nanmax(volumes)), 1e-7), 10) + 0.5
+                panels.at[config['volume_panel'], 'mag'] = {'lo': lo, 'hi': hi}
 
-        if isinstance(addplot,dict):
-            addplot = [addplot,]   # make list of dict to be consistent
+        if isinstance(addplot, dict):
+            addplot = [addplot, ]   # make list of dict to be consistent
 
         elif not _list_of_dict(addplot):
-            raise TypeError('addplot must be `dict`, or `list of dict`, NOT '+str(type(addplot)))
+            raise TypeError(
+                'addplot must be `dict`, or `list of dict`, NOT '+str(type(addplot)))
 
         for apdict in addplot:
 
-            panid = apdict['panel'] 
+            panid = apdict['panel']
             if not external_axes_mode:
-                if   panid == 'main' : panid = 0  # for backwards compatibility
-                elif panid == 'lower': panid = 1  # for backwards compatibility
+                if panid == 'main':
+                    panid = 0  # for backwards compatibility
+                elif panid == 'lower':
+                    panid = 1  # for backwards compatibility
                 if apdict['y_on_right'] is not None:
-                    panels.at[panid,'y_on_right'] = apdict['y_on_right']
+                    panels.at[panid, 'y_on_right'] = apdict['y_on_right']
 
             aptype = apdict['type']
             if aptype == 'ohlc' or aptype == 'candle':
-                ax = _addplot_collections(panid,panels,apdict,xdates,config)
-                _addplot_apply_supplements(ax,apdict,xdates)
-            else:         
+                ax = _addplot_collections(
+                    panid, panels, apdict, xdates, config)
+                _addplot_apply_supplements(ax, apdict, xdates)
+            else:
                 apdata = apdict['data']
-                if isinstance(apdata,list) and not isinstance(apdata[0],(float,int)):
+                if isinstance(apdata, list) and not isinstance(apdata[0], (float, int)):
                     raise TypeError('apdata is list but NOT of float or int')
-                if isinstance(apdata,pd.DataFrame): 
+                if isinstance(apdata, pd.DataFrame):
                     havedf = True
                 else:
                     havedf = False      # must be a single series or array
-                    apdata = [apdata,]  # make it iterable
+                    apdata = [apdata, ]  # make it iterable
                 for column in apdata:
-                    ydata = apdata.loc[:,column] if havedf else column
-                    ax = _addplot_columns(panid,panels,ydata,apdict,xdates,config)
-                    _addplot_apply_supplements(ax,apdict,xdates)
+                    ydata = apdata.loc[:, column] if havedf else column
+                    ax = _addplot_columns(
+                        panid, panels, ydata, apdict, xdates, config)
+                    _addplot_apply_supplements(ax, apdict, xdates)
 
     # fill_between is NOT supported for external_axes_mode
     # (caller can easily call ax.fill_between() themselves).
     if config['fill_between'] is not None and not external_axes_mode:
         fblist = copy.deepcopy(config['fill_between'])
         if _num_or_seq_of_num(fblist):
-            fblist = [dict(y1=fblist),]
-        elif isinstance(fblist,dict):
-            fblist = [fblist,]
+            fblist = [dict(y1=fblist), ]
+        elif isinstance(fblist, dict):
+            fblist = [fblist, ]
         if not _list_of_dict(fblist):
             raise TypeError('Bad type for `fill_between` specifier.')
         for fb in fblist:
@@ -741,62 +781,61 @@ def plot( data, **kwargs ):
             if 'panel' in fb:
                 panid = fb['panel']
                 del fb['panel']
-            fb['x'] = xdates # add 'x' to caller's fb dict
-            ax = panels.at[panid,'axes'][0]
+            fb['x'] = xdates  # add 'x' to caller's fb dict
+            ax = panels.at[panid, 'axes'][0]
             ax.fill_between(**fb)
-            
+
     # put the primary axis on one side,
     # and the twinx() on the "other" side:
     if not external_axes_mode:
-        for panid,row in panels.iterrows():
+        for panid, row in panels.iterrows():
             ax = row['axes']
             y_on_right = style['y_on_right'] if row['y_on_right'] is None else row['y_on_right']
-            _set_ylabels_side(ax[0],ax[1],y_on_right)
+            _set_ylabels_side(ax[0], ax[1], y_on_right)
     else:
         y_on_right = style['y_on_right']
-        _set_ylabels_side(axA1,None,y_on_right)
+        _set_ylabels_side(axA1, None, y_on_right)
 
     # TODO: ================================================================
     # TODO:  Investigate:
     # TODO:  ===========
     # TODO:  It appears to me that there may be some or significant overlap
     # TODO:  between what the following functions actually do:
-    # TODO:  At the very least, all four of them appear to communicate 
+    # TODO:  At the very least, all four of them appear to communicate
     # TODO:  to matplotlib that the xaxis should be treated as dates:
     # TODO:   ->  'ax.autoscale_view()'
     # TODO:   ->  'ax.xaxis_dates()'
     # TODO:   ->  'plt.autofmt_xdates()'
     # TODO:   ->  'fig.autofmt_xdate()'
     # TODO: ================================================================
-    
 
-    #if config['autofmt_xdate']:
+    # if config['autofmt_xdate']:
         #print('CALLING fig.autofmt_xdate()')
-        #fig.autofmt_xdate()
+        # fig.autofmt_xdate()
 
     axA1.autoscale_view()  # Is this really necessary??
-                           # It appears to me, based on experience coding types 'ohlc' and 'candle'
-                           # for `addplot`, that this IS necessary when the only thing done to the
-                           # the axes is .add_collection().  (However, if ax.plot() .scatter() or
-                           # .bar() was called, then possibly this is not necessary; not entirely
-                           # sure, but it definitely was necessary to get 'ohlc' and 'candle' 
-                           # working in `addplot`).
+    # It appears to me, based on experience coding types 'ohlc' and 'candle'
+    # for `addplot`, that this IS necessary when the only thing done to the
+    # the axes is .add_collection().  (However, if ax.plot() .scatter() or
+    # .bar() was called, then possibly this is not necessary; not entirely
+    # sure, but it definitely was necessary to get 'ohlc' and 'candle'
+    # working in `addplot`).
 
     axA1.set_ylabel(config['ylabel'])
 
     if config['volume']:
         if external_axes_mode:
-            volumeAxes.tick_params(axis='x',rotation=xrotation)
+            volumeAxes.tick_params(axis='x', rotation=xrotation)
             volumeAxes.xaxis.set_major_formatter(formatter)
 
         vscale = 'linear'
         ysd = config['volume_yscale']
-        if isinstance(ysd,dict):
+        if isinstance(ysd, dict):
             yscale = ysd['yscale']
-            del      ysd['yscale']
-            volumeAxes.set_yscale(yscale,**ysd)
+            del ysd['yscale']
+            volumeAxes.set_yscale(yscale, **ysd)
             vscale = yscale
-        elif isinstance(ysd,str):
+        elif isinstance(ysd, str):
             volumeAxes.set_yscale(ysd)
             vscale = ysd
         offset = ''
@@ -807,24 +846,28 @@ def plot( data, **kwargs ):
                 offset = volumeAxes.yaxis.get_major_formatter().get_offset()
                 if len(offset) > 0:
                     offset = (' x '+offset)
-            elif isinstance(vxp,int) and vxp > 0:
-                volumeAxes.ticklabel_format(useOffset=False,scilimits=(vxp,vxp),axis='y')
+            elif isinstance(vxp, int) and vxp > 0:
+                volumeAxes.ticklabel_format(
+                    useOffset=False, scilimits=(vxp, vxp), axis='y')
                 offset = '  $10^{'+str(vxp)+'}$'
-            elif isinstance(vxp,int) and vxp == 0:
-                volumeAxes.ticklabel_format(useOffset=False,style='plain',axis='y')
+            elif isinstance(vxp, int) and vxp == 0:
+                volumeAxes.ticklabel_format(
+                    useOffset=False, style='plain', axis='y')
                 offset = ''
             else:
                 offset = ''
                 scilims = plt.rcParams['axes.formatter.limits']
                 if scilims[0] < scilims[1]:
-                    for power in (5,4,3,2,1):
+                    for power in (5, 4, 3, 2, 1):
                         xp = scilims[1]*power
                         if vymax >= 10.**xp:
-                            volumeAxes.ticklabel_format(useOffset=False,scilimits=(xp,xp),axis='y')
+                            volumeAxes.ticklabel_format(
+                                useOffset=False, scilimits=(xp, xp), axis='y')
                             offset = '  $10^{'+str(xp)+'}$'
                             break
                 elif scilims[0] == scilims[1] and scilims[1] != 0:
-                    volumeAxes.ticklabel_format(useOffset=False,scilimits=scilims,axis='y')
+                    volumeAxes.ticklabel_format(
+                        useOffset=False, scilimits=scilims, axis='y')
                     offset = ' $10^'+str(scilims[1])+'$'
             volumeAxes.yaxis.offsetText.set_visible(False)
 
@@ -835,7 +878,7 @@ def plot( data, **kwargs ):
                 offset = '\n'+offset
             vol_label = config['ylabel_lower'] + offset
         volumeAxes.set_ylabel(vol_label)
-    
+
     if config['title'] is not None:
         if config['tight_layout']:
             # IMPORTANT: `y=0.89` is based on the top of the top panel
@@ -844,24 +887,24 @@ def plot( data, **kwargs ):
             title_kwargs = dict(va='bottom', y=0.89)
         else:
             title_kwargs = dict(va='center')
-        if isinstance(config['title'],dict):
+        if isinstance(config['title'], dict):
             title_dict = config['title']
             if 'title' not in title_dict:
                 raise ValueError('Must have "title" entry in title dict')
             else:
                 title = title_dict['title']
                 del title_dict['title']
-            title_kwargs.update(title_dict)  # allows override default values set by mplfinance above
+            # allows override default values set by mplfinance above
+            title_kwargs.update(title_dict)
         else:
             title = config['title']      # config['title'] is a string
-        fig.suptitle(title,**title_kwargs)
-    
-    
+        fig.suptitle(title, **title_kwargs)
+
     if config['axtitle'] is not None:
         axA1.set_title(config['axtitle'])
 
     if not external_axes_mode:
-        for panid,row in panels.iterrows():
+        for panid, row in panels.iterrows():
             if not row['used2nd']:
                 row['axes'][1].set_visible(False)
 
@@ -879,25 +922,27 @@ def plot( data, **kwargs ):
 
     if config['savefig'] is not None:
         save = config['savefig']
-        if isinstance(save,dict):
+        if isinstance(save, dict):
             if config['tight_layout'] and 'bbox_inches' not in save:
-                fig.savefig(**save,bbox_inches='tight')
+                fig.savefig(**save, bbox_inches='tight')
             else:
                 fig.savefig(**save)
         else:
             if config['tight_layout']:
-                fig.savefig(save,bbox_inches='tight')
+                fig.savefig(save, bbox_inches='tight')
             else:
                 fig.savefig(save)
-        if config['closefig']: # True or 'auto'
+        if config['closefig']:  # True or 'auto'
             plt.close(fig)
     elif not config['returnfig']:
-        plt.show(block=config['block']) # https://stackoverflow.com/a/13361748/1639359
+        # https://stackoverflow.com/a/13361748/1639359
+        plt.show(block=config['block'])
         if config['closefig'] == True or (config['block'] and config['closefig']):
             plt.close(fig)
-    
+
     if config['returnfig']:
-        if config['closefig'] == True: plt.close(fig)
+        if config['closefig'] == True:
+            plt.close(fig)
         return (fig, axlist)
 
     # rcp   = copy.deepcopy(plt.rcParams)
@@ -906,30 +951,33 @@ def plot( data, **kwargs ):
     # print('rcpdfhead(3)=',rcpdf.head(3))
     # return # rcpdf
 
-def _adjust_figsize(fig,config):
+
+def _adjust_figsize(fig, config):
     if fig is None:
         return
     if config['figsize'] is None:
-        w,h = config['figratio']
+        w, h = config['figratio']
         r = float(w)/float(h)
         if r < 0.20 or r > 5.0:
-            raise ValueError('"figratio" (aspect ratio)  must be between 0.20 and 5.0 (but is '+str(r)+')')
+            raise ValueError(
+                '"figratio" (aspect ratio)  must be between 0.20 and 5.0 (but is '+str(r)+')')
         default_scale = DEFAULT_FIGRATIO[1]/h
         h *= default_scale
         w *= default_scale
-        base      = (w,h)
-        figscale  = config['figscale']
-        fsize     = [d*figscale for d in base]
+        base = (w, h)
+        figscale = config['figscale']
+        fsize = [d*figscale for d in base]
     else:
         fsize = config['figsize']
     fig.set_size_inches(fsize)
 
+
 def _adjust_fontsize(config):
     if config['fontscale'] is None:
         return
-    if not isinstance(plt.rcParams['font.size'],(float,int)):
-        warnings.warn('\n\n ================================================================= '+
-                      '\n\n   WARNING: Unable to scale fonts: plt.rcParams["font.size"] is NOT a float!'+
+    if not isinstance(plt.rcParams['font.size'], (float, int)):
+        warnings.warn('\n\n ================================================================= ' +
+                      '\n\n   WARNING: Unable to scale fonts: plt.rcParams["font.size"] is NOT a float!' +
                       '\n\n ================================================================ ',
                       category=UserWarning)
         return
@@ -949,18 +997,19 @@ def _adjust_fontsize(config):
     #        None:       1.0,
     #    }
     # --------------------------------------------
-    fontstuff = ['axes.labelsize','axes.titlesize', 'figure.titlesize','legend.fontsize',
-                 'legend.title_fontsize','xtick.labelsize','ytick.labelsize']
+    fontstuff = ['axes.labelsize', 'axes.titlesize', 'figure.titlesize', 'legend.fontsize',
+                 'legend.title_fontsize', 'xtick.labelsize', 'ytick.labelsize']
     for item in fontstuff:
-        if isinstance(plt.rcParams[item],(float,int)):
+        if isinstance(plt.rcParams[item], (float, int)):
             plt.rcParams[item] *= config['fontscale']
 
-def _addplot_collections(panid,panels,apdict,xdates,config):
+
+def _addplot_collections(panid, panels, apdict, xdates, config):
 
     apdata = apdict['data']
     aptype = apdict['type']
     external_axes_mode = apdict['ax'] is not None
-   
+
     #--------------------------------------------------------------#
     # Note: _auto_secondary_y() sets the 'magnitude' column in the
     #       `panels` dataframe, which is needed for automatically
@@ -973,134 +1022,152 @@ def _addplot_collections(panid,panels,apdict,xdates,config):
     #       if any have secondary_y='auto', but since that is the
     #       default value, we will just assume we have at least one.
 
-    valid_apc_types = ['ohlc','candle']
+    valid_apc_types = ['ohlc', 'candle']
     if aptype not in valid_apc_types:
-        raise TypeError('Invalid aptype='+str(aptype)+'. Must be one of '+str(valid_apc_types))
-    if not isinstance(apdata,pd.DataFrame):
-        raise TypeError('addplot type "'+aptype+'" MUST be accompanied by addplot data of type `pd.DataFrame`')
-    d,o,h,l,c,v = _check_and_prepare_data(apdata,config)
-    
+        raise TypeError('Invalid aptype='+str(aptype) +
+                        '. Must be one of '+str(valid_apc_types))
+    if not isinstance(apdata, pd.DataFrame):
+        raise TypeError('addplot type "'+aptype +
+                        '" MUST be accompanied by addplot data of type `pd.DataFrame`')
+    d, o, h, l, c, v = _check_and_prepare_data(apdata, config)
+
     mc = apdict['marketcolors']
     if _is_marketcolor_object(mc):
         apstyle = config['style'].copy()
         apstyle['marketcolors'] = mc
     else:
         apstyle = config['style']
-    
-    collections = _construct_mpf_collections(aptype,d,xdates,o,h,l,c,v,config,apstyle)
+
+    collections = _construct_mpf_collections(
+        aptype, d, xdates, o, h, l, c, v, config, apstyle)
 
     if not external_axes_mode:
-        lo = math.log(max(math.fabs(np.nanmin(l)),1e-7),10) - 0.5
-        hi = math.log(max(math.fabs(np.nanmax(h)),1e-7),10) + 0.5
-        secondary_y = _auto_secondary_y( panels, panid, lo, hi )
+        lo = math.log(max(math.fabs(np.nanmin(l)), 1e-7), 10) - 0.5
+        hi = math.log(max(math.fabs(np.nanmax(h)), 1e-7), 10) + 0.5
+        secondary_y = _auto_secondary_y(panels, panid, lo, hi)
         if 'auto' != apdict['secondary_y']:
-            secondary_y = apdict['secondary_y'] 
+            secondary_y = apdict['secondary_y']
         if secondary_y:
-            ax = panels.at[panid,'axes'][1] 
-            panels.at[panid,'used2nd'] = True
-        else: 
-            ax = panels.at[panid,'axes'][0]
+            ax = panels.at[panid, 'axes'][1]
+            panels.at[panid, 'used2nd'] = True
+        else:
+            ax = panels.at[panid, 'axes'][0]
     else:
         ax = apdict['ax']
 
     for coll in collections:
         ax.add_collection(coll)
     if apdict['mav'] is not None:
-        apmavprices = _plot_mav(ax,config,xdates,c,apdict['mav'])
+        apmavprices = _plot_mav(ax, config, xdates, c, apdict['mav'])
+    # if apdict['ema'] is not None:
+    #     apemaprices = _plot_ema(ax, config, xdates, c, apdict['ema'])
+
     ax.autoscale_view()
     return ax
 
-def _addplot_columns(panid,panels,ydata,apdict,xdates,config):
+
+def _addplot_columns(panid, panels, ydata, apdict, xdates, config):
     external_axes_mode = apdict['ax'] is not None
     if not external_axes_mode:
         secondary_y = False
         if apdict['secondary_y'] == 'auto':
             yd = [y for y in ydata if not math.isnan(y)]
-            ymhi = math.log(max(math.fabs(np.nanmax(yd)),1e-7),10)
-            ymlo = math.log(max(math.fabs(np.nanmin(yd)),1e-7),10)
-            secondary_y = _auto_secondary_y( panels, panid, ymlo, ymhi )
+            ymhi = math.log(max(math.fabs(np.nanmax(yd)), 1e-7), 10)
+            ymlo = math.log(max(math.fabs(np.nanmin(yd)), 1e-7), 10)
+            secondary_y = _auto_secondary_y(panels, panid, ymlo, ymhi)
         else:
             secondary_y = apdict['secondary_y']
             #print("apdict['secondary_y'] says secondary_y is",secondary_y)
 
         if secondary_y:
-            ax = panels.at[panid,'axes'][1] 
-            panels.at[panid,'used2nd'] = True
-        else: 
-            ax = panels.at[panid,'axes'][0]
+            ax = panels.at[panid, 'axes'][1]
+            panels.at[panid, 'used2nd'] = True
+        else:
+            ax = panels.at[panid, 'axes'][0]
     else:
         ax = apdict['ax']
 
     aptype = apdict['type']
     if aptype == 'scatter':
-        size  = apdict['markersize']
-        mark  = apdict['marker']
+        size = apdict['markersize']
+        mark = apdict['marker']
         color = apdict['color']
         alpha = apdict['alpha']
-        edgecolors  = apdict['edgecolors']
+        edgecolors = apdict['edgecolors']
         linewidths = apdict['linewidths']
 
-        if isinstance(mark,(list,tuple,np.ndarray)):
-            _mscatter(xdates, ydata, ax=ax, m=mark, s=size, color=color, alpha=alpha, edgecolors=edgecolors, linewidths=linewidths)
+        if isinstance(mark, (list, tuple, np.ndarray)):
+            _mscatter(xdates, ydata, ax=ax, m=mark, s=size, color=color,
+                      alpha=alpha, edgecolors=edgecolors, linewidths=linewidths)
         else:
-            ax.scatter(xdates, ydata, s=size, marker=mark, color=color, alpha=alpha, edgecolors=edgecolors, linewidths=linewidths)
+            ax.scatter(xdates, ydata, s=size, marker=mark, color=color,
+                       alpha=alpha, edgecolors=edgecolors, linewidths=linewidths)
     elif aptype == 'bar':
-        width  = 0.8 if apdict['width'] is None else apdict['width']
+        width = 0.8 if apdict['width'] is None else apdict['width']
         bottom = apdict['bottom']
-        color  = apdict['color']
-        alpha  = apdict['alpha']
-        ax.bar(xdates,ydata,width=width,bottom=bottom,color=color,alpha=alpha)
+        color = apdict['color']
+        alpha = apdict['alpha']
+        ax.bar(xdates, ydata, width=width,
+               bottom=bottom, color=color, alpha=alpha)
     elif aptype == 'line':
-        ls     = apdict['linestyle']
-        color  = apdict['color']
-        width  = apdict['width'] if apdict['width'] is not None else 1.6*config['_width_config']['line_width']
-        alpha  = apdict['alpha']
-        ax.plot(xdates,ydata,linestyle=ls,color=color,linewidth=width,alpha=alpha)
+        ls = apdict['linestyle']
+        color = apdict['color']
+        width = apdict['width'] if apdict['width'] is not None else 1.6 * \
+            config['_width_config']['line_width']
+        alpha = apdict['alpha']
+        ax.plot(xdates, ydata, linestyle=ls, color=color,
+                linewidth=width, alpha=alpha)
     elif aptype == 'step':
         stepwhere = apdict['stepwhere']
         ls = apdict['linestyle']
-        color  = apdict['color']
-        width  = apdict['width'] if apdict['width'] is not None else 1.6*config['_width_config']['line_width']
-        alpha  = apdict['alpha']
-        ax.step(xdates,ydata,where = stepwhere,linestyle=ls,color=color,linewidth=width,alpha=alpha)
+        color = apdict['color']
+        width = apdict['width'] if apdict['width'] is not None else 1.6 * \
+            config['_width_config']['line_width']
+        alpha = apdict['alpha']
+        ax.step(xdates, ydata, where=stepwhere, linestyle=ls,
+                color=color, linewidth=width, alpha=alpha)
     else:
         raise ValueError('addplot type "'+str(aptype)+'" NOT yet supported.')
 
     if apdict['mav'] is not None:
-        apmavprices = _plot_mav(ax,config,xdates,ydata,apdict['mav'])
-
+        apmavprices = _plot_mav(ax, config, xdates, ydata, apdict['mav'])
+    # if apdict['ema'] is not None:
+    #     apemaprices = _plot_ema(ax, config, xdates, ydata, apdict['ema'])
     return ax
 
-def _addplot_apply_supplements(ax,apdict,xdates):
+
+def _addplot_apply_supplements(ax, apdict, xdates):
     if (apdict['ylabel'] is not None):
         ax.set_ylabel(apdict['ylabel'])
     if apdict['ylim'] is not None:
-        ax.set_ylim(apdict['ylim'][0],apdict['ylim'][1])
+        ax.set_ylim(apdict['ylim'][0], apdict['ylim'][1])
     if apdict['title'] is not None:
         ax.set_title(apdict['title'])
     ysd = apdict['yscale']
-    if isinstance(ysd,dict):
+    if isinstance(ysd, dict):
         yscale = ysd['yscale']
-        del      ysd['yscale']
-        ax.set_yscale(yscale,**ysd)
-    elif isinstance(ysd,str):
+        del ysd['yscale']
+        ax.set_yscale(yscale, **ysd)
+    elif isinstance(ysd, str):
         ax.set_yscale(ysd)
     # added by Wen
     if "fill_between" in apdict and apdict['fill_between'] is not None:
         # deep copy because mplfinance code sometimes modifies the fill_between dict
         fblist = copy.deepcopy(apdict['fill_between'])
-        if isinstance(fblist,dict):
-            fblist = [fblist,]
+        if isinstance(fblist, dict):
+            fblist = [fblist, ]
         if _list_of_dict(fblist):
             for fb in fblist:
                 if 'x' in fb:
                     raise ValueError('fill_between dict may not contain `x`')
-                fb['x'] = xdates # add 'x' to caller's fb dict
+                fb['x'] = xdates  # add 'x' to caller's fb dict
                 ax.fill_between(**fb)
         else:
-            raise ValueError('Invalid addplot fill_between: must be `dict` or `list of dict`')
+            raise ValueError(
+                'Invalid addplot fill_between: must be `dict` or `list of dict`')
+
 
-def _set_ylabels_side(ax_pri,ax_sec,primary_on_right):
+def _set_ylabels_side(ax_pri, ax_sec, primary_on_right):
     # put the primary axis on one side,
     # and the twinx() on the "other" side:
     if primary_on_right == True:
@@ -1116,7 +1183,8 @@ def _set_ylabels_side(ax_pri,ax_sec,primary_on_right):
             ax_sec.yaxis.set_label_position('right')
             ax_sec.yaxis.tick_right()
 
-def _plot_mav(ax,config,xdates,prices,apmav=None,apwidth=None):
+
+def _plot_mav(ax, config, xdates, prices, apmav=None, apwidth=None):
     style = config['style']
     if apmav is not None:
         mavgs = apmav
@@ -1125,20 +1193,20 @@ def _plot_mav(ax,config,xdates,prices,apmav=None,apwidth=None):
     mavp_list = []
     if mavgs is not None:
         shift = None
-        if isinstance(mavgs,dict):
+        if isinstance(mavgs, dict):
             shift = mavgs['shift']
             mavgs = mavgs['period']
-        if isinstance(mavgs,int):
+        if isinstance(mavgs, int):
             mavgs = mavgs,      # convert to tuple
         if len(mavgs) > 7:
             mavgs = mavgs[0:7]  # take at most 7
-     
+
         if style['mavcolors'] is not None:
             mavc = cycle(style['mavcolors'])
         else:
             mavc = None
 
-        for idx,mav in enumerate(mavgs):
+        for idx, mav in enumerate(mavgs):
             mean = pd.Series(prices).rolling(mav).mean()
             if shift is not None:
                 mean = mean.shift(periods=shift[idx])
@@ -1152,7 +1220,7 @@ def _plot_mav(ax,config,xdates,prices,apmav=None,apwidth=None):
     return mavp_list
 
 
-def _plot_ema(ax,config,xdates,prices,apmav=None,apwidth=None):
+def _plot_ema(ax, config, xdates, prices, apmav=None, apwidth=None):
     '''ema: exponential moving average'''
     style = config['style']
     if apmav is not None:
@@ -1162,160 +1230,162 @@ def _plot_ema(ax,config,xdates,prices,apmav=None,apwidth=None):
     mavp_list = []
     if mavgs is not None:
         shift = None
-        if isinstance(mavgs,dict):
+        if isinstance(mavgs, dict):
             shift = mavgs['shift']
             mavgs = mavgs['period']
-        if isinstance(mavgs,int):
+        if isinstance(mavgs, int):
             mavgs = mavgs,      # convert to tuple
         if len(mavgs) > 7:
             mavgs = mavgs[0:7]  # take at most 7
-     
+
         if style['mavcolors'] is not None:
             mavc = cycle(style['mavcolors'])
         else:
             mavc = None
 
-        for idx,mav in enumerate(mavgs):
+        for idx, mav in enumerate(mavgs):
             # mean = pd.Series(prices).rolling(mav).mean()
-            mean = pd.Series(prices).ewm(span=mav,adjust=False).mean()
+            mean = pd.Series(prices).ewm(span=mav, adjust=False).mean()
             if shift is not None:
                 mean = mean.shift(periods=shift[idx])
-            mavprices = mean.values
+            emaprices = mean.values
             lw = config['_width_config']['line_width']
             if mavc:
-                ax.plot(xdates, mavprices, linewidth=lw, color=next(mavc))
+                ax.plot(xdates, emaprices, linewidth=lw, color=next(mavc))
             else:
-                ax.plot(xdates, mavprices, linewidth=lw)
-            mavp_list.append(mavprices)
+                ax.plot(xdates, emaprices, linewidth=lw)
+            mavp_list.append(emaprices)
     return mavp_list
 
 
-def _auto_secondary_y( panels, panid, ylo, yhi ):
+def _auto_secondary_y(panels, panid, ylo, yhi):
     # If mag(nitude) for this panel is not yet set, then set it
     # here, as this is the first ydata to be plotted on this panel:
     # i.e. consider this to be the 'primary' axis for this panel.
     secondary_y = False
-    p = panid,'mag'
+    p = panid, 'mag'
     if panels.at[p] is None:
-        panels.at[p] = {'lo':ylo,'hi':yhi}
+        panels.at[p] = {'lo': ylo, 'hi': yhi}
     elif ylo < panels.at[p]['lo'] or yhi > panels.at[p]['hi']:
         secondary_y = True
-    #if secondary_y:
+    # if secondary_y:
     #    print('auto says USE secondary_y ... for panel',panid)
-    #else:
+    # else:
     #    print('auto says do NOT use secondary_y ... for panel',panid)
     return secondary_y
 
+
 def _valid_addplot_kwargs():
 
-    valid_linestyles = ('-','solid','--','dashed','-.','dashdot','.','dotted',None,' ','')
-    valid_types = ('line','scatter','bar', 'ohlc', 'candle','step')
-    valid_stepwheres = ('pre','post','mid')
+    valid_linestyles = ('-', 'solid', '--', 'dashed', '-.',
+                        'dashdot', '.', 'dotted', None, ' ', '')
+    valid_types = ('line', 'scatter', 'bar', 'ohlc', 'candle', 'step')
+    valid_stepwheres = ('pre', 'post', 'mid')
     valid_edgecolors = ('face', 'none', None)
 
     vkwargs = {
-        'scatter'     : { 'Default'     : False,
-                          'Description' : "Deprecated.  (Use kwarg `type='scatter' instead.",
-                          'Validator'   : lambda value: isinstance(value,bool) },
-
-        'type'        : { 'Default'     : 'line',
-                          'Description' : 'addplot type: "line","scatter","bar", "ohlc", "candle","step"',
-                          'Validator'   : lambda value: value in valid_types },
-
-        'mav'         : { 'Default'     : None,
-                          'Description' : 'Moving Average window size(s); (int or tuple of ints)',
-                          'Validator'   : _mav_validator },
-        
-        'panel'       : { 'Default'     : 0, 
-                          'Description' : 'Panel (int 0-31) to use for this addplot',
-                          'Validator'   : lambda value: _valid_panel_id(value) },
-
-        'marker'      : { 'Default'     : 'o',
-                          'Description' : "marker for `type='scatter'` plot",
-                          'Validator'   : lambda value: _bypass_kwarg_validation(value)  },
-
-        'markersize'  : { 'Default'     : 18,
-                          'Description' : 'size of marker for `type="scatter"`; default=18',
-                          'Validator'   : lambda value: isinstance(value,(int,float)) },
-
-        'color'       : { 'Default'     : None,
-                          'Description' : 'color (or sequence of colors) of line(s), scatter marker(s), or bar(s).',
-                          'Validator'   : lambda value: mcolors.is_color_like(value) or
-                                         (isinstance(value,(list,tuple,np.ndarray)) and all([mcolors.is_color_like(v) for v in value])) },
-
-        'linestyle'   : { 'Default'     : None,
-                          'Description' : 'line style for `type=line` ('+str(valid_linestyles)+')',
-                          'Validator'   : lambda value: value in valid_linestyles },
-
-        'linewidths'  : { 'Default': None,
-                          'Description' : 'edge widths of scatter markers',
-                          'Validator'   : lambda value: isinstance(value,(int,float)) },
-
-        'edgecolors'  : { 'Default': None,
-                          'Description' : 'edgecolors of scatter markers',
-                          'Validator': lambda value: mcolors.is_color_like(value) or value in valid_edgecolors},
-
-        'width'       : { 'Default'     : None, # width of `bar` or `line`
-                          'Description' : 'width of bar or line for `type="bar"` or `type="line"',
-                          'Validator'   : lambda value: isinstance(value,(int,float)) or
-                                                        all([isinstance(v,(int,float)) for v in value]) },
-
-        'bottom'      : { 'Default'     : 0,  # bottom for `type=bar` plots
-                          'Description' : 'bottom value for `type=bar` bars. Default=0',
-                          'Validator'   : lambda value: isinstance(value,(int,float)) or
-                                                        all([isinstance(v,(int,float)) for v in value]) },
-        'alpha'       : { 'Default'     : 1,  # alpha of `bar`, `line`, or `scatter`
-                          'Description' : 'opacity for 0.0 (transparent) to 1.0 (opaque)',
-                          'Validator'   : lambda value: isinstance(value,(int,float)) or
-                                                        all([isinstance(v,(int,float)) for v in value]) },
-
-        'secondary_y' : { 'Default'     : 'auto',
-                          'Description' : "True|False|'auto' place the additional plot data on a"+
-                                          " secondary y-axis.  'auto' compares the magnitude or the"+
-                                          " addplot data, to data already on the axis, and if it appears"+
-                                          " they are of different magnitudes, then it uses a secondary y-axis."+
-                                          " True or False always override 'auto'.",
-                          'Validator'   : lambda value: isinstance(value,bool) or value == 'auto' },
-
-        'y_on_right'  : { 'Default'     : None,
-                          'Description' : 'True|False put y-axis tick labels on the right, for this addplot'+
-                                          ' regardless of what the mplfinance style says to to.',
-                          'Validator'   : lambda value: isinstance(value,bool) },
-
-        'ylabel'      : { 'Default'     : None,
-                          'Description' : 'label for y-axis (for this addplot)',
-                          'Validator'   : lambda value: isinstance(value,str) },
-
-        'ylim'        : {'Default'      : None,
-                         'Description' : 'Limits for addplot y-axis as tuple (min,max), i.e. (bottom,top)',
-                         'Validator'    : lambda value: isinstance(value, (list,tuple)) and len(value) == 2 
-                                                                      and all([isinstance(v,(int,float)) for v in value])},
-
-        'title'       : { 'Default'     : None,
-                          'Description' : 'Axes Title (subplot title) for this addplot.',
-                          'Validator'   : lambda value: isinstance(value,str) },
-
-        'ax'          : { 'Default'      : None,
-                          'Description' : 'Matplotlib Axes object on which to plot this addplot',
-                          'Validator'    : lambda value: isinstance(value,mpl_axes.Axes) },
-
-        'yscale'      : { 'Default'     : None,
-                          'Description' : 'addplot y-axis scale: "linear", "log", "symlog", or "logit"',
-                          'Validator'   : lambda value: _yscale_validator(value) },
-
-        'stepwhere'   : { 'Default'     : 'pre',
-                          'Description' : "'pre','post', or 'mid': where to place step relative"+
-                                          " to data for `type='step'`",
-                          'Validator'   : lambda value : value in valid_stepwheres },                  
-        
-        'marketcolors': { 'Default'     : None, # use 'style' for default, instead.
-                          'Description' : "marketcolors for this addplot (instead of the mplfinance"+
-                                          " style\'s marketcolors).  For addplot `type='ohlc'`"+
-                                          " and type='candle'",
-                          'Validator'   : lambda value: _is_marketcolor_object(value) },
-        'fill_between': { 'Default'     : None,    # added by Wen
-                          'Description' : " fill region",
-                          'Validator'   : _fill_between_validator },
+        'scatter': {'Default': False,
+                    'Description': "Deprecated.  (Use kwarg `type='scatter' instead.",
+                    'Validator': lambda value: isinstance(value, bool)},
+
+        'type': {'Default': 'line',
+                 'Description': 'addplot type: "line","scatter","bar", "ohlc", "candle","step"',
+                 'Validator': lambda value: value in valid_types},
+
+        'mav': {'Default': None,
+                'Description': 'Moving Average window size(s); (int or tuple of ints)',
+                'Validator': _mav_validator},
+
+        'panel': {'Default': 0,
+                  'Description': 'Panel (int 0-31) to use for this addplot',
+                  'Validator': lambda value: _valid_panel_id(value)},
+
+        'marker': {'Default': 'o',
+                   'Description': "marker for `type='scatter'` plot",
+                   'Validator': lambda value: _bypass_kwarg_validation(value)},
+
+        'markersize': {'Default': 18,
+                       'Description': 'size of marker for `type="scatter"`; default=18',
+                       'Validator': lambda value: isinstance(value, (int, float))},
+
+        'color': {'Default': None,
+                  'Description': 'color (or sequence of colors) of line(s), scatter marker(s), or bar(s).',
+                  'Validator': lambda value: mcolors.is_color_like(value) or
+                  (isinstance(value, (list, tuple, np.ndarray)) and all([mcolors.is_color_like(v) for v in value]))},
+
+        'linestyle': {'Default': None,
+                      'Description': 'line style for `type=line` ('+str(valid_linestyles)+')',
+                      'Validator': lambda value: value in valid_linestyles},
+
+        'linewidths': {'Default': None,
+                       'Description': 'edge widths of scatter markers',
+                       'Validator': lambda value: isinstance(value, (int, float))},
+
+        'edgecolors': {'Default': None,
+                       'Description': 'edgecolors of scatter markers',
+                       'Validator': lambda value: mcolors.is_color_like(value) or value in valid_edgecolors},
+
+        'width': {'Default': None,  # width of `bar` or `line`
+                  'Description': 'width of bar or line for `type="bar"` or `type="line"',
+                  'Validator': lambda value: isinstance(value, (int, float)) or
+                  all([isinstance(v, (int, float)) for v in value])},
+
+        'bottom': {'Default': 0,  # bottom for `type=bar` plots
+                   'Description': 'bottom value for `type=bar` bars. Default=0',
+                   'Validator': lambda value: isinstance(value, (int, float)) or
+                   all([isinstance(v, (int, float)) for v in value])},
+        'alpha': {'Default': 1,  # alpha of `bar`, `line`, or `scatter`
+                  'Description': 'opacity for 0.0 (transparent) to 1.0 (opaque)',
+                  'Validator': lambda value: isinstance(value, (int, float)) or
+                  all([isinstance(v, (int, float)) for v in value])},
+
+        'secondary_y': {'Default': 'auto',
+                        'Description': "True|False|'auto' place the additional plot data on a" +
+                        " secondary y-axis.  'auto' compares the magnitude or the" +
+                        " addplot data, to data already on the axis, and if it appears" +
+                        " they are of different magnitudes, then it uses a secondary y-axis." +
+                        " True or False always override 'auto'.",
+                        'Validator': lambda value: isinstance(value, bool) or value == 'auto'},
+
+        'y_on_right': {'Default': None,
+                       'Description': 'True|False put y-axis tick labels on the right, for this addplot' +
+                       ' regardless of what the mplfinance style says to to.',
+                       'Validator': lambda value: isinstance(value, bool)},
+
+        'ylabel': {'Default': None,
+                   'Description': 'label for y-axis (for this addplot)',
+                   'Validator': lambda value: isinstance(value, str)},
+
+        'ylim': {'Default': None,
+                 'Description': 'Limits for addplot y-axis as tuple (min,max), i.e. (bottom,top)',
+                 'Validator': lambda value: isinstance(value, (list, tuple)) and len(value) == 2
+                 and all([isinstance(v, (int, float)) for v in value])},
+
+        'title': {'Default': None,
+                  'Description': 'Axes Title (subplot title) for this addplot.',
+                  'Validator': lambda value: isinstance(value, str)},
+
+        'ax': {'Default': None,
+               'Description': 'Matplotlib Axes object on which to plot this addplot',
+               'Validator': lambda value: isinstance(value, mpl_axes.Axes)},
+
+        'yscale': {'Default': None,
+                   'Description': 'addplot y-axis scale: "linear", "log", "symlog", or "logit"',
+                   'Validator': lambda value: _yscale_validator(value)},
+
+        'stepwhere': {'Default': 'pre',
+                      'Description': "'pre','post', or 'mid': where to place step relative" +
+                      " to data for `type='step'`",
+                      'Validator': lambda value: value in valid_stepwheres},
+
+        'marketcolors': {'Default': None,  # use 'style' for default, instead.
+                         'Description': "marketcolors for this addplot (instead of the mplfinance" +
+                         " style\'s marketcolors).  For addplot `type='ohlc'`" +
+                         " and type='candle'",
+                         'Validator': lambda value: _is_marketcolor_object(value)},
+        'fill_between': {'Default': None,    # added by Wen
+                         'Description': " fill region",
+                         'Validator': _fill_between_validator},
 
     }
 
@@ -1340,4 +1410,4 @@ def make_addplot(data, **kwargs):
     if config['scatter'] == True and config['type'] == 'line':
         config['type'] = 'scatter'
 
-    return dict( data=data, **config)
+    return dict(data=data, **config)
diff --git a/tests/test_ema.py b/tests/test_ema.py
new file mode 100644
index 00000000..7fa3b519
--- /dev/null
+++ b/tests/test_ema.py
@@ -0,0 +1,85 @@
+
+import mplfinance as mpf
+import requests        # for making http requests to binance
+import json            # for parsing what binance sends back to us
+import pandas as pd    # for storing and manipulating the data we get back
+import numpy as np     # numerical python, i usually need this somewhere
+# and so i import by habit nowadays
+
+import matplotlib.pyplot as plt  # for charts and such
+import datetime as dt  # for dealing with times
+
+INTERVAL = '1d'
+
+
+def get_bars(quote, interval=INTERVAL):
+
+    root_url = 'https://api.binance.com/api/v1/klines'
+    url = root_url + '?symbol=' + quote + '&interval=' + interval
+    data = json.loads(requests.get(url).text)
+    df = pd.DataFrame(data)
+    df.columns = ['open_time',
+                  'o', 'h', 'l', 'c', 'v',
+                  'close_time', 'qav', 'num_trades',
+                  'taker_base_vol', 'taker_quote_vol', 'ignore']
+    df.index = [dt.datetime.fromtimestamp(x/1000.0) for x in df.close_time]
+
+    return df
+
+
+def coinpair(quote, interval='1d', base='USDT'):
+    '''returns ohlc data of the quote cryptocurrency with
+        the base currency (i.e. 'market'); base for alts must be either USDT or BTC'''
+
+    btcusd = 1 if quote == 'BTC' else \
+        get_bars('BTCUSDT', interval=interval)['c'].astype('float') \
+        if base == 'USDT' else 1
+
+    base0 = 'USDT' if quote == 'BTC' else 'BTC'
+
+    df = get_bars(quote + base0, interval=interval)
+
+    df['close'] = df['c'].astype('float')*btcusd
+    df['open'] = df['o'].astype('float')*btcusd
+    df['high'] = df['h'].astype('float')*btcusd
+    df['low'] = df['l'].astype('float')*btcusd
+
+    df.drop(['o', 'h', 'l', 'c'], axis=1, inplace=True)
+    print(quote, base, 'on {} candles'.format(interval))
+
+    return df
+
+
+def test_ema():
+
+    coin = 'BTC'
+    market = 'USDT'
+    candles = '1M'
+
+    df = coinpair(coin, interval=candles, base=market)
+
+    # mpf.plot(df,type='candle',figratio=(5,2),figscale=0.5,\
+    #          title=coin+market+" ({} candles)".format(candles),\
+    #          yscale='log'
+    #          )
+    #
+
+    ema25 = df['close'].ewm(span=25.0, adjust=False).mean()
+    mav25 = df['close'].rolling(window=25).mean()
+
+    # mpf.plot(df, type='ohlc', mav=25)
+
+    ap = [
+        mpf.make_addplot(df, panel=1, type='ohlc', color='c',
+                         ylabel='mpf mav', mav=25, secondary_y=False),
+        mpf.make_addplot(ema25, panel=2, type='line', width=2,  color='c',
+                         ylabel='calculated', secondary_y=False),
+        mpf.make_addplot(mav25, panel=2, type='line', width=2, color='blue',
+                         ylabel='calculated', secondary_y=False)
+
+    ]
+    mpf.plot(df, ylabel="mpf ema", type='ohlc',
+             ema=25, addplot=ap, panel_ratios=(1, 1))
+
+
+test_ema()
diff --git a/tests/test_images/test_ema.png b/tests/test_images/test_ema.png
new file mode 100644
index 0000000000000000000000000000000000000000..0cc180b2537f8cd9b4e34ba152c41e74bb343bc3
GIT binary patch
literal 57100
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

literal 0
HcmV?d00001


From 5c15d4d051ff19dffcd736e6f412824740146489 Mon Sep 17 00:00:00 2001
From: Vedant Gawande <programmer.vedant@gmail.com>
Date: Sat, 22 Oct 2022 00:34:29 +0530
Subject: [PATCH 09/22] Added Date field on x-axis

---
 build/lib/mplfinance/__init__.py              |    7 +
 build/lib/mplfinance/_arg_validators.py       |  445 +++++
 build/lib/mplfinance/_helpers.py              |  121 ++
 build/lib/mplfinance/_kwarg_help.py           |  154 ++
 build/lib/mplfinance/_mpf_warnings.py         |   16 +
 build/lib/mplfinance/_mplrcputils.py          |   87 +
 build/lib/mplfinance/_mplwraps.py             |  121 ++
 build/lib/mplfinance/_panels.py               |  232 +++
 build/lib/mplfinance/_styledata/__init__.py   |   45 +
 build/lib/mplfinance/_styledata/binance.py    |   29 +
 build/lib/mplfinance/_styledata/blueskies.py  |   23 +
 build/lib/mplfinance/_styledata/brasil.py     |   25 +
 build/lib/mplfinance/_styledata/charles.py    |   30 +
 build/lib/mplfinance/_styledata/checkers.py   |   26 +
 build/lib/mplfinance/_styledata/classic.py    |   28 +
 build/lib/mplfinance/_styledata/default.py    |   29 +
 build/lib/mplfinance/_styledata/ibd.py        |   38 +
 build/lib/mplfinance/_styledata/kenan.py      |   33 +
 build/lib/mplfinance/_styledata/mike.py       |   36 +
 .../lib/mplfinance/_styledata/nightclouds.py  |   23 +
 build/lib/mplfinance/_styledata/sas.py        |    4 +
 .../mplfinance/_styledata/starsandstripes.py  |   24 +
 build/lib/mplfinance/_styledata/yahoo.py      |   23 +
 build/lib/mplfinance/_styles.py               |  382 +++++
 build/lib/mplfinance/_utils.py                | 1515 +++++++++++++++++
 build/lib/mplfinance/_version.py              |    6 +
 build/lib/mplfinance/_widths.py               |  197 +++
 build/lib/mplfinance/original_flavor.py       |  885 ++++++++++
 build/lib/mplfinance/plotting.py              | 1307 ++++++++++++++
 dist/mplfinance-0.12.9b2-py3.10.egg           |  Bin 0 -> 148059 bytes
 src/mplfinance/plotting.py                    |    7 +
 31 files changed, 5898 insertions(+)
 create mode 100644 build/lib/mplfinance/__init__.py
 create mode 100644 build/lib/mplfinance/_arg_validators.py
 create mode 100644 build/lib/mplfinance/_helpers.py
 create mode 100644 build/lib/mplfinance/_kwarg_help.py
 create mode 100644 build/lib/mplfinance/_mpf_warnings.py
 create mode 100644 build/lib/mplfinance/_mplrcputils.py
 create mode 100644 build/lib/mplfinance/_mplwraps.py
 create mode 100644 build/lib/mplfinance/_panels.py
 create mode 100644 build/lib/mplfinance/_styledata/__init__.py
 create mode 100644 build/lib/mplfinance/_styledata/binance.py
 create mode 100644 build/lib/mplfinance/_styledata/blueskies.py
 create mode 100644 build/lib/mplfinance/_styledata/brasil.py
 create mode 100644 build/lib/mplfinance/_styledata/charles.py
 create mode 100644 build/lib/mplfinance/_styledata/checkers.py
 create mode 100644 build/lib/mplfinance/_styledata/classic.py
 create mode 100644 build/lib/mplfinance/_styledata/default.py
 create mode 100644 build/lib/mplfinance/_styledata/ibd.py
 create mode 100644 build/lib/mplfinance/_styledata/kenan.py
 create mode 100644 build/lib/mplfinance/_styledata/mike.py
 create mode 100644 build/lib/mplfinance/_styledata/nightclouds.py
 create mode 100644 build/lib/mplfinance/_styledata/sas.py
 create mode 100644 build/lib/mplfinance/_styledata/starsandstripes.py
 create mode 100644 build/lib/mplfinance/_styledata/yahoo.py
 create mode 100644 build/lib/mplfinance/_styles.py
 create mode 100644 build/lib/mplfinance/_utils.py
 create mode 100644 build/lib/mplfinance/_version.py
 create mode 100644 build/lib/mplfinance/_widths.py
 create mode 100644 build/lib/mplfinance/original_flavor.py
 create mode 100644 build/lib/mplfinance/plotting.py
 create mode 100644 dist/mplfinance-0.12.9b2-py3.10.egg

diff --git a/build/lib/mplfinance/__init__.py b/build/lib/mplfinance/__init__.py
new file mode 100644
index 00000000..f1e1865c
--- /dev/null
+++ b/build/lib/mplfinance/__init__.py
@@ -0,0 +1,7 @@
+import mplfinance._mpf_warnings
+from   mplfinance.plotting    import plot, make_addplot
+from   mplfinance._styles     import make_mpf_style, make_marketcolors
+from   mplfinance._styles     import available_styles, write_style_file
+from   mplfinance._version    import __version__
+from   mplfinance._mplwraps   import figure, show
+from   mplfinance._kwarg_help import kwarg_help
diff --git a/build/lib/mplfinance/_arg_validators.py b/build/lib/mplfinance/_arg_validators.py
new file mode 100644
index 00000000..d7398232
--- /dev/null
+++ b/build/lib/mplfinance/_arg_validators.py
@@ -0,0 +1,445 @@
+import matplotlib.dates  as mdates
+import pandas   as pd
+import numpy    as np
+import datetime
+from   mplfinance._helpers import _list_of_dict, _mpf_is_color_like
+from   mplfinance._helpers import _num_or_seq_of_num
+import matplotlib as mpl
+import warnings
+
+def _check_and_prepare_data(data, config):
+    '''
+    Check and Prepare the data input:
+    For now, data must be a Pandas DataFrame with a DatetimeIndex
+    and columns named 'Open', 'High', 'Low', 'Close', and optionally 'Volume'
+
+    Later (if there is demand for it) we may accept all of the following data formats:
+      1. Pandas DataFrame with DatetimeIndex (as described above)
+      2. Pandas Series with DatetimeIndex:
+             Values are close prices, and Series generates a line plot
+      3. Tuple of Lists, or List of Lists:
+             The inner Lists are each columns, in the order: DateTime, Open, High, Low, Close, Volume
+      4. Tuple of Tuples or List of Tuples:
+             The inner tuples are each row, containing values in the order: DateTime, Open, High, Low, Close, Volume
+
+    Return a Tuple of Lists: datetimes, opens, highs, lows, closes, volumes
+    '''
+    if not isinstance(data, pd.core.frame.DataFrame):
+        raise TypeError('Expect data as DataFrame')
+
+    if not isinstance(data.index,pd.core.indexes.datetimes.DatetimeIndex):
+        raise TypeError('Expect data.index as DatetimeIndex')
+
+    if (len(data.index) > config['warn_too_much_data'] and
+        (config['type']=='candle' or config['type']=='ohlc' or config['type']=='hollow_and_filled')
+       ):
+        warnings.warn('\n\n ================================================================= '+
+                      '\n\n   WARNING: YOU ARE PLOTTING SO MUCH DATA THAT IT MAY NOT BE'+
+                        '\n            POSSIBLE TO SEE DETAILS (Candles, Ohlc-Bars, Etc.)'+
+                        '\n   For more information see:'+
+                        '\n   - https://github.com/matplotlib/mplfinance/wiki/Plotting-Too-Much-Data'+
+                        '\n   '+
+                        '\n   TO SILENCE THIS WARNING, set `type=\'line\'` in `mpf.plot()`'+
+                        '\n   OR set kwarg `warn_too_much_data=N` where N is an integer '+
+                        '\n   LARGER than the number of data points you want to plot.'+
+                      '\n\n ================================================================ ',
+                  category=UserWarning)
+
+    # We will not be fully case-insensitive (since Pandas columns as NOT case-insensitive)
+    # but because so many people have requested it, for the default column names we will
+    # try both Capitalized and lower case:
+    columns = config['columns']
+    if columns is None:
+        columns =  ('Open', 'High', 'Low', 'Close', 'Volume')
+        if all([c.lower() in data for c in columns[0:4]]):
+            columns =  ('open', 'high', 'low', 'close', 'volume')
+        
+    o, h, l, c, v = columns
+    cols = [o, h, l, c]
+
+    if config['tz_localize']:
+        dates   = mdates.date2num(data.index.tz_localize(None).to_pydatetime())
+    else:  # Just in case someone was depending on this bug (Issue 236)
+        dates   = mdates.date2num(data.index.to_pydatetime())
+    opens   = data[o].values
+    highs   = data[h].values
+    lows    = data[l].values
+    closes  = data[c].values
+    if v in data.columns:
+        volumes = data[v].values
+        cols.append(v)
+    else:
+        volumes = None
+
+    for col in cols:
+        if not all( isinstance(v,(float,int)) for v in data[col] ):
+            raise ValueError('Data for column "'+str(col)+'" must be ALL float or int.')
+
+    return dates, opens, highs, lows, closes, volumes
+
+def _get_valid_plot_types(plottype=None):
+
+    _alias_types = {
+        'candlestick'       : 'candle',
+        'ohlc_bars'         : 'ohlc',
+        'hollow_candle'     : 'hollow_and_filled',
+        'hollow'            : 'hollow_and_filled',
+        'hnf'               : 'hollow_and_filled',
+    }
+
+    _valid_types = ['candle','ohlc', 'line','renko','pnf','hollow_and_filled']
+
+    _valid_types_all = _valid_types.copy()
+    _valid_types_all.extend(_alias_types.keys())
+
+    if plottype is None:
+        return _valid_types_all
+    elif plottype in _alias_types:
+        return _alias_types[plottype]
+    return plottype
+        
+
+def _mav_validator(mav_value):
+    '''
+    Value for mav (moving average) keyword may be:
+    scalar int greater than 1, or tuple of ints, or list of ints (each greater than 1)
+    or a dict of `period` and `shift` each of which may be:
+    scalar int, or tuple of ints, or list of ints: each `period` int must be greater than 1
+    '''
+    def _valid_mav(value, is_period=True):
+        if not isinstance(value,(tuple,list,int)):
+            return False
+        if isinstance(value,int):
+            return (value >= 2 or not is_period)
+        # Must be a tuple or list here:
+        for num in value:
+            if not isinstance(num,int) or (is_period and num < 2):
+                return False
+        return True
+
+    if not isinstance(mav_value,(tuple,list,int,dict)):
+        return False
+
+    if not isinstance(mav_value,dict):
+        return _valid_mav(mav_value)
+
+    else: #isinstance(mav_value,dict)
+        if 'period' not in mav_value: return False
+
+        period = mav_value['period']
+        if not _valid_mav(period): return False
+
+        if 'shift' not in mav_value: return True
+
+        shift  = mav_value['shift']
+        if not _valid_mav(shift, False):  return False
+        if isinstance(period,int) and isinstance(shift,int): return True
+        if isinstance(period,(tuple,list)) and isinstance(shift,(tuple,list)):
+            if len(period) != len(shift): return False
+            return True
+        return False
+
+
+def _hlines_validator(value):
+    if isinstance(value,dict):
+        if 'hlines' in value:
+            value = value['hlines']
+        else:
+            return False
+    return ( isinstance(value,(float,int)) or (isinstance(value,(list,tuple)) and
+             all([isinstance(v,(float,int)) for v in value])) )
+
+def _is_datelike(value):
+    if isinstance(value, (pd.Timestamp,datetime.datetime,datetime.date)):
+        return True
+    if isinstance(value,str):
+        try:
+            dt = pd.to_datetime(value)
+            return True
+        except:
+            return False
+    return False
+
+def _xlim_validator(value):
+    return (isinstance(value, (list,tuple)) and len(value) == 2
+            and (all([isinstance(v,(int,float)) for v in value])
+                 or all([_is_datelike(v) for v in value])))
+
+def _vlines_validator(value):
+    '''Validate `vlines` kwarg value:  must be "datelike" or sequence of "datelike"
+    '''
+    if isinstance(value,dict):
+        if 'vlines' in value:
+            value = value['vlines']
+        else:
+            return False
+    if _is_datelike(value): return True
+    if not isinstance(value,(list,tuple)): return False
+    if not all([_is_datelike(v) for v in value]): return False
+    return True
+
+def _alines_validator(value, returnStandardizedValue=False):
+    '''
+    Value for segments to be passed into LineCollection constructor must be:
+    - a sequence of `lines`, where
+    - a `lines` is a sequence of 2 or more vertices, where
+    - a vertex is a `pair`, aka a sequence of two values, an x and a y point.
+
+    From matplotlib.collections:
+        `segments` are:
+        A sequence of (line0, line1, line2), where:
+
+        linen = (x0, y0), (x1, y1), ... (xm, ym)
+       
+        or the equivalent numpy array with two columns. Each line can be a different length.
+
+    The above is from the matplotlib LineCollection documentation.
+    It basically says that the "segments" passed into the LineCollection constructor 
+    must be a Sequence of Sequences of 2 or more xy Pairs.  However here in `mplfinance`
+    we want to allow that (seq of seq of xy pairs) _as well as_ just a sequence of pairs.
+    Therefore here in the validator we will allow both:
+       (a) seq of at least 2 date,float pairs         (this is a 'line'    as defined above)
+       (b) seq of seqs of at least 2 date,float pairs (this is a 'seqment' as defined above)
+    '''
+    if isinstance(value,dict):
+        if 'alines' in value:
+            value = value['alines']
+        else:
+            return False
+
+    if not isinstance(value,(list,tuple)):
+        return False if not returnStandardizedValue else None
+
+    if not all([isinstance(line,(list,tuple)) and len(line) > 1 for line in value]):
+        return False if not returnStandardizedValue else None
+
+    # now, were the above really `lines`, or were they simply `vertices`
+    if all( [ isinstance(point,(list,tuple)) and len(point)==2 and
+              _is_datelike(point[0]) and isinstance(point[1],(float,int))
+              for line in value for point in line ] ):
+        # they were lines:
+        return True if not returnStandardizedValue else value
+
+    # here, if valid, we have a sequence of vertices (points)
+    if all( [ isinstance(point,(list,tuple)) and len(point)==2 and
+              _is_datelike(point[0]) and isinstance(point[1],(float,int))
+              for point in value ] ):
+        return True if not returnStandardizedValue else [value,]
+
+    return False if not returnStandardizedValue else None
+
+def _tlines_validator(value):
+    '''
+    Validate `tlines` kwarg value: must be sequence of "datelike" pairs.
+    '''
+    def _tlines_subvalidator(value):
+        if isinstance(value,dict):
+            if 'tlines' in value:
+                value = value['tlines']
+            else:
+                return False
+        if not isinstance(value,(list,tuple)):
+            return False
+        if not all([isinstance(pair,(list,tuple)) and len(pair) == 2 and
+                    _is_datelike(pair[0]) and _is_datelike(pair[1]) for pair in value]):
+            return False
+        return True
+
+    if isinstance(value,(list,tuple)) and all([isinstance(v,dict) for v in value]):
+        for v in value:
+            if not _tlines_subvalidator(v):
+                return False
+        return True
+    else:
+        return _tlines_subvalidator(value)
+
+def _bypass_kwarg_validation(value):
+    ''' For some kwargs, we either don't know enough, or
+        the validation is too complex to make it worth while,
+        so we bypass kwarg validation.  If the kwarg is 
+        invalid, then eventually an exception will be 
+        raised at the time the kwarg value is actually used.
+    '''
+    return True
+
+def _kwarg_not_implemented(value):
+    ''' If you want to list a kwarg in a valid_kwargs dict for a given
+        function, but you have not yet, or don't yet want to, implement
+        the kwarg; or you simply want to (temporarily) disable the kwarg,
+        then use this function as the kwarg validator
+    '''
+    raise NotImplementedError('kwarg NOT implemented.')
+
+def _validate_vkwargs_dict(vkwargs):
+    """
+    Check that we didn't make a typo in any of the things
+    that should be the same for all vkwargs dict items:
+
+    {kwarg : {'Default': ... , 'Description': ... , 'Validator': ...} }
+    """
+    for key, value in vkwargs.items():
+        # has been changed to 3 to support descriptions
+        if len(value) != 3:
+            raise ValueError('Items != 3 in valid kwarg table, for kwarg "'+key+'"')
+        if 'Default' not in value:
+            raise ValueError('Missing "Default" value for kwarg "'+key+'"')
+        if 'Description' not in value:
+            raise ValueError('Missing "Description" value for kwarg "'+key+'"')
+        if 'Validator' not in value:
+            raise ValueError('Missing "Validator" function for kwarg "'+key+'"')
+
+def _process_kwargs(kwargs, vkwargs):
+    '''
+    Given a "valid kwargs table" and some kwargs, verify that each key-word
+    is valid per the kwargs table, and that the value of the kwarg is the
+    correct type.  Fill a configuration dictionary with the default value
+    for each kwarg, and then substitute in any values that were provided 
+    as kwargs and return the configuration dictionary.
+    '''
+    # initialize configuration from valid_kwargs_table:
+    config  = {}
+    for key, value in vkwargs.items():
+        config[key] = value['Default']
+
+    # now validate kwargs, and for any valid kwargs
+    #  replace the appropriate value in config:
+    for key in kwargs.keys():
+        if key not in vkwargs:
+            raise KeyError('Unrecognized kwarg="'+str(key)+'"')
+        else:
+            value = kwargs[key]
+            try:
+                valid = vkwargs[key]['Validator'](value)
+            except Exception as ex:
+                ex.extra_info = 'kwarg "'+key+'" validator raised exception to value: "'+str(value)+'"'
+                raise
+            if not valid:
+                import inspect
+                v = inspect.getsource(vkwargs[key]['Validator']).strip()
+                raise TypeError('kwarg "'+key+'" validator returned False for value: "'+str(value)+'"\n    '+v)
+
+       # ---------------------------------------------------------------
+       #  At this point in the loop, if we have not raised an exception,
+       #      then kwarg is valid as far as we can tell, therefore, 
+       #      go ahead and replace the appropriate value in config:
+
+        config[key] = value
+
+    return config
+
+def _valid_panel_id(panid):
+    return panid in ['main','lower'] or (isinstance(panid,int) and panid >= 0 and panid < 32)
+
+def _scale_padding_validator(value):
+    if isinstance(value,(int,float)):
+        return True
+    elif isinstance(value,dict):
+        valid_keys=('left','right','top','bottom')
+        for key in value:
+            if key not in valid_keys:
+                raise ValueError('Invalid key "'+str(key)+'" found in `scale_padding` dict.')
+            if not isinstance(value[key],(int,float)):
+                raise ValueError('`scale_padding` dict contains non-number at key "'+str(key)+'"') 
+        return True
+    else:
+        raise ValueError('`scale_padding` kwarg must be a number, or dict of (left,right,top,bottom) numbers.')
+    return False
+
+def _yscale_validator(value):
+    if isinstance(value,str) and value in ("linear", "log", "symlog", "logit"):
+        return True
+
+    if not isinstance(value,dict):
+        return False
+
+    # At this point, value is a dict:
+    if not 'yscale' in value:
+        return False
+
+    yscale = value['yscale']
+    if not (isinstance(yscale,str) and yscale in ("linear", "log", "symlog", "logit")):
+        return False
+
+    return True
+
+
+def _is_marketcolor_object(obj):
+    if not isinstance(obj,dict): return False
+    market_colors_keys = ('candle','edge','wick','ohlc')
+    return all([k in obj for k in market_colors_keys])
+
+
+def _mco_validator(value):        # marketcolor overrides validator
+    if isinstance(value,dict):    # not yet supported, but maybe we will have other
+        if 'colors' not in value: # kwargs related to mktcolor overrides (ex: `mco_faceonly`)
+            raise ValueError('`marketcolor_overrides` as dict must contain `colors` key.')
+        colors = value['colors']
+    else:
+        colors = value
+    if not isinstance(colors,(list,tuple,np.ndarray)):
+        return False
+    return all([(c is None or 
+                 _mpf_is_color_like(c) or
+                 _is_marketcolor_object(c) ) for c in colors])
+
+def _check_for_external_axes(config):
+    '''
+    Check that all `fig` and `ax` kwargs are either ALL None, 
+    or ALL are valid instances of Figures/Axes:
+ 
+    An external Axes object can be passed in three places:
+        - mpf.plot() `ax=` kwarg
+        - mpf.plot() `volume=` kwarg
+        - mpf.make_addplot() `ax=` kwarg
+    ALL three places MUST be an Axes object, OR
+    ALL three places MUST be None.  But it may not be mixed.
+    '''
+    ap_axlist = []
+    addplot = config['addplot']
+    if addplot is not None:
+        if isinstance(addplot,dict):
+            addplot = [addplot,]   # make list of dict to be consistent
+        elif not _list_of_dict(addplot):
+            raise TypeError('addplot must be `dict`, or `list of dict`, NOT '+str(type(addplot)))
+        for apd in addplot:
+            ap_axlist.append(apd['ax'])
+ 
+    if len(ap_axlist) > 0:
+        if config['ax'] is None:
+            if not all([ax is None for ax in ap_axlist]):
+                raise ValueError('make_addplot() `ax` kwarg NOT all None, while plot() `ax` kwarg IS None')
+        else: # config['ax'] is NOT None:
+            if not isinstance(config['ax'],mpl.axes.Axes):
+                raise ValueError('plot() ax kwarg must be of type `matplotlib.axis.Axes`')
+            if not all([isinstance(ax,mpl.axes.Axes) for ax in ap_axlist]):
+                raise ValueError('make_addplot() `ax` kwargs must all be of type `matplotlib.axis.Axes`')
+
+    # At this point, if we have not raised an exception, then plot(ax=) and make_addplot(ax=)
+    # are in sync: either they are all None, or they are all of type `matplotlib.axes.Axes`.
+    # Therefore we only need plot(ax=), i.e. config['ax'], as we check `volume`: ### and `fig`:
+
+    if config['ax'] is None:
+        if isinstance(config['volume'],mpl.axes.Axes):
+            raise ValueError('`volume` set to external Axes requires all other Axes be external.')
+        #if config['fig'] is not None:
+        #    raise ValueError('`fig` kwarg must be None if `ax` kwarg is None.')
+    else:
+        if not isinstance(config['volume'],mpl.axes.Axes) and config['volume'] != False:
+            raise ValueError('`volume` must be of type `matplotlib.axis.Axes`')
+        #if not isinstance(config['fig'],mpl.figure.Figure):
+        #    raise ValueError('`fig` kwarg must be of type `matplotlib.figure.Figure`')
+    
+    external_axes_mode = True if isinstance(config['ax'],mpl.axes.Axes) else False
+    return external_axes_mode
+
+def _valid_fb_dict(value):
+    return (isinstance(value,dict) and
+            'y1' in value and
+            _num_or_seq_of_num(value['y1']))
+
+def _fill_between_validator(value):
+    if _num_or_seq_of_num(value): return True
+    if _valid_fb_dict(value): return True
+    if _list_of_dict(value):
+        return all([_valid_fb_dict(v) for v in value])
+    return False
diff --git a/build/lib/mplfinance/_helpers.py b/build/lib/mplfinance/_helpers.py
new file mode 100644
index 00000000..c10ddf92
--- /dev/null
+++ b/build/lib/mplfinance/_helpers.py
@@ -0,0 +1,121 @@
+"""
+Some helper functions for mplfinance.
+NOTE: This is the lowest level in mplfinance:
+      This file should have NO dependencies on
+      any other mplfinance files.
+"""
+
+import datetime
+import matplotlib.dates  as mdates
+import matplotlib.colors as mcolors
+import numpy as np
+
+def _adjust_color_brightness(color,amount=0.5):
+    
+    def _adjcb(c1, amount):
+        import matplotlib.colors as mc
+        import colorsys
+        # mc.is_color_like(value)
+        try:
+            c = mc.cnames[c1]
+        except:
+            c = c1
+        c = colorsys.rgb_to_hls(*mc.to_rgb(c))
+        return colorsys.hls_to_rgb(c[0], max(0, min(1, amount * c[1])), c[2])
+
+    if not isinstance(color,(list,tuple)):
+        return _adjcb(color,amount)
+        
+    cout = []
+    cadj = {}
+    for c1 in color:
+        if c1 in cadj:
+            cout.append(cadj[c1])
+        else:
+            newc = _adjcb(c1,amount)
+            cadj[c1] = newc
+            cout.append(cadj[c1])
+    return cout
+
+
+def _determine_format_string( dates, datetime_format=None ):
+    """
+    Determine the datetime format string based on the averge number
+    of days between data points, or if the user passed in kwarg
+    datetime_format, use that as an override.
+    """
+    avg_days_between_points = (dates[-1] - dates[0]) / float(len(dates))
+
+    if datetime_format is not None:
+        return datetime_format
+
+    # avgerage of 3 or more data points per day we will call intraday data:
+    if avg_days_between_points < 0.33:  # intraday
+        if mdates.num2date(dates[-1]).date() != mdates.num2date(dates[0]).date():
+            # intraday data for more than one day:
+            fmtstring = '%b %d, %H:%M'
+        else:  # intraday data for a single day
+            fmtstring = '%H:%M'
+    else:  # 'daily' data (or could be weekly, etc.)
+        if mdates.num2date(dates[-1]).date().year != mdates.num2date(dates[0]).date().year:
+           fmtstring = '%Y-%b-%d'
+        else:
+           fmtstring = '%b %d'
+    return fmtstring
+
+
+def _list_of_dict(x):
+    '''
+    Return True if x is a list of dict's
+    '''
+    return isinstance(x,list) and all([isinstance(item,dict) for item in x])
+
+def _num_or_seq_of_num(value):
+    return ( isinstance(value,(int,float,np.integer,np.floating))  or
+             (isinstance(value,(list,tuple,np.ndarray)) and
+             all([isinstance(v,(int,float,np.integer,np.floating)) for v in value]))
+           )
+
+def roundTime(dt=None, roundTo=60):
+   """Round a datetime object to any time lapse in seconds
+   dt : datetime.datetime object, default now.
+   roundTo : Closest number of seconds to round to, default 1 minute.
+   Author: Thierry Husson 2012 - Use it as you want but don't blame me.
+   """
+   if dt is None : dt = datetime.datetime.now()
+   seconds = (dt.replace(tzinfo=None) - dt.min).seconds
+   rounding = (seconds+roundTo/2) // roundTo * roundTo
+   return dt + datetime.timedelta(0,rounding-seconds,-dt.microsecond)
+
+
+def _is_uint8_rgb_or_rgba(tup):
+    """ Deterine if rgb or rgba is in (0-255) format:
+    Matplotlib expects rgb (and rgba) tuples to contain
+    three (or four) floats between 0.0 and 1.0 
+    
+    Some people express rgb as tuples of three integers
+    between 0 and 255.
+    (In rgba, alpha is still a float from 0.0 to 1.0)
+    """
+    if isinstance(tup,str):  return False
+    if not np.iterable(tup): return False
+    L = len(tup)
+    if L < 3 or L > 4: return False
+    if L == 4 and (tup[3] < 0 or tup[3] > 1): return False
+    return not any([not isinstance(v,(int,np.unsignedinteger)) or v<0 or v>255 for v in tup[0:3]])
+
+def _mpf_is_color_like(c):
+    """Determine if an object is a color.
+    
+    Identical to `matplotlib.colors.is_color_like()`
+    BUT ALSO considers int (0-255) rgb and rgba colors.
+    """
+    if mcolors.is_color_like(c): return True
+    return _is_uint8_rgb_or_rgba(c)
+    
+def _mpf_to_rgba(c, alpha=None):
+    cnew = c
+    if _is_uint8_rgb_or_rgba(c) and any(e>1 for e in c[:3]):
+        cnew = tuple([e/255. for e in c[:3]])
+        if len(c) == 4: cnew += c[3:]
+    return mcolors.to_rgba(cnew, alpha)
diff --git a/build/lib/mplfinance/_kwarg_help.py b/build/lib/mplfinance/_kwarg_help.py
new file mode 100644
index 00000000..c4ea52b5
--- /dev/null
+++ b/build/lib/mplfinance/_kwarg_help.py
@@ -0,0 +1,154 @@
+import mplfinance as mpf
+import pandas as pd
+import textwrap
+
+def df_wrapcols(df,wrap_columns=None):
+
+    if wrap_columns is None: return df
+    if not isinstance(wrap_columns,dict):
+        raise TypeError('wrap_columns must be a dict of column_names and wrap_lengths')
+
+    for col in wrap_columns:
+        if col not in df.columns:
+            raise ValueError('column "'+str(col)+'" not found in df.columns')
+
+    index = []
+    column_data = {}
+    for col in df.columns:
+        column_data[col] = []
+  
+    for ix in df.index:
+        row = df.loc[ix,]
+        
+        row_data = {}
+        for col in row.index:
+            cstr = str(row[col])
+            if col in wrap_columns:
+                wlen = wrap_columns[col]
+                tw   = textwrap.wrap(cstr,wlen) if not cstr.isspace() else [' ']
+            else:
+                tw = [cstr]
+            row_data[col] = tw
+
+        cmax = max(row_data,key=lambda k: len(row_data[k]))
+        rlen = len(row_data[cmax])
+        for r in range(rlen):
+            for col in row.index:
+                extension = [' ']*(rlen - len(row_data[col]))
+                row_data[col].extend(extension)
+                column_data[col].append(row_data[col][r])
+            ixstr = str(ix)+'.'+str(r) if r > 0 else str(ix)
+            index.append(ixstr)
+
+    return pd.DataFrame(column_data,index=index)
+
+def make_left_formatter(maxwidth):
+    wm3 = maxwidth-3
+    w   = maxwidth
+    def left_formatter(value):
+        if not isinstance(value,str):
+            return f'{value:<}'
+        elif value[0:maxwidth] == '-'*maxwidth:
+            return f'{value:<{w}.{w}s}'
+        elif len(value) > maxwidth:
+            return f'{value:<{wm3}.{wm3}s}...'
+        else:
+            return f'{value:<{w}.{w}s}'
+    return left_formatter
+
+
+def kwarg_help( func_name=None, kwarg_names=None, sort=False ):
+
+    func_kwarg_map = {
+        'plot'              : mpf.plotting._valid_plot_kwargs,
+        'make_addplot'      : mpf.plotting._valid_addplot_kwargs,
+        'make_marketcolors' : mpf._styles._valid_make_marketcolors_kwargs,
+        'make_mpf_style'    : mpf._styles._valid_make_mpf_style_kwargs,
+        'renko_params'      : mpf._utils._valid_renko_kwargs,
+        'pnf_params'        : mpf._utils._valid_pnf_kwargs,
+        'lines'             : mpf._utils._valid_lines_kwargs,
+        'scale_width_adjustment': mpf._widths._valid_scale_width_kwargs,
+        'update_width_config': mpf._widths._valid_update_width_kwargs,
+    }
+
+    func_kwarg_aliases = {
+        'addplot'           : mpf.plotting._valid_addplot_kwargs,
+        'marketcolors'      : mpf._styles._valid_make_marketcolors_kwargs,
+        'mpf_style'         : mpf._styles._valid_make_mpf_style_kwargs,
+        'style'             : mpf._styles._valid_make_mpf_style_kwargs,
+        'renko'             : mpf._utils._valid_renko_kwargs,
+        'pnf'               : mpf._utils._valid_pnf_kwargs,
+        'hlines'            : mpf._utils._valid_lines_kwargs,
+        'alines'            : mpf._utils._valid_lines_kwargs,
+        'tlines'            : mpf._utils._valid_lines_kwargs,
+        'vlines'            : mpf._utils._valid_lines_kwargs,
+    }
+
+    if func_name is None:
+        print('\nUsage: `kwarg_help(func_name)` or `kwarg_help(func_name,kwarg_names)`')
+        print('        kwarg_help is available for the following func_names:')
+        s = str(list(func_kwarg_map.keys()))
+        text = textwrap.wrap(s,68)
+        for t in text:
+            print('           ',t)
+        print()
+        return
+
+    fkmap = {**func_kwarg_map, **func_kwarg_aliases}
+           
+    if func_name not in fkmap:
+        raise ValueError('Function name "'+func_name+'" NOT a valid function name')
+
+    if kwarg_names is not None and isinstance(kwarg_names,str):
+        kwarg_names = [ kwarg_names, ]
+
+    if ( kwarg_names is not None 
+         and (not isinstance(kwarg_names,(list,tuple)) 
+              or not all([isinstance(k,str) for k in kwarg_names])
+             ) 
+       ):
+        raise ValueError('kwarg_names must be a sequence (list,tuple) of strings')
+
+    vks = fkmap[func_name]()
+
+    df = (pd.DataFrame(vks).T).drop('Validator',axis=1)
+    df.index.name = 'Kwarg'
+    if sort: df.sort_index(inplace=True)
+    df.reset_index(inplace=True)
+
+    if kwarg_names is not None:
+        for k in kwarg_names:
+            if k not in df['Kwarg'].values:
+                print('   Warning: "'+k+'" is not a valid `kwarg_name` for `func_name` "'+func_name,'"')
+        df = df[ df['Kwarg'].isin(kwarg_names) ]
+        if len(df) < 1:
+            raise ValueError(' None of specified `kwarg_names` are valid for `func_name` "'+func_name,'"')
+
+    df['Default'] = ["'"+d+"'" if isinstance(d,str) else str(d) for d in df['Default']]
+        
+    klen = df['Kwarg'].str.len().max()+1
+    dlen = df['Default'].str.len().max()+1
+
+    wraplen = max( 40, 80-(klen+dlen) )
+    df = df_wrapcols(df,wrap_columns={'Description':wraplen})
+
+    dividers = []
+    for col in df.columns:
+        dividers.append('-'*int(df[col].str.len().max()))
+    dfd = pd.DataFrame(dividers).T
+    dfd.columns = df.columns
+    dfd.index = pd.Index(['---'])
+
+    df = dfd.append(df)
+
+    formatters = { 'Kwarg'       : make_left_formatter( klen ),
+                   'Default'     : make_left_formatter( dlen ),
+                   'Description' : make_left_formatter( wraplen ),
+                 }
+    
+    print('\n ','-'*78)
+    print('  Kwargs for func_name "'+func_name+'":')
+
+    s = df.to_string(formatters=formatters,index=False,justify='left')
+
+    print('\n ',s.replace('\n','\n  '))
diff --git a/build/lib/mplfinance/_mpf_warnings.py b/build/lib/mplfinance/_mpf_warnings.py
new file mode 100644
index 00000000..dd687d02
--- /dev/null
+++ b/build/lib/mplfinance/_mpf_warnings.py
@@ -0,0 +1,16 @@
+import sys as __sys
+if not __sys.warnoptions:
+    import os as __os
+    import warnings as __warnings
+    __warnings.filterwarnings("default",category=DeprecationWarning,module='mplfinance') # Change the filter in this process
+    __os.environ["PYTHONWARNINGS"] = "default::DeprecationWarning:mplfinance"            # Also affect subprocesses
+
+if __sys.version_info <= (3, 6):
+    __warnings.filterwarnings("default",category=ImportWarning,module='mplfinance')   # Change the filter in this process
+    __os.environ["PYTHONWARNINGS"] = "default::ImportWarning:mplfinance"              # Also affect subprocesses
+    __warnings.warn('\n\n ================================================================= '+
+                    '\n\n    WARNING: `mplfinance` is NOT supported for Python versions '+
+                    '\n               less than 3.6'
+                    '\n\n ================================================================= ',
+                    category=ImportWarning)
+
diff --git a/build/lib/mplfinance/_mplrcputils.py b/build/lib/mplfinance/_mplrcputils.py
new file mode 100644
index 00000000..ec39a05c
--- /dev/null
+++ b/build/lib/mplfinance/_mplrcputils.py
@@ -0,0 +1,87 @@
+#!/usr/bin/env python
+"""
+rcparams utilities 
+"""
+
+import pandas as pd
+import matplotlib.pyplot as plt
+import sys
+
+__author__ = "Daniel Goldfarb"
+__version__ = "0.1.0"
+__license__ = "MIT"
+
+def rcParams_to_df(rcp,name=None):
+    keys = []
+    vals = []
+    for item in rcp:
+        keys.append(item)
+        vals.append(rcp[item])
+    df = pd.DataFrame(vals,index=pd.Index(keys,name='rcParamsKey'))    
+    if name is not None:
+        df.columns = [name]
+    else:
+        df.columns = ['Value']
+    return df
+
+def compare_styles(s1,s2):
+    with plt.rc_context():
+         plt.style.use('default')
+         plt.style.use(s1)
+         df1 = rcParams_to_df(plt.rcParams,name=s1)
+
+    with plt.rc_context():
+         plt.style.use('default')
+         plt.style.use(s2)
+         df2 = rcParams_to_df(plt.rcParams,name=s2)
+    
+    df  = pd.concat([df1,df2],axis=1)
+    dif = df[df[s1] != df[s2]].dropna(how='all')
+    return (dif,df,df1,df2)
+
+def main():
+    """ Main entry point of the app """
+    def usage():
+        print('\n    Usage: rcparams <command> <arguments> \n')
+        print('    Available commands: ')
+        print('        rcparams find <findstring>')
+        print('        rcparams compare <style1> <style2>')
+        print('')
+        exit(1)
+    commands = ('find','compare')
+
+    if len(sys.argv) < 3 :
+        print('\n    Too few arguments!')
+        usage()
+
+    command  = sys.argv[1]
+    if command not in commands:
+        print('\n    Unrecognized command \"'+command+'\"')
+        usage()
+
+    if command == 'find':
+        findstr = sys.argv[2]
+        df = rcParams_to_df(plt.rcParams)
+        if findstr == '--all':
+            for key in df.index:
+                print(key+':',df.loc[key,'Value'])
+        else:
+            print(df[df.index.str.contains(findstr)])
+
+    elif command == 'compare':
+        if len(sys.argv) < 4 :
+            print('\n    Need two styles to compare!')
+            usage()
+        style1 = sys.argv[2]
+        style2 = sys.argv[3]
+        dif,df,df1,df2 = compare_styles(style1,style2)
+        print('\n==== dif ====\n',dif)
+
+    else:
+        print('\n    Unrecognized command \"'+command+'\"')
+        usage()
+
+
+if __name__ == "__main__":
+    """ This is executed when run from the command line """
+    main()
diff --git a/build/lib/mplfinance/_mplwraps.py b/build/lib/mplfinance/_mplwraps.py
new file mode 100644
index 00000000..bad47fbb
--- /dev/null
+++ b/build/lib/mplfinance/_mplwraps.py
@@ -0,0 +1,121 @@
+import matplotlib.pyplot as plt
+import matplotlib.figure as mplfigure
+import matplotlib.axes   as mpl_axes
+from   mplfinance import _styles
+import numpy as np
+
+"""
+    This file contains:
+
+    (1) A wrapper of method `matplotlib.pyplot.figure()` that creates a 
+        `mplfinance.Mpf_Figure` which is derived from `matplotlib.figure.Figure`
+        The wrapper function is the same as `matplotlib.pyplot.figure()` except
+        that it additionally accepts kwarg `style=` to set the mplfinance style.
+
+    (2) Class `mplfinance.Mpf_Figure` derived from `matplotlib.figure.Figure`
+        which has the following overrides:
+        - Attribute `mpfstyle` indicating the mplfinance style used at Figure creation.
+        - Methods (listed below) which are identical to the same method in class
+          `matplotlib.figure.Figure` except that the `mplfinance.Mpf_Figure` versions:
+            - accept kwarg `style=` to set the mplfinance style of Subplot Axes, or
+            - if `style=` is not specified, then the attribute
+              `mplfinance.Mpf_Figure.mpfstyle` is used for the Subplot Axes style.
+          - Figure.add_subplot() 
+          - Figure.add_axes() 
+          - Figure.subplot()  (this is analogous to pyplot.subplot() which calls Figure.add_subplot())
+          - Figure.subplots() 
+
+     (3) A wrapper to matplot.pyplot.show(), because it happens often enough, when using mplfinance,
+         that sometimes one has to import matplotlib.pyplot *ONLY* for the purpose of calling .show()
+"""
+
+show = plt.show  # Not a true wrapper, rather an assignment.
+
+def _check_for_and_apply_style(kwargs):
+
+    if 'style' in kwargs:
+        style = kwargs['style']
+        del kwargs['style']
+    else:
+        style = 'default'
+
+    if not _styles._valid_mpf_style(style):
+        raise TypeError('Invalid mplfinance style')
+
+    if isinstance(style,str):
+        style = _styles._get_mpfstyle(style)
+
+    if isinstance(style,dict):
+        _styles._apply_mpfstyle(style)
+    else:
+        raise TypeError('style should be a `dict`; why is it not?')
+
+    return style
+
+
+def figure(*args,**kwargs):
+
+    style = _check_for_and_apply_style(kwargs)
+
+    f = plt.figure(FigureClass=Mpf_Figure,*args,**kwargs)
+    f.mpfstyle = style
+    return f
+
+
+class Mpf_Figure(mplfigure.Figure):
+
+    def add_subplot(self,*args,**kwargs):
+
+        if 'style' in kwargs or not hasattr(self,'mpfstyle'):
+            style = _check_for_and_apply_style(kwargs)
+        else:
+            style = _check_for_and_apply_style(dict(style=self.mpfstyle))
+
+        ax = mplfigure.Figure.add_subplot(self,*args,**kwargs)
+        ax.mpfstyle = style
+        return ax
+
+    def add_axes(self,*args,**kwargs):
+    
+        if 'style' in kwargs or not hasattr(self,'mpfstyle'):
+            style = _check_for_and_apply_style(kwargs)
+        else:
+            style = _check_for_and_apply_style(dict(style=self.mpfstyle))
+
+        ax = mplfigure.Figure.add_axes(self,*args,**kwargs)
+        ax.mpfstyle = style
+        return ax
+
+    def subplot(self,*args,**kwargs):
+    
+        plt.figure(self.number)  # make it the current Figure
+
+        if 'style' in kwargs or not hasattr(self,'mpfstyle'):
+            style = _check_for_and_apply_style(kwargs)
+        else:
+            style = _check_for_and_apply_style(dict(style=self.mpfstyle))
+
+        ax = plt.subplot(*args,**kwargs)
+        ax.mpfstyle = style
+        return ax
+
+
+    def subplots(self,*args,**kwargs):
+    
+        if 'style' in kwargs or not hasattr(self,'mpfstyle'):
+            style = _check_for_and_apply_style(kwargs)
+            self.mpfstyle = style
+        else:
+            style = _check_for_and_apply_style(dict(style=self.mpfstyle))
+    
+        axlist = mplfigure.Figure.subplots(self,*args,**kwargs)
+
+        if isinstance(axlist,mpl_axes.Axes):
+            axlist.mpfstyle = style
+        elif isinstance(axlist,np.ndarray):
+            for ax in axlist.flatten():
+                ax.mpfstyle = style
+        else:
+           raise TypeError('Unexpected type ('+str(type(axlist))+') '+
+                           'returned from "matplotlib.figure.Figure.subplots()"')
+        return axlist
diff --git a/build/lib/mplfinance/_panels.py b/build/lib/mplfinance/_panels.py
new file mode 100644
index 00000000..7d8524a2
--- /dev/null
+++ b/build/lib/mplfinance/_panels.py
@@ -0,0 +1,232 @@
+from mplfinance._helpers import _list_of_dict
+from mplfinance._arg_validators import _valid_panel_id
+import pandas as pd
+
+def _build_panels( figure, config ):
+    """
+    Create and return a DataFrame containing panel information
+    and Axes objects for each panel, etc.
+
+    We allow up to 32 panels, identified by their panel id (panid)
+    which is an integer 0 through 31.  
+
+    Parameters
+    ----------
+    figure       : pyplot.Figure
+        figure on which to create the Axes for the panels
+
+    config       : dict
+        config dict from `mplfinance.plot()`
+        
+    Config
+    ------
+    The following items are used from `config`:
+
+    num_panels   : integer (0-31) or None
+        number of panels to create
+
+    addplot      : dict or None
+        value for the `addplot=` kwarg passed into `mplfinance.plot()`
+
+    volume_panel : integer (0-31) or None
+        panel id (0-number_of_panels)
+
+    main_panel   : integer (0-31) or None
+        panel id (0-number_of_panels)
+
+    panel_ratios : sequence or None
+        sequence of relative sizes for the panels;
+
+        NOTE: If len(panel_ratios) == number of panels (regardless
+        of whether number of panels was specified or inferred),
+        then panel ratios are the relative sizes of each panel,
+        in panel id order, 0 through N (where N = number of panels).
+
+        If len(panel_ratios) != number of panels, then len(panel_ratios)
+        must equal 2, and panel_ratios[0] is the relative size for the 'main'
+        panel, and panel_ratios[1] is the relative size for all other panels.
+
+        If the number of panels == 1, the panel_ratios is ignored.
+
+    
+Returns
+    ----------
+    panels  : pandas.DataFrame
+        dataframe indexed by panel id (panid) and having the following columns:
+          axes           : tuple of matplotlib.Axes (primary and secondary) for each column.
+          used secondary : bool indicating whether or not the seconday Axes is in use.
+          relative size  : height of panel as proportion of sum of all relative sizes
+
+    """
+
+    num_panels   = config['num_panels']
+    addplot      = config['addplot']
+    volume       = config['volume']
+    volume_panel = config['volume_panel']
+    num_panels   = config['num_panels']
+    main_panel   = config['main_panel']
+    panel_ratios = config['panel_ratios']
+
+    if not _valid_panel_id(main_panel):
+        raise ValueError('main_panel id must be integer 0 to 31, but is '+str(main_panel))
+
+    if num_panels is None:  # then infer the number of panels:
+        pset = {0} # start with a set including only panel zero
+        if addplot is not None:
+            if isinstance(addplot,dict):
+                addplot = [addplot,]   # make list of dict to be consistent
+            elif not _list_of_dict(addplot):
+                raise TypeError('addplot must be `dict`, or `list of dict`, NOT '+str(type(addplot)))
+
+            backwards_panel_compatibility = {'main':0,'lower':1,'A':0,'B':1,'C':2}
+
+            for apdict in addplot:
+                panel = apdict['panel']
+                if panel in backwards_panel_compatibility:
+                    panel = backwards_panel_compatibility[panel]
+                if not _valid_panel_id(panel):
+                    raise ValueError('addplot panel must be integer 0 to 31, but is "'+str(panel)+'"')
+                pset.add(panel)
+
+        if volume is True:
+            if not _valid_panel_id(volume_panel):
+                raise ValueError('volume_panel must be integer 0 to 31, but is "'+str(volume_panel)+'"')
+            pset.add(volume_panel)
+
+        pset.add(main_panel)
+
+        pset = sorted(pset)
+        missing = [m for m in range(len(pset)) if m not in pset]
+        if len(missing) != 0:
+            raise ValueError('inferred panel list is missing panels: '+str(missing))
+
+    else:
+        if not isinstance(num_panels,int) or num_panels < 1 or num_panels > 32:
+            raise ValueError('num_panels must be integer 1 to 32, but is "'+str(volume_panel)+'"')
+        pset = range(0,num_panels)
+
+    _nones = [None]*len(pset)
+    panels = pd.DataFrame(dict(axes=_nones,
+                               relsize=_nones,
+                               lift=_nones,
+                               height=_nones,
+                               used2nd=[False]*len(pset),
+                               title=_nones,
+                               y_on_right=_nones),
+                          index=pset)
+    panels.index.name = 'panid'
+
+    # Now determine the height for each panel:
+    # ( figure, num_panels='infer', addplot=None, volume_panel=None, main_panel=0, panel_ratios=None ):
+
+    if panel_ratios is not None:
+        if not isinstance(panel_ratios,(list,tuple)):
+            raise TypeError('panel_ratios must be a list or tuple')
+        if len(panel_ratios) != len(panels) and not (len(panel_ratios)==2 and len(panels) > 2):
+            err  = 'len(panel_ratios) must be 2, or must be same as number of panels'
+            err += '\nlen(panel_ratios)='+str(len(panel_ratios))+'  num panels='+str(len(panels))
+            raise ValueError(err)
+        if len(panel_ratios) == 2 and len(panels) > 2:
+            pratios = [panel_ratios[1]]*len(panels)
+            pratios[main_panel] = panel_ratios[0]
+        else:
+            pratios = panel_ratios
+    else:
+        pratios = [2]*len(panels)
+        pratios[main_panel] = 5
+
+    panels['relsize'] = pratios
+    #print('len(panels)=',len(panels))
+    #print('len(pratios)=',len(pratios))
+
+    #print('pratios=')
+    #print(pratios)
+
+    #print('panels=')
+    #print(panels)
+
+    # TODO:  Throughout this section, right_pad is intentionally *less* 
+    #        than left_pad.  This assumes that the y-axis labels are on
+    #        the left, which is true for many mpf_styles, but *not* all.
+    #        Ideally need to determine which side has the axis labels.
+    #        And keep in mind, if secondary_y is in effect, then both
+    #        sides can have axis labels.
+
+    left_pad    = 0.18
+    right_pad   = 0.10
+    top_pad     = 0.12
+    bot_pad     = 0.18
+
+    scale_left = scale_right = scale_top = scale_bot = 1.0
+
+    scale_padding = config['scale_padding']
+    if isinstance(scale_padding,dict):
+        if 'left'   in scale_padding: scale_left  = scale_padding['left']
+        if 'right'  in scale_padding: scale_right = scale_padding['right']
+        if 'top'    in scale_padding: scale_top   = scale_padding['top']
+        if 'bottom' in scale_padding: scale_bot   = scale_padding['bottom']
+    else: # isinstance(scale_padding,(int,float):
+        scale_left = scale_right = scale_top = scale_bot = scale_padding
+        
+    if config['tight_layout']:
+        right_pad   *= 0.4
+        top_pad     *= 0.4
+        scale_left  *= 0.6
+        scale_right *= 0.6
+        scale_top   *= 0.6
+        scale_bot   *= 0.6
+
+    left_pad  *= scale_left
+    right_pad *= scale_right
+    top_pad   *= scale_top
+    bot_pad   *= scale_bot
+
+    plot_height = 1.0 - (bot_pad  + top_pad  )
+    plot_width  = 1.0 - (left_pad + right_pad)
+
+    #   print('scale_padding=',scale_padding)
+    #   print('left_pad =',left_pad)
+    #   print('right_pad=',right_pad)
+    #   print('top_pad  =',top_pad)
+    #   print('bot_pad  =',bot_pad)
+    #   print('plot_height =',plot_height)
+    #   print('plot_width  =',plot_width)
+        
+    psum = sum(pratios)
+    for panid,size in enumerate(pratios):
+        panels.at[panid,'height'] = plot_height * size / psum
+
+    # Now create the Axes:
+
+    for panid,row in panels.iterrows():
+        height = row.height
+        lift   = panels['height'].loc[panid+1:].sum()
+        panels.at[panid,'lift'] = lift
+        if panid == 0:
+            # rect = [left, bottom, width, height] 
+            ax0 = figure.add_axes( [left_pad, bot_pad+lift, plot_width, height] )
+        else:
+            ax0 = figure.add_axes( [left_pad, bot_pad+lift, plot_width, height], sharex=panels.at[0,'axes'][0] )
+        ax1 = ax0.twinx()
+        ax1.grid(False)
+        if config['saxbelow']:      # issue#115 issuecomment-639446764
+            ax0.set_axisbelow(True) # so grid does not show through plot data on any panel.
+        elif panid == volume_panel:
+            ax0.set_axisbelow(True) # so grid does not show through volume bars.
+        panels.at[panid,'axes'] = (ax0,ax1)
+
+    return panels
+    
+
+def _set_ticks_on_bottom_panel_only(panels,formatter,rotation=45):
+
+    bot = panels.index.values[-1]
+    ax  = panels.at[bot,'axes'][0]
+    ax.tick_params(axis='x',rotation=rotation)
+    ax.xaxis.set_major_formatter(formatter)
+
+    if len(panels) == 1: return
+
+    for panid in panels.index.values[::-1][1:]:
+        panels.at[panid,'axes'][0].tick_params(axis='x',labelbottom=False)
+
diff --git a/build/lib/mplfinance/_styledata/__init__.py b/build/lib/mplfinance/_styledata/__init__.py
new file mode 100644
index 00000000..0dcbf598
--- /dev/null
+++ b/build/lib/mplfinance/_styledata/__init__.py
@@ -0,0 +1,45 @@
+'''
+__init__ for mplfinance._styledata module
+'''
+
+from mplfinance._styledata import default
+from mplfinance._styledata import nightclouds
+from mplfinance._styledata import classic
+from mplfinance._styledata import mike
+from mplfinance._styledata import charles
+from mplfinance._styledata import blueskies
+from mplfinance._styledata import starsandstripes
+from mplfinance._styledata import sas
+from mplfinance._styledata import brasil
+from mplfinance._styledata import yahoo
+from mplfinance._styledata import checkers
+from mplfinance._styledata import binance
+from mplfinance._styledata import kenan
+from mplfinance._styledata import ibd
+
+_style_names = [n for n in dir() if not n.startswith('_')]
+
+_styles = {}
+for name in _style_names:
+    cmd = f'_styles.update({name} = {name}.style)'
+    eval(cmd)
+
+def _validate_style(style):
+    keys = ['base_mpl_style','marketcolors','mavcolors','y_on_right',
+            'gridcolor','gridstyle','facecolor','rc' ]
+    for key in keys:
+        if key not in style.keys():
+            err = f'Key "{key}" not found in style:\n\n    {style}'
+            raise ValueError(err)
+    
+    mktckeys = ['candle','edge','wick','ohlc','volume','alpha']
+    for key in mktckeys:
+        if key not in style['marketcolors'].keys():
+            err = f'Key "{key}" not found in marketcolors for style:\n\n    {style}'
+            raise ValueError(err)
+
+#print('type(_styles)=',type(_styles))
+#print('_styles=',_styles)
+for s in _styles.keys():
+    _validate_style(_styles[s])
+
diff --git a/build/lib/mplfinance/_styledata/binance.py b/build/lib/mplfinance/_styledata/binance.py
new file mode 100644
index 00000000..880096a8
--- /dev/null
+++ b/build/lib/mplfinance/_styledata/binance.py
@@ -0,0 +1,29 @@
+style = dict(style_name    = 'binance',
+             base_mpl_style= 'seaborn-darkgrid',
+             marketcolors  = {'candle'  : {'up':'#70a800', 'down':'#ea0070'},
+                              'edge'    : {'up':'#70a800', 'down':'#ea0070'},
+                              'wick'    : {'up':'#70a800', 'down':'#ea0070'},
+                              'ohlc'    : {'up':'#70a800', 'down':'#ea0070'},
+                              'volume'  : {'up':'#70a800', 'down':'#ea0070'},
+                              'vcedge'  : {'up':'#70a800', 'down':'#ea0070'},
+                              'vcdopcod': False,
+                              'alpha'   : 0.9,
+                             },
+             mavcolors     = ['#ffc201','#ff10ff','#cd0468','#1f77b4',
+                              '#ff7f0e','#2ca02c','#40e0d0'],
+             y_on_right    = False,
+             gridcolor     = '#d0d0d0',
+             gridstyle     = '--',
+             facecolor     = '#ffffff',
+             rc            = [ ('axes.edgecolor'  , '#e6e6e6' ),
+                               ('axes.linewidth'  ,  1.5      ),
+                               ('axes.labelsize'  , 'medium'  ),
+                               ('axes.labelweight', 'semibold'),
+                               ('lines.linewidth' ,  2.0      ),
+                               ('font.weight'     , 'medium'  ),
+                               ('font.size'       ,  12.0     ),
+                               ('figure.titlesize', 'x-large' ),
+                               ('figure.titleweight','semibold'),
+                             ],
+             base_mpf_style= 'binance'
+            )
diff --git a/build/lib/mplfinance/_styledata/blueskies.py b/build/lib/mplfinance/_styledata/blueskies.py
new file mode 100644
index 00000000..26985778
--- /dev/null
+++ b/build/lib/mplfinance/_styledata/blueskies.py
@@ -0,0 +1,23 @@
+style = dict(style_name    = 'blueskies',
+             base_mpl_style='fast', 
+             marketcolors  = {'candle'  : {'up':'w', 'down':'#0095ff'},
+                              'edge'    : {'up':'k', 'down':'#0095ff'},
+                              'wick'    : {'up':'k', 'down':'#0095ff'},
+                              'ohlc'    : {'up':'#0095ff', 'down':'#0095ff'},
+                              'volume'  : {'up':'w', 'down':'#0095ff'},
+                              'vcdopcod': False,
+                              'alpha'   : 1.0,
+                             },
+             mavcolors     = None,
+             y_on_right    = False,
+             facecolor     = '#dbf1ff',
+             gridcolor     = None,
+             gridstyle     = None,
+             rc            = [('patch.linewidth'      ,  1.0      ),
+                              ('patch.force_edgecolor', True      ),
+                              ('lines.linewidth'      ,  1.0      ),
+                              ('figure.titlesize'     , 'x-large' ),
+                              ('figure.titleweight'   , 'semibold'),
+                             ],
+             base_mpf_style='blueskies', 
+            )
diff --git a/build/lib/mplfinance/_styledata/brasil.py b/build/lib/mplfinance/_styledata/brasil.py
new file mode 100644
index 00000000..f3e73e75
--- /dev/null
+++ b/build/lib/mplfinance/_styledata/brasil.py
@@ -0,0 +1,25 @@
+style = {'base_mpl_style': 'fast',
+         'marketcolors': {'candle': {'up': '#fedf00', 'down': '#002776'},
+                          'edge'  : {'up': '#fedf00', 'down': '#002776'},
+                          'wick'  : {'up': '#fedf00', 'down': '#002776'},
+                          'ohlc'  : {'up': '#fedf00', 'down': '#002776'},
+                          'volume': {'up': '#fedf00', 'down': '#002776'},
+                          'vcedge': {'up': '#1f77b4', 'down': '#1f77b4'},
+                          'vcdopcod': False,
+                          'alpha': 0.9},
+         'mavcolors' : None,
+         'facecolor' : None,
+         'gridcolor' : None,
+         'gridstyle' : None,
+         'y_on_right': True,
+         'rc': {'axes.grid'     :  True,
+                'axes.grid.axis': 'y',
+                'grid.color'    : '#fedf00',
+                'grid.linestyle': '--',
+                'axes.facecolor': '#009b3a',
+                'axes.edgecolor': '#002776',
+                'figure.titlesize'  : 'x-large',
+                'figure.titleweight': 'semibold',
+               },
+         'base_mpf_style': 'brasil'
+        }
diff --git a/build/lib/mplfinance/_styledata/charles.py b/build/lib/mplfinance/_styledata/charles.py
new file mode 100644
index 00000000..0347a605
--- /dev/null
+++ b/build/lib/mplfinance/_styledata/charles.py
@@ -0,0 +1,30 @@
+style = dict(style_name    = 'charles',
+             base_mpl_style= 'fast', 
+             marketcolors  = {'candle'  : {'up':'#006340', 'down':'#a02128'},
+                              'edge'    : {'up':'#006340', 'down':'#a02128'},
+                              'wick'    : {'up':'#006340', 'down':'#a02128'},
+                              'ohlc'    : {'up':'#006340', 'down':'#a02128'},
+                              'volume'  : {'up':'#007a00', 'down':'#d50d18'},
+                              'vcdopcod': True, # Volume Color Depends On Price Change On Day
+                              'alpha'   : 1.0,
+                             },
+             mavcolors     = ['#ef5714','#ef5714','#9f4878','#9f4878'],
+             y_on_right    = True,
+             gridcolor     = '#a0a0a0',
+             gridstyle     = '--',
+             facecolor     = 'w',
+             rc            = [ ('axes.edgecolor'  , 'white'   ),
+                               ('axes.linewidth'  ,  1.5      ),
+                               ('axes.labelsize'  , 'large'   ),
+                               ('axes.labelweight', 'semibold'),
+                               ('axes.grid'       ,  True     ),
+                               ('axes.grid.axis'  ,  'y'      ),
+                               ('grid.linewidth'  ,  0.4      ),
+                               ('lines.linewidth' ,  2.0      ),
+                               ('font.weight'     , 'medium'  ),
+                               ('font.size'       ,  10.0     ),
+                               ('figure.titlesize', 'x-large' ),
+                               ('figure.titleweight','semibold'),
+                             ],
+             base_mpf_style= 'charles'
+            )
diff --git a/build/lib/mplfinance/_styledata/checkers.py b/build/lib/mplfinance/_styledata/checkers.py
new file mode 100644
index 00000000..f599758d
--- /dev/null
+++ b/build/lib/mplfinance/_styledata/checkers.py
@@ -0,0 +1,26 @@
+style = {'base_mpl_style': 'ggplot',
+         'marketcolors'  : {'candle': {'up': '#000000', 'down': '#ff0000'},
+                            'edge'  : {'up': '#000000', 'down': '#ff0000'},
+                            'wick'  : {'up': '#606060', 'down': '#606060'},
+                            'ohlc'  : {'up': '#000000', 'down': '#ff0000'},
+                            'volume': {'up': '#6f6f6f', 'down': '#ff4040'},
+                            'vcedge': {'up': '#1f77b4', 'down': '#1f77b4'},
+         'vcdopcod'      : False,
+         'alpha'         : 0.9},
+         'mavcolors'     : None,
+         'facecolor'     : 'w',
+         'gridcolor'     : '#c0c0c0',
+         'gridstyle'     : '-',
+         'y_on_right'    : True,
+         'rc'            : {'axes.grid.axis': 'both',
+                            'axes.grid'     : True,
+                            'axes.edgecolor': '#c0c0c0',
+                            'axes.labelcolor': 'k',
+                            'ytick.color'   : 'k',
+                            'xtick.color'   : 'k',
+                            'lines.markeredgecolor': 'k',
+                            'patch.force_edgecolor': True,
+                            'figure.titlesize'     : 'x-large',
+                            'figure.titleweight'   : 'semibold',
+                           },
+         'base_mpf_style': 'checkers'}
diff --git a/build/lib/mplfinance/_styledata/classic.py b/build/lib/mplfinance/_styledata/classic.py
new file mode 100644
index 00000000..0a2fe461
--- /dev/null
+++ b/build/lib/mplfinance/_styledata/classic.py
@@ -0,0 +1,28 @@
+style = dict(style_name    = 'classic',
+             base_mpl_style= 'fast', 
+             marketcolors  = {'candle'  : {'up':'w', 'down':'k'},
+                              'edge'    : {'up':'k', 'down':'k'},
+                              'wick'    : {'up':'k', 'down':'k'},
+                              'ohlc'    : {'up':'k', 'down':'k'},
+                              'volume'  : {'up':'#181818', 'down':'#181818'},
+                              'vcedge'  : {'up':'#181818', 'down':'#181818'},
+                              'vcdopcod': False, # Volume Color is Per Price Change On Day
+                              'alpha'   : 0.9,
+                             },
+             mavcolors     = ['#1a1a1a','#262626','#333333','#404040'],
+             y_on_right    = True,
+             gridcolor     = '#cccccc',
+             gridstyle     = '--',
+             facecolor     = 'w',
+             rc            = [ ('axes.edgecolor'  , 'black'   ),
+                               ('axes.linewidth'  ,  1.5      ),
+                               ('axes.labelsize'  , 'large'   ),
+                               ('axes.labelweight', 'semibold'),
+                               ('lines.linewidth' ,  2.0      ),
+                               ('font.weight'     , 'medium'  ),
+                               ('font.size'       ,  12.0     ),
+                               ('figure.titlesize', 'x-large' ),
+                               ('figure.titleweight','semibold'),
+                             ],
+             base_mpf_style= 'classic'
+            )
diff --git a/build/lib/mplfinance/_styledata/default.py b/build/lib/mplfinance/_styledata/default.py
new file mode 100644
index 00000000..7e2690ad
--- /dev/null
+++ b/build/lib/mplfinance/_styledata/default.py
@@ -0,0 +1,29 @@
+style = dict(style_name    = 'default',
+             base_mpl_style= 'seaborn-darkgrid', 
+             marketcolors  = {'candle'  : {'up':'w', 'down':'k'},
+                              'edge'    : {'up':'k', 'down':'k'},
+                              'wick'    : {'up':'k', 'down':'k'},
+                              'ohlc'    : {'up':'k', 'down':'k'},
+                              'volume'  : {'up':'#1f77b4', 'down':'#1f77b4'},
+                              'vcedge'  : {'up':'#1f77b4', 'down':'#1f77b4'},
+                              'vcdopcod': False, # Volume Color is Per Price Change On Day
+                              'alpha'   : 0.9,
+                             },
+             mavcolors     = ['#40e0d0','#ff00ff','#ffd700','#1f77b4',
+                              '#ff7f0e','#2ca02c','#e377c2'],
+             y_on_right    = False,
+             gridcolor     = None,
+             gridstyle     = None,
+             facecolor     = '#DCE3EF',
+             rc            = [ ('axes.edgecolor'  , 'black'   ),
+                               ('axes.linewidth'  ,  1.5      ),
+                               ('axes.labelsize'  , 'large'   ),
+                               ('axes.labelweight', 'semibold'),
+                               ('lines.linewidth' ,  2.0      ),
+                               ('font.weight'     , 'medium'  ),
+                               ('font.size'       ,  12.0     ),
+                               ('figure.titlesize', 'x-large' ),
+                               ('figure.titleweight','semibold'),
+                             ],
+             base_mpf_style= 'default'
+            )
diff --git a/build/lib/mplfinance/_styledata/ibd.py b/build/lib/mplfinance/_styledata/ibd.py
new file mode 100644
index 00000000..c233f885
--- /dev/null
+++ b/build/lib/mplfinance/_styledata/ibd.py
@@ -0,0 +1,38 @@
+style = dict(style_name    = 'ibd',
+             base_mpl_style= 'fast', 
+             marketcolors  = {'candle'  : {'up':'#2A3FE5', 'down':'#DB39AD'},
+                              'edge'    : {'up':'#2A3FE5', 'down':'#DB39AD'},
+                              'wick'    : {'up':'#2A3FE5', 'down':'#DB39AD'},
+                              'ohlc'    : {'up':'#2A3FE5', 'down':'#DB39AD'},
+                              'volume'  : {'up':'#2A3FE5', 'down':'#DB39AD'},
+                              'vcedge'  : {'up':'#2A3FE5', 'down':'#DB39AD'},
+                              'vcdopcod': True, # Volume Color is Per Price Change On Day
+                              'alpha'   : 1.0,
+                             },
+             mavcolors     = ['green','red','black','blue'],
+             y_on_right    = True,
+             gridcolor     = None,
+             gridstyle     = None,
+             facecolor     = None,
+             rc            =  [     ('axes.titlesize',      8),
+                                    ('axes.labelsize',      8) , 
+                                    ('lines.linewidth',     3),
+                                    ('lines.markersize',    4),
+                                    ('ytick.left',          False),
+                                    ('ytick.right',         True),
+                                    ('ytick.labelleft',     False),   
+                                    ('ytick.labelright',    True), 
+                                    ('xtick.labelsize',     6),
+                                    ('ytick.labelsize',     7),
+                                    ('axes.linewidth',      0.8),
+                                    ('grid.alpha',          0.2), 
+                                    ('axes.grid'       ,  True     ),
+                                    ('axes.grid.axis'  ,  'y'      ),  
+                                    ('grid.color'      , '#b0b0b0' ),
+                                    ('grid.linestyle'  , 'solid'      ),
+                                    ('grid.linewidth'  ,  0.8      ),
+                                    ('figure.titlesize', 'x-large' ),
+                                    ('figure.titleweight','semibold'),
+                              ],
+             base_mpf_style= 'ibd'
+            )
diff --git a/build/lib/mplfinance/_styledata/kenan.py b/build/lib/mplfinance/_styledata/kenan.py
new file mode 100644
index 00000000..98ed0620
--- /dev/null
+++ b/build/lib/mplfinance/_styledata/kenan.py
@@ -0,0 +1,33 @@
+style = {   'style_name': 'kenan',
+            'base_mpl_style': 'seaborn-darkgrid',
+            'marketcolors': {   'candle': {'up': 'k', 'down': 'r'},
+                                'edge': {'up': 'k', 'down': 'r'},
+                                'wick': {'up': 'k', 'down': 'r'},
+                                'ohlc': {'up': 'k', 'down': 'k'},
+                                'volume': {'up': '#1f77b4', 'down': '#1f77b4'},
+                                'vcedge': {'up': '#1f77b4', 'down': '#1f77b4'},
+                                'vcdopcod': False,
+                                'alpha': 0.9,
+                                'hollow': 'w'},
+            'mavcolors': [   '#40e0d0',
+                             '#ff00ff',
+                             '#ffd700',
+                             '#1f77b4',
+                             '#ff7f0e',
+                             '#2ca02c',
+                             '#e377c2'],
+            'y_on_right': False,
+            'gridcolor': None,
+            'gridstyle': None,
+            'facecolor': '#DCE3EF',
+            'rc': [   ('axes.edgecolor', 'black'),
+                      ('axes.linewidth', 1.5),
+                      ('axes.labelsize', 'large'),
+                      ('axes.labelweight', 'semibold'),
+                      ('lines.linewidth', 2.0),
+                      ('font.weight', 'medium'),
+                      ('font.size', 12.0),
+                      ('figure.titlesize', 'x-large' ),
+                      ('figure.titleweight','semibold'),
+                  ],
+            'base_mpf_style': 'default'}
diff --git a/build/lib/mplfinance/_styledata/mike.py b/build/lib/mplfinance/_styledata/mike.py
new file mode 100644
index 00000000..ef026e24
--- /dev/null
+++ b/build/lib/mplfinance/_styledata/mike.py
@@ -0,0 +1,36 @@
+style = dict(style_name    = 'mike',
+             base_mpl_style= 'dark_background', 
+             marketcolors  = {'candle'  : {'up':'#000000', 'down':'#0080ff'},
+                              'edge'    : {'up':'#ffffff', 'down':'#0080ff'},
+                              'wick'    : {'up':'#ffffff', 'down':'#ffffff'},
+                              'ohlc'    : {'up':'#ffffff', 'down':'#ffffff'},
+                              'volume'  : {'up':'#7189aa', 'down':'#7189aa'},
+                              'vcdopcod': False, # Volume Color Depends On Price Change On Day
+                              'alpha'   : 1.0,
+                             },
+             mavcolors     = ['#ec009c','#78ff8f','#fcf120'],
+             y_on_right    = True,
+             gridcolor     = None,
+             gridstyle     = None,
+             facecolor     = None,
+             rc            = [ ('axes.edgecolor'  , 'white'   ),
+                               ('axes.linewidth'  ,  1.5      ),
+                               ('axes.labelsize'  , 'large'   ),
+                               ('axes.labelweight', 'semibold'),
+                               ('axes.grid'       , True      ),
+                               ('axes.grid.axis'  , 'both'    ),
+                               ('axes.grid.which' , 'major'   ),
+                               ('grid.alpha'      ,  0.9      ),
+                               ('grid.color'      , '#b0b0b0' ),
+                               ('grid.linestyle'  , '--'      ),
+                               ('grid.linewidth'  ,  0.8      ),
+                               ('figure.facecolor', '#0a0a0a' ),
+                               ('patch.linewidth' ,  1.0      ),
+                               ('lines.linewidth' ,  1.0      ),
+                               ('font.weight'     , 'medium'  ),
+                               ('font.size'       ,  10.0     ),
+                               ('figure.titlesize', 'x-large' ),
+                               ('figure.titleweight','semibold'),
+                             ],
+             base_mpf_style= 'mike'
+            )
diff --git a/build/lib/mplfinance/_styledata/nightclouds.py b/build/lib/mplfinance/_styledata/nightclouds.py
new file mode 100644
index 00000000..2507d12e
--- /dev/null
+++ b/build/lib/mplfinance/_styledata/nightclouds.py
@@ -0,0 +1,23 @@
+style = dict(style_name    = 'nightclouds',
+             base_mpl_style='dark_background', 
+             marketcolors  = {'candle'  : {'up':'w', 'down':'#0095ff'},
+                              'edge'    : {'up':'w', 'down':'#0095ff'},
+                              'wick'    : {'up':'w', 'down':'w'},
+                              'ohlc'    : {'up':'w', 'down':'w'},
+                              'volume'  : {'up':'w', 'down':'#0095ff'},
+                              'vcdopcod': False,
+                              'alpha'   : 1.0,
+                             },
+             mavcolors     = ['#40e0d0','#ff00ff','#ffd700','#1f77b4',
+                              '#ff7f0e','#2ca02c','#e377c2'],
+             y_on_right    = False,
+             facecolor     = '#0b0b0b',
+             gridcolor     = '#999999',
+             gridstyle     = '--',
+             rc            = [('patch.linewidth' ,  1.0      ),
+                              ('lines.linewidth' ,  1.0      ),
+                              ('figure.titlesize', 'x-large' ),
+                              ('figure.titleweight','semibold'),
+                             ],
+             base_mpf_style='nightclouds', 
+            )
diff --git a/build/lib/mplfinance/_styledata/sas.py b/build/lib/mplfinance/_styledata/sas.py
new file mode 100644
index 00000000..e88e310a
--- /dev/null
+++ b/build/lib/mplfinance/_styledata/sas.py
@@ -0,0 +1,4 @@
+# style sas is just an abbreviation for starsandstripes:
+
+from mplfinance._styledata import starsandstripes
+style = starsandstripes.style
diff --git a/build/lib/mplfinance/_styledata/starsandstripes.py b/build/lib/mplfinance/_styledata/starsandstripes.py
new file mode 100644
index 00000000..09120cd6
--- /dev/null
+++ b/build/lib/mplfinance/_styledata/starsandstripes.py
@@ -0,0 +1,24 @@
+style = {'base_mpl_style': 'fast',
+         'marketcolors': {'candle': {'up': '#082865', 'down': '#ae0019'},
+                          'edge'  : {'up': '#082865', 'down': '#ae0019'},
+                          'wick'  : {'up': '#082865', 'down': '#ae0019'},
+                          'ohlc'  : {'up': '#082865', 'down': '#ae0019'},
+                          'volume': {'up': '#082865', 'down': '#ae0019'},
+                          'vcedge': {'up': '#1f77b4', 'down': '#1f77b4'},
+                          'vcdopcod': False,
+                          'alpha': 0.9},
+         'mavcolors': None,
+         'facecolor': None,
+         'gridcolor': None,
+         'gridstyle': None,
+         'y_on_right': True,
+         'rc': {'axes.edgecolor': '#082865',
+                'axes.grid'     :  True,
+                'axes.grid.axis': 'y',
+                'grid.color'    : '#082865',
+                'grid.linestyle': '--',
+                'figure.titlesize'  :'x-large',
+                'figure.titleweight':'semibold',
+               },
+         'base_mpf_style': 'starsandstripes'
+        }
diff --git a/build/lib/mplfinance/_styledata/yahoo.py b/build/lib/mplfinance/_styledata/yahoo.py
new file mode 100644
index 00000000..85f1c576
--- /dev/null
+++ b/build/lib/mplfinance/_styledata/yahoo.py
@@ -0,0 +1,23 @@
+style = {'base_mpl_style': 'fast',
+         'marketcolors'  : {'candle': {'up': '#00b060', 'down': '#fe3032'},
+                            'edge'  : {'up': '#00b060', 'down': '#fe3032'},
+                            'wick'  : {'up': '#606060', 'down': '#606060'},
+                            'ohlc'  : {'up': '#00b060', 'down': '#fe3032'},
+                            'volume': {'up': '#4dc790', 'down': '#fd6b6c'},
+                            'vcedge': {'up': '#1f77b4', 'down': '#1f77b4'},
+         'vcdopcod'      : True,
+         'alpha'         : 0.9},
+         'mavcolors'     : None,
+         'facecolor'     : '#fafafa',
+         'gridcolor'     : '#d0d0d0',
+         'gridstyle'     : '-',
+         'y_on_right'    : True,
+         'rc'            : {'axes.labelcolor': '#101010',
+                            'axes.edgecolor' : 'f0f0f0',
+                            'axes.grid.axis' : 'y',
+                            'ytick.color'    : '#101010',
+                            'xtick.color'    : '#101010',
+                            'figure.titlesize': 'x-large',
+                            'figure.titleweight':'semibold',
+                           },
+         'base_mpf_style': 'yahoo'}
diff --git a/build/lib/mplfinance/_styles.py b/build/lib/mplfinance/_styles.py
new file mode 100644
index 00000000..15d0538b
--- /dev/null
+++ b/build/lib/mplfinance/_styles.py
@@ -0,0 +1,382 @@
+import matplotlib.pyplot as plt
+import copy
+import pprint
+import os.path as path
+
+from   mplfinance._arg_validators import _process_kwargs, _validate_vkwargs_dict
+from   mplfinance._styledata      import _styles
+from   mplfinance._helpers        import _mpf_is_color_like
+
+
+def _get_mpfstyle(style):
+    ''' 
+    Return a copy of the specified pre-defined mpfstyle.  We return
+    a copy, because returning the original will effectively return 
+    a pointer which allows style's definition to be modified.
+    '''
+    return copy.deepcopy(_styles[style])
+
+def _apply_mpfstyle(style):
+
+    plt.style.use('default')
+
+    if style['base_mpl_style'] is not None:
+        plt.style.use(style['base_mpl_style']) 
+
+    if style['rc'] is not None:
+        plt.rcParams.update(style['rc'])
+
+    if style['facecolor'] is not None:
+        plt.rcParams.update({'axes.facecolor' : style['facecolor'] })
+
+    if 'edgecolor' in style and style['edgecolor'] is not None:
+        plt.rcParams.update({'axes.edgecolor' : style['edgecolor'] })
+
+    if 'figcolor' in style and style['figcolor'] is not None:
+        plt.rcParams.update({'figure.facecolor' : style['figcolor'] })
+        plt.rcParams.update({'savefig.facecolor': style['figcolor'] })
+
+    explicit_grid = False
+    if style['gridcolor'] is not None:
+        explicit_grid = True
+        plt.rcParams.update({'grid.color' : style['gridcolor'] })
+
+    if style['gridstyle'] is not None:
+        explicit_grid = True
+        plt.rcParams.update({'grid.linestyle' : style['gridstyle'] })
+
+    plt.rcParams.update({'axes.grid.axis' : 'both' })
+    if 'gridaxis' in style and style['gridaxis'] is not None:
+        gax = style['gridaxis']
+        explicit_grid = True
+        if gax == 'horizontal'[0:len(gax)]:
+            plt.rcParams.update({'axes.grid.axis' : 'y' })
+        elif gax == 'vertical'[0:len(gax)]:
+            plt.rcParams.update({'axes.grid.axis' : 'x' })
+
+    if explicit_grid:
+        plt.rcParams.update({'axes.grid' : True })
+
+
+def _valid_make_mpf_style_kwargs():
+    vkwargs = {
+        'base_mpf_style': { 'Default'     : None,
+                            'Description' : 'mplfinance style to use as base of new mplfinance style',
+                            'Validator'   : lambda value: value in _styles.keys() },
+
+        'base_mpl_style': { 'Default'     : None,
+                            'Description' : 'matplotlib style to use as base of new mplfinance style',
+                            'Validator'   : lambda value: isinstance(value,(str,list))}, # and is in plt.style.available
+
+        'marketcolors'  : { 'Default'     : None,
+                            'Description' : 'market colors object, from `mpf.make_market_colors()`',
+                            'Validator'   : lambda value: isinstance(value,dict)  },
+
+        'mavcolors'     : { 'Default'     : None,
+                            'Description' : 'sequence of colors to use for moving averages',
+                            'Validator'   : lambda value: isinstance(value,list) },  # TODO: all([_mpf_is_color_like(v) for v in value.values()])
+
+
+        'facecolor'     : { 'Default'     : None,
+                            'Description' : 'background color for Axes',
+                            'Validator'   : lambda value: isinstance(value,str) },
+
+        'edgecolor'     : { 'Default'     : None,
+                            'Description' : 'edge color for Axes',
+                            'Validator'   : lambda value: isinstance(value,str) },
+
+        'figcolor'      : { 'Default'     : None,
+                            'Description' : 'background color for Figure.',
+                            'Validator'   : lambda value: isinstance(value,str) },
+
+        'gridcolor'     : { 'Default'     : None,
+                            'Description' : 'color for grid lines',
+                            'Validator'   : lambda value: isinstance(value,str) },
+
+        'gridstyle'     : { 'Default'     : None,
+                            'Description' : "grid line style ('-', '--', '-.', ':', '', offset, on-off-seq)."+
+                                            " (see also: https://matplotlib.org/stable/gallery/lines_bars_and_markers/linestyles.html)",
+                            'Validator'   : lambda value: isinstance(value,str) },
+
+        'gridaxis'      : { 'Default'     : None,
+                            'Description' : "grid lines 'vertical', 'horizontal', or 'both'",
+                            'Validator'   : lambda value: value in [ 'vertical'[0:len(value)], 'horizontal'[0:len(value)], 'both'[0:len(value)] ] },
+
+        'y_on_right'    : { 'Default'     : None,
+                            'Description' : 'True|False primary Axes y-ticks and labels on right.',
+                            'Validator'   : lambda value: isinstance(value,bool) },
+
+        'rc'            : { 'Default'     : None,
+                            'Description' : 'rcparams overrides (dict) (all other rcparams unchanged)',
+                            'Validator'   : lambda value: isinstance(value,dict) },
+
+        'legacy_rc'     : { 'Default'     : None,  # Just in case someone depended upon old behavior
+                            'Description' : 'rcparams to set (dict) (all other rcparams cleared)',
+                            'Validator'   : lambda value: isinstance(value,dict) },
+
+        'style_name'    : { 'Default'     : None,
+                            'Description' : 'name for this style; useful when calling `mpf.write_style_file(style,filename)`',
+                            'Validator'   : lambda value: isinstance(value,str) },
+
+    }
+
+    _validate_vkwargs_dict(vkwargs)
+
+    return vkwargs
+
+
+def available_styles():
+    return list(_styles.keys())
+
+def make_mpf_style( **kwargs ):
+    config = _process_kwargs(kwargs, _valid_make_mpf_style_kwargs())
+    if config['rc'] is not None and config['legacy_rc'] is not None:
+        raise ValueError('kwargs `rc` and `legacy_rc` may NOT be used together!')
+
+    # -----------
+    # March 2021: Found bug that if caller used `base_mpf_style` and `rc` at
+    #   the same time, then the caller's `rc` will completely replace the `rc` 
+    #   of `base_mpf_style`.  That was never the intention!  Rather it should be
+    #   that the caller's `rc` merely adds to and/or modifies the `rc` of the
+    #   `base_mpf_style`.  In order to provide a path to "backwards compatibility"
+    #   for users who may have depended on the bug behavior (callers `rc` replaces
+    #   `rc` of `base_mpf_style`) we provide a new kwarg `legacy_rc` which will
+    #   now behave the way that `rc` used to behave.
+    # -----------
+
+    if config['base_mpf_style'] is not None:
+        style  = _get_mpfstyle(config['base_mpf_style'])
+        # Have to handle 'rc' separately, so we don't wipe 
+        # out the 'rc' params in the `base_mpf_style` that
+        # are not specified in the `make_mpf_style` config:
+        if config['rc'] is not None:
+            rc = config['rc']
+            del config['rc']
+            if isinstance(style['rc'],list):
+                style['rc'] = dict(style['rc'])
+            if style['rc'] is None:
+                style['rc'] = {}
+            style['rc'].update(rc)
+        elif config['legacy_rc'] is not None:
+            config['rc'] = config['legacy_rc']
+            del config['legacy_rc']
+        update = [ (k,v) for k,v in config.items() if v is not None ]
+        style.update(update)
+    else:
+        style  = config
+
+    if style['marketcolors'] is None:
+        style['marketcolors'] = _styles['default']['marketcolors']
+
+    return style
+
+def _valid_mpf_color_spec(value):
+    'value must be a color, "inherit"-like, or dict of colors'
+    return ( _mpf_is_color_like(value) or 
+             ( isinstance(value,str) and value == 'inherit'[0:len(value)]) or
+             ( isinstance(value,dict) and
+               all([_mpf_is_color_like(v) for v in value.values()])
+             )
+           )
+
+def _valid_mpf_style(value):
+    if value in available_styles():
+        return True
+    if not isinstance(value,dict):
+        return False
+    if 'marketcolors' not in value:
+        return False
+    if not isinstance(value['marketcolors'],dict):
+        return False
+    # {'candle': {'up': 'b', 'down': 'g'},
+    #  'edge': {'up': 'k', 'down': 'k'},
+    #  'wick': {'up': 'k', 'down': 'k'},
+    #  'ohlc': {'up': 'k', 'down': 'k'},
+    #  'volume': {'up': '#1f77b4', 'down': '#1f77b4'},
+    #  'vcedge': {'up': '#1f77b4', 'down': '#1f77b4'},
+    #  'vcdopcod': False,
+    #  'alpha': 0.9}
+    for item in ('candle','edge','wick','ohlc','volume'):
+        if item not in value['marketcolors']:
+            return False
+        itemcolors = value['marketcolors'][item]
+        if not isinstance(itemcolors,dict):
+            return False
+        if 'up' not in itemcolors or 'down' not in itemcolors:
+            return False
+    return True
+
+
+def _valid_make_marketcolors_kwargs():
+    vkwargs = {
+        'up'            : { 'Default'     : None,
+                            'Description' : 'color to indicate up', 
+                            'Validator'   : lambda value: _mpf_is_color_like(value) },
+
+        'down'          : { 'Default'     : None,
+                            'Description' : 'color to indicate down', 
+                            'Validator'   : lambda value: _mpf_is_color_like(value) },
+
+        'hollow'        : { 'Default'     : None,
+                            'Description' : "color for hollow candles (for `type=hollow`)",
+                            'Validator'   : lambda value: _mpf_is_color_like(value) },
+
+        'alpha'         : { 'Default'     : None,
+                            'Description' : 'opacity 0.0 (transparent) to 1.0 (opaque);'+
+                                            ' applies to candles,renko,pnf (but not ohlc bars)',
+                            'Validator'   : lambda value: (isinstance(value,float)
+                                                           and 0.0 <= value and 1.0 >= value ) },
+
+        'edge'          : { 'Default'     : None,
+                            'Description' : 'color of candle edge; may also be "i" or "inherit"'+
+                                            ' to take color from base_mpf_style',
+                            'Validator'   : lambda value: _valid_mpf_color_spec(value) },
+
+        'wick'          : { 'Default'     : None,
+                            'Description' : "color of candle wick; may be single color,"+
+                                            " or may be dict with keys 'up' and 'down'",
+                            'Validator'   : lambda value: isinstance(value,dict)
+                                                          or isinstance(value,str)
+                                                          or _mpf_is_color_like(value) },
+
+        'ohlc'          : { 'Default'     : None,
+			    'Description' : "color of ohlc bars; may be single color,"+
+					    " or may be dict with keys 'up' and 'down'",
+                            'Validator'   : lambda value: isinstance(value,dict)
+                                                          or isinstance(value,str)
+                                                          or _mpf_is_color_like(value) },
+
+        'volume'        : { 'Default'   : None,
+			    'Description' : "color of volume bars; may be single color,"+
+					    " or may be dict with keys 'up' and 'down'",
+                            'Validator'   : lambda value: isinstance(value,dict)
+                                                          or isinstance(value,str)
+                                                          or _mpf_is_color_like(value) },
+
+        'vcdopcod'      : { 'Default'     : False,
+                            'Description' : 'True/False volume color depends on price change from previous day',
+                            'Validator'   : lambda value: isinstance(value,bool) },
+
+
+        'inherit'       : { 'Default'     : False,
+                            'Description' : 'inherit color from base_mpf_style for: edge,volume,ohlc,wick',
+                            'Validator'   : lambda value: isinstance(value,bool) },
+
+        'base_mpf_style': { 'Default'     : None,
+                            'Description' : 'mplfinance style market colors as basis for new market colors object',
+                            'Validator'   : lambda value: isinstance(value,str) },
+    }
+
+    _validate_vkwargs_dict(vkwargs)
+
+    return vkwargs
+
+
+def make_marketcolors(**kwargs):
+    '''
+    Create a 'marketcolors' dict that is structured as expected
+    by mplfinance._styles code:
+        up     = color for close >= open
+        down   = color for close  < open
+        edge   = color for edge of candlestick; if "inherit"
+                 then edge color will be same as up or down.
+        wick   = color for wick of candlestick; if "inherit"
+                 then wick color will be same as up or down.
+        alpha  = opacity, 0.0 to 1.0, of candlestick face.
+        ohlc   = color of ohlc bars when all the same color;
+                 if ohlc == "inherit" then use up/down colors.
+        volume = color of volume bars when all the same color;
+                 if volume == "inherit" then use up/down colors.
+    '''
+
+    config = _process_kwargs(kwargs, _valid_make_marketcolors_kwargs())
+
+    if config['base_mpf_style'] is not None:
+        style = _get_mpfstyle(config['base_mpf_style'])
+    else:
+        style = _get_mpfstyle('default')
+
+    marketcolors = style['marketcolors']
+
+    up   = config['up']
+    down = config['down']
+    if up is not None and down is not None:
+        marketcolors.update(candle=dict(up=up,down=down))
+    elif up is not None:
+        candle = marketcolors['candle']
+        candle.update(up=up)
+        marketcolors.update(candle=candle)
+    elif down is not None:
+        candle = marketcolors['candle']
+        candle.update(down=down)
+        marketcolors.update(down=down)
+
+    def _check_and_set_mktcolor(candle,**kwarg):
+        if len(kwarg) != 1:
+            raise ValueError('Expect only ONE kwarg')
+        key,value = kwarg.popitem()
+        if isinstance(value,(dict)):
+            colors = value
+        elif isinstance(value,str) and value == 'inherit'[0:len(value)]:
+            colors = candle
+        else:
+            colors = dict(up=value, down=value)
+        for updown in ['up','down']:
+            if not _mpf_is_color_like(colors[updown]):
+                err = f'NOT is_color_like() for {key}[\'{updown}\'] = {colors[updown]}'
+                raise ValueError(err)
+        return colors
+
+    candle = marketcolors['candle']
+
+    for kw in ['edge','volume','ohlc','wick']:
+        # `inherit=True` takes precedence:
+        if config[kw] is not None or config['inherit'] == True:
+            if config['inherit'] == True:
+                kwa = {kw:'i'}
+            else:
+                kwa = {kw:config[kw]}
+            c   = _check_and_set_mktcolor(candle,**kwa)
+            marketcolors.update([(kw,c)])
+
+    if config['hollow'] is not None:
+        marketcolors.update({'hollow':config['hollow']})
+
+    if config['alpha'] is not None:
+        marketcolors.update({'alpha':config['alpha']})
+
+    if config['vcdopcod'] is not None:
+        marketcolors.update({'vcdopcod':config['vcdopcod']})
+
+    return marketcolors
+
+def write_style_file(style,filename):
+    pp   = pprint.PrettyPrinter(indent=4,sort_dicts=False,compact=True)
+    strl = pp.pformat(style).splitlines()
+
+    if not isinstance(style,dict):
+        raise TypeError('Specified style must be in `dict` format')
+
+    if path.exists(filename):
+        print('"'+filename+'" exists.') 
+        answer = input(' Overwrite(Y/N)? ')
+        a = answer.lower()
+        if a != 'y' and a != 'yes':
+            raise FileExistsError
+
+    f = open(filename,'w')
+    f.write('style = '+strl[0].replace('{','dict(',1).replace("'","",2).replace(':',' =',1)+'\n')
+    for line in strl[1:-1]:
+        if "'" in line[0:5]:
+            f.write('            '+line.replace("'","",2).replace(':',' =',1)+'\n')
+        else:
+            f.write('            '+line+'\n')
+    line = strl[-1]
+    if "'" in line[0:5]:
+        line = line.replace("'","",2).replace(':',' =',1)[::-1]
+    else:
+        line = line[::-1]
+    f.write('            '+line.replace('}',')',1)[::-1]+'\n')
+    f.close()
+    print('Wrote style file "'+filename+'"')
+    return
diff --git a/build/lib/mplfinance/_utils.py b/build/lib/mplfinance/_utils.py
new file mode 100644
index 00000000..a4f80dfc
--- /dev/null
+++ b/build/lib/mplfinance/_utils.py
@@ -0,0 +1,1515 @@
+"""
+A collection of utilities for analyzing and plotting financial data.
+"""
+
+import numpy  as np
+import pandas as pd
+import matplotlib.dates as mdates
+import datetime
+
+from itertools import cycle
+
+from matplotlib import colors as mcolors, pyplot as plt
+from matplotlib.patches     import Ellipse
+from matplotlib.collections import LineCollection, PolyCollection, PatchCollection
+
+from mplfinance._arg_validators import _process_kwargs, _validate_vkwargs_dict
+from mplfinance._arg_validators import _alines_validator, _bypass_kwarg_validation
+from mplfinance._arg_validators import _xlim_validator, _is_datelike
+from mplfinance._styles         import _get_mpfstyle
+from mplfinance._helpers        import _mpf_to_rgba
+
+from six.moves import zip
+
+def _check_input(opens, closes, highs, lows):
+    """Checks that *opens*, *highs*, *lows* and *closes* have the same length.
+    NOTE: this code assumes if any value open, high, low, close is
+    missing (*-1*) they all are missing
+
+    Parameters
+    ----------
+    opens : sequence
+        sequence of opening values
+    highs : sequence
+        sequence of high values
+    lows : sequence
+        sequence of low values
+    closes : sequence
+        sequence of closing values
+
+    Raises
+    ------
+    ValueError
+        if the input sequences don't have the same length
+        if the input sequences don't have NaN is same locations
+    """
+    same_length = len(opens) == len(highs) == len(lows) == len(closes)
+    if not same_length:
+        raise ValueError('O,H,L,C must have the same length!')
+
+    o = np.where(np.isnan(opens))[0]
+    h = np.where(np.isnan(highs))[0]
+    l = np.where(np.isnan(lows))[0]
+    c = np.where(np.isnan(closes))[0]
+
+    # First check that they have the same number of NaN:
+    same_numnans = len(o) == len(h) == len(l) == len(c)
+    if not same_numnans:
+        raise ValueError('O,H,L,C must have the same amount of missing data!')
+
+    same_missing = ((o == h).all() and
+                    (o == l).all() and
+                    (o == c).all()
+                   )
+    if not same_missing:
+        raise ValueError('O,H,L,C must have the same missing data!')
+
+
+def _check_and_convert_xlim_configuration(data, config):
+    '''
+    Check, if user entered `xlim` kwarg, if user entered dates
+    then we may need to convert them to iloc or matplotlib dates.
+    '''
+    if config['xlim'] is None:
+        return None
+
+    xlim = config['xlim']
+
+    if not _xlim_validator(xlim):
+        raise ValueError('Bad xlim configuration #1')
+
+    if all([_is_datelike(dt) for dt in xlim]):
+        if config['show_nontrading']:
+            xlim = [ _date_to_mdate(dt) for dt in xlim]
+        else:
+            xlim = [ _date_to_iloc_extrapolate(data.index.to_series(),dt) for dt in xlim]
+
+    return xlim
+
+
+def _construct_mpf_collections(ptype,dates,xdates,opens,highs,lows,closes,volumes,config,style):
+    collections = None
+    if ptype == 'candle' or ptype == 'candlestick':
+        collections = _construct_candlestick_collections(xdates, opens, highs, lows, closes,
+                                                         marketcolors=style['marketcolors'],config=config )
+
+    elif ptype =='hollow_and_filled':
+            collections = _construct_hollow_candlestick_collections(xdates, opens, highs, lows, closes,
+                                                         marketcolors=style['marketcolors'],config=config )
+
+    elif ptype == 'ohlc' or ptype == 'bars' or ptype == 'ohlc_bars':
+        collections = _construct_ohlc_collections(xdates, opens, highs, lows, closes,
+                                                  marketcolors=style['marketcolors'],config=config )
+    elif ptype == 'renko':
+        collections = _construct_renko_collections(
+            dates, highs, lows, volumes, config['renko_params'], closes, marketcolors=style['marketcolors'])
+
+    elif ptype == 'pnf':
+        collections = _construct_pointnfig_collections(
+            dates, highs, lows, volumes, config['pnf_params'], closes, marketcolors=style['marketcolors'])
+    else:
+        raise TypeError('Unknown ptype="',str(ptype),'"')
+
+    return collections
+
+
+def _calculate_atr(atr_length, highs, lows, closes):
+    """Calculate the average true range
+    atr_length : time period to calculate over
+    all_highs : list of highs
+    all_lows : list of lows
+    all_closes : list of closes
+    """
+    if atr_length < 1:
+        raise ValueError("Specified atr_length may not be less than 1")
+    elif atr_length >= len(closes):
+        raise ValueError("Specified atr_length is larger than the length of the dataset: " + str(len(closes)))
+    atr = 0
+    for i in range(len(highs)-atr_length, len(highs)):
+        high = highs[i]
+        low = lows[i]
+        close_prev = closes[i-1]
+        tr = max(abs(high-low), abs(high-close_prev), abs(low-close_prev))
+        atr += tr
+    return atr/atr_length
+
+def combine_adjacent(arr):
+    """Sum like signed adjacent elements
+    arr : starting array
+
+    Returns
+    -------
+    output: new summed array
+    indexes: indexes indicating the first
+             element summed for each group in arr
+    """
+    output, indexes = [], []
+    curr_i = 0
+    while len(arr) > 0:
+        curr_sign = arr[0]/abs(arr[0])
+        index = 0
+        while index < len(arr) and arr[index]/abs(arr[index]) == curr_sign:
+            index += 1
+        output.append(sum(arr[:index]))
+        indexes.append(curr_i)
+        curr_i += index
+
+        for _ in range(index):
+            arr.pop(0)
+    return output, indexes
+
+def coalesce_volume_dates(in_volumes, in_dates, indexes):
+    """Sums volumes between the indexes and ouputs
+    dates at the indexes
+    in_volumes : original volume list
+    in_dates : original dates list
+    indexes : list of indexes
+
+    Returns
+    -------
+    volumes: new volume array
+    dates: new dates array
+    """
+    volumes, dates = [], []
+    for i in range(len(indexes)):
+        dates.append(in_dates[indexes[i]])
+        to_sum_to = indexes[i+1] if i+1 < len(indexes) else len(in_volumes)
+        volumes.append(sum(in_volumes[indexes[i]:to_sum_to]))
+    return volumes, dates
+
+
+def _updown_colors(upcolor,downcolor,opens,closes,use_prev_close=False):
+    # -----------------------------------------------------
+    # Note that `nan` values result in `opn < cls` == False
+    # In other words, nans don't get plotted by collections
+    # but this function will choose DOWN COLOR for nans.
+    # -----------------------------------------------------
+    if upcolor == downcolor:
+        return [upcolor]*len(opens)
+    cmap = {True : upcolor, False : downcolor}
+    if not use_prev_close:
+        return [ cmap[opn < cls] for opn,cls in zip(opens,closes) ]
+    else:
+        first = cmap[opens[0] < closes[0]]
+        _list = [ cmap[pre < cls] for cls,pre in zip(closes[1:], closes) ]
+        return [first] + _list
+
+def _make_updown_color_list(key,marketcolors,opens,closes,overrides=None):
+    length = len(opens)
+    ups    = [marketcolors[key][ 'up' ]]*length
+    downs  = [marketcolors[key]['down']]*length
+    if overrides is not None:
+        for ix,mco in enumerate(overrides):
+            if mco is None: continue
+            if mcolors.is_color_like(mco):
+                ups[ix]   = mco
+                downs[ix] = mco
+            else: # assume it is correctly a marketcolors object (dict)
+                ups[ix]   = mco[key][ 'up' ]
+                downs[ix] = mco[key]['down']
+    return [ups[ix] if opens[ix] < closes[ix] else downs[ix] for ix in range(length)]
+
+
+def _updownhollow_colors(upcolor,downcolor,hollowcolor,opens,closes):
+    if upcolor == downcolor:
+        return upcolor
+    umap = {True : hollowcolor, False : upcolor  }
+    dmap = {True : hollowcolor, False : downcolor}
+    first = umap[closes[0] > opens[0]]
+    _list = [ umap[cls > opn] if cls > cls0 else dmap[cls > opn] for cls0,opn,cls in zip(closes[0:-1],opens[1:],closes[1:]) ]
+    return [first] + _list
+
+
+def _date_to_iloc(dtseries,date):
+    '''Convert a `date` to a location, given a date series w/a datetime index.
+       If `date` does not exactly match a date in the series then interpolate between two dates.
+       If `date` is outside the range of dates in the series, then raise an exception
+      .
+    '''
+    d1s = dtseries.loc[date:]
+    if len(d1s) < 1:
+        sdtrange = str(dtseries[0])+' to '+str(dtseries[-1])
+        raise ValueError('User specified line date "'+str(date)+'" is beyond (greater than) range of plotted data ('+sdtrange+').')
+    d1 = d1s.index[0]
+    d2s = dtseries.loc[:date]
+    if len(d2s) < 1:
+        sdtrange = str(dtseries[0])+' to '+str(dtseries[-1])
+        raise ValueError('User specified line date "'+str(date)+'" is before (less than) range of plotted data ('+sdtrange+').')
+    d2 = dtseries.loc[:date].index[-1]
+    # If there are duplicate dates in the series, for example in a renko plot
+    # then .get_loc(date) will return a slice containing all the dups, so:
+    loc1 = dtseries.index.get_loc(d1)
+    if isinstance(loc1,slice): loc1 = loc1.start
+    loc2 = dtseries.index.get_loc(d2)
+    if isinstance(loc2,slice): loc2 = loc2.stop - 1
+    return (loc1+loc2)/2.0
+
+def _date_to_iloc_linear(dtseries,date,trace=False):
+    '''Find the location of a date using linear extrapolation.
+       Use the endpoints of `dtseries` to calculate the slope
+       and yintercept for the line:
+           iloc = (slope)*(dtseries) + (yintercept)
+       Then use them to calculate the location of `date`
+    '''
+    d1 = _date_to_mdate(dtseries.index[0])
+    d2 = _date_to_mdate(dtseries.index[-1])
+
+    if trace: print('d1,d2=',d1,d2)
+    i1 = 0.0
+    i2 = len(dtseries) - 1.0
+    if trace: print('i1,i2=',i1,i2)
+
+    slope   = (i2 - i1) / (d2 - d1)
+    yitrcpt1 = i1 - (slope*d1)
+    if trace: print('slope,yitrcpt=',slope,yitrcpt1)
+    yitrcpt2 = i2 - (slope*d2)
+    if trace: print('slope,yitrcpt=',slope,yitrcpt2)
+    if yitrcpt1 != yitrcpt2:
+        print('WARNING: yintercepts NOT equal!!!(',yitrcpt1,yitrcpt2,')')
+        yitrcpt = (yitrcpt1 + yitrcpt2) / 2.0
+    else:
+        yitrcpt = yitrcpt1
+    return (slope * _date_to_mdate(date)) + yitrcpt
+
+def _date_to_iloc_5_7ths(dtseries,date,direction,trace=False):
+        first = _date_to_mdate(dtseries.index[0])
+        last  = _date_to_mdate(dtseries.index[-1])
+        avg_days_between_points = (last - first)/float(len(dtseries))
+        if avg_days_between_points < 0.33:  # intraday (not daily)
+            return None
+        if direction == 'forward':
+            delta       = _date_to_mdate(date) - _date_to_mdate(dtseries.index[-1])
+            loc_5_7ths  = len(dtseries) - 1 + (5/7.)*delta
+        elif direction == 'backward':
+            delta      = _date_to_mdate(dtseries.index[0]) - _date_to_mdate(date)
+            loc_5_7ths = - (5./7.)*delta
+        else:
+            raise ValueError('_date_to_iloc_5_7ths got BAD direction value='+str(direction))
+        return loc_5_7ths
+
+def _date_to_iloc_extrapolate(dtseries,date):
+    '''Convert a `date` to a location, given a date series w/a datetime index.
+       If `date` does not exactly match a date in the series then interpolate between two dates.
+       If `date` is outside the range of dates in the series, then extrapolate:
+       Extrapolation results in increased error as the distance of the extrapolation increases.
+       We have two methods to extrapolate:
+       (1) Determine a linear equation based on the data provided in `dtseries`,
+           and use that equation to calculate the location for the date.
+       (2) Multiply by 5/7 the number of days between the edge date of dtseries and the
+           date for which we are requesting a location.
+           THIS ASSUMES DAILY data AND a 5 DAY TRADING WEEK.
+       Empirical observation (scratch_pad/date_to_iloc_extrapolation.ipynb) shows that
+       the systematic error of these two methods tends to be in opposite directions:
+       taking the average of the two methods reduces systematic errorr: However,
+       since method (2) applies only to DAILY data, we take the average of the two
+       methods only for daily data.  For intraday data we use only method (1).
+    '''
+
+    d1s = dtseries.loc[date:]
+    if len(d1s) < 1:
+        # extrapolate forward:
+        loc_linear  = _date_to_iloc_linear(dtseries,date)
+        loc_5_7ths  = _date_to_iloc_5_7ths(dtseries,date,'forward')
+        if loc_5_7ths is not None:
+            return (loc_linear + loc_5_7ths)/2.0
+        else:
+            return loc_linear
+    d1 = d1s.index[0]
+    d2s = dtseries.loc[:date]
+    if len(d2s) < 1:
+        # extrapolate backward:
+        loc_linear = _date_to_iloc_linear(dtseries,date)
+        loc_5_7ths = _date_to_iloc_5_7ths(dtseries,date,'backward')
+        if loc_5_7ths is not None:
+            return (loc_linear + loc_5_7ths)/2.0
+        else:
+            return loc_linear
+    # Below here we *interpolate* (not extrapolate)
+    d2 = dtseries.loc[:date].index[-1]
+    # If there are duplicate dates in the series, for example in a renko plot
+    # then .get_loc(date) will return a slice containing all the dups, so:
+    loc1 = dtseries.index.get_loc(d1)
+    if isinstance(loc1,slice): loc1 = loc1.start
+    loc2 = dtseries.index.get_loc(d2)
+    if isinstance(loc2,slice): loc2 = loc2.stop - 1
+    return (loc1+loc2)/2.0
+
+
+def _date_to_mdate(date):
+    if isinstance(date,str):
+        pydt = pd.to_datetime(date).to_pydatetime()
+    elif isinstance(date,pd.Timestamp):
+        pydt = date.to_pydatetime()
+    elif isinstance(date,(datetime.datetime,datetime.date)):
+        pydt = date
+    else:
+        return None
+    return mdates.date2num(pydt)
+
+def _convert_segment_dates(segments,dtindex):
+    '''
+    Convert line segment dates to matplotlib dates
+    Inputted segment dates may be: pandas-parseable date-time string, pandas timestamp,
+                                   or a python datetime or date, or (if dtindex is not None) integer index
+    A "segment" is a "sequence of lines",
+        see: https://matplotlib.org/api/collections_api.html#matplotlib.collections.LineCollection
+    '''
+    #import pdb
+    #pdb.set_trace()
+    if dtindex is not None:
+        dtseries = dtindex.to_series()
+    converted = []
+    for line in segments:
+        new_line = []
+        for dt,value in line:
+            if dtindex is not None:
+                date = _date_to_iloc(dtseries,dt)
+            else:
+                date = _date_to_mdate(dt)
+            if date is None:
+                raise TypeError('NON-DATE in segment line='+str(line))
+            new_line.append((date,value))
+        converted.append(new_line)
+    return converted
+
+def _valid_renko_kwargs():
+    '''
+    Construct and return the "valid renko kwargs table" for the mplfinance.plot(type='renko')
+    function. A valid kwargs table is a `dict` of `dict`s. The keys of the outer dict are
+    the valid key-words for the function.  The value for each key is a dict containing 3
+    specific keys: "Default", "Description" and "Validator" with the following values:
+        "Default"      - The default value for the kwarg if none is specified.
+        "Description"  - The description for the kwarg.
+        "Validator"    - A function that takes the caller specified value for the kwarg,
+                         and validates that it is the correct type, and (for kwargs with
+                         a limited set of allowed values) may also validate that the
+                         kwarg value is one of the allowed values.
+    '''
+    vkwargs = {
+        'brick_size'  : { 'Default'     : 'atr',
+                          'Description' : 'size of each brick on y-axis (typically price).'+
+                                          ' specify a number, or specify "atr" for average true range.',
+                          'Validator'   : lambda value: isinstance(value,(float,int))
+                                                        or value == 'atr' },
+        'atr_length'  : { 'Default'     : 14,
+                          'Description' : 'number of periods for atr calculation (if brick size is "atr")',
+                          'Validator'   : lambda value: isinstance(value,int)
+                                                        or value == 'total' },
+    }
+
+    _validate_vkwargs_dict(vkwargs)
+
+    return vkwargs
+
+
+def _valid_pnf_kwargs():
+    '''
+    Construct and return the "valid pnf kwargs table" for the mplfinance.plot(type='pnf')
+    function. A valid kwargs table is a `dict` of `dict`s. The keys of the outer dict are
+    the valid key-words for the function.  The value for each key is a dict containing 3
+    specific keys: "Default", "Description" and "Validator" with the following values:
+        "Default"      - The default value for the kwarg if none is specified.
+        "Description"  - The description for the kwarg.
+        "Validator"    - A function that takes the caller specified value for the kwarg,
+                         and validates that it is the correct type, and (for kwargs with
+                         a limited set of allowed values) may also validate that the
+                         kwarg value is one of the allowed values.
+    '''
+    vkwargs = {
+        'box_size'    : { 'Default'     : 'atr',
+                          'Description' : 'size of each box on y-axis (typically price).'+
+                                          ' specify a number, or specify "atr" for average true range.',
+                          'Validator'   : lambda value: isinstance(value,(float,int))
+                                                        or value == 'atr' },
+        'atr_length'  : { 'Default'     : 14,
+                          'Description' : 'number of periods for atr calculation (if box size is "atr")',
+                          'Validator'   : lambda value: isinstance(value,int)
+                                                        or value == 'total' },
+
+        'reversal'    : { 'Default'     : 1,
+                          'Description' : 'number of boxes, in opposite direction, needed to reverse'+
+                                          ' a trend (i.e. to start a new column).',
+                          'Validator'   : lambda value: isinstance(value,int) },
+    }
+
+    _validate_vkwargs_dict(vkwargs)
+
+    return vkwargs
+
+
+def _valid_lines_kwargs():
+    '''
+    Construct and return the "valid lines (hlines,vlines,alines,tlines) kwargs table"
+    for the mplfinance.plot() `[h|v|a|t]lines=` kwarg functions.
+    A valid kwargs table is a `dict` of `dict`s. The keys of the outer dict are
+    the valid key-words for the function.  The value for each key is a dict containing 3
+    specific keys: "Default", "Description" and "Validator" with the following values:
+        "Default"      - The default value for the kwarg if none is specified.
+        "Description"  - The description for the kwarg.
+        "Validator"    - A function that takes the caller specified value for the kwarg,
+                         and validates that it is the correct type, and (for kwargs with
+                         a limited set of allowed values) may also validate that the
+                         kwarg value is one of the allowed values.
+    '''
+    valid_linestyles = ['-','solid','--','dashed','-.','dashdot',':','dotted',None,' ','']
+    vkwargs = {
+        'hlines'    : { 'Default'     : None,
+                        'Description' : 'Draw one or more HORIZONTAL LINES across entire plot, by'+
+                                        ' specifying a price, or sequence of prices.  May also be a dict'+
+                                        ' with key `hlines` specifying a price or sequence of prices, plus'+
+                                        ' one or more of the following keys: `colors`, `linestyle`,'+
+                                        ' `linewidths`, `alpha`.',
+                        'Validator'   : _bypass_kwarg_validation },
+
+        'vlines'    : { 'Default'     : None,
+                        'Description' : 'Draw one or more VERTICAL LINES across entire plot, by'+
+                                        ' specifying a date[time], or sequence of date[time].  May also'+
+                                        ' be a dict with key `vlines` specifying a date[time] or sequence'+
+                                        ' of date[time], plus one or more of the following keys:'+
+                                        ' `colors`, `linestyle`, `linewidths`, `alpha`.',
+                        'Validator'   : _bypass_kwarg_validation },
+
+        'alines'    : { 'Default'     : None,
+                        'Description' : 'Draw one or more ARBITRARY LINES anywhere on the plot, by'+
+                                        ' specifying a sequence of two or more date/price pairs, or by'+
+                                        ' specifying a sequence of sequences of two or more date/price pairs.'+
+                                        ' May also be a dict with key `alines` (as date/price pairs described above),'+
+                                        ' plus one or more of the following keys:'+
+                                        ' `colors`, `linestyle`, `linewidths`, `alpha`.',
+                        'Validator'   : _bypass_kwarg_validation },
+
+        'tlines'    : { 'Default'     : None,
+                        'Description' : 'Draw one or more TREND LINES by specifying one or more pairs of date[times]'+
+                                        ' between which each trend line should be drawn.  May also be a dict with key'+
+                                        ' `tlines` as just described, plus one or more of the following keys:'+
+                                        ' `colors`, `linestyle`, `linewidths`, `alpha`, `tline_use`,`tline_method`.',
+                        'Validator'   : _bypass_kwarg_validation },
+
+        'colors'    : { 'Default'     : None,
+                        'Description' : 'Color of [hvat]lines (or sequence of colors, if each line to be a different color)',
+                        'Validator'   : lambda value: value is None
+                                                      or mcolors.is_color_like(value)
+                                                      or (isinstance(value,(list,tuple))
+                                                          and all([mcolors.is_color_like(v) for v in value]) ) },
+
+        'linestyle' : { 'Default'     : '-',
+                        'Description' : 'line style of [hvat]lines (or sequence of line styles, if each line to have a different linestyle)',
+                        'Validator'   : lambda value: value is None or value in valid_linestyles or
+                                            all([v in valid_linestyles for v in value]) },
+
+        'linewidths': { 'Default'     : None,
+                        'Description' : 'line width of [hvat]lines (or sequence of line widths, if each line to have a different width)',
+                        'Validator'   : lambda value: value is None
+                                                      or isinstance(value,(float,int))
+                                                      or all([isinstance(v,(float,int)) for v in value]) },
+
+        'alpha': {'Default': 1.0,
+                  'Description': 'Opacity of [hvat]lines (or sequence of opacities,'
+                                 + 'if each line is to have a different opacity)'
+                                 + 'float from 0.0 to 1.0 ' + ' (1.0 means fully opaque; 0.0 means transparent.',
+                  'Validator': lambda value: isinstance(value, (float, int))
+                                             or all([isinstance(v, (float, int)) for v in value])},
+
+
+        'tline_use' : { 'Default'     : 'close',
+                        'Description' : 'value to use for TREND LINE ("open","high","low","close") or sequence of'+
+                                        ' any combination of "open", "high", "low", "close" to use a average of the'+
+                                        ' specified values to determine the trend line.',
+                        'Validator'   : lambda value: isinstance(value,str)
+                                                      or (isinstance(value,(list,tuple))
+                                                          and all([isinstance(v,str) for v in value]) ) },
+
+        'tline_method': { 'Default'     : 'point-to-point',
+                          'Description' : 'method for TREND LINE determination: "point-to-point" or "least-squares"',
+                          'Validator'   : lambda value: value in ['point-to-point','least-squares'] }
+    }
+
+    _validate_vkwargs_dict(vkwargs)
+
+    return vkwargs
+
+
+def _construct_ohlc_collections(dates, opens, highs, lows, closes, marketcolors=None, config=None):
+    """Represent the time, open, high, low, close as a vertical line
+    ranging from low to high.  The left tick is the open and the right
+    tick is the close.
+    *opens*, *highs*, *lows* and *closes* must have the same length.
+    NOTE: this code assumes if any value open, high, low, close is
+    missing (*-1*) they all are missing
+
+    Parameters
+    ----------
+    opens : sequence
+        sequence of opening values
+    highs : sequence
+        sequence of high values
+    lows : sequence
+        sequence of low values
+    closes : sequence
+        sequence of closing values
+    marketcolors : dict of colors: 'up', 'down'
+
+    Returns
+    -------
+    ret : list
+        a list or tuple of matplotlib collections to be added to the axes
+    """
+
+    _check_input(opens, highs, lows, closes)
+
+    if marketcolors is None:
+        mktcolors = _get_mpfstyle('classic')['marketcolors']['ohlc']
+    else:
+        mktcolors = marketcolors['ohlc']
+
+    rangeSegments = [((dt, low), (dt, high)) for dt, low, high in zip(dates, lows, highs)]
+
+    datalen = len(dates)
+
+    avg_dist_between_points = (dates[-1] - dates[0]) / float(datalen)
+
+    ticksize = config['_width_config']['ohlc_ticksize']
+
+    # the ticks will be from ticksize to 0 in points at the origin and
+    # we'll translate these to the date, open location
+    openSegments = [((dt-ticksize, op), (dt, op)) for dt, op in zip(dates, opens)]
+
+    # the ticks will be from 0 to ticksize in points at the origin and
+    # we'll translate these to the date, close location
+    closeSegments = [((dt, close), (dt+ticksize, close)) for dt, close in zip(dates, closes)]
+
+    if mktcolors['up'] == mktcolors['down'] and config['marketcolor_overrides'] is None:
+        colors = mktcolors['up']
+    else:
+        overrides = config['marketcolor_overrides']
+        colors    = _make_updown_color_list('ohlc',marketcolors,opens,closes,overrides)
+
+    lw = config['_width_config']['ohlc_linewidth']
+
+    rangeCollection = LineCollection(rangeSegments,
+                                     colors=colors,
+                                     linewidths=lw,
+                                     )
+
+    openCollection = LineCollection(openSegments,
+                                    colors=colors,
+                                    linewidths=lw,
+                                    )
+
+    closeCollection = LineCollection(closeSegments,
+                                     colors=colors,
+                                     linewidths=lw
+                                     )
+
+    return [rangeCollection, openCollection, closeCollection]
+
+
+def _construct_candlestick_collections(dates, opens, highs, lows, closes, marketcolors=None, config=None):
+    """Represent the open, close as a bar line and high low range as a
+    vertical line.
+
+    NOTE: this code assumes if any value open, low, high, close is
+    missing they all are missing
+
+
+    Parameters
+    ----------
+    opens : sequence
+        sequence of opening values
+    highs : sequence
+        sequence of high values
+    lows : sequence
+        sequence of low values
+    closes : sequence
+        sequence of closing values
+    marketcolors : dict of colors: up, down, edge, wick, alpha
+    alpha : float
+        bar transparency
+
+    Returns
+    -------
+    ret : list
+        (lineCollection, barCollection)
+    """
+
+    _check_input(opens, highs, lows, closes)
+
+    if marketcolors is None:
+        marketcolors = _get_mpfstyle('classic')['marketcolors']
+
+    datalen = len(dates)
+
+    avg_dist_between_points = (dates[-1] - dates[0]) / float(datalen)
+
+    delta = config['_width_config']['candle_width'] / 2.0
+
+    barVerts = [((date - delta, open),
+                 (date - delta, close),
+                 (date + delta, close),
+                 (date + delta, open))
+                for date, open, close in zip(dates, opens, closes)]
+
+    rangeSegLow   = [((date, low), (date, min(open,close)))
+                     for date, low, open, close in zip(dates, lows, opens, closes)]
+
+    rangeSegHigh  = [((date, high), (date, max(open,close)))
+                     for date, high, open, close in zip(dates, highs, opens, closes)]
+
+    rangeSegments = rangeSegLow + rangeSegHigh
+
+    alpha  = marketcolors['alpha']
+
+    overrides = config['marketcolor_overrides']
+    faceonly  = config['mco_faceonly']
+
+    colors    = _make_updown_color_list('candle',marketcolors,opens,closes,overrides)
+    colors    = [ _mpf_to_rgba(c,alpha) for c in colors ] # include alpha
+    if faceonly: overrides = None
+    edgecolor = _make_updown_color_list('edge',marketcolors,opens,closes,overrides)
+    wickcolor = _make_updown_color_list('wick',marketcolors,opens,closes,overrides)
+
+    lw = config['_width_config']['candle_linewidth']
+
+    rangeCollection = LineCollection(rangeSegments,
+                                     colors=wickcolor,
+                                     linewidths=lw,
+                                     )
+
+    barCollection = PolyCollection(barVerts,
+                                   facecolors=colors,
+                                   edgecolors=edgecolor,
+                                   linewidths=lw
+                                   )
+
+    return [rangeCollection, barCollection]
+
+
+def _construct_hollow_candlestick_collections(dates, opens, highs, lows, closes, marketcolors=None, config=None):
+    """Represent today's open to close as a "bar" line (candle body)
+    and high low range as a vertical line (candle wick)
+
+    If config['type']=='hollow_and_filled' (hollow and filled candles) then candle edge and
+    wick color depend on PREVIOUS close to today's close (up or down), and the center of the
+    candle body (hollow or filled) depends on the today's open to close (up or down).
+
+    NOTE: this code assumes if any value open, low, high, close is
+    missing they all are missing
+
+    Parameters
+    ----------
+    opens : sequence
+        sequence of opening values
+    highs : sequence
+        sequence of high values
+    lows : sequence
+        sequence of low values
+    closes : sequence
+        sequence of closing values
+    marketcolors : dict of colors: up, down, edge, wick, alpha
+    alpha : float
+        bar (candle body) transparency
+
+    Returns
+    -------
+    ret : list
+        (lineCollection, barCollection)
+    """
+
+    _check_input(opens, highs, lows, closes)
+
+    if marketcolors is None:
+        marketcolors = _get_mpfstyle('classic')['marketcolors']
+
+    datalen = len(dates)
+
+    avg_dist_between_points = (dates[-1] - dates[0]) / float(datalen)
+
+    delta = config['_width_config']['candle_width'] / 2.0
+
+    barVerts = [((date - delta, open),
+                 (date - delta, close),
+                 (date + delta, close),
+                 (date + delta, open))
+                for date, open, close in zip(dates, opens, closes)]
+
+    rangeSegLow   = [((date, low), (date, min(open,close)))
+                     for date, low, open, close in zip(dates, lows, opens, closes)]
+
+    rangeSegHigh  = [((date, high), (date, max(open,close)))
+                     for date, high, open, close in zip(dates, highs, opens, closes)]
+
+    rangeSegments = rangeSegLow + rangeSegHigh
+
+    alpha  = marketcolors['alpha']
+
+    uc     = mcolors.to_rgba(marketcolors['candle'][ 'up' ], alpha)
+    dc     = mcolors.to_rgba(marketcolors['candle']['down'], alpha)
+
+    hc = mcolors.to_rgba(marketcolors['hollow']) if 'hollow' in marketcolors else (0,0,0,0)
+
+    colors = _updownhollow_colors(uc, dc, hc, opens, closes)  # for candle body.
+
+    edgecolor = _updown_colors(uc, dc, opens, closes, use_prev_close=True)
+
+    wickcolor = _updown_colors(uc, dc, opens, closes, use_prev_close=True)
+
+    # For hollow candles, we scale the candle linewidth up a little:
+    lw = 1.25 * config['_width_config']['candle_linewidth']
+
+    rangeCollection = LineCollection(rangeSegments,
+                                     colors=wickcolor,
+                                     linewidths=lw,
+                                     )
+
+    barCollection = PolyCollection(barVerts,
+                                   facecolors=colors,
+                                   edgecolors=edgecolor,
+                                   linewidths=lw
+                                   )
+
+    return [rangeCollection, barCollection]
+
+
+def _construct_renko_collections(dates, highs, lows, volumes, config_renko_params, closes, marketcolors=None):
+    """Represent the price change with bricks
+
+    NOTE: this code assumes if any value open, low, high, close is
+    missing they all are missing
+
+    Algorithm Explanation
+    ---------------------
+    In the first part of the algorithm, we populate the cdiff array
+    along with adjusting the dates and volumes arrays into the new_dates and
+    new_volumes arrays. A single date includes a range from no bricks to many
+    bricks, if a date has no bricks it shall not be included in new_dates,
+    and if it has n bricks then it will be included n times. Volumes use a
+    volume cache to save volume amounts for dates that do not have any bricks
+    before adding the cache to the next date that has at least one brick.
+    We populate the cdiff array with each close values difference from the
+    previously created brick divided by the brick size.
+
+    In the second part of the algorithm, we iterate through the values in cdiff
+    and add 1s or -1s to the bricks array depending on whether the value is
+    positive or negative. Every time there is a trend change (ex. previous brick is
+    an upbrick, current brick is a down brick) we draw one less brick to account
+    for the price having to move the previous bricks amount before creating a
+    brick in the opposite direction.
+
+    In the final part of the algorithm, we enumerate through the bricks array and
+    assign up-colors or down-colors to the associated index in the color array and
+    populate the verts list with each bricks vertice to be used to create the matplotlib
+    PolyCollection.
+
+    Useful sources:
+    https://avilpage.com/2018/01/how-to-plot-renko-charts-with-python.html
+    https://school.stockcharts.com/doku.php?id=chart_analysis:renko
+
+    Parameters
+    ----------
+    dates : sequence
+        sequence of dates
+    highs : sequence
+        sequence of high values
+    lows : sequence
+        sequence of low values
+    config_renko_params : kwargs table (dictionary)
+        brick_size : size of each brick
+        atr_length : length of time used for calculating atr
+    closes : sequence
+        sequence of closing values
+    marketcolors : dict of colors: up, down, edge, wick, alpha
+
+    Returns
+    -------
+    ret : list
+        rectCollection
+    """
+    renko_params = _process_kwargs(config_renko_params, _valid_renko_kwargs())
+    if marketcolors is None:
+        marketcolors = _get_mpfstyle('classic')['marketcolors']
+
+    brick_size = renko_params['brick_size']
+    atr_length = renko_params['atr_length']
+
+
+    if brick_size == 'atr':
+        if atr_length == 'total':
+            brick_size = _calculate_atr(len(closes)-1, highs, lows, closes)
+        else:
+            brick_size = _calculate_atr(atr_length, highs, lows, closes)
+    else: # is an integer or float
+        upper_limit = (max(closes) - min(closes)) / 2
+        lower_limit = 0.01 * _calculate_atr(len(closes)-1, highs, lows, closes)
+        if brick_size > upper_limit:
+            raise ValueError("Specified brick_size may not be larger than (50% of the close price range of the dataset) which has value: "+ str(upper_limit))
+        elif brick_size < lower_limit:
+            raise ValueError("Specified brick_size may not be smaller than (0.01* the Average True Value of the dataset) which has value: "+ str(lower_limit))
+
+    alpha  = marketcolors['alpha']
+
+    uc     = mcolors.to_rgba(marketcolors['candle'][ 'up' ], alpha)
+    dc     = mcolors.to_rgba(marketcolors['candle']['down'], alpha)
+    euc    = mcolors.to_rgba(marketcolors['edge'][ 'up' ], 1.0)
+    edc    = mcolors.to_rgba(marketcolors['edge']['down'], 1.0)
+
+    cdiff = [] # holds the differences between each close and the previously created brick / the brick size
+    prev_close_brick = closes[0]
+    volume_cache = 0 # holds the volumes for the dates that were skipped
+    new_dates = [] # holds the dates corresponding with the index
+    new_volumes = [] # holds the volumes corresponding with the index.  If more than one index for the same day then they all have the same volume.
+
+    for i in range(len(closes)-1):
+        brick_diff = int((closes[i+1] - prev_close_brick) / brick_size)
+        if brick_diff == 0:
+            if volumes is not None:
+                volume_cache += volumes[i]
+            continue
+
+        cdiff.extend([int(brick_diff/abs(brick_diff))] * abs(brick_diff))
+        if volumes is not None:
+            new_volumes.extend([volumes[i] + volume_cache] * abs(brick_diff))
+            volume_cache = 0
+        new_dates.extend([dates[i]] * abs(brick_diff))
+        prev_close_brick += brick_diff *brick_size
+
+    bricks = [] # holds bricks, -1 for down bricks, 1 for up bricks
+    curr_price = closes[0]
+
+    last_diff_sign = 0 # direction the bricks were last going in -1 -> down, 1 -> up
+    dates_volumes_index = 0 # keeps track of the index of the current date/volume
+    for diff in cdiff:
+
+        curr_diff_sign = diff/abs(diff)
+        if last_diff_sign != 0 and curr_diff_sign != last_diff_sign:
+            last_diff_sign = curr_diff_sign
+            new_dates.pop(dates_volumes_index)
+            if volumes is not None:
+                if dates_volumes_index == len(new_volumes)-1:
+                    new_volumes[dates_volumes_index-1] += new_volumes[dates_volumes_index]
+                else:
+                    new_volumes[dates_volumes_index+1] += new_volumes[dates_volumes_index]
+                new_volumes.pop(dates_volumes_index)
+            continue
+        last_diff_sign = curr_diff_sign
+
+        if diff > 0:
+            bricks.extend([1]*abs(diff))
+        else:
+            bricks.extend([-1]*abs(diff))
+        dates_volumes_index += 1
+
+
+    verts = [] # holds the brick vertices
+    colors = [] # holds the facecolors for each brick
+    edge_colors = [] # holds the edgecolors for each brick
+    brick_values = [] # holds the brick values for each brick
+    for index, number in enumerate(bricks):
+        if number == 1: # up brick
+            colors.append(uc)
+            edge_colors.append(euc)
+        else: # down brick
+            colors.append(dc)
+            edge_colors.append(edc)
+
+        curr_price += (brick_size * number)
+        brick_values.append(curr_price)
+
+        x, y = index, curr_price
+
+        verts.append((
+            (x, y),
+            (x, y+brick_size),
+            (x+1, y+brick_size),
+            (x+1, y)))
+
+    useAA = 0,    # use tuple here
+    lw = None
+    rectCollection = PolyCollection(verts,
+                                    facecolors=colors,
+                                    antialiaseds=useAA,
+                                    edgecolors=edge_colors,
+                                    linewidths=lw
+                                    )
+    calculated_values = dict(dates=new_dates,volumes=new_volumes,
+                             values=brick_values,size=brick_size)
+    return [rectCollection,], calculated_values
+
+
+def _construct_pointnfig_collections(dates, highs, lows, volumes, config_pointnfig_params, closes, marketcolors=None):
+    """Represent the price change with Xs and Os
+
+    NOTE: this code assumes if any value open, low, high, close is
+    missing they all are missing
+
+    Algorithm Explanation
+    ---------------------
+    In the first part of the algorithm, we populate the boxes array
+    along with adjusting the dates and volumes arrays into the new_dates and
+    new_volumes arrays. A single date includes a range from no boxes to many
+    boxes, if a date has no boxes it shall not be included in new_dates,
+    and if it has n boxes then it will be included n times. Volumes use a
+    volume cache to save volume amounts for dates that do not have any boxes
+    before adding the cache to the next date that has at least one box.
+    We populate the boxes array with each close values difference from the
+    previously created brick divided by the box size.
+
+    The second part of the algorithm has a series of step. First we combine the
+    adjacent like signed values in the boxes array (ex. [-1, -2, 3, -4] -> [-3, 3, -4]).
+    Next we subtract 1 from the absolute value of each element in boxes except the
+    first to ensure every time there is a trend change (ex. previous box is
+    an X, current brick is a O) we draw one less box to account for the price
+    having to move the previous box's amount before creating a box in the
+    opposite direction. During this same step we also combine like signed elements
+    and associated volume/date data ignoring any zero values that are created by
+    subtracting 1 from the box value. Next we recreate the box array utilizing a
+    rolling_change and volume_cache to store and sum the changes that don't break
+    the reversal threshold.
+
+    Lastly, we enumerate through the boxes to populate the line_seg and circle_patches
+    arrays. line_seg holds the / and \ line segments that make up an X and
+    circle_patches holds matplotlib.patches Ellipse objects for each O. We start
+    by filling an x and y array each iteration which contain the x and y
+    coordinates for each box in the column. Then for each coordinate pair in
+    x, y we add to either the line_seg array or the circle_patches array
+    depending on the value of sign for the current column (1 indicates
+    line_seg, -1 indicates circle_patches). The height of the boxes take
+    into account padding which separates each box by a small margin in
+    order to increase readability.
+
+    Useful sources:
+    https://stackoverflow.com/questions/8750648/point-and-figure-chart-with-matplotlib
+    https://www.investopedia.com/articles/technical/03/081303.asp
+
+    Parameters
+    ----------
+    dates : sequence
+        sequence of dates
+    highs : sequence
+        sequence of high values
+    lows : sequence
+        sequence of low values
+    config_pointnfig_params : kwargs table (dictionary)
+        box_size : size of each box
+        atr_length : length of time used for calculating atr
+    closes : sequence
+        sequence of closing values
+    marketcolors : dict of colors: up, down, edge, wick, alpha
+
+    Returns
+    -------
+    ret : tuple
+        rectCollection
+    """
+    pointnfig_params = _process_kwargs(config_pointnfig_params, _valid_pnf_kwargs())
+    if marketcolors is None:
+        marketcolors = _get_mpfstyle('classic')['marketcolors']
+
+    box_size = pointnfig_params['box_size']
+    atr_length = pointnfig_params['atr_length']
+    reversal = pointnfig_params['reversal']
+
+    if box_size == 'atr':
+        if atr_length == 'total':
+            box_size = _calculate_atr(len(closes)-1, highs, lows, closes)
+        else:
+            box_size = _calculate_atr(atr_length, highs, lows, closes)
+    else: # is an integer or float
+        upper_limit = (max(closes) - min(closes)) / 2
+        lower_limit = 0.01 * _calculate_atr(len(closes)-1, highs, lows, closes)
+        if box_size > upper_limit:
+            raise ValueError("Specified box_size may not be larger than (50% of the close price range of the dataset) which has value: "+ str(upper_limit))
+        elif box_size < lower_limit:
+            raise ValueError("Specified box_size may not be smaller than (0.01* the Average True Value of the dataset) which has value: "+ str(lower_limit))
+
+    if reversal < 1 or reversal > 9:
+        raise ValueError("Specified reversal must be an integer in the range [1,9]")
+
+    alpha  = marketcolors['alpha']
+
+    uc     = mcolors.to_rgba(marketcolors['ohlc'][ 'up' ], alpha)
+    dc     = mcolors.to_rgba(marketcolors['ohlc']['down'], alpha)
+    tfc    = mcolors.to_rgba(marketcolors['edge']['down'], 0) # transparent face color
+
+    boxes = [] # each element in an integer representing the number of boxes to be drawn on that indexes column (negative numbers -> Os, positive numbers -> Xs)
+    prev_close_box = closes[0] # represents the value of the last box in the previous column
+    volume_cache = 0 # holds the volumes for the dates that were skipped
+    temp_volumes, temp_dates = [], [] # holds the temp adjusted volumes and dates respectively
+
+    for i in range(len(closes)-1):
+        box_diff = int((closes[i+1] - prev_close_box) / box_size)
+        if box_diff == 0:
+            if volumes is not None:
+                volume_cache += volumes[i]
+            continue
+
+        boxes.append(box_diff)
+        if volumes is not None:
+            temp_volumes.append(volumes[i] + volume_cache)
+            volume_cache = 0
+        temp_dates.append(dates[i])
+        prev_close_box += box_diff *box_size
+
+    # combine adjacent similarly signed differences
+    boxes, indexes = combine_adjacent(boxes)
+    new_volumes, new_dates = coalesce_volume_dates(temp_volumes, temp_dates, indexes)
+
+    adjusted_boxes = [boxes[0]]
+    temp_volumes, temp_dates = [new_volumes[0]], [new_dates[0]]
+    volume_cache = 0
+
+    # Clean data to subtract 1 from all box # not including the first boxes element and combine like signed adjacent values (after ignoring zeros)
+    for i in range(1, len(boxes)):
+        adjusted_value = boxes[i]- int((boxes[i]/abs(boxes[i])))
+
+        # not equal to 0 and different signs
+        if adjusted_value != 0 and adjusted_boxes[-1]*adjusted_value < 0:
+
+            # Append adjusted_value, volumes, and date to associated lists
+            adjusted_boxes.append(adjusted_value)
+            temp_volumes.append(new_volumes[i] + volume_cache)
+            temp_dates.append(new_dates[i])
+
+            # reset volume_cache once we use it
+            volume_cache = 0
+
+        # not equal to 0 and same signs
+        elif adjusted_value != 0 and adjusted_boxes[-1]*adjusted_value > 0:
+
+            # Add adjusted_value and volume values to last added elements
+            adjusted_boxes[-1] += adjusted_value
+            temp_volumes[-1] += new_volumes[i] + volume_cache
+
+            # reset volume_cache once we use it
+            volume_cache = 0
+
+        else: # adjusted_value == 0
+            volume_cache += new_volumes[i]
+
+    boxes = [adjusted_boxes[0]]
+    new_volumes = [temp_volumes[0]]
+    new_dates = [temp_dates[0]]
+
+    rolling_change = 0
+    volume_cache = 0
+    biggest_difference = 0 # only used for the last column
+
+    #Clean data to account for reversal size (added to allow overriding the default reversal of 1)
+    for i in range(1, len(adjusted_boxes)):
+
+        # Add to rolling_change and volume_cache which stores the box and volume values
+        rolling_change += adjusted_boxes[i]
+        volume_cache += temp_volumes[i]
+
+        # if rolling_change is the same sign as the previous box and the abs value is bigger than the
+        # abs value of biggest_difference then we should replace biggest_difference with rolling_change
+        if rolling_change*boxes[-1] > 0 and abs(rolling_change) > abs(biggest_difference):
+            biggest_difference = rolling_change
+
+        # Add to new list if the rolling change is >= the reversal
+        if abs(rolling_change) >= reversal:
+
+            # if rolling_change is the same sign as the previous # of boxes then combine
+            if rolling_change*boxes[-1] > 0:
+                boxes[-1] += rolling_change
+                new_volumes[-1] += volume_cache
+
+            # otherwise add new box
+            else: # < 0 (== 0 can't happen since neither rolling_change or boxes[-1] can be 0)
+                boxes.append(rolling_change)
+                new_volumes.append(volume_cache)
+                new_dates.append(temp_dates[i])
+
+            # reset rolling_change and volume_cache once we've used them
+            rolling_change = 0
+            volume_cache = 0
+
+            # reset biggest_difference as we start from the beginning every time there is a reversal
+            biggest_difference = 0
+
+    # Adjust the last box column if the left over rolling_change is the same sign as the column
+    boxes[-1] += biggest_difference
+    new_volumes[-1] += volume_cache
+
+    curr_price = closes[0]
+    box_values = [] # y values for the boxes
+    circle_patches = [] # list of circle patches to be used to create the cirCollection
+    line_seg = [] # line segments that make up the Xs
+
+    for index, difference in enumerate(boxes):
+        diff = abs(difference)
+
+        sign = (difference / abs(difference)) # -1 or 1
+        start_iteration = 0 if sign > 0 else 1
+
+        x = [index] * (diff)
+        y = [curr_price + (i * box_size * sign) for i in range(start_iteration, diff+start_iteration)]
+
+        curr_price += (box_size * sign * (diff))
+        box_values.append( y )
+
+        for i in range(len(x)): # x and y have the same length
+            height = box_size * 0.85
+            width = 0.6
+            if height < 0.5:
+                width = height
+
+            padding = (box_size * 0.075)
+            if sign == 1: # X
+                line_seg.append([(x[i]-width/2, y[i] + padding), (x[i]+width/2, y[i]+height + padding)]) # create / part of the X
+                line_seg.append([(x[i]-width/2, y[i]+height+padding), (x[i]+width/2, y[i]+padding)]) # create \ part of the X
+            else: # O
+                circle_patches.append(Ellipse((x[i], y[i]-(height/2) - padding), width, height))
+
+    useAA = 0,    # use tuple here
+    lw = 0.5
+
+    cirCollection = PatchCollection(circle_patches)
+    cirCollection.set_facecolor([tfc] * len(circle_patches))
+    cirCollection.set_edgecolor([dc] * len(circle_patches))
+
+    xCollection = LineCollection(line_seg,
+                                 colors=[uc] * len(line_seg),
+                                 linewidths=lw,
+                                 antialiaseds=useAA
+                                 )
+    calculated_values = dict(dates=new_dates,counts=boxes,values=box_values,
+                             volumes=new_volumes,size=box_size)
+    return [cirCollection, xCollection], calculated_values
+
+
+def _construct_aline_collections(alines, dtix=None):
+    """construct arbitrary line collections
+
+    Parameters
+    ----------
+    alines : sequence
+        sequences of segments, which are sequences of lines,
+        which are sequences of two or more points ( date[time], price ) or (x,y)
+
+        date[time] may be (a) pandas.to_datetime parseable string,
+                          (b) pandas Timestamp, or
+                          (c) python datetime.datetime or datetime.date
+
+    alines may also be a dict, containing
+    the following keys:
+
+        'alines'     : the same as defined above: sequence of price, or dates, or segments
+        'colors'     : colors for the above alines
+        'linestyle'  : line types for the above alines
+        'linewidths' : line widths for the above alines
+
+    dtix:  date index for the x-axis, used for converting the dates when
+           x-values are 'evenly spaced integers' (as when skipping non-trading days)
+
+    Returns
+    -------
+    ret : list
+        lines collections
+    """
+    if alines is None:
+        return None
+
+    if isinstance(alines,dict):
+        aconfig = _process_kwargs(alines, _valid_lines_kwargs())
+        alines = aconfig['alines']
+    else:
+        aconfig = _process_kwargs({}, _valid_lines_kwargs())
+
+    alines = _alines_validator(alines, returnStandardizedValue=True)
+    if alines is None:
+        raise ValueError('Unable to standardize alines value: '+str(alines))
+
+    alines = _convert_segment_dates(alines,dtix)
+
+    lw = aconfig['linewidths']
+    co = aconfig['colors']
+    ls = aconfig['linestyle']
+    al = aconfig['alpha']
+    lcollection = LineCollection(alines,colors=co,linewidths=lw,linestyles=ls,antialiaseds=(0,),alpha=al)
+    return lcollection
+
+
+def _construct_hline_collections(hlines,minx,maxx):
+    """Construct horizontal lines collection
+
+    Parameters
+    ----------
+    hlines : sequence
+        sequence of [price] values at which to draw horizontal lines
+
+    hlines may also be a dict, containing
+    the following keys:
+
+        'hlines'     : the same as defined above: sequence of price, or dates, or segments
+        'colors'     : colors for the above hlines
+        'linestyle'  : line types for the above hlines
+        'linewidths' : line widths for the above hlines
+
+    minx : the minimum value for x for the horizontal line, already converted to `xdates` format
+    maxx : the maximum value for x for the horizontal line, already converted to `xdates` format
+
+    Returns
+    -------
+    ret : list
+        lines collections
+    """
+
+    if hlines is None:
+        return None
+
+    #print('_construct_hline_collections() called:',
+    #      '\nhlines=',hlines,'\nminx,maxx=',minx,maxx)
+
+    # hlines do NOT require converting segment dates, because the dates
+    # are not user-specified, but are from already converted minxdt,maxxdt
+
+    if isinstance(hlines,dict):
+        hconfig = _process_kwargs(hlines, _valid_lines_kwargs())
+        hlines = hconfig['hlines']
+    else:
+        hconfig = _process_kwargs({}, _valid_lines_kwargs())
+
+    #print('hconfig=',hconfig)
+    #print('hlines=',hlines)
+
+    lines = []
+    if not isinstance(hlines,(list,tuple)):
+        hlines = [hlines,] # may be a single price value
+
+    for val in hlines:
+        lines.append( [(minx,val),(maxx,val)] )
+
+    lw = hconfig['linewidths']
+    co = hconfig['colors']
+    ls = hconfig['linestyle']
+    al = hconfig['alpha']
+    lcollection = LineCollection(lines,colors=co,linewidths=lw,linestyles=ls,antialiaseds=(0,),alpha=al)
+    return lcollection
+
+
+def _construct_vline_collections(vlines,dtix,miny,maxy):
+    """Construct vertical lines collection
+    Parameters
+    ----------
+    vlines : sequence
+        sequence of dates or datetimes at which to draw vertical lines
+        dates/datetimes may be (a) pandas.to_datetime parseable string,
+                               (b) pandas Timestamp
+                               (c) python datetime.datetime or datetime.date
+
+    vlines may also be a dict, containing
+    the following keys:
+
+        'vlines'     : the same as defined above: sequence of dates/datetimes
+        'colors'     : colors for the above vlines
+        'linestyle'  : line types for the above vlines
+        'linewidths' : line widths for the above vlines
+
+    dtix:  date index for the x-axis, used for converting the dates when
+           x-values are 'evenly spaced integers' (as when skipping non-trading days)
+
+    miny : minimum y-value for the vertical line
+
+    maxy : maximum y-value for the vertical line
+
+    Returns
+    -------
+    ret : list
+        lines collections
+    """
+
+    if vlines is None:
+        return None
+
+    #print('_construct_vline_collections() called:',
+    #      '\nvlines=',vlines,
+    #      '\ndtix=',dtix)
+    #print('miny,maxy=',miny,maxy)
+
+    if isinstance(vlines,dict):
+        vconfig = _process_kwargs(vlines, _valid_lines_kwargs())
+        vlines = vconfig['vlines']
+    else:
+        vconfig = _process_kwargs({}, _valid_lines_kwargs())
+
+    #print('vconfig=',vconfig)
+    #print('vlines=',vlines)
+
+    if not isinstance(vlines,(list,tuple)):
+        vlines = [vlines,]
+
+    lines = []
+    for val in vlines:
+        lines.append( [(val,miny),(val,maxy)] )
+
+    lines = _convert_segment_dates(lines,dtix)
+
+    lw = vconfig['linewidths']
+    co = vconfig['colors']
+    ls = vconfig['linestyle']
+    al = vconfig['alpha']
+    lcollection = LineCollection(lines,colors=co,linewidths=lw,linestyles=ls,antialiaseds=(0,),alpha=al)
+    return lcollection
+
+def _construct_tline_collections(tlines, dtix, dates, opens, highs, lows, closes):
+    """construct trend line collections
+
+    Parameters
+    ----------
+    tlines : sequence
+        sequences of pairs of date[time]s
+
+        date[time] may be (a) pandas.to_datetime parseable string,
+                          (b) pandas Timestamp, or
+                          (c) python datetime.datetime or datetime.date
+
+    tlines may also be a dict, containing
+    the following keys:
+
+        'tlines'     : the same as defined above: sequence of pairs of date[time]s
+        'colors'     : colors for the above tlines
+        'linestyle'  : line types for the above tlines
+        'linewidths' : line widths for the above tlines
+
+    dtix:  date index for the x-axis, used for converting the dates when
+           x-values are 'evenly spaced integers' (as when skipping non-trading days)
+
+    Returns
+    -------
+    ret : list
+        lines collections
+    """
+    if tlines is None:
+        return None
+
+    if isinstance(tlines,dict):
+        tconfig = _process_kwargs(tlines, _valid_lines_kwargs())
+        tlines  = tconfig['tlines']
+    else:
+        tconfig = _process_kwargs({}, _valid_lines_kwargs())
+
+    tline_use    = tconfig['tline_use']
+    tline_method = tconfig['tline_method']
+
+    #print('tconfig=',tconfig)
+    #print('tlines=',tlines)
+
+    # reconstruct the data frame:
+    df = pd.DataFrame({'open':opens,'high':highs,'low':lows,'close':closes},
+                      index=pd.DatetimeIndex(mdates.num2date(dates))   )
+    df.index = df.index.tz_localize(None)
+
+    # possible `tvalue`s : close,open,high,low,oc_avg,hl_avg,ohlc_avg,hilo
+    #          'hilo' means high on the up trend, low on the down trend.
+    # possible `tmethod`s: point-to-point, leastsquares
+
+    def _tline_point_to_point(dfslice,tline_use):
+        p1 = dfslice.iloc[ 0]
+        p2 = dfslice.iloc[-1]
+        x1 = p1.name
+        y1 = p1[tline_use].mean()
+        x2 = p2.name
+        y2 = p2[tline_use].mean()
+        return ((x1,y1),(x2,y2))
+
+    def _tline_lsq(dfslice,tline_use):
+        '''
+        This closed-form linear least squares algorithm was taken from:
+        https://mmas.github.io/least-squares-fitting-numpy-scipy
+        '''
+        si = dfslice[tline_use].mean(axis=1)
+        s  = si.dropna()
+        if len(s) < 2:
+            err = 'NOT enough data for Least Squares'
+            if (len(si) > 2):
+                err += ', due to presence of NaNs'
+            raise ValueError(err)
+        xs = mdates.date2num(s.index.to_pydatetime())
+        ys = s.values
+        a  = np.vstack([xs, np.ones(len(xs))]).T
+        m, b  = np.dot(np.linalg.inv(np.dot(a.T,a)), np.dot(a.T,ys))
+        x1, x2 = xs[0], xs[-1]
+        y1 = m*x1 + b
+        y2 = m*x2 + b
+        x1, x2 = mdates.num2date(x1).replace(tzinfo=None), mdates.num2date(x2).replace(tzinfo=None)
+        return ((x1,y1),(x2,y2))
+
+    if isinstance(tline_use,str):
+        tline_use = [tline_use,]
+    tline_use = [ u.lower() for u in tline_use ]
+
+    alines = []
+    for d1,d2 in tlines:
+        dfslice = df.loc[d1:d2]
+        if len(dfslice) < 2:
+            dfdr = '\ndf date range: ['+str(df.index[0])+' , '+str(df.index[-1])+']'
+            raise ValueError('\ntlines date pair ('+str(d1)+','+str(d2)+
+                             ') too close, or wrong order, or out of range!'+dfdr)
+        if tline_method == 'least squares' or tline_method == 'least-squares':
+            p1,p2 = _tline_lsq(dfslice,tline_use)
+        elif tline_method == 'point-to-point':
+            p1,p2 = _tline_point_to_point(dfslice,tline_use)
+        else:
+            raise ValueError('\nUnrecognized value for `tline_method` = "'+str(tline_method)+'"')
+
+        alines.append((p1,p2))
+
+    del tconfig['alines']
+    alines = dict(alines=alines,**tconfig)
+    alines['tlines'] = None
+
+    return _construct_aline_collections(alines, dtix)
+
+
+from matplotlib.ticker import Formatter
+class IntegerIndexDateTimeFormatter(Formatter):
+    """
+    Formatter for axis that is indexed by integer, where the integers
+    represent the index location of the datetime object that should be
+    formatted at that lcoation.  This formatter is used typically when
+    plotting datetime on an axis but the user does NOT want to see gaps
+    where days (or times) are missing.  To use: plot the data against
+    a range of integers equal in length to the array of datetimes that
+    you would otherwise plot on that axis.  Construct this formatter
+    by providing the arrange of datetimes (as matplotlib floats). When
+    the formatter receives an integer in the range, it will look up the
+    datetime and format it.
+
+    """
+    def __init__(self, dates, fmt='%b %d, %H:%M'):
+        self.dates = dates
+        self.len   = len(dates)
+        self.fmt   = fmt
+
+    def __call__(self, x, pos=0):
+        #import pdb; pdb.set_trace()
+        'Return label for time x at position pos'
+        # not sure what 'pos' is for: see
+        # https://matplotlib.org/gallery/ticks_and_spines/date_index_formatter.html
+        ix = int(np.round(x))
+
+        if ix >= self.len or ix < 0:
+            date = None
+            dateformat = ''
+        else:
+            date = self.dates[ix]
+            dateformat = mdates.num2date(date).strftime(self.fmt)
+        #print('x=',x,'pos=',pos,'dates[',ix,']=',date,'dateformat=',dateformat)
+        return dateformat
+
+def _mscatter(x,y,ax=None, m=None, **kw):
+    import matplotlib.markers as mmarkers
+    if not ax: ax=plt.gca()
+    sc = ax.scatter(x,y,**kw)
+    if (m is not None) and (len(m)==len(x)):
+        paths = []
+        for marker in m:
+            if isinstance(marker, mmarkers.MarkerStyle):
+                marker_obj = marker
+            else:
+                marker_obj = mmarkers.MarkerStyle(marker)
+            path = marker_obj.get_path().transformed(
+                        marker_obj.get_transform())
+            paths.append(path)
+        sc.set_paths(paths)
+    return sc
diff --git a/build/lib/mplfinance/_version.py b/build/lib/mplfinance/_version.py
new file mode 100644
index 00000000..44439d7d
--- /dev/null
+++ b/build/lib/mplfinance/_version.py
@@ -0,0 +1,6 @@
+version_info = (0, 12, 9, 'beta', 2)
+
+_specifier_ = {'alpha': 'a','beta': 'b','candidate': 'rc','final': ''}
+
+__version__ = '%s.%s.%s%s'%(version_info[0], version_info[1], version_info[2],
+  '' if version_info[3]=='final' else _specifier_[version_info[3]]+str(version_info[4]))
diff --git a/build/lib/mplfinance/_widths.py b/build/lib/mplfinance/_widths.py
new file mode 100644
index 00000000..3b6813c4
--- /dev/null
+++ b/build/lib/mplfinance/_widths.py
@@ -0,0 +1,197 @@
+import pandas as pd
+from mplfinance._arg_validators import _process_kwargs, _validate_vkwargs_dict
+
+def _get_widths_df():
+    '''
+    Provide a dataframe of width data that appropriate scales widths of
+    various aspects of the plot (candles,ohlc bars,volume bars) based on
+    the amount or density of data.  These numbers were arrived at by 
+    carefully testing many use-cases of plots with various styles, 
+    and observing which numbers gave the "best" appearance.
+    '''
+    numpoints = [n for n in range(30,241,30)]
+    volume_width     = (0.98, 0.96,  0.95,  0.925,  0.9,  0.9,  0.875, 0.825 )
+    volume_linewidth = tuple([0.65]*8)
+    candle_width     = (0.65, 0.575, 0.50, 0.445, 0.435, 0.425, 0.420, 0.415)
+    candle_linewidth = (1.00, 0.875, 0.75, 0.625, 0.500, 0.438, 0.435, 0.435)
+    ohlc_tickwidth   = tuple([0.35]*8)
+    ohlc_linewidth   = (1.50, 1.175, 0.85, 0.525, 0.525, 0.525, 0.525, 0.525)
+    line_width       = (2.25, 1.8, 1.3, 0.813, 0.807, 0.801, 0.796, 0.791)
+    widths = {}
+    widths['vw']  = volume_width
+    widths['vlw'] = volume_linewidth
+    widths['cw']  = candle_width
+    widths['clw'] = candle_linewidth
+    widths['ow']  = ohlc_tickwidth
+    widths['olw'] = ohlc_linewidth
+    widths['lw']  = line_width
+    return pd.DataFrame(widths,index=numpoints)
+
+_widths = _get_widths_df()
+
+
+def _valid_scale_width_kwargs():
+    vkwargs = {
+        'ohlc'             : { 'Default'     : None,
+                               'Description' : 'length of horizontal open/close tickmarks on ohlc bars',
+                               'Validator'   : lambda value: isinstance(value,(float,int)) },
+
+        'volume'           : { 'Default'     : None,
+                               'Description' : 'width of volume bars',
+                               'Validator'   : lambda value: isinstance(value,(float,int)) },
+
+        'candle'           : { 'Default'     : None,
+                               'Description' : 'width of candles',
+                               'Validator'   : lambda value: isinstance(value,(float,int)) },
+
+        'lines'            : { 'Default'     : None,
+                               'Description' : 'width of lines (for line plots and moving averages)',
+                               'Validator'   : lambda value: isinstance(value,(float,int)) },
+
+        'volume_linewidth' : { 'Default'     : None,
+                               'Description' : 'width of edges of volume bars',
+                               'Validator'   : lambda value: isinstance(value,(float,int)) },
+
+        'ohlc_linewidth'   : { 'Default'     : None,
+                               'Description' : 'width (thickness) of ohlc bars',
+                               'Validator'   : lambda value: isinstance(value,(float,int)) },
+
+        'candle_linewidth' : { 'Default'     : None,
+                               'Description' : 'width of candle edges and wicks',
+                               'Validator'   : lambda value: isinstance(value,(float,int)) },
+    }
+
+    _validate_vkwargs_dict(vkwargs)
+
+    return vkwargs
+
+
+def _valid_update_width_kwargs():
+    vkwargs = {
+
+        'ohlc_ticksize'    : { 'Default'     : None,
+                               'Description' : 'length of horizontal open/close tickmarks on ohlc bars',
+                               'Validator'   : lambda value: isinstance(value,(float,int)) },
+
+        'ohlc_linewidth'   : { 'Default'     : None,
+                               'Description' : 'width (thickness) of ohlc bars',
+                               'Validator'   : lambda value: isinstance(value,(float,int)) },
+
+        'volume_width'     : { 'Default'     : None,
+                               'Description' : 'width of volume bars',
+                               'Validator'   : lambda value: isinstance(value,(float,int)) },
+
+        'volume_linewidth' : { 'Default'     : None,
+                               'Description' : 'width of edges of volume bars',
+                               'Validator'   : lambda value: isinstance(value,(float,int)) },
+
+        'candle_width'     : { 'Default'     : None,
+                               'Description' : 'width of candles',
+                               'Validator'   : lambda value: isinstance(value,(float,int)) },
+
+        'candle_linewidth' : { 'Default'     : None,
+                               'Description' : 'width of candle edges and wicks',
+                               'Validator'   : lambda value: isinstance(value,(float,int)) },
+
+        'line_width'       : { 'Default'     : None,
+                               'Description' : 'width of lines (for line plots and moving averages)',
+                               'Validator'   : lambda value: isinstance(value,(float,int)) },
+    }
+
+    _validate_vkwargs_dict(vkwargs)
+
+    return vkwargs
+
+
+def _determine_width_config( xdates, config ):
+    '''
+    Given x-axis xdates, and `mpf.plot()` kwargs config,
+    determine the widths and linewidths for candles,
+    volume bars, ohlc bars, etc.
+    '''
+    datalen = len(xdates)
+    avg_dist_between_points = (xdates[-1] - xdates[0]) / float(datalen)
+
+    tweak  = 1.06 if datalen > 100 else 1.03
+
+    adjust = tweak*avg_dist_between_points if config['show_nontrading'] else 1.0
+
+    width_config = {}
+
+    if config['width_adjuster_version'] == 'v0':  # Behave like original version of code:
+
+        width_config['volume_width'    ] = 0.5*avg_dist_between_points
+        width_config['volume_linewidth'] = None
+        width_config['ohlc_ticksize'   ] = avg_dist_between_points / 2.5
+        width_config['ohlc_linewidth'  ] = None
+        width_config['candle_width'    ] = avg_dist_between_points / 2.0
+        width_config['candle_linewidth'] = None
+        width_config['line_width'      ] = None
+
+    else: # config['width_adjuster_version'] == 'v1'
+
+        width_config['volume_width'    ] = _dfinterpolate(_widths,datalen,'vw' ) * adjust
+        width_config['volume_linewidth'] = _dfinterpolate(_widths,datalen,'vlw')
+        width_config['ohlc_ticksize'   ] = _dfinterpolate(_widths,datalen,'ow' ) * adjust
+        width_config['ohlc_linewidth'  ] = _dfinterpolate(_widths,datalen,'olw')
+        width_config['candle_width'    ] = _dfinterpolate(_widths,datalen,'cw' ) * adjust
+        width_config['candle_linewidth'] = _dfinterpolate(_widths,datalen,'clw')
+        width_config['line_width'      ] = _dfinterpolate(_widths,datalen,'lw')
+
+    if config['scale_width_adjustment'] is not None:
+
+        scale = _process_kwargs(config['scale_width_adjustment'],_valid_scale_width_kwargs())
+        if scale['volume'] is not None:
+            width_config['volume_width']  *= scale['volume']
+        if scale['ohlc'] is not None:
+            width_config['ohlc_ticksize'] *= scale['ohlc']
+        if scale['candle'] is not None:
+            width_config['candle_width']  *= scale['candle']
+        if scale['lines'] is not None:
+            width_config['line_width']    *= scale['lines']
+        if scale['volume_linewidth'] is not None:
+            width_config['volume_linewidth']  *= scale['volume_linewidth']
+        if scale['ohlc_linewidth'] is not None: 
+            width_config['ohlc_linewidth'  ]  *= scale['ohlc_linewidth']
+        if scale['candle_linewidth'] is not None:
+            width_config['candle_linewidth']  *= scale['candle_linewidth']
+
+    if config['update_width_config'] is not None:
+     
+        update = _process_kwargs(config['update_width_config'],_valid_update_width_kwargs())
+        uplist = [ (k,v) for k,v in update.items() if v is not None ]
+        width_config.update(uplist)
+
+    return width_config
+
+
+def _dfinterpolate(df,key,column):
+    '''
+    Given a DataFrame, with all values and the Index as floats,
+    and given a float key, find the row that matches the key, or 
+    find the two rows surrounding that key, and return the interpolated
+    value for the specified column, based on where the key falls between
+    the two rows.  If they key is an exact match for a key in the index,
+    the return the exact value from the column.  If the key is less than
+    or greater than any key in the index, then return either the first
+    or last value for the column.
+    '''
+    s = df[column]
+    s1 = s.loc[:key]
+    if len(s1) < 1:
+        return s.iloc[0]
+    j1 = s1.index[-1]
+    v1 = s1.iloc[-1]
+    
+    s2 = s.loc[key:]
+    if len(s2) < 1:
+        return s.iloc[-1]
+    j2 = s2.index[0]
+    v2 = s2.iloc[0]
+
+    if j1 == j2:
+        return v1
+    delta   = j2 - j1
+    portion = (key - j1)/delta
+    ans = v1 + (v2-v1)*portion
+    return ans
diff --git a/build/lib/mplfinance/original_flavor.py b/build/lib/mplfinance/original_flavor.py
new file mode 100644
index 00000000..f6963963
--- /dev/null
+++ b/build/lib/mplfinance/original_flavor.py
@@ -0,0 +1,885 @@
+"""
+A collection of functions for analyzing and plotting
+financial data.   User contributions welcome!
+
+"""
+from __future__ import (absolute_import, division, print_function,
+                        unicode_literals)
+
+import numpy as np
+from matplotlib import colors as mcolors
+from matplotlib.collections import LineCollection, PolyCollection
+from matplotlib.lines import TICKLEFT, TICKRIGHT, Line2D
+from matplotlib.patches import Rectangle
+from matplotlib.transforms import Affine2D
+
+from six.moves import xrange, zip
+
+
+def plot_day_summary_oclh(ax, quotes, ticksize=3,
+                          colorup='k', colordown='r'):
+    """Plots day summary
+
+        Represent the time, open, close, high, low as a vertical line
+        ranging from low to high.  The left tick is the open and the right
+        tick is the close.
+
+
+
+    Parameters
+    ----------
+    ax : `Axes`
+        an `Axes` instance to plot to
+    quotes : sequence of (time, open, close, high, low, ...) sequences
+        data to plot.  time must be in float date format - see date2num
+    ticksize : int
+        open/close tick marker in points
+    colorup : color
+        the color of the lines where close >= open
+    colordown : color
+        the color of the lines where close <  open
+
+    Returns
+    -------
+    lines : list
+        list of tuples of the lines added (one tuple per quote)
+    """
+    return _plot_day_summary(ax, quotes, ticksize=ticksize,
+                             colorup=colorup, colordown=colordown,
+                             ochl=True)
+
+
+def plot_day_summary_ohlc(ax, quotes, ticksize=3,
+                          colorup='k', colordown='r'):
+    """Plots day summary
+
+        Represent the time, open, high, low, close as a vertical line
+        ranging from low to high.  The left tick is the open and the right
+        tick is the close.
+
+
+
+    Parameters
+    ----------
+    ax : `Axes`
+        an `Axes` instance to plot to
+    quotes : sequence of (time, open, high, low, close, ...) sequences
+        data to plot.  time must be in float date format - see date2num
+    ticksize : int
+        open/close tick marker in points
+    colorup : color
+        the color of the lines where close >= open
+    colordown : color
+        the color of the lines where close <  open
+
+    Returns
+    -------
+    lines : list
+        list of tuples of the lines added (one tuple per quote)
+    """
+    return _plot_day_summary(ax, quotes, ticksize=ticksize,
+                             colorup=colorup, colordown=colordown,
+                             ochl=False)
+
+
+def _plot_day_summary(ax, quotes, ticksize=3,
+                      colorup='k', colordown='r',
+                      ochl=True):
+    """Plots day summary
+
+
+        Represent the time, open, high, low, close as a vertical line
+        ranging from low to high.  The left tick is the open and the right
+        tick is the close.
+
+
+
+    Parameters
+    ----------
+    ax : `Axes`
+        an `Axes` instance to plot to
+    quotes : sequence of quote sequences
+        data to plot.  time must be in float date format - see date2num
+        (time, open, high, low, close, ...) vs
+        (time, open, close, high, low, ...)
+        set by `ochl`
+    ticksize : int
+        open/close tick marker in points
+    colorup : color
+        the color of the lines where close >= open
+    colordown : color
+        the color of the lines where close <  open
+    ochl: bool
+        argument to select between ochl and ohlc ordering of quotes
+
+    Returns
+    -------
+    lines : list
+        list of tuples of the lines added (one tuple per quote)
+    """
+    # unfortunately this has a different return type than plot_day_summary2_*
+    lines = []
+    for q in quotes:
+        if ochl:
+            t, open, close, high, low = q[:5]
+        else:
+            t, open, high, low, close = q[:5]
+
+        if close >= open:
+            color = colorup
+        else:
+            color = colordown
+
+        vline = Line2D(xdata=(t, t), ydata=(low, high),
+                       color=color,
+                       antialiased=False,   # no need to antialias vert lines
+                       )
+
+        oline = Line2D(xdata=(t, t), ydata=(open, open),
+                       color=color,
+                       antialiased=False,
+                       marker=TICKLEFT,
+                       markersize=ticksize,
+                       )
+
+        cline = Line2D(xdata=(t, t), ydata=(close, close),
+                       color=color,
+                       antialiased=False,
+                       markersize=ticksize,
+                       marker=TICKRIGHT)
+
+        lines.extend((vline, oline, cline))
+        ax.add_line(vline)
+        ax.add_line(oline)
+        ax.add_line(cline)
+
+    ax.autoscale_view()
+
+    return lines
+
+
+def candlestick_ochl(ax, quotes, width=0.2, colorup='k', colordown='r',
+                     alpha=1.0):
+    """
+    Plot the time, open, close, high, low as a vertical line ranging
+    from low to high.  Use a rectangular bar to represent the
+    open-close span.  If close >= open, use colorup to color the bar,
+    otherwise use colordown
+
+    Parameters
+    ----------
+    ax : `Axes`
+        an Axes instance to plot to
+    quotes : sequence of (time, open, close, high, low, ...) sequences
+        As long as the first 5 elements are these values,
+        the record can be as long as you want (e.g., it may store volume).
+
+        time must be in float days format - see date2num
+
+    width : float
+        fraction of a day for the rectangle width
+    colorup : color
+        the color of the rectangle where close >= open
+    colordown : color
+         the color of the rectangle where close <  open
+    alpha : float
+        the rectangle alpha level
+
+    Returns
+    -------
+    ret : tuple
+        returns (lines, patches) where lines is a list of lines
+        added and patches is a list of the rectangle patches added
+
+    """
+    return _candlestick(ax, quotes, width=width, colorup=colorup,
+                        colordown=colordown,
+                        alpha=alpha, ochl=True)
+
+
+def candlestick_ohlc(ax, quotes, width=0.2, colorup='k', colordown='r',
+                     alpha=1.0):
+    """
+    Plot the time, open, high, low, close as a vertical line ranging
+    from low to high.  Use a rectangular bar to represent the
+    open-close span.  If close >= open, use colorup to color the bar,
+    otherwise use colordown
+
+    Parameters
+    ----------
+    ax : `Axes`
+        an Axes instance to plot to
+    quotes : sequence of (time, open, high, low, close, ...) sequences
+        As long as the first 5 elements are these values,
+        the record can be as long as you want (e.g., it may store volume).
+
+        time must be in float days format - see date2num
+
+    width : float
+        fraction of a day for the rectangle width
+    colorup : color
+        the color of the rectangle where close >= open
+    colordown : color
+         the color of the rectangle where close <  open
+    alpha : float
+        the rectangle alpha level
+
+    Returns
+    -------
+    ret : tuple
+        returns (lines, patches) where lines is a list of lines
+        added and patches is a list of the rectangle patches added
+
+    """
+    return _candlestick(ax, quotes, width=width, colorup=colorup,
+                        colordown=colordown,
+                        alpha=alpha, ochl=False)
+
+
+def _candlestick(ax, quotes, width=0.2, colorup='k', colordown='r',
+                 alpha=1.0, ochl=True):
+    """
+    Plot the time, open, high, low, close as a vertical line ranging
+    from low to high.  Use a rectangular bar to represent the
+    open-close span.  If close >= open, use colorup to color the bar,
+    otherwise use colordown
+
+    Parameters
+    ----------
+    ax : `Axes`
+        an Axes instance to plot to
+    quotes : sequence of quote sequences
+        data to plot.  time must be in float date format - see date2num
+        (time, open, high, low, close, ...) vs
+        (time, open, close, high, low, ...)
+        set by `ochl`
+    width : float
+        fraction of a day for the rectangle width
+    colorup : color
+        the color of the rectangle where close >= open
+    colordown : color
+         the color of the rectangle where close <  open
+    alpha : float
+        the rectangle alpha level
+    ochl: bool
+        argument to select between ochl and ohlc ordering of quotes
+
+    Returns
+    -------
+    ret : tuple
+        returns (lines, patches) where lines is a list of lines
+        added and patches is a list of the rectangle patches added
+
+    """
+
+    OFFSET = width / 2.0
+
+    lines = []
+    patches = []
+    for q in quotes:
+        if ochl:
+            t, open, close, high, low = q[:5]
+        else:
+            t, open, high, low, close = q[:5]
+
+        if close >= open:
+            color = colorup
+            lower = open
+            height = close - open
+        else:
+            color = colordown
+            lower = close
+            height = open - close
+
+        vline = Line2D(
+            xdata=(t, t), ydata=(low, high),
+            color=color,
+            linewidth=0.5,
+            antialiased=True,
+        )
+
+        rect = Rectangle(
+            xy=(t - OFFSET, lower),
+            width=width,
+            height=height,
+            facecolor=color,
+            edgecolor=color,
+        )
+        rect.set_alpha(alpha)
+
+        lines.append(vline)
+        patches.append(rect)
+        ax.add_line(vline)
+        ax.add_patch(rect)
+    ax.autoscale_view()
+
+    return lines, patches
+
+
+def _check_input(opens, closes, highs, lows, miss=-1):
+    """Checks that *opens*, *highs*, *lows* and *closes* have the same length.
+    NOTE: this code assumes if any value open, high, low, close is
+    missing (*-1*) they all are missing
+
+    Parameters
+    ----------
+    ax : `Axes`
+        an Axes instance to plot to
+    opens : sequence
+        sequence of opening values
+    highs : sequence
+        sequence of high values
+    lows : sequence
+        sequence of low values
+    closes : sequence
+        sequence of closing values
+    miss : int
+        identifier of the missing data
+
+    Raises
+    ------
+    ValueError
+        if the input sequences don't have the same length
+    """
+
+    def _missing(sequence, miss=-1):
+        """Returns the index in *sequence* of the missing data, identified by
+        *miss*
+
+        Parameters
+        ----------
+        sequence :
+            sequence to evaluate
+        miss :
+            identifier of the missing data
+
+        Returns
+        -------
+        where_miss: numpy.ndarray
+            indices of the missing data
+        """
+        return np.where(np.array(sequence) == miss)[0]
+
+    same_length = len(opens) == len(highs) == len(lows) == len(closes)
+    _missopens = _missing(opens)
+    same_missing = ((_missopens == _missing(highs)).all() and
+                    (_missopens == _missing(lows)).all() and
+                    (_missopens == _missing(closes)).all())
+
+    if not (same_length and same_missing):
+        msg = ("*opens*, *highs*, *lows* and *closes* must have the same"
+               " length. NOTE: this code assumes if any value open, high,"
+               " low, close is missing (*-1*) they all must be missing.")
+        raise ValueError(msg)
+
+
+def plot_day_summary2_ochl(ax, opens, closes, highs, lows, ticksize=4,
+                           colorup='k', colordown='r'):
+    """Represent the time, open, close, high, low,  as a vertical line
+    ranging from low to high.  The left tick is the open and the right
+    tick is the close.
+
+    Parameters
+    ----------
+    ax : `Axes`
+        an Axes instance to plot to
+    opens : sequence
+        sequence of opening values
+    closes : sequence
+        sequence of closing values
+    highs : sequence
+        sequence of high values
+    lows : sequence
+        sequence of low values
+    ticksize : int
+        size of open and close ticks in points
+    colorup : color
+        the color of the lines where close >= open
+    colordown : color
+         the color of the lines where close <  open
+
+    Returns
+    -------
+    ret : list
+        a list of lines added to the axes
+    """
+
+    return plot_day_summary2_ohlc(ax, opens, highs, lows, closes, ticksize,
+                                  colorup, colordown)
+
+
+def plot_day_summary2_ohlc(ax, opens, highs, lows, closes, ticksize=4,
+                           colorup='k', colordown='r'):
+    """Represent the time, open, high, low, close as a vertical line
+    ranging from low to high.  The left tick is the open and the right
+    tick is the close.
+    *opens*, *highs*, *lows* and *closes* must have the same length.
+    NOTE: this code assumes if any value open, high, low, close is
+    missing (*-1*) they all are missing
+
+    Parameters
+    ----------
+    ax : `Axes`
+        an Axes instance to plot to
+    opens : sequence
+        sequence of opening values
+    highs : sequence
+        sequence of high values
+    lows : sequence
+        sequence of low values
+    closes : sequence
+        sequence of closing values
+    ticksize : int
+        size of open and close ticks in points
+    colorup : color
+        the color of the lines where close >= open
+    colordown : color
+         the color of the lines where close <  open
+
+    Returns
+    -------
+    ret : list
+        a list of lines added to the axes
+    """
+
+    _check_input(opens, highs, lows, closes)
+
+    rangeSegments = [((i, low), (i, high)) for i, low, high in
+                     zip(xrange(len(lows)), lows, highs) if low != -1]
+
+    # the ticks will be from ticksize to 0 in points at the origin and
+    # we'll translate these to the i, close location
+    openSegments = [((-ticksize, 0), (0, 0))]
+
+    # the ticks will be from 0 to ticksize in points at the origin and
+    # we'll translate these to the i, close location
+    closeSegments = [((0, 0), (ticksize, 0))]
+
+    offsetsOpen = [(i, open) for i, open in
+                   zip(xrange(len(opens)), opens) if open != -1]
+
+    offsetsClose = [(i, close) for i, close in
+                    zip(xrange(len(closes)), closes) if close != -1]
+
+    scale = ax.figure.dpi * (1.0 / 72.0)
+
+    tickTransform = Affine2D().scale(scale, 0.0)
+
+    colorup = mcolors.to_rgba(colorup)
+    colordown = mcolors.to_rgba(colordown)
+    colord = {True: colorup, False: colordown}
+    colors = [colord[open < close] for open, close in
+              zip(opens, closes) if open != -1 and close != -1]
+
+    useAA = 0,   # use tuple here
+    lw = 1,      # and here
+    rangeCollection = LineCollection(rangeSegments,
+                                     colors=colors,
+                                     linewidths=lw,
+                                     antialiaseds=useAA,
+                                     )
+
+    openCollection = LineCollection(openSegments,
+                                    colors=colors,
+                                    antialiaseds=useAA,
+                                    linewidths=lw,
+                                    offsets=offsetsOpen,
+                                    transOffset=ax.transData,
+                                    )
+    openCollection.set_transform(tickTransform)
+
+    closeCollection = LineCollection(closeSegments,
+                                     colors=colors,
+                                     antialiaseds=useAA,
+                                     linewidths=lw,
+                                     offsets=offsetsClose,
+                                     transOffset=ax.transData,
+                                     )
+    closeCollection.set_transform(tickTransform)
+
+    minpy, maxx = (0, len(rangeSegments))
+    miny = min([low for low in lows if low != -1])
+    maxy = max([high for high in highs if high != -1])
+    corners = (minpy, miny), (maxx, maxy)
+    ax.update_datalim(corners)
+    ax.autoscale_view()
+
+    # add these last
+    ax.add_collection(rangeCollection)
+    ax.add_collection(openCollection)
+    ax.add_collection(closeCollection)
+    return rangeCollection, openCollection, closeCollection
+
+
+def candlestick2_ochl(ax, opens, closes, highs, lows, width=4,
+                      colorup='k', colordown='r',
+                      alpha=0.75):
+    """Represent the open, close as a bar line and high low range as a
+    vertical line.
+
+    Preserves the original argument order.
+
+
+    Parameters
+    ----------
+    ax : `Axes`
+        an Axes instance to plot to
+    opens : sequence
+        sequence of opening values
+    closes : sequence
+        sequence of closing values
+    highs : sequence
+        sequence of high values
+    lows : sequence
+        sequence of low values
+    width : int
+        size of open and close ticks in points
+    colorup : color
+        the color of the lines where close >= open
+    colordown : color
+        the color of the lines where close <  open
+    alpha : float
+        bar transparency
+
+    Returns
+    -------
+    ret : tuple
+        (lineCollection, barCollection)
+    """
+
+    return candlestick2_ohlc(ax, opens, highs, lows, closes, width=width,
+                             colorup=colorup, colordown=colordown,
+                             alpha=alpha)
+
+
+def candlestick2_ohlc(ax, opens, highs, lows, closes, width=4,
+                      colorup='k', colordown='r',
+                      alpha=0.75):
+    """Represent the open, close as a bar line and high low range as a
+    vertical line.
+
+    NOTE: this code assumes if any value open, low, high, close is
+    missing they all are missing
+
+
+    Parameters
+    ----------
+    ax : `Axes`
+        an Axes instance to plot to
+    opens : sequence
+        sequence of opening values
+    highs : sequence
+        sequence of high values
+    lows : sequence
+        sequence of low values
+    closes : sequence
+        sequence of closing values
+    width : float
+        size of open and close ticks in points
+    colorup : color
+        the color of the lines where close >= open
+    colordown : color
+        the color of the lines where close <  open
+    alpha : float
+        bar transparency
+
+    Returns
+    -------
+    ret : tuple
+        (lineCollection, barCollection)
+    """
+
+    _check_input(opens, highs, lows, closes)
+
+    delta = width / 2.
+    barVerts = [((i - delta, open),
+                 (i - delta, close),
+                 (i + delta, close),
+                 (i + delta, open))
+                for i, open, close in zip(xrange(len(opens)), opens, closes)
+                if open != -1 and close != -1]
+
+    rangeSegments = [((i, low), (i, high))
+                     for i, low, high in zip(xrange(len(lows)), lows, highs)
+                     if low != -1]
+
+    colorup = mcolors.to_rgba(colorup, alpha)
+    colordown = mcolors.to_rgba(colordown, alpha)
+    colord = {True: colorup, False: colordown}
+    colors = [colord[open < close]
+              for open, close in zip(opens, closes)
+              if open != -1 and close != -1]
+
+    useAA = 0,  # use tuple here
+    lw = 0.5,   # and here
+    rangeCollection = LineCollection(rangeSegments,
+                                     colors=colors,
+                                     linewidths=lw,
+                                     antialiaseds=useAA,
+                                     )
+
+    barCollection = PolyCollection(barVerts,
+                                   facecolors=colors,
+                                   edgecolors=colors,
+                                   antialiaseds=useAA,
+                                   linewidths=lw,
+                                   )
+
+    minx, maxx = 0, len(rangeSegments)
+    miny = min([low for low in lows if low != -1])
+    maxy = max([high for high in highs if high != -1])
+
+    corners = (minx, miny), (maxx, maxy)
+    ax.update_datalim(corners)
+    ax.autoscale_view()
+
+    # add these last
+    ax.add_collection(rangeCollection)
+    ax.add_collection(barCollection)
+    return rangeCollection, barCollection
+
+
+def volume_overlay(ax, opens, closes, volumes,
+                   colorup='k', colordown='r',
+                   width=4, alpha=1.0):
+    """Add a volume overlay to the current axes.  The opens and closes
+    are used to determine the color of the bar.  -1 is missing.  If a
+    value is missing on one it must be missing on all
+
+    Parameters
+    ----------
+    ax : `Axes`
+        an Axes instance to plot to
+    opens : sequence
+        a sequence of opens
+    closes : sequence
+        a sequence of closes
+    volumes : sequence
+        a sequence of volumes
+    width : int
+        the bar width in points
+    colorup : color
+        the color of the lines where close >= open
+    colordown : color
+        the color of the lines where close <  open
+    alpha : float
+        bar transparency
+
+    Returns
+    -------
+    ret : `barCollection`
+        The `barrCollection` added to the axes
+
+    """
+
+    colorup = mcolors.to_rgba(colorup, alpha)
+    colordown = mcolors.to_rgba(colordown, alpha)
+    colord = {True: colorup, False: colordown}
+    colors = [colord[open < close]
+              for open, close in zip(opens, closes)
+              if open != -1 and close != -1]
+
+    delta = width / 2.
+    bars = [((i - delta, 0), (i - delta, v), (i + delta, v), (i + delta, 0))
+            for i, v in enumerate(volumes)
+            if v != -1]
+
+    barCollection = PolyCollection(bars,
+                                   facecolors=colors,
+                                   edgecolors=((0, 0, 0, 1), ),
+                                   antialiaseds=(0,),
+                                   linewidths=(0.5,),
+                                   )
+
+    ax.add_collection(barCollection)
+    corners = (0, 0), (len(bars), max(volumes))
+    ax.update_datalim(corners)
+    ax.autoscale_view()
+
+    # add these last
+    return barCollection
+
+
+def volume_overlay2(ax, closes, volumes,
+                    colorup='k', colordown='r',
+                    width=4, alpha=1.0):
+    """
+    Add a volume overlay to the current axes.  The closes are used to
+    determine the color of the bar.  -1 is missing.  If a value is
+    missing on one it must be missing on all
+
+    nb: first point is not displayed - it is used only for choosing the
+    right color
+
+
+    Parameters
+    ----------
+    ax : `Axes`
+        an Axes instance to plot to
+    closes : sequence
+        a sequence of closes
+    volumes : sequence
+        a sequence of volumes
+    width : int
+        the bar width in points
+    colorup : color
+        the color of the lines where close >= open
+    colordown : color
+        the color of the lines where close <  open
+    alpha : float
+        bar transparency
+
+    Returns
+    -------
+    ret : `barCollection`
+        The `barrCollection` added to the axes
+
+    """
+
+    return volume_overlay(ax, closes[:-1], closes[1:], volumes[1:],
+                          colorup, colordown, width, alpha)
+
+
+def volume_overlay3(ax, quotes,
+                    colorup='k', colordown='r',
+                    width=4, alpha=1.0):
+    """Add a volume overlay to the current axes.  quotes is a list of (d,
+    open, high, low, close, volume) and close-open is used to
+    determine the color of the bar
+
+    Parameters
+    ----------
+    ax : `Axes`
+        an Axes instance to plot to
+    quotes : sequence of (time, open, high, low, close, ...) sequences
+        data to plot.  time must be in float date format - see date2num
+    width : int
+        the bar width in points
+    colorup : color
+        the color of the lines where close1 >= close0
+    colordown : color
+        the color of the lines where close1 <  close0
+    alpha : float
+         bar transparency
+
+    Returns
+    -------
+    ret : `barCollection`
+        The `barrCollection` added to the axes
+
+
+    """
+
+    colorup = mcolors.to_rgba(colorup, alpha)
+    colordown = mcolors.to_rgba(colordown, alpha)
+    colord = {True: colorup, False: colordown}
+
+    dates, opens, highs, lows, closes, volumes = list(zip(*quotes))
+    colors = [colord[close1 >= close0]
+              for close0, close1 in zip(closes[:-1], closes[1:])
+              if close0 != -1 and close1 != -1]
+    colors.insert(0, colord[closes[0] >= opens[0]])
+
+    right = width / 2.0
+    left = -width / 2.0
+
+    bars = [((left, 0), (left, volume), (right, volume), (right, 0))
+            for d, open, high, low, close, volume in quotes]
+
+    sx = ax.figure.dpi * (1.0 / 72.0)  # scale for points
+    sy = ax.bbox.height / ax.viewLim.height
+
+    barTransform = Affine2D().scale(sx, sy)
+
+    dates = [d for d, open, high, low, close, volume in quotes]
+    offsetsBars = [(d, 0) for d in dates]
+
+    useAA = 0,  # use tuple here
+    lw = 0.5,   # and here
+    barCollection = PolyCollection(bars,
+                                   facecolors=colors,
+                                   edgecolors=((0, 0, 0, 1),),
+                                   antialiaseds=useAA,
+                                   linewidths=lw,
+                                   offsets=offsetsBars,
+                                   transOffset=ax.transData,
+                                   )
+    barCollection.set_transform(barTransform)
+
+    minpy, maxx = (min(dates), max(dates))
+    miny = 0
+    maxy = max([volume for d, open, high, low, close, volume in quotes])
+    corners = (minpy, miny), (maxx, maxy)
+    ax.update_datalim(corners)
+    # print 'datalim', ax.dataLim.bounds
+    # print 'viewlim', ax.viewLim.bounds
+
+    ax.add_collection(barCollection)
+    ax.autoscale_view()
+
+    return barCollection
+
+
+def index_bar(ax, vals,
+              facecolor='b', edgecolor='l',
+              width=4, alpha=1.0, ):
+    """Add a bar collection graph with height vals (-1 is missing).
+
+    Parameters
+    ----------
+    ax : `Axes`
+        an Axes instance to plot to
+    vals : sequence
+        a sequence of values
+    facecolor : color
+        the color of the bar face
+    edgecolor : color
+        the color of the bar edges
+    width : int
+        the bar width in points
+    alpha : float
+       bar transparency
+
+    Returns
+    -------
+    ret : `barCollection`
+        The `barrCollection` added to the axes
+
+    """
+
+    facecolors = (mcolors.to_rgba(facecolor, alpha),)
+    edgecolors = (mcolors.to_rgba(edgecolor, alpha),)
+
+    right = width / 2.0
+    left = -width / 2.0
+
+    bars = [((left, 0), (left, v), (right, v), (right, 0))
+            for v in vals if v != -1]
+
+    sx = ax.figure.dpi * (1.0 / 72.0)  # scale for points
+    sy = ax.bbox.height / ax.viewLim.height
+
+    barTransform = Affine2D().scale(sx, sy)
+
+    offsetsBars = [(i, 0) for i, v in enumerate(vals) if v != -1]
+
+    barCollection = PolyCollection(bars,
+                                   facecolors=facecolors,
+                                   edgecolors=edgecolors,
+                                   antialiaseds=(0,),
+                                   linewidths=(0.5,),
+                                   offsets=offsetsBars,
+                                   transOffset=ax.transData,
+                                   )
+    barCollection.set_transform(barTransform)
+
+    minpy, maxx = (0, len(offsetsBars))
+    miny = 0
+    maxy = max([v for v in vals if v != -1])
+    corners = (minpy, miny), (maxx, maxy)
+    ax.update_datalim(corners)
+    ax.autoscale_view()
+
+    # add these last
+    ax.add_collection(barCollection)
+    return barCollection
diff --git a/build/lib/mplfinance/plotting.py b/build/lib/mplfinance/plotting.py
new file mode 100644
index 00000000..073864a0
--- /dev/null
+++ b/build/lib/mplfinance/plotting.py
@@ -0,0 +1,1307 @@
+import matplotlib.dates  as mdates
+import matplotlib.pyplot as plt
+import matplotlib.colors as mcolors
+import matplotlib.axes   as mpl_axes
+import matplotlib.figure as mpl_fig
+import pandas as pd
+import numpy  as np
+import copy
+import io
+import os
+import math
+import warnings
+import statistics as stat
+
+from itertools import cycle
+#from pandas.plotting import register_matplotlib_converters
+#register_matplotlib_converters()
+
+from mplfinance._utils import _construct_aline_collections
+from mplfinance._utils import _construct_hline_collections
+from mplfinance._utils import _construct_vline_collections
+from mplfinance._utils import _construct_tline_collections
+from mplfinance._utils import _construct_mpf_collections
+
+from mplfinance._widths import _determine_width_config
+
+from mplfinance._utils import _updown_colors
+from mplfinance._utils import IntegerIndexDateTimeFormatter
+from mplfinance._utils import _mscatter
+from mplfinance._utils import _check_and_convert_xlim_configuration
+
+from mplfinance import _styles
+
+from mplfinance._arg_validators import _check_and_prepare_data, _mav_validator
+from mplfinance._arg_validators import _get_valid_plot_types, _fill_between_validator
+from mplfinance._arg_validators import _process_kwargs, _validate_vkwargs_dict
+from mplfinance._arg_validators import _kwarg_not_implemented, _bypass_kwarg_validation
+from mplfinance._arg_validators import _hlines_validator, _vlines_validator
+from mplfinance._arg_validators import _alines_validator, _tlines_validator
+from mplfinance._arg_validators import _scale_padding_validator, _yscale_validator
+from mplfinance._arg_validators import _valid_panel_id, _check_for_external_axes
+from mplfinance._arg_validators import _xlim_validator, _mco_validator, _is_marketcolor_object
+
+from mplfinance._panels import _build_panels
+from mplfinance._panels import _set_ticks_on_bottom_panel_only
+
+from mplfinance._helpers import _determine_format_string
+from mplfinance._helpers import _list_of_dict
+from mplfinance._helpers import _num_or_seq_of_num
+from mplfinance._helpers import _adjust_color_brightness
+
+VALID_PMOVE_TYPES = ['renko', 'pnf']
+
+DEFAULT_FIGRATIO = (8.00,5.75)
+
+def with_rc_context(func):
+    '''
+    This decoractor creates an rcParams context around a function, so that any changes
+    the function makes to rcParams will be reversed when the decorated function returns
+    (therefore those changes have no effect outside of the decorated function).
+    '''
+    def decorator(*args, **kwargs):
+        with plt.rc_context():
+            return func(*args, **kwargs)
+    return decorator
+
+def _warn_no_xgaps_deprecated(value):
+    warnings.warn('\n\n ================================================================= '+
+                  '\n\n   WARNING: `no_xgaps` is /deprecated/:'+
+                  '\n     Default value is now `no_xgaps=True`'+
+                  '\n     However, to set `no_xgaps=False` and silence this warning,'+
+                  '\n     use instead: `show_nontrading=True`.'+
+                  '\n\n ================================================================ ',
+                  category=DeprecationWarning)
+    return isinstance(value,bool)
+
+def _warn_set_ylim_deprecated(value):
+    warnings.warn('\n\n ================================================================= '+
+                  '\n\n   WARNING: `set_ylim=(ymin,ymax)` kwarg '+
+                    '\n             has been replaced with: '+
+                    '\n            `ylim=(ymin,ymax)`.'+
+                  '\n\n ================================================================ ',
+                  category=DeprecationWarning)
+    return isinstance(value,bool)
+
+
+def _valid_plot_kwargs():
+    '''
+    Construct and return the "valid kwargs table" for the mplfinance.plot() function.
+    A valid kwargs table is a `dict` of `dict`s.  The keys of the outer dict are the
+    valid key-words for the function.  The value for each key is a dict containing
+    2 specific keys: "Default", and "Validator" with the following values:
+        "Default"      - The default value for the kwarg if none is specified.
+        "Validator"    - A function that takes the caller specified value for the kwarg,
+                         and validates that it is the correct type, and (for kwargs with 
+                         a limited set of allowed values) may also validate that the
+                         kwarg value is one of the allowed values.
+    '''
+
+    vkwargs = {
+        'columns'                   : { 'Default'     : None, # use default names: ('Open', 'High', 'Low', 'Close', 'Volume')
+                                        'Description' : ('Column names to be used when plotting the data.'+
+                                                         ' Default: ("Open", "High", "Low", "Close", "Volume")'),
+                                        'Validator'   : lambda value: isinstance(value, (tuple, list))
+                                                                   and len(value) == 5
+                                                                   and all(isinstance(c, str) for c in value) },
+        'type'                      : { 'Default'     : 'ohlc',
+                                        'Description' : 'Plot type: '+str(_get_valid_plot_types()),
+                                        'Validator'   : lambda value: value in _get_valid_plot_types() },
+ 
+        'style'                     : { 'Default'     : None,
+                                        'Description' : 'plot style; see `mpf.available_styles()`',
+                                        'Validator'   : _styles._valid_mpf_style },
+ 
+        'volume'                    : { 'Default'     : False,
+                                        'Description' : 'Plot volume: True, False, or set to Axes object on which to plot.',
+                                        'Validator'   : lambda value: isinstance(value,bool) or isinstance(value,mpl_axes.Axes) },
+ 
+        'mav'                       : { 'Default'     : None,
+                                        'Description' : 'Moving Average window size(s); (int or tuple of ints)',
+                                        'Validator'   : _mav_validator },
+        
+        'renko_params'              : { 'Default'     : dict(),
+                                        'Description' : 'dict of renko parameters; call `mpf.kwarg_help("renko_params")`',
+                                        'Validator'   : lambda value: isinstance(value,dict) },
+
+        'pnf_params'                : { 'Default'     : dict(),
+                                        'Description' : 'dict of point-and-figure parameters; call `mpf.kwarg_help("pnf_params")`',
+                                        'Validator'   : lambda value: isinstance(value,dict) },
+ 
+        'study'                     : { 'Default'     : None,
+                                        'Description' : 'kwarg not implemented',
+                                        'Validator'   : lambda value: _kwarg_not_implemented(value) }, 
+ 
+        'marketcolor_overrides'     : { 'Default'     : None, 
+                                        'Description' : 'sequence of color objects to override market colors.'+
+                                                        'sequence must be same length as ohlc(v) DataFrame. Each'+
+                                                        'color object may be a color, marketcolor object, or None.',
+                                        'Validator'   : _mco_validator },
+ 
+        'mco_faceonly'              : { 'Default'     : False, # If True: Override only the face of the candle
+                                        'Description' : 'True/False marketcolor_overrides only apply to face of candle.',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+ 
+        'no_xgaps'                  : { 'Default'     : True,  # None means follow default logic below:
+                                        'Description' : 'deprecated',
+                                        'Validator'   : lambda value: _warn_no_xgaps_deprecated(value) },
+ 
+        'show_nontrading'           : { 'Default'     : False, 
+                                        'Description' : 'True/False show spaces for non-trading days/periods',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+ 
+        'figscale'                  : { 'Default'     : None, # scale base figure size up or down.
+                                        'Description' : 'Scale figure size up (if > 1) or down (if < 1)',
+                                        'Validator'   : lambda value: isinstance(value,float) or isinstance(value,int) },
+ 
+        'figratio'                  : { 'Default'     : None, # aspect ratio; scaled to 8.0 height
+                                        'Description' : 'Aspect ratio of the figure. Default: (8.00,5.75)',
+                                        'Validator'   : lambda value: isinstance(value,(tuple,list))
+                                                                      and len(value) == 2
+                                                                      and isinstance(value[0],(float,int))
+                                                                      and isinstance(value[1],(float,int)) },
+ 
+        'figsize'                   : { 'Default'     : None,  # figure size; overrides figratio and figscale
+                                        'Description' : ('Figure size: overrides both figscale and figratio,'+
+                                                        ' else defaults to figratio*figscale'),
+                                        'Validator'   : lambda value: isinstance(value,(tuple,list))
+                                                                      and len(value) == 2
+                                                                      and isinstance(value[0],(float,int))
+                                                                      and isinstance(value[1],(float,int)) },
+
+        'fontscale'                 : { 'Default'     : None, # scale all fonts up or down
+                                        'Description' : 'Scale font sizes up (if > 1) or down (if < 1)',
+                                        'Validator'   : lambda value: isinstance(value,float) or isinstance(value,int) },
+ 
+        'linecolor'                 : { 'Default'     : None, # line color in line plot
+                                        'Description' : 'Line color for `type=line`',
+                                        'Validator'   : lambda value: mcolors.is_color_like(value) },
+
+        'title'                     : { 'Default'     : None, # Figure Title
+                                        'Description' : 'Figure Title (see also `axtitle`)',
+                                        'Validator'   : lambda value: isinstance(value,(str,dict)) },
+ 
+        'axtitle'                   : { 'Default'     : None, # Axes Title (subplot title)
+                                        'Description' : 'Axes Title (subplot title)',
+                                        'Validator'   : lambda value: isinstance(value,(str,dict)) },
+                                        
+        'xlabel'                    : { 'Default'     : 'Date', # x-axis label
+                                        'Description' : 'label for x-axis of main plot',
+                                        'Validator'   : lambda value: isinstance(value,str) },
+ 
+        'ylabel'                    : { 'Default'     : 'Price', # y-axis label
+                                        'Description' : 'label for y-axis of main plot',
+                                        'Validator'   : lambda value: isinstance(value,str) },
+ 
+        'ylabel_lower'              : { 'Default'     : None, # y-axis label default logic below
+                                        'Description' : 'label for y-axis of volume',
+                                        'Validator'   : lambda value: isinstance(value,str) },
+ 
+        'addplot'                   : { 'Default'     : None, 
+                                        'Description' : 'addplot object or sequence of addplot objects (from `mpf.make_addplot()`)',
+                                        'Validator'   : lambda value: isinstance(value,dict) or (isinstance(value,list) and all([isinstance(d,dict) for d in value])) },
+ 
+        'savefig'                   : { 'Default'     : None, 
+                                        'Description' : 'file name, or BytesIO, or dict with key `fname` plus other keys allowed as '+
+                                                        ' kwargs to matplotlib `Figure.savefig()`',
+                                        'Validator'   : lambda value: isinstance(value,dict) or isinstance(value,str) or isinstance(value, io.BytesIO) or isinstance(value, os.PathLike) },
+ 
+        'block'                     : { 'Default'     : None, 
+                                        'Description' : 'True/False wait for figure to be closed before returning',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+ 
+        'returnfig'                 : { 'Default'     : False, 
+                                        'Description' : 'return Figure and list of Axes objects created by mplfinance;'+
+                                                        ' user must display plot when ready, usually by calling `mpf.show()`',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+
+        'return_calculated_values'  : { 'Default'     : None,
+                                        'Description' : 'set to a variable containing an empty dict; `mpf.plot()` will fill'+
+                                                        ' the dict with various mplfinance calculated values',
+                                        'Validator'   : lambda value: isinstance(value, dict) and len(value) == 0},
+
+        'set_ylim'                  : { 'Default'     : None,
+                                        'Description' : 'deprecated',
+                                        'Validator'   : lambda value: _warn_set_ylim_deprecated(value) },
+ 
+        'ylim'                      : { 'Default'     : None,
+                                        'Description' : 'Limits for y-axis as tuple (min,max), i.e. (bottom,top)',
+                                        'Validator'   : lambda value: isinstance(value, (list,tuple)) and len(value) == 2 
+                                                                      and all([isinstance(v,(int,float)) for v in value])},
+ 
+        'xlim'                      : { 'Default'     : None,
+                                        'Description' : 'Limits for x-axis as tuple (min,max), i.e. (left,right)',
+                                        'Validator'   : lambda value: _xlim_validator(value) },
+ 
+        'set_ylim_panelB'           : { 'Default'     : None,
+                                        'Description' : 'deprecated',
+                                        'Validator'   : lambda value: _warn_set_ylim_deprecated(value) },
+ 
+        'hlines'                    : { 'Default'     : None, 
+                                        'Description' : 'Draw one or more HORIZONTAL LINES across entire plot, by'+
+                                                        ' specifying a price, or sequence of prices.  May also be a dict'+
+                                                        ' with key `hlines` specifying a price or sequence of prices, plus'+
+                                                        ' one or more of the following keys: `colors`, `linestyle`,'+
+                                                        ' `linewidths`, `alpha`.',
+                                        'Validator'   : lambda value: _hlines_validator(value) },
+ 
+        'vlines'                    : { 'Default'     : None, 
+                                        'Description' : 'Draw one or more VERTICAL LINES across entire plot, by'+
+                                                        ' specifying a date[time], or sequence of date[time].  May also'+
+                                                        ' be a dict with key `vlines` specifying a date[time] or sequence'+
+                                                        ' of date[time], plus one or more of the following keys:'+
+                                                        ' `colors`, `linestyle`, `linewidths`, `alpha`.',
+                                        'Validator'   : lambda value: _vlines_validator(value) },
+
+        'alines'                    : { 'Default'     : None, 
+                                        'Description' : 'Draw one or more ARBITRARY LINES anywhere on the plot, by'+
+                                                        ' specifying a sequence of two or more date/price pairs, or by'+
+                                                        ' specifying a sequence of sequences of two or more date/price pairs.'+
+                                                        ' May also be a dict with key `alines` (as date/price pairs described above),'+
+                                                        ' plus one or more of the following keys:'+
+                                                        ' `colors`, `linestyle`, `linewidths`, `alpha`.',
+                                        'Validator'   : lambda value: _alines_validator(value) },
+ 
+        'tlines'                    : { 'Default'     : None, 
+                                        'Description' : 'Draw one or more TREND LINES by specifying one or more pairs of date[times]'+
+                                                        ' between which each trend line should be drawn.  May also be a dict with key'+
+                                                        ' `tlines` as just described, plus one or more of the following keys:'+
+                                                        ' `colors`, `linestyle`, `linewidths`, `alpha`, `tline_use`,`tline_method`.',
+                                        'Validator'   : lambda value: _tlines_validator(value) },
+       
+        'panel_ratios'              : { 'Default'     : None,
+                                        'Description' : 'sequence of numbers indicating relative sizes of panels; sequence len'+
+                                                        ' must be same as number of panels, or len 2 where first entry is for'+
+                                                        ' main panel, and second entry is for all other panels',
+                                        'Validator'   : lambda value: isinstance(value,(tuple,list)) and len(value) <= 32 and
+                                                                      all([isinstance(v,(int,float)) for v in value]) },
+
+        'main_panel'                : { 'Default'     : 0,
+                                        'Description' : 'integer - which panel is the main panel for `.plot()`',
+                                        'Validator'   : lambda value: _valid_panel_id(value) },
+
+        'volume_panel'              : { 'Default'     : 1,
+                                        'Description' : 'integer - which panel is the volume panel',
+                                        'Validator'   : lambda value: _valid_panel_id(value) },
+
+        'num_panels'                : { 'Default'     : None,
+                                        'Description' : 'total number of panels',
+                                        'Validator'   : lambda value: isinstance(value,int) and value in range(1,32+1) },
+
+        'datetime_format'           : { 'Default'     : None,
+                                        'Description' : 'x-axis tick format as valid `strftime()` format string',
+                                        'Validator'   : lambda value: isinstance(value,str) },
+
+        'xrotation'                 : { 'Default'     : 45,
+                                        'Description' : 'Angle (degrees) for x-axis tick labels; 90=vertical',
+                                        'Validator'   : lambda value: isinstance(value,(int,float)) },
+
+        'axisoff'                   : { 'Default'     : False,
+                                        'Description' : '`axisoff=True` means do NOT display any axis.',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+
+        'closefig'                  : { 'Default'     : 'auto',
+                                        'Description' : 'True|False close the Figure before returning',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+
+        'fill_between'              : { 'Default'     : None,
+                                        'Description' : 'fill between specification as y-value, or sequence of'+
+                                                        ' y-values, or dict containing key "y1" plus any additional'+
+                                                        ' kwargs for `fill_between()`',
+                                        'Validator'   : _fill_between_validator },
+
+        'tight_layout'              : { 'Default'     : False,
+                                        'Description' : 'True|False implement tight layout (minimal padding around Figure)'+
+                                                        ' (see also `scale_padding` kwarg)',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+
+        'scale_padding'             : { 'Default'     : 1.0,   # Issue#193 
+                                        'Description' : 'Increase, > 1.0, or decrease, < 1.0, padding around figure.'+
+                                                        ' May also be a dict containing one or more of the following keys:'+
+                                                        ' "top", "bottom", "left", "right", to individual scale padding'+
+                                                        ' on each side of Figure.',
+                                        'Validator'   : lambda value: _scale_padding_validator(value) },
+
+        'width_adjuster_version'    : { 'Default'     : 'v1',
+                                        'Description' : 'specify version of object width adjustment algorithm: "v0" or "v1"'+
+                                                        ' (See also "widths" tutorial in mplfinance examples folder).',
+                                        'Validator'   : lambda value: value in ('v0', 'v1') },
+
+        'scale_width_adjustment'    : { 'Default'     : None,
+                                        'Description' : 'scale width of plot objects wider, > 1.0, or narrower, < 1.0'+
+                                                        ' may also be a dict to scale individual widths.'+
+                                                        ' (See also "widths" tutorial in mplfinance examples folder).',
+                                        'Validator'   : lambda value: isinstance(value,dict) and len(value) > 0 },
+
+        'update_width_config'       : { 'Default'     : None,
+                                        'Description' : 'dict - update individual items in width configuration.'+
+                                                        ' (See also "widths" tutorial in mplfinance examples folder).',
+                                        'Validator'   : lambda value: isinstance(value,dict) and len(value) > 0 },
+
+        'return_width_config'       : { 'Default'     : None,
+                                        'Description' : 'empty dict variable to be filled with width configuration settings.',
+                                        'Validator'   : lambda value: isinstance(value,dict) and len(value)==0 },
+
+        'saxbelow'                  : { 'Default'     : True,  # Issue#115 Comment#639446764
+                                        'Description' : 'set the volume Axes below (behind) all other Axes objects',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+        
+        'ax'                        : { 'Default'     : None,
+                                        'Description' : 'Matplotlib Axes object on which to plot',
+                                        'Validator'   : lambda value: isinstance(value,mpl_axes.Axes) },
+
+        'volume_exponent'           : { 'Default'     : None,
+                                        'Description' : 'integer exponent on the volume axis'+
+                                                        ' (or set to "legacy" for old mplfinance style)',
+                                        'Validator'   : lambda value: isinstance(value,int) or value == 'legacy'},
+
+        'tz_localize'               : { 'Default'     : True,
+                                        'Description' : 'True|False localize the times in the DatetimeIndex',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+
+        'yscale'                    : { 'Default'     : None,
+                                        'Description' : 'y-axis scale: "linear", "log", "symlog", or "logit"',
+                                        'Validator'   : lambda value: _yscale_validator(value) },
+
+        'volume_yscale'             : { 'Default'     : None,
+                                        'Description' : 'Volume y-axis scale: "linear", "log", "symlog", or "logit"',
+                                        'Validator'   : lambda value: _yscale_validator(value) },
+
+        'volume_ylim'               : { 'Default'     : None,
+                                        'Description' : 'Volume y-axis limits as tuple (min,max), i.e. (bottom,top)',
+                                        'Validator'   : lambda value: isinstance(value, (list,tuple)) and len(value) == 2
+                                                        and all([isinstance(v,(int,float)) for v in value])},
+
+        'volume_alpha'              : { 'Default'     : 1,  # alpha of Volume bars
+                                        'Description' : 'opacity for Volume bar: 0.0 (transparent) to 1.0 (opaque)',
+                                        'Validator'   : lambda value: isinstance(value,(int,float)) or
+                                                        all([isinstance(v,(int,float)) for v in value]) },
+
+        'warn_too_much_data'        : { 'Default'     : 599,
+                                        'Description' : 'Tolerance for data amount in plot. Default=599 rows.'+
+                                                        ' Values greater than \'warn_too_much_data\' will trigger a warning.',
+                                        'Validator'   : lambda value: isinstance(value,int) },
+    }
+
+    _validate_vkwargs_dict(vkwargs)
+
+    return vkwargs
+
+###@with_rc_context
+def plot( data, **kwargs ):
+    """
+    Given a Pandas DataFrame containing columns Open,High,Low,Close and optionally Volume
+    with a DatetimeIndex, plot the data.
+    Available plots include ohlc bars, candlestick, and line plots.
+    Also provide visually analysis in the form of common technical studies, such as:
+    moving averages, renko, etc.
+    Also provide ability to plot trading signals, and/or addtional user-defined data.
+    """
+
+    config = _process_kwargs(kwargs, _valid_plot_kwargs())
+
+    # translate alias types:
+    config['type'] = _get_valid_plot_types(config['type'])
+    
+    dates,opens,highs,lows,closes,volumes = _check_and_prepare_data(data, config)
+
+    config['xlim'] = _check_and_convert_xlim_configuration(data, config)
+
+    if config['type'] in VALID_PMOVE_TYPES and config['addplot'] is not None:
+        err = "`addplot` is not supported for `type='" + config['type'] +"'`"
+        raise ValueError(err)
+
+    if config['marketcolor_overrides'] is not None:
+        if len(config['marketcolor_overrides']) != len(dates):
+            raise ValueError('`marketcolor_overrides` must be same length as dataframe.')
+
+    external_axes_mode = _check_for_external_axes(config)
+
+    if external_axes_mode:
+        if config['figscale'] is not None:
+            warnings.warn('\n\n ================================================================= '+
+                          '\n\n   WARNING: `figscale` has NO effect in External Axes Mode.'+
+                          '\n\n ================================================================ ',
+                          category=UserWarning)
+        if config['figratio'] is not None:
+            warnings.warn('\n\n ================================================================= '+
+                          '\n\n   WARNING: `figratio` has NO effect in External Axes Mode.'+
+                          '\n\n ================================================================ ',
+                          category=UserWarning)
+        if config['figsize'] is not None:
+            warnings.warn('\n\n ================================================================= '+
+                          '\n\n   WARNING: `figsize` has NO effect in External Axes Mode.'+
+                          '\n\n ================================================================ ',
+                          category=UserWarning)
+    else:
+        if config['figscale'] is None: config['figscale'] = 1.0
+        if config['figratio'] is None: config['figratio'] = DEFAULT_FIGRATIO
+
+    style = config['style']
+
+    if external_axes_mode and hasattr(config['ax'],'mpfstyle') and style is None:
+        style = config['ax'].mpfstyle
+    elif style is None:
+        style = 'default'
+
+    if isinstance(style,str):
+        style = _styles._get_mpfstyle(style)
+
+    config['style'] = style
+
+    if isinstance(style,dict):
+        if not external_axes_mode: _styles._apply_mpfstyle(style)
+    else:
+        raise TypeError('style should be a `dict`; why is it not?')
+
+    if not external_axes_mode:
+        fig = plt.figure()
+        _adjust_figsize(fig,config)
+    else:
+        fig = None
+
+    _adjust_fontsize(config)
+
+    if config['volume'] and volumes is None:
+        raise ValueError('Request for volume, but NO volume data.')
+
+    if external_axes_mode:
+        panels = None
+        axA1   = config['ax']
+        axA1.set_axisbelow(config['saxbelow'])
+        if config['volume']:
+            volumeAxes = config['volume']
+            volumeAxes.set_axisbelow(config['saxbelow'])
+    else:
+        panels = _build_panels(fig, config)
+        axA1 = panels.at[config['main_panel'],'axes'][0]
+        if config['volume']:
+            if config['volume_panel'] == config['main_panel']:
+                # ohlc and volume on same panel: move volume to secondary axes:
+                volumeAxes = panels.at[config['volume_panel'],'axes'][1]
+                volumeAxes.set_zorder(axA1.get_zorder()-0.1) # Make sure ohlc is above volume
+                axA1.patch.set_visible(False)                # Let volume show through
+                panels.at[config['main_panel'],'used2nd'] = True
+            else:
+                volumeAxes = panels.at[config['volume_panel'],'axes'][0]
+        else:
+            volumeAxes = None
+
+    fmtstring = _determine_format_string(dates, config['datetime_format'])
+
+    ptype = config['type'] 
+
+    if config['show_nontrading']:
+        formatter = mdates.DateFormatter(fmtstring)
+        xdates = dates
+    else:
+        formatter = IntegerIndexDateTimeFormatter(dates, fmtstring)
+        xdates = np.arange(len(dates))
+
+    # Will have to handle widths config separately for PMOVE types ??
+    config['_width_config'] = _determine_width_config(xdates, config)
+
+    rwc = config['return_width_config']
+    if isinstance(rwc,dict) and len(rwc)==0:
+        config['return_width_config'].update(config['_width_config'])
+
+    collections = None
+    if ptype == 'line':
+        lw = config['_width_config']['line_width']
+        axA1.plot(xdates, closes, color=config['linecolor'], linewidth=lw)
+    else:
+        collections =_construct_mpf_collections(ptype,dates,xdates,opens,highs,lows,closes,volumes,config,style)
+
+    if ptype in VALID_PMOVE_TYPES:
+        collections, calculated_values = collections
+        volumes       = calculated_values['volumes']
+        pmove_dates   = calculated_values['dates']
+        pmove_values  = calculated_values['values']
+        if all([isinstance(v,(list,tuple)) for v in pmove_values]):
+            pmove_avgvals = [sum(v)/len(v) for v in pmove_values]
+        else:
+            pmove_avgvals = pmove_values
+        pmove_size    = calculated_values['size']
+        pmove_counts  = calculated_values['counts'] if 'counts' in calculated_values else None
+        formatter = IntegerIndexDateTimeFormatter(pmove_dates, fmtstring)
+        xdates = np.arange(len(pmove_dates))
+
+    if collections is not None:
+        for collection in collections:
+            axA1.add_collection(collection)
+
+    if ptype in VALID_PMOVE_TYPES:
+        mavprices = _plot_mav(axA1,config,xdates,pmove_avgvals)
+    else:
+        mavprices = _plot_mav(axA1,config,xdates,closes)
+
+    avg_dist_between_points = (xdates[-1] - xdates[0]) / float(len(xdates))
+    if not config['tight_layout']:
+        minx = xdates[0]  - avg_dist_between_points
+        maxx = xdates[-1] + avg_dist_between_points
+    else:
+        minx = xdates[0]  - (0.45 * avg_dist_between_points)
+        maxx = xdates[-1] + (0.45 * avg_dist_between_points)
+
+    if len(xdates) == 1:  # kludge special case
+        minx = minx - 0.75
+        maxx = maxx + 0.75
+    if ptype not in VALID_PMOVE_TYPES:
+        _lows  = lows
+        _highs = highs
+    else:
+        _lows  = pmove_avgvals
+        _highs = [value+pmove_size for value in pmove_avgvals]
+
+    miny = np.nanmin(_lows)
+    maxy = np.nanmax(_highs)
+
+    if config['ylim'] is not None:
+        axA1.set_ylim(config['ylim'][0], config['ylim'][1])
+    elif config['tight_layout']:
+        ydelta = 0.01 * (maxy-miny)
+        if miny > 0.0:
+            # don't let it go negative:
+            setminy = max(0.9*miny,miny-ydelta)
+        else:
+            setminy = miny-ydelta
+        axA1.set_ylim(setminy,maxy+ydelta)
+
+    if config['xlim'] is not None:
+        axA1.set_xlim(config['xlim'][0], config['xlim'][1])
+    elif config['tight_layout']:
+        axA1.set_xlim(minx,maxx)
+
+    if (config['ylim'] is None and
+        config['xlim'] is None and
+        not config['tight_layout']):
+        corners = (minx, miny), (maxx, maxy)
+        axA1.update_datalim(corners)
+
+    if config['return_calculated_values'] is not None:
+        retdict = config['return_calculated_values']
+        if ptype == 'renko':
+            retdict['renko_bricks' ] = pmove_values
+            retdict['renko_dates'  ] = mdates.num2date(pmove_dates)
+            retdict['renko_size'   ] = pmove_size
+            retdict['renko_volumes'] = volumes if config['volume'] else None
+        elif ptype == 'pnf':
+            retdict['pnf_dates'    ] = mdates.num2date(pmove_dates)
+            retdict['pnf_counts'   ] = pmove_counts
+            retdict['pnf_values'   ] = pmove_values
+            retdict['pnf_avgvals'  ] = pmove_avgvals
+            retdict['pnf_size'     ] = pmove_size
+            retdict['pnf_volumes'  ] = volumes if config['volume'] else None
+        if config['mav'] is not None:
+            mav = config['mav']
+            if len(mav) != len(mavprices):
+                warnings.warn('len(mav)='+str(len(mav))+' BUT len(mavprices)='+str(len(mavprices)))
+            else:
+                for jj in range(0,len(mav)):     
+                    retdict['mav' + str(mav[jj])] = mavprices[jj]
+        retdict['minx'] = minx
+        retdict['maxx'] = maxx
+        retdict['miny'] = miny
+        retdict['maxy'] = maxy
+
+    # Note: these are NOT mutually exclusive, so the order of this
+    #       if/elif is important: VALID_PMOVE_TYPES must be first.
+    if ptype in VALID_PMOVE_TYPES:
+        dtix = pd.DatetimeIndex([dt for dt in mdates.num2date(pmove_dates)])
+    elif not config['show_nontrading']:
+        dtix = data.index
+    else:
+        dtix = None
+
+    line_collections = []
+    line_collections.append(_construct_aline_collections(config['alines'], dtix))
+    line_collections.append(_construct_hline_collections(config['hlines'], minx, maxx))
+    line_collections.append(_construct_vline_collections(config['vlines'], dtix, miny, maxy))
+    tlines = config['tlines']
+    if isinstance(tlines,(list,tuple)) and all([isinstance(item,dict) for item in tlines]):
+        pass
+    else:
+        tlines = [tlines,]
+    for tline_item in tlines:
+        line_collections.append(_construct_tline_collections(tline_item, dtix, dates, opens, highs, lows, closes))
+     
+    for collection in line_collections:
+        if collection is not None:
+            axA1.add_collection(collection)
+
+    datalen = len(xdates)
+    if config['volume']:
+        vup,vdown = style['marketcolors']['volume'].values()
+        #-- print('vup,vdown=',vup,vdown)
+        vcolors = _updown_colors(vup, vdown, opens, closes, use_prev_close=style['marketcolors']['vcdopcod'])
+        #-- print('len(vcolors),len(opens),len(closes)=',len(vcolors),len(opens),len(closes))
+        #-- print('vcolors=',vcolors)
+
+        w  = config['_width_config']['volume_width']
+        lw = config['_width_config']['volume_linewidth']
+
+        adjc = _adjust_color_brightness(vcolors,0.90)
+        valp = config['volume_alpha']
+        volumeAxes.bar(xdates,volumes,width=w,linewidth=lw,color=vcolors,ec=adjc,alpha=valp)
+        if config['volume_ylim'] is not None:
+            vymin = config['volume_ylim'][0]
+            vymax = config['volume_ylim'][1]
+        else:
+            vymin = 0.3 * np.nanmin(volumes)
+            vymax = 1.1 * np.nanmax(volumes)
+        volumeAxes.set_ylim(vymin,vymax)
+
+    xrotation = config['xrotation']
+    if not external_axes_mode:
+        _set_ticks_on_bottom_panel_only(panels,formatter,rotation=xrotation)
+    else:
+        axA1.tick_params(axis='x',rotation=xrotation)
+        axA1.xaxis.set_major_formatter(formatter)
+
+    ysd = config['yscale']
+    if isinstance(ysd,dict):
+        yscale = ysd['yscale']
+        del      ysd['yscale']
+        axA1.set_yscale(yscale,**ysd)
+    elif isinstance(ysd,str):
+        axA1.set_yscale(ysd)
+ 
+
+    addplot = config['addplot']
+    if addplot is not None and ptype not in VALID_PMOVE_TYPES:
+        # NOTE: If in external_axes_mode, then all code relating
+        #       to panels and secondary_y becomes irrrelevant.
+        #       If the user wants something on a secondary_y then user should
+        #       determine that externally, and pass in the appropriate axes.
+
+        if not external_axes_mode:
+            # Calculate the Order of Magnitude Range ('mag')
+            # If addplot['secondary_y'] == 'auto', then: If the addplot['data']
+            # is out of the Order of Magnitude Range, then use secondary_y.
+
+            lo = math.log(max(math.fabs(np.nanmin(lows)),1e-7),10) - 0.5
+            hi = math.log(max(math.fabs(np.nanmax(highs)),1e-7),10) + 0.5
+
+            panels['mag'] = [None]*len(panels)  # create 'mag'nitude column
+
+            panels.at[config['main_panel'],'mag'] = {'lo':lo,'hi':hi} # update main panel magnitude range
+
+            if config['volume']:
+                lo = math.log(max(math.fabs(np.nanmin(volumes)),1e-7),10) - 0.5
+                hi = math.log(max(math.fabs(np.nanmax(volumes)),1e-7),10) + 0.5
+                panels.at[config['volume_panel'],'mag'] = {'lo':lo,'hi':hi}
+
+        if isinstance(addplot,dict):
+            addplot = [addplot,]   # make list of dict to be consistent
+
+        elif not _list_of_dict(addplot):
+            raise TypeError('addplot must be `dict`, or `list of dict`, NOT '+str(type(addplot)))
+
+        for apdict in addplot:
+
+            panid = apdict['panel'] 
+            if not external_axes_mode:
+                if   panid == 'main' : panid = 0  # for backwards compatibility
+                elif panid == 'lower': panid = 1  # for backwards compatibility
+                if apdict['y_on_right'] is not None:
+                    panels.at[panid,'y_on_right'] = apdict['y_on_right']
+
+            aptype = apdict['type']
+            if aptype == 'ohlc' or aptype == 'candle':
+                ax = _addplot_collections(panid,panels,apdict,xdates,config)
+                _addplot_apply_supplements(ax,apdict,xdates)
+            else:         
+                apdata = apdict['data']
+                if isinstance(apdata,list) and not isinstance(apdata[0],(float,int)):
+                    raise TypeError('apdata is list but NOT of float or int')
+                if isinstance(apdata,pd.DataFrame): 
+                    havedf = True
+                else:
+                    havedf = False      # must be a single series or array
+                    apdata = [apdata,]  # make it iterable
+                for column in apdata:
+                    ydata = apdata.loc[:,column] if havedf else column
+                    ax = _addplot_columns(panid,panels,ydata,apdict,xdates,config)
+                    _addplot_apply_supplements(ax,apdict,xdates)
+
+    # fill_between is NOT supported for external_axes_mode
+    # (caller can easily call ax.fill_between() themselves).
+    if config['fill_between'] is not None and not external_axes_mode:
+        fblist = copy.deepcopy(config['fill_between'])
+        if _num_or_seq_of_num(fblist):
+            fblist = [dict(y1=fblist),]
+        elif isinstance(fblist,dict):
+            fblist = [fblist,]
+        if not _list_of_dict(fblist):
+            raise TypeError('Bad type for `fill_between` specifier.')
+        for fb in fblist:
+            if 'x' in fb:
+                raise ValueError('fill_between dict may not contain `x`')
+            panid = config['main_panel']
+            if 'panel' in fb:
+                panid = fb['panel']
+                del fb['panel']
+            fb['x'] = xdates # add 'x' to caller's fb dict
+            ax = panels.at[panid,'axes'][0]
+            ax.fill_between(**fb)
+            
+    # put the primary axis on one side,
+    # and the twinx() on the "other" side:
+    if not external_axes_mode:
+        for panid,row in panels.iterrows():
+            ax = row['axes']
+            y_on_right = style['y_on_right'] if row['y_on_right'] is None else row['y_on_right']
+            _set_ylabels_side(ax[0],ax[1],y_on_right)
+    else:
+        y_on_right = style['y_on_right']
+        _set_ylabels_side(axA1,None,y_on_right)
+
+    # TODO: ================================================================
+    # TODO:  Investigate:
+    # TODO:  ===========
+    # TODO:  It appears to me that there may be some or significant overlap
+    # TODO:  between what the following functions actually do:
+    # TODO:  At the very least, all four of them appear to communicate 
+    # TODO:  to matplotlib that the xaxis should be treated as dates:
+    # TODO:   ->  'ax.autoscale_view()'
+    # TODO:   ->  'ax.xaxis_dates()'
+    # TODO:   ->  'plt.autofmt_xdates()'
+    # TODO:   ->  'fig.autofmt_xdate()'
+    # TODO: ================================================================
+    
+
+    #if config['autofmt_xdate']:
+        #print('CALLING fig.autofmt_xdate()')
+        #fig.autofmt_xdate()
+
+    axA1.autoscale_view()  # Is this really necessary??
+                           # It appears to me, based on experience coding types 'ohlc' and 'candle'
+                           # for `addplot`, that this IS necessary when the only thing done to the
+                           # the axes is .add_collection().  (However, if ax.plot() .scatter() or
+                           # .bar() was called, then possibly this is not necessary; not entirely
+                           # sure, but it definitely was necessary to get 'ohlc' and 'candle' 
+                           # working in `addplot`).
+
+    axA1.set_ylabel(config['ylabel'])
+    axA1.set_xlabel(config['xlabel'])
+
+    if config['volume']:
+        if external_axes_mode:
+            volumeAxes.tick_params(axis='x',rotation=xrotation)
+            volumeAxes.xaxis.set_major_formatter(formatter)
+
+        vscale = 'linear'
+        ysd = config['volume_yscale']
+        if isinstance(ysd,dict):
+            yscale = ysd['yscale']
+            del      ysd['yscale']
+            volumeAxes.set_yscale(yscale,**ysd)
+            vscale = yscale
+        elif isinstance(ysd,str):
+            volumeAxes.set_yscale(ysd)
+            vscale = ysd
+        offset = ''
+        if vscale == 'linear':
+            vxp = config['volume_exponent']
+            if vxp == 'legacy':
+                volumeAxes.figure.canvas.draw()  # This is needed to calculate offset
+                offset = volumeAxes.yaxis.get_major_formatter().get_offset()
+                if len(offset) > 0:
+                    offset = (' x '+offset)
+            elif isinstance(vxp,int) and vxp > 0:
+                volumeAxes.ticklabel_format(useOffset=False,scilimits=(vxp,vxp),axis='y')
+                offset = '  $10^{'+str(vxp)+'}$'
+            elif isinstance(vxp,int) and vxp == 0:
+                volumeAxes.ticklabel_format(useOffset=False,style='plain',axis='y')
+                offset = ''
+            else:
+                offset = ''
+                scilims = plt.rcParams['axes.formatter.limits']
+                if scilims[0] < scilims[1]:
+                    for power in (5,4,3,2,1):
+                        xp = scilims[1]*power
+                        if vymax >= 10.**xp:
+                            volumeAxes.ticklabel_format(useOffset=False,scilimits=(xp,xp),axis='y')
+                            offset = '  $10^{'+str(xp)+'}$'
+                            break
+                elif scilims[0] == scilims[1] and scilims[1] != 0:
+                    volumeAxes.ticklabel_format(useOffset=False,scilimits=scilims,axis='y')
+                    offset = ' $10^'+str(scilims[1])+'$'
+            volumeAxes.yaxis.offsetText.set_visible(False)
+
+        if config['ylabel_lower'] is None:
+            vol_label = 'Volume'+offset
+        else:
+            if len(offset) > 0:
+                offset = '\n'+offset
+            vol_label = config['ylabel_lower'] + offset
+        volumeAxes.set_ylabel(vol_label)
+    
+    if config['title'] is not None:
+        if config['tight_layout']:
+            # IMPORTANT: `y=0.89` is based on the top of the top panel
+            #            being at 0.18+0.7 = 0.88.  See _panels.py
+            # If the value changes there, then it needs to change here.
+            title_kwargs = dict(va='bottom', y=0.89)
+        else:
+            title_kwargs = dict(va='center')
+        if isinstance(config['title'],dict):
+            title_dict = config['title']
+            if 'title' not in title_dict:
+                raise ValueError('Must have "title" entry in title dict')
+            else:
+                title = title_dict['title']
+                del title_dict['title']
+            title_kwargs.update(title_dict)  # allows override default values set by mplfinance above
+        else:
+            title = config['title']      # config['title'] is a string
+        fig.suptitle(title,**title_kwargs)
+    
+    
+    if config['axtitle'] is not None:
+        axA1.set_title(config['axtitle'])
+
+    if not external_axes_mode:
+        for panid,row in panels.iterrows():
+            if not row['used2nd']:
+                row['axes'][1].set_visible(False)
+
+    if external_axes_mode:
+        return None
+
+    # Should we create a new kwarg to return a flattened axes list
+    # versus a list of tuples of primary and secondary axes?
+    # For now, for backwards compatibility, we flatten axes list:
+    axlist = [ax for axes in panels['axes'] for ax in axes]
+
+    if config['axisoff']:
+        for ax in axlist:
+            ax.set_axis_off()
+
+    if config['savefig'] is not None:
+        save = config['savefig']
+        if isinstance(save,dict):
+            if config['tight_layout'] and 'bbox_inches' not in save:
+                fig.savefig(**save,bbox_inches='tight')
+            else:
+                fig.savefig(**save)
+        else:
+            if config['tight_layout']:
+                fig.savefig(save,bbox_inches='tight')
+            else:
+                fig.savefig(save)
+        if config['closefig']: # True or 'auto'
+            plt.close(fig)
+    elif not config['returnfig']:
+        plt.show(block=config['block']) # https://stackoverflow.com/a/13361748/1639359
+        if config['closefig'] == True or (config['block'] and config['closefig']):
+            plt.close(fig)
+    
+    if config['returnfig']:
+        if config['closefig'] == True: plt.close(fig)
+        return (fig, axlist)
+
+    # rcp   = copy.deepcopy(plt.rcParams)
+    # rcpdf = rcParams_to_df(rcp)
+    # print('type(rcpdf)=',type(rcpdf))
+    # print('rcpdfhead(3)=',rcpdf.head(3))
+    # return # rcpdf
+
+def _adjust_figsize(fig,config):
+    if fig is None:
+        return
+    if config['figsize'] is None:
+        w,h = config['figratio']
+        r = float(w)/float(h)
+        if r < 0.20 or r > 5.0:
+            raise ValueError('"figratio" (aspect ratio)  must be between 0.20 and 5.0 (but is '+str(r)+')')
+        default_scale = DEFAULT_FIGRATIO[1]/h
+        h *= default_scale
+        w *= default_scale
+        base      = (w,h)
+        figscale  = config['figscale']
+        fsize     = [d*figscale for d in base]
+    else:
+        fsize = config['figsize']
+    fig.set_size_inches(fsize)
+
+def _adjust_fontsize(config):
+    if config['fontscale'] is None:
+        return
+    if not isinstance(plt.rcParams['font.size'],(float,int)):
+        warnings.warn('\n\n ================================================================= '+
+                      '\n\n   WARNING: Unable to scale fonts: plt.rcParams["font.size"] is NOT a float!'+
+                      '\n\n ================================================================ ',
+                      category=UserWarning)
+        return
+    plt.rcParams['font.size'] *= config['fontscale']
+    # --------------------------------------------
+    # From: matplotlib.font_manager.font_scalings:
+    #    font_scalings = {
+    #        'xx-small': 0.579,
+    #        'x-small':  0.694,
+    #        'small':    0.833,
+    #        'medium':   1.0,
+    #        'large':    1.200,
+    #        'x-large':  1.440,
+    #        'xx-large': 1.728,
+    #        'larger':   1.2,
+    #        'smaller':  0.833,
+    #        None:       1.0,
+    #    }
+    # --------------------------------------------
+    fontstuff = ['axes.labelsize','axes.titlesize', 'figure.titlesize','legend.fontsize',
+                 'legend.title_fontsize','xtick.labelsize','ytick.labelsize']
+    for item in fontstuff:
+        if isinstance(plt.rcParams[item],(float,int)):
+            plt.rcParams[item] *= config['fontscale']
+
+def _addplot_collections(panid,panels,apdict,xdates,config):
+
+    apdata = apdict['data']
+    aptype = apdict['type']
+    external_axes_mode = apdict['ax'] is not None
+   
+    #--------------------------------------------------------------#
+    # Note: _auto_secondary_y() sets the 'magnitude' column in the
+    #       `panels` dataframe, which is needed for automatically
+    #       determining if secondary_y is needed.  Therefore we call
+    #       _auto_secondary_y() for *all* addplots, even those that
+    #       are set to True or False (not 'auto') for secondary_y
+    #       because their magnitudes may be needed if *any* apdicts
+    #       contain secondary_y='auto'.
+    #       In theory we could first loop through all apdicts to see
+    #       if any have secondary_y='auto', but since that is the
+    #       default value, we will just assume we have at least one.
+
+    valid_apc_types = ['ohlc','candle']
+    if aptype not in valid_apc_types:
+        raise TypeError('Invalid aptype='+str(aptype)+'. Must be one of '+str(valid_apc_types))
+    if not isinstance(apdata,pd.DataFrame):
+        raise TypeError('addplot type "'+aptype+'" MUST be accompanied by addplot data of type `pd.DataFrame`')
+    d,o,h,l,c,v = _check_and_prepare_data(apdata,config)
+    
+    mc = apdict['marketcolors']
+    if _is_marketcolor_object(mc):
+        apstyle = config['style'].copy()
+        apstyle['marketcolors'] = mc
+    else:
+        apstyle = config['style']
+    
+    collections = _construct_mpf_collections(aptype,d,xdates,o,h,l,c,v,config,apstyle)
+
+    if not external_axes_mode:
+        lo = math.log(max(math.fabs(np.nanmin(l)),1e-7),10) - 0.5
+        hi = math.log(max(math.fabs(np.nanmax(h)),1e-7),10) + 0.5
+        secondary_y = _auto_secondary_y( panels, panid, lo, hi )
+        if 'auto' != apdict['secondary_y']:
+            secondary_y = apdict['secondary_y'] 
+        if secondary_y:
+            ax = panels.at[panid,'axes'][1] 
+            panels.at[panid,'used2nd'] = True
+        else: 
+            ax = panels.at[panid,'axes'][0]
+    else:
+        ax = apdict['ax']
+
+    for coll in collections:
+        ax.add_collection(coll)
+    if apdict['mav'] is not None:
+        apmavprices = _plot_mav(ax,config,xdates,c,apdict['mav'])
+    ax.autoscale_view()
+    return ax
+
+def _addplot_columns(panid,panels,ydata,apdict,xdates,config):
+    external_axes_mode = apdict['ax'] is not None
+    if not external_axes_mode:
+        secondary_y = False
+        if apdict['secondary_y'] == 'auto':
+            yd = [y for y in ydata if not math.isnan(y)]
+            ymhi = math.log(max(math.fabs(np.nanmax(yd)),1e-7),10)
+            ymlo = math.log(max(math.fabs(np.nanmin(yd)),1e-7),10)
+            secondary_y = _auto_secondary_y( panels, panid, ymlo, ymhi )
+        else:
+            secondary_y = apdict['secondary_y']
+            #print("apdict['secondary_y'] says secondary_y is",secondary_y)
+
+        if secondary_y:
+            ax = panels.at[panid,'axes'][1] 
+            panels.at[panid,'used2nd'] = True
+        else: 
+            ax = panels.at[panid,'axes'][0]
+    else:
+        ax = apdict['ax']
+
+    aptype = apdict['type']
+    if aptype == 'scatter':
+        size  = apdict['markersize']
+        mark  = apdict['marker']
+        color = apdict['color']
+        alpha = apdict['alpha']
+        edgecolors  = apdict['edgecolors']
+        linewidths = apdict['linewidths']
+
+        if isinstance(mark,(list,tuple,np.ndarray)):
+            _mscatter(xdates, ydata, ax=ax, m=mark, s=size, color=color, alpha=alpha, edgecolors=edgecolors, linewidths=linewidths)
+        else:
+            ax.scatter(xdates, ydata, s=size, marker=mark, color=color, alpha=alpha, edgecolors=edgecolors, linewidths=linewidths)
+    elif aptype == 'bar':
+        width  = 0.8 if apdict['width'] is None else apdict['width']
+        bottom = apdict['bottom']
+        color  = apdict['color']
+        alpha  = apdict['alpha']
+        ax.bar(xdates,ydata,width=width,bottom=bottom,color=color,alpha=alpha)
+    elif aptype == 'line':
+        ls     = apdict['linestyle']
+        color  = apdict['color']
+        width  = apdict['width'] if apdict['width'] is not None else 1.6*config['_width_config']['line_width']
+        alpha  = apdict['alpha']
+        ax.plot(xdates,ydata,linestyle=ls,color=color,linewidth=width,alpha=alpha)
+    elif aptype == 'step':
+        stepwhere = apdict['stepwhere']
+        ls = apdict['linestyle']
+        color  = apdict['color']
+        width  = apdict['width'] if apdict['width'] is not None else 1.6*config['_width_config']['line_width']
+        alpha  = apdict['alpha']
+        ax.step(xdates,ydata,where = stepwhere,linestyle=ls,color=color,linewidth=width,alpha=alpha)
+    else:
+        raise ValueError('addplot type "'+str(aptype)+'" NOT yet supported.')
+
+    if apdict['mav'] is not None:
+        apmavprices = _plot_mav(ax,config,xdates,ydata,apdict['mav'])
+
+    return ax
+
+def _addplot_apply_supplements(ax,apdict,xdates):
+    if (apdict['ylabel'] is not None):
+        ax.set_ylabel(apdict['ylabel'])
+    if (apdict['xlabel'] is not None):
+        ax.set_xlabel(apdict['xlabel'])
+    if apdict['ylim'] is not None:
+        ax.set_ylim(apdict['ylim'][0],apdict['ylim'][1])
+    if apdict['title'] is not None:
+        ax.set_title(apdict['title'])
+    ysd = apdict['yscale']
+    if isinstance(ysd,dict):
+        yscale = ysd['yscale']
+        del      ysd['yscale']
+        ax.set_yscale(yscale,**ysd)
+    elif isinstance(ysd,str):
+        ax.set_yscale(ysd)
+    # added by Wen
+    if "fill_between" in apdict and apdict['fill_between'] is not None:
+        # deep copy because mplfinance code sometimes modifies the fill_between dict
+        fblist = copy.deepcopy(apdict['fill_between'])
+        if isinstance(fblist,dict):
+            fblist = [fblist,]
+        if _list_of_dict(fblist):
+            for fb in fblist:
+                if 'x' in fb:
+                    raise ValueError('fill_between dict may not contain `x`')
+                fb['x'] = xdates # add 'x' to caller's fb dict
+                ax.fill_between(**fb)
+        else:
+            raise ValueError('Invalid addplot fill_between: must be `dict` or `list of dict`')
+
+def _set_ylabels_side(ax_pri,ax_sec,primary_on_right):
+    # put the primary axis on one side,
+    # and the twinx() on the "other" side:
+    if primary_on_right == True:
+        ax_pri.yaxis.set_label_position('right')
+        ax_pri.yaxis.tick_right()
+        if ax_sec is not None:
+            ax_sec.yaxis.set_label_position('left')
+            ax_sec.yaxis.tick_left()
+    else:  # treat non-True as False, whether False, None, or anything else.
+        ax_pri.yaxis.set_label_position('left')
+        ax_pri.yaxis.tick_left()
+        if ax_sec is not None:
+            ax_sec.yaxis.set_label_position('right')
+            ax_sec.yaxis.tick_right()
+
+def _plot_mav(ax,config,xdates,prices,apmav=None,apwidth=None):
+    style = config['style']
+    if apmav is not None:
+        mavgs = apmav
+    else:
+        mavgs = config['mav']
+    mavp_list = []
+    if mavgs is not None:
+        shift = None
+        if isinstance(mavgs,dict):
+            shift = mavgs['shift']
+            mavgs = mavgs['period']
+        if isinstance(mavgs,int):
+            mavgs = mavgs,      # convert to tuple
+        if len(mavgs) > 7:
+            mavgs = mavgs[0:7]  # take at most 7
+     
+        if style['mavcolors'] is not None:
+            mavc = cycle(style['mavcolors'])
+        else:
+            mavc = None
+
+        for idx,mav in enumerate(mavgs):
+            mean = pd.Series(prices).rolling(mav).mean()
+            if shift is not None:
+                mean = mean.shift(periods=shift[idx])
+            mavprices = mean.values
+            lw = config['_width_config']['line_width']
+            if mavc:
+                ax.plot(xdates, mavprices, linewidth=lw, color=next(mavc))
+            else:
+                ax.plot(xdates, mavprices, linewidth=lw)
+            mavp_list.append(mavprices)
+    return mavp_list
+
+def _auto_secondary_y( panels, panid, ylo, yhi ):
+    # If mag(nitude) for this panel is not yet set, then set it
+    # here, as this is the first ydata to be plotted on this panel:
+    # i.e. consider this to be the 'primary' axis for this panel.
+    secondary_y = False
+    p = panid,'mag'
+    if panels.at[p] is None:
+        panels.at[p] = {'lo':ylo,'hi':yhi}
+    elif ylo < panels.at[p]['lo'] or yhi > panels.at[p]['hi']:
+        secondary_y = True
+    #if secondary_y:
+    #    print('auto says USE secondary_y ... for panel',panid)
+    #else:
+    #    print('auto says do NOT use secondary_y ... for panel',panid)
+    return secondary_y
+
+def _valid_addplot_kwargs():
+
+    valid_linestyles = ('-','solid','--','dashed','-.','dashdot','.','dotted',None,' ','')
+    valid_types = ('line','scatter','bar', 'ohlc', 'candle','step')
+    valid_stepwheres = ('pre','post','mid')
+    valid_edgecolors = ('face', 'none', None)
+
+    vkwargs = {
+        'scatter'     : { 'Default'     : False,
+                          'Description' : "Deprecated.  (Use kwarg `type='scatter' instead.",
+                          'Validator'   : lambda value: isinstance(value,bool) },
+
+        'type'        : { 'Default'     : 'line',
+                          'Description' : 'addplot type: "line","scatter","bar", "ohlc", "candle","step"',
+                          'Validator'   : lambda value: value in valid_types },
+
+        'mav'         : { 'Default'     : None,
+                          'Description' : 'Moving Average window size(s); (int or tuple of ints)',
+                          'Validator'   : _mav_validator },
+        
+        'panel'       : { 'Default'     : 0, 
+                          'Description' : 'Panel (int 0-31) to use for this addplot',
+                          'Validator'   : lambda value: _valid_panel_id(value) },
+
+        'marker'      : { 'Default'     : 'o',
+                          'Description' : "marker for `type='scatter'` plot",
+                          'Validator'   : lambda value: _bypass_kwarg_validation(value)  },
+
+        'markersize'  : { 'Default'     : 18,
+                          'Description' : 'size of marker for `type="scatter"`; default=18',
+                          'Validator'   : lambda value: isinstance(value,(int,float)) },
+
+        'color'       : { 'Default'     : None,
+                          'Description' : 'color (or sequence of colors) of line(s), scatter marker(s), or bar(s).',
+                          'Validator'   : lambda value: mcolors.is_color_like(value) or
+                                         (isinstance(value,(list,tuple,np.ndarray)) and all([mcolors.is_color_like(v) for v in value])) },
+
+        'linestyle'   : { 'Default'     : None,
+                          'Description' : 'line style for `type=line` ('+str(valid_linestyles)+')',
+                          'Validator'   : lambda value: value in valid_linestyles },
+
+        'linewidths'  : { 'Default': None,
+                          'Description' : 'edge widths of scatter markers',
+                          'Validator'   : lambda value: isinstance(value,(int,float)) },
+
+        'edgecolors'  : { 'Default': None,
+                          'Description' : 'edgecolors of scatter markers',
+                          'Validator': lambda value: mcolors.is_color_like(value) or value in valid_edgecolors},
+
+        'width'       : { 'Default'     : None, # width of `bar` or `line`
+                          'Description' : 'width of bar or line for `type="bar"` or `type="line"',
+                          'Validator'   : lambda value: isinstance(value,(int,float)) or
+                                                        all([isinstance(v,(int,float)) for v in value]) },
+
+        'bottom'      : { 'Default'     : 0,  # bottom for `type=bar` plots
+                          'Description' : 'bottom value for `type=bar` bars. Default=0',
+                          'Validator'   : lambda value: isinstance(value,(int,float)) or
+                                                        all([isinstance(v,(int,float)) for v in value]) },
+        'alpha'       : { 'Default'     : 1,  # alpha of `bar`, `line`, or `scatter`
+                          'Description' : 'opacity for 0.0 (transparent) to 1.0 (opaque)',
+                          'Validator'   : lambda value: isinstance(value,(int,float)) or
+                                                        all([isinstance(v,(int,float)) for v in value]) },
+
+        'secondary_y' : { 'Default'     : 'auto',
+                          'Description' : "True|False|'auto' place the additional plot data on a"+
+                                          " secondary y-axis.  'auto' compares the magnitude or the"+
+                                          " addplot data, to data already on the axis, and if it appears"+
+                                          " they are of different magnitudes, then it uses a secondary y-axis."+
+                                          " True or False always override 'auto'.",
+                          'Validator'   : lambda value: isinstance(value,bool) or value == 'auto' },
+
+        'y_on_right'  : { 'Default'     : None,
+                          'Description' : 'True|False put y-axis tick labels on the right, for this addplot'+
+                                          ' regardless of what the mplfinance style says to to.',
+                          'Validator'   : lambda value: isinstance(value,bool) },
+
+        'ylabel'      : { 'Default'     : None,
+                          'Description' : 'label for y-axis (for this addplot)',
+                          'Validator'   : lambda value: isinstance(value,str) },
+
+        'ylim'        : {'Default'      : None,
+                         'Description' : 'Limits for addplot y-axis as tuple (min,max), i.e. (bottom,top)',
+                         'Validator'    : lambda value: isinstance(value, (list,tuple)) and len(value) == 2 
+                                                                      and all([isinstance(v,(int,float)) for v in value])},
+
+        'title'       : { 'Default'     : None,
+                          'Description' : 'Axes Title (subplot title) for this addplot.',
+                          'Validator'   : lambda value: isinstance(value,str) },
+
+        'ax'          : { 'Default'      : None,
+                          'Description' : 'Matplotlib Axes object on which to plot this addplot',
+                          'Validator'    : lambda value: isinstance(value,mpl_axes.Axes) },
+
+        'yscale'      : { 'Default'     : None,
+                          'Description' : 'addplot y-axis scale: "linear", "log", "symlog", or "logit"',
+                          'Validator'   : lambda value: _yscale_validator(value) },
+
+        'stepwhere'   : { 'Default'     : 'pre',
+                          'Description' : "'pre','post', or 'mid': where to place step relative"+
+                                          " to data for `type='step'`",
+                          'Validator'   : lambda value : value in valid_stepwheres },                  
+        
+        'marketcolors': { 'Default'     : None, # use 'style' for default, instead.
+                          'Description' : "marketcolors for this addplot (instead of the mplfinance"+
+                                          " style\'s marketcolors).  For addplot `type='ohlc'`"+
+                                          " and type='candle'",
+                          'Validator'   : lambda value: _is_marketcolor_object(value) },
+        'fill_between': { 'Default'     : None,    # added by Wen
+                          'Description' : " fill region",
+                          'Validator'   : _fill_between_validator },
+
+    }
+
+    _validate_vkwargs_dict(vkwargs)
+
+    return vkwargs
+
+
+def make_addplot(data, **kwargs):
+    '''
+    Take data (pd.Series, pd.DataFrame, np.ndarray of floats, list of floats), and
+    kwargs (see valid_addplot_kwargs_table) and construct a correctly structured dict
+    to be passed into plot() using kwarg `addplot`.  
+    NOTE WELL: len(data) here must match the len(data) passed into plot()
+    '''
+    if not isinstance(data, (pd.Series, pd.DataFrame, np.ndarray, list)):
+        raise TypeError('Wrong type for data, in make_addplot()')
+
+    config = _process_kwargs(kwargs, _valid_addplot_kwargs())
+
+    # kwarg `type` replaces kwarg `scatter`
+    if config['scatter'] == True and config['type'] == 'line':
+        config['type'] = 'scatter'
+
+    return dict( data=data, **config)
diff --git a/dist/mplfinance-0.12.9b2-py3.10.egg b/dist/mplfinance-0.12.9b2-py3.10.egg
new file mode 100644
index 0000000000000000000000000000000000000000..9fbe8be5d35e48c7adbbf480c38e88f18bfc4191
GIT binary patch
literal 148059
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
bO>j9$7+}8&c=ZSV(E{&Axb(pLJH-D1o8XLc

literal 0
HcmV?d00001

diff --git a/src/mplfinance/plotting.py b/src/mplfinance/plotting.py
index b3d4f341..073864a0 100644
--- a/src/mplfinance/plotting.py
+++ b/src/mplfinance/plotting.py
@@ -184,6 +184,10 @@ def _valid_plot_kwargs():
         'axtitle'                   : { 'Default'     : None, # Axes Title (subplot title)
                                         'Description' : 'Axes Title (subplot title)',
                                         'Validator'   : lambda value: isinstance(value,(str,dict)) },
+                                        
+        'xlabel'                    : { 'Default'     : 'Date', # x-axis label
+                                        'Description' : 'label for x-axis of main plot',
+                                        'Validator'   : lambda value: isinstance(value,str) },
  
         'ylabel'                    : { 'Default'     : 'Price', # y-axis label
                                         'Description' : 'label for y-axis of main plot',
@@ -779,6 +783,7 @@ def plot( data, **kwargs ):
                            # working in `addplot`).
 
     axA1.set_ylabel(config['ylabel'])
+    axA1.set_xlabel(config['xlabel'])
 
     if config['volume']:
         if external_axes_mode:
@@ -1070,6 +1075,8 @@ def _addplot_columns(panid,panels,ydata,apdict,xdates,config):
 def _addplot_apply_supplements(ax,apdict,xdates):
     if (apdict['ylabel'] is not None):
         ax.set_ylabel(apdict['ylabel'])
+    if (apdict['xlabel'] is not None):
+        ax.set_xlabel(apdict['xlabel'])
     if apdict['ylim'] is not None:
         ax.set_ylim(apdict['ylim'][0],apdict['ylim'][1])
     if apdict['title'] is not None:

From 4be48185c54be9e9e977c4eadbbc947b4d00044d Mon Sep 17 00:00:00 2001
From: Vedant Gawande <programmer.vedant@gmail.com>
Date: Sat, 22 Oct 2022 00:35:42 +0530
Subject: [PATCH 10/22] Added Date field on x-axis

---
 build/lib/mplfinance/__init__.py              |    7 -
 build/lib/mplfinance/_arg_validators.py       |  445 -----
 build/lib/mplfinance/_helpers.py              |  121 --
 build/lib/mplfinance/_kwarg_help.py           |  154 --
 build/lib/mplfinance/_mpf_warnings.py         |   16 -
 build/lib/mplfinance/_mplrcputils.py          |   87 -
 build/lib/mplfinance/_mplwraps.py             |  121 --
 build/lib/mplfinance/_panels.py               |  232 ---
 build/lib/mplfinance/_styledata/__init__.py   |   45 -
 build/lib/mplfinance/_styledata/binance.py    |   29 -
 build/lib/mplfinance/_styledata/blueskies.py  |   23 -
 build/lib/mplfinance/_styledata/brasil.py     |   25 -
 build/lib/mplfinance/_styledata/charles.py    |   30 -
 build/lib/mplfinance/_styledata/checkers.py   |   26 -
 build/lib/mplfinance/_styledata/classic.py    |   28 -
 build/lib/mplfinance/_styledata/default.py    |   29 -
 build/lib/mplfinance/_styledata/ibd.py        |   38 -
 build/lib/mplfinance/_styledata/kenan.py      |   33 -
 build/lib/mplfinance/_styledata/mike.py       |   36 -
 .../lib/mplfinance/_styledata/nightclouds.py  |   23 -
 build/lib/mplfinance/_styledata/sas.py        |    4 -
 .../mplfinance/_styledata/starsandstripes.py  |   24 -
 build/lib/mplfinance/_styledata/yahoo.py      |   23 -
 build/lib/mplfinance/_styles.py               |  382 -----
 build/lib/mplfinance/_utils.py                | 1515 -----------------
 build/lib/mplfinance/_version.py              |    6 -
 build/lib/mplfinance/_widths.py               |  197 ---
 build/lib/mplfinance/original_flavor.py       |  885 ----------
 build/lib/mplfinance/plotting.py              | 1307 --------------
 dist/mplfinance-0.12.9b2-py3.10.egg           |  Bin 148059 -> 0 bytes
 30 files changed, 5891 deletions(-)
 delete mode 100644 build/lib/mplfinance/__init__.py
 delete mode 100644 build/lib/mplfinance/_arg_validators.py
 delete mode 100644 build/lib/mplfinance/_helpers.py
 delete mode 100644 build/lib/mplfinance/_kwarg_help.py
 delete mode 100644 build/lib/mplfinance/_mpf_warnings.py
 delete mode 100644 build/lib/mplfinance/_mplrcputils.py
 delete mode 100644 build/lib/mplfinance/_mplwraps.py
 delete mode 100644 build/lib/mplfinance/_panels.py
 delete mode 100644 build/lib/mplfinance/_styledata/__init__.py
 delete mode 100644 build/lib/mplfinance/_styledata/binance.py
 delete mode 100644 build/lib/mplfinance/_styledata/blueskies.py
 delete mode 100644 build/lib/mplfinance/_styledata/brasil.py
 delete mode 100644 build/lib/mplfinance/_styledata/charles.py
 delete mode 100644 build/lib/mplfinance/_styledata/checkers.py
 delete mode 100644 build/lib/mplfinance/_styledata/classic.py
 delete mode 100644 build/lib/mplfinance/_styledata/default.py
 delete mode 100644 build/lib/mplfinance/_styledata/ibd.py
 delete mode 100644 build/lib/mplfinance/_styledata/kenan.py
 delete mode 100644 build/lib/mplfinance/_styledata/mike.py
 delete mode 100644 build/lib/mplfinance/_styledata/nightclouds.py
 delete mode 100644 build/lib/mplfinance/_styledata/sas.py
 delete mode 100644 build/lib/mplfinance/_styledata/starsandstripes.py
 delete mode 100644 build/lib/mplfinance/_styledata/yahoo.py
 delete mode 100644 build/lib/mplfinance/_styles.py
 delete mode 100644 build/lib/mplfinance/_utils.py
 delete mode 100644 build/lib/mplfinance/_version.py
 delete mode 100644 build/lib/mplfinance/_widths.py
 delete mode 100644 build/lib/mplfinance/original_flavor.py
 delete mode 100644 build/lib/mplfinance/plotting.py
 delete mode 100644 dist/mplfinance-0.12.9b2-py3.10.egg

diff --git a/build/lib/mplfinance/__init__.py b/build/lib/mplfinance/__init__.py
deleted file mode 100644
index f1e1865c..00000000
--- a/build/lib/mplfinance/__init__.py
+++ /dev/null
@@ -1,7 +0,0 @@
-import mplfinance._mpf_warnings
-from   mplfinance.plotting    import plot, make_addplot
-from   mplfinance._styles     import make_mpf_style, make_marketcolors
-from   mplfinance._styles     import available_styles, write_style_file
-from   mplfinance._version    import __version__
-from   mplfinance._mplwraps   import figure, show
-from   mplfinance._kwarg_help import kwarg_help
diff --git a/build/lib/mplfinance/_arg_validators.py b/build/lib/mplfinance/_arg_validators.py
deleted file mode 100644
index d7398232..00000000
--- a/build/lib/mplfinance/_arg_validators.py
+++ /dev/null
@@ -1,445 +0,0 @@
-import matplotlib.dates  as mdates
-import pandas   as pd
-import numpy    as np
-import datetime
-from   mplfinance._helpers import _list_of_dict, _mpf_is_color_like
-from   mplfinance._helpers import _num_or_seq_of_num
-import matplotlib as mpl
-import warnings
-
-def _check_and_prepare_data(data, config):
-    '''
-    Check and Prepare the data input:
-    For now, data must be a Pandas DataFrame with a DatetimeIndex
-    and columns named 'Open', 'High', 'Low', 'Close', and optionally 'Volume'
-
-    Later (if there is demand for it) we may accept all of the following data formats:
-      1. Pandas DataFrame with DatetimeIndex (as described above)
-      2. Pandas Series with DatetimeIndex:
-             Values are close prices, and Series generates a line plot
-      3. Tuple of Lists, or List of Lists:
-             The inner Lists are each columns, in the order: DateTime, Open, High, Low, Close, Volume
-      4. Tuple of Tuples or List of Tuples:
-             The inner tuples are each row, containing values in the order: DateTime, Open, High, Low, Close, Volume
-
-    Return a Tuple of Lists: datetimes, opens, highs, lows, closes, volumes
-    '''
-    if not isinstance(data, pd.core.frame.DataFrame):
-        raise TypeError('Expect data as DataFrame')
-
-    if not isinstance(data.index,pd.core.indexes.datetimes.DatetimeIndex):
-        raise TypeError('Expect data.index as DatetimeIndex')
-
-    if (len(data.index) > config['warn_too_much_data'] and
-        (config['type']=='candle' or config['type']=='ohlc' or config['type']=='hollow_and_filled')
-       ):
-        warnings.warn('\n\n ================================================================= '+
-                      '\n\n   WARNING: YOU ARE PLOTTING SO MUCH DATA THAT IT MAY NOT BE'+
-                        '\n            POSSIBLE TO SEE DETAILS (Candles, Ohlc-Bars, Etc.)'+
-                        '\n   For more information see:'+
-                        '\n   - https://github.com/matplotlib/mplfinance/wiki/Plotting-Too-Much-Data'+
-                        '\n   '+
-                        '\n   TO SILENCE THIS WARNING, set `type=\'line\'` in `mpf.plot()`'+
-                        '\n   OR set kwarg `warn_too_much_data=N` where N is an integer '+
-                        '\n   LARGER than the number of data points you want to plot.'+
-                      '\n\n ================================================================ ',
-                  category=UserWarning)
-
-    # We will not be fully case-insensitive (since Pandas columns as NOT case-insensitive)
-    # but because so many people have requested it, for the default column names we will
-    # try both Capitalized and lower case:
-    columns = config['columns']
-    if columns is None:
-        columns =  ('Open', 'High', 'Low', 'Close', 'Volume')
-        if all([c.lower() in data for c in columns[0:4]]):
-            columns =  ('open', 'high', 'low', 'close', 'volume')
-        
-    o, h, l, c, v = columns
-    cols = [o, h, l, c]
-
-    if config['tz_localize']:
-        dates   = mdates.date2num(data.index.tz_localize(None).to_pydatetime())
-    else:  # Just in case someone was depending on this bug (Issue 236)
-        dates   = mdates.date2num(data.index.to_pydatetime())
-    opens   = data[o].values
-    highs   = data[h].values
-    lows    = data[l].values
-    closes  = data[c].values
-    if v in data.columns:
-        volumes = data[v].values
-        cols.append(v)
-    else:
-        volumes = None
-
-    for col in cols:
-        if not all( isinstance(v,(float,int)) for v in data[col] ):
-            raise ValueError('Data for column "'+str(col)+'" must be ALL float or int.')
-
-    return dates, opens, highs, lows, closes, volumes
-
-def _get_valid_plot_types(plottype=None):
-
-    _alias_types = {
-        'candlestick'       : 'candle',
-        'ohlc_bars'         : 'ohlc',
-        'hollow_candle'     : 'hollow_and_filled',
-        'hollow'            : 'hollow_and_filled',
-        'hnf'               : 'hollow_and_filled',
-    }
-
-    _valid_types = ['candle','ohlc', 'line','renko','pnf','hollow_and_filled']
-
-    _valid_types_all = _valid_types.copy()
-    _valid_types_all.extend(_alias_types.keys())
-
-    if plottype is None:
-        return _valid_types_all
-    elif plottype in _alias_types:
-        return _alias_types[plottype]
-    return plottype
-        
-
-def _mav_validator(mav_value):
-    '''
-    Value for mav (moving average) keyword may be:
-    scalar int greater than 1, or tuple of ints, or list of ints (each greater than 1)
-    or a dict of `period` and `shift` each of which may be:
-    scalar int, or tuple of ints, or list of ints: each `period` int must be greater than 1
-    '''
-    def _valid_mav(value, is_period=True):
-        if not isinstance(value,(tuple,list,int)):
-            return False
-        if isinstance(value,int):
-            return (value >= 2 or not is_period)
-        # Must be a tuple or list here:
-        for num in value:
-            if not isinstance(num,int) or (is_period and num < 2):
-                return False
-        return True
-
-    if not isinstance(mav_value,(tuple,list,int,dict)):
-        return False
-
-    if not isinstance(mav_value,dict):
-        return _valid_mav(mav_value)
-
-    else: #isinstance(mav_value,dict)
-        if 'period' not in mav_value: return False
-
-        period = mav_value['period']
-        if not _valid_mav(period): return False
-
-        if 'shift' not in mav_value: return True
-
-        shift  = mav_value['shift']
-        if not _valid_mav(shift, False):  return False
-        if isinstance(period,int) and isinstance(shift,int): return True
-        if isinstance(period,(tuple,list)) and isinstance(shift,(tuple,list)):
-            if len(period) != len(shift): return False
-            return True
-        return False
-
-
-def _hlines_validator(value):
-    if isinstance(value,dict):
-        if 'hlines' in value:
-            value = value['hlines']
-        else:
-            return False
-    return ( isinstance(value,(float,int)) or (isinstance(value,(list,tuple)) and
-             all([isinstance(v,(float,int)) for v in value])) )
-
-def _is_datelike(value):
-    if isinstance(value, (pd.Timestamp,datetime.datetime,datetime.date)):
-        return True
-    if isinstance(value,str):
-        try:
-            dt = pd.to_datetime(value)
-            return True
-        except:
-            return False
-    return False
-
-def _xlim_validator(value):
-    return (isinstance(value, (list,tuple)) and len(value) == 2
-            and (all([isinstance(v,(int,float)) for v in value])
-                 or all([_is_datelike(v) for v in value])))
-
-def _vlines_validator(value):
-    '''Validate `vlines` kwarg value:  must be "datelike" or sequence of "datelike"
-    '''
-    if isinstance(value,dict):
-        if 'vlines' in value:
-            value = value['vlines']
-        else:
-            return False
-    if _is_datelike(value): return True
-    if not isinstance(value,(list,tuple)): return False
-    if not all([_is_datelike(v) for v in value]): return False
-    return True
-
-def _alines_validator(value, returnStandardizedValue=False):
-    '''
-    Value for segments to be passed into LineCollection constructor must be:
-    - a sequence of `lines`, where
-    - a `lines` is a sequence of 2 or more vertices, where
-    - a vertex is a `pair`, aka a sequence of two values, an x and a y point.
-
-    From matplotlib.collections:
-        `segments` are:
-        A sequence of (line0, line1, line2), where:
-
-        linen = (x0, y0), (x1, y1), ... (xm, ym)
-       
-        or the equivalent numpy array with two columns. Each line can be a different length.
-
-    The above is from the matplotlib LineCollection documentation.
-    It basically says that the "segments" passed into the LineCollection constructor 
-    must be a Sequence of Sequences of 2 or more xy Pairs.  However here in `mplfinance`
-    we want to allow that (seq of seq of xy pairs) _as well as_ just a sequence of pairs.
-    Therefore here in the validator we will allow both:
-       (a) seq of at least 2 date,float pairs         (this is a 'line'    as defined above)
-       (b) seq of seqs of at least 2 date,float pairs (this is a 'seqment' as defined above)
-    '''
-    if isinstance(value,dict):
-        if 'alines' in value:
-            value = value['alines']
-        else:
-            return False
-
-    if not isinstance(value,(list,tuple)):
-        return False if not returnStandardizedValue else None
-
-    if not all([isinstance(line,(list,tuple)) and len(line) > 1 for line in value]):
-        return False if not returnStandardizedValue else None
-
-    # now, were the above really `lines`, or were they simply `vertices`
-    if all( [ isinstance(point,(list,tuple)) and len(point)==2 and
-              _is_datelike(point[0]) and isinstance(point[1],(float,int))
-              for line in value for point in line ] ):
-        # they were lines:
-        return True if not returnStandardizedValue else value
-
-    # here, if valid, we have a sequence of vertices (points)
-    if all( [ isinstance(point,(list,tuple)) and len(point)==2 and
-              _is_datelike(point[0]) and isinstance(point[1],(float,int))
-              for point in value ] ):
-        return True if not returnStandardizedValue else [value,]
-
-    return False if not returnStandardizedValue else None
-
-def _tlines_validator(value):
-    '''
-    Validate `tlines` kwarg value: must be sequence of "datelike" pairs.
-    '''
-    def _tlines_subvalidator(value):
-        if isinstance(value,dict):
-            if 'tlines' in value:
-                value = value['tlines']
-            else:
-                return False
-        if not isinstance(value,(list,tuple)):
-            return False
-        if not all([isinstance(pair,(list,tuple)) and len(pair) == 2 and
-                    _is_datelike(pair[0]) and _is_datelike(pair[1]) for pair in value]):
-            return False
-        return True
-
-    if isinstance(value,(list,tuple)) and all([isinstance(v,dict) for v in value]):
-        for v in value:
-            if not _tlines_subvalidator(v):
-                return False
-        return True
-    else:
-        return _tlines_subvalidator(value)
-
-def _bypass_kwarg_validation(value):
-    ''' For some kwargs, we either don't know enough, or
-        the validation is too complex to make it worth while,
-        so we bypass kwarg validation.  If the kwarg is 
-        invalid, then eventually an exception will be 
-        raised at the time the kwarg value is actually used.
-    '''
-    return True
-
-def _kwarg_not_implemented(value):
-    ''' If you want to list a kwarg in a valid_kwargs dict for a given
-        function, but you have not yet, or don't yet want to, implement
-        the kwarg; or you simply want to (temporarily) disable the kwarg,
-        then use this function as the kwarg validator
-    '''
-    raise NotImplementedError('kwarg NOT implemented.')
-
-def _validate_vkwargs_dict(vkwargs):
-    """
-    Check that we didn't make a typo in any of the things
-    that should be the same for all vkwargs dict items:
-
-    {kwarg : {'Default': ... , 'Description': ... , 'Validator': ...} }
-    """
-    for key, value in vkwargs.items():
-        # has been changed to 3 to support descriptions
-        if len(value) != 3:
-            raise ValueError('Items != 3 in valid kwarg table, for kwarg "'+key+'"')
-        if 'Default' not in value:
-            raise ValueError('Missing "Default" value for kwarg "'+key+'"')
-        if 'Description' not in value:
-            raise ValueError('Missing "Description" value for kwarg "'+key+'"')
-        if 'Validator' not in value:
-            raise ValueError('Missing "Validator" function for kwarg "'+key+'"')
-
-def _process_kwargs(kwargs, vkwargs):
-    '''
-    Given a "valid kwargs table" and some kwargs, verify that each key-word
-    is valid per the kwargs table, and that the value of the kwarg is the
-    correct type.  Fill a configuration dictionary with the default value
-    for each kwarg, and then substitute in any values that were provided 
-    as kwargs and return the configuration dictionary.
-    '''
-    # initialize configuration from valid_kwargs_table:
-    config  = {}
-    for key, value in vkwargs.items():
-        config[key] = value['Default']
-
-    # now validate kwargs, and for any valid kwargs
-    #  replace the appropriate value in config:
-    for key in kwargs.keys():
-        if key not in vkwargs:
-            raise KeyError('Unrecognized kwarg="'+str(key)+'"')
-        else:
-            value = kwargs[key]
-            try:
-                valid = vkwargs[key]['Validator'](value)
-            except Exception as ex:
-                ex.extra_info = 'kwarg "'+key+'" validator raised exception to value: "'+str(value)+'"'
-                raise
-            if not valid:
-                import inspect
-                v = inspect.getsource(vkwargs[key]['Validator']).strip()
-                raise TypeError('kwarg "'+key+'" validator returned False for value: "'+str(value)+'"\n    '+v)
-
-       # ---------------------------------------------------------------
-       #  At this point in the loop, if we have not raised an exception,
-       #      then kwarg is valid as far as we can tell, therefore, 
-       #      go ahead and replace the appropriate value in config:
-
-        config[key] = value
-
-    return config
-
-def _valid_panel_id(panid):
-    return panid in ['main','lower'] or (isinstance(panid,int) and panid >= 0 and panid < 32)
-
-def _scale_padding_validator(value):
-    if isinstance(value,(int,float)):
-        return True
-    elif isinstance(value,dict):
-        valid_keys=('left','right','top','bottom')
-        for key in value:
-            if key not in valid_keys:
-                raise ValueError('Invalid key "'+str(key)+'" found in `scale_padding` dict.')
-            if not isinstance(value[key],(int,float)):
-                raise ValueError('`scale_padding` dict contains non-number at key "'+str(key)+'"') 
-        return True
-    else:
-        raise ValueError('`scale_padding` kwarg must be a number, or dict of (left,right,top,bottom) numbers.')
-    return False
-
-def _yscale_validator(value):
-    if isinstance(value,str) and value in ("linear", "log", "symlog", "logit"):
-        return True
-
-    if not isinstance(value,dict):
-        return False
-
-    # At this point, value is a dict:
-    if not 'yscale' in value:
-        return False
-
-    yscale = value['yscale']
-    if not (isinstance(yscale,str) and yscale in ("linear", "log", "symlog", "logit")):
-        return False
-
-    return True
-
-
-def _is_marketcolor_object(obj):
-    if not isinstance(obj,dict): return False
-    market_colors_keys = ('candle','edge','wick','ohlc')
-    return all([k in obj for k in market_colors_keys])
-
-
-def _mco_validator(value):        # marketcolor overrides validator
-    if isinstance(value,dict):    # not yet supported, but maybe we will have other
-        if 'colors' not in value: # kwargs related to mktcolor overrides (ex: `mco_faceonly`)
-            raise ValueError('`marketcolor_overrides` as dict must contain `colors` key.')
-        colors = value['colors']
-    else:
-        colors = value
-    if not isinstance(colors,(list,tuple,np.ndarray)):
-        return False
-    return all([(c is None or 
-                 _mpf_is_color_like(c) or
-                 _is_marketcolor_object(c) ) for c in colors])
-
-def _check_for_external_axes(config):
-    '''
-    Check that all `fig` and `ax` kwargs are either ALL None, 
-    or ALL are valid instances of Figures/Axes:
- 
-    An external Axes object can be passed in three places:
-        - mpf.plot() `ax=` kwarg
-        - mpf.plot() `volume=` kwarg
-        - mpf.make_addplot() `ax=` kwarg
-    ALL three places MUST be an Axes object, OR
-    ALL three places MUST be None.  But it may not be mixed.
-    '''
-    ap_axlist = []
-    addplot = config['addplot']
-    if addplot is not None:
-        if isinstance(addplot,dict):
-            addplot = [addplot,]   # make list of dict to be consistent
-        elif not _list_of_dict(addplot):
-            raise TypeError('addplot must be `dict`, or `list of dict`, NOT '+str(type(addplot)))
-        for apd in addplot:
-            ap_axlist.append(apd['ax'])
- 
-    if len(ap_axlist) > 0:
-        if config['ax'] is None:
-            if not all([ax is None for ax in ap_axlist]):
-                raise ValueError('make_addplot() `ax` kwarg NOT all None, while plot() `ax` kwarg IS None')
-        else: # config['ax'] is NOT None:
-            if not isinstance(config['ax'],mpl.axes.Axes):
-                raise ValueError('plot() ax kwarg must be of type `matplotlib.axis.Axes`')
-            if not all([isinstance(ax,mpl.axes.Axes) for ax in ap_axlist]):
-                raise ValueError('make_addplot() `ax` kwargs must all be of type `matplotlib.axis.Axes`')
-
-    # At this point, if we have not raised an exception, then plot(ax=) and make_addplot(ax=)
-    # are in sync: either they are all None, or they are all of type `matplotlib.axes.Axes`.
-    # Therefore we only need plot(ax=), i.e. config['ax'], as we check `volume`: ### and `fig`:
-
-    if config['ax'] is None:
-        if isinstance(config['volume'],mpl.axes.Axes):
-            raise ValueError('`volume` set to external Axes requires all other Axes be external.')
-        #if config['fig'] is not None:
-        #    raise ValueError('`fig` kwarg must be None if `ax` kwarg is None.')
-    else:
-        if not isinstance(config['volume'],mpl.axes.Axes) and config['volume'] != False:
-            raise ValueError('`volume` must be of type `matplotlib.axis.Axes`')
-        #if not isinstance(config['fig'],mpl.figure.Figure):
-        #    raise ValueError('`fig` kwarg must be of type `matplotlib.figure.Figure`')
-    
-    external_axes_mode = True if isinstance(config['ax'],mpl.axes.Axes) else False
-    return external_axes_mode
-
-def _valid_fb_dict(value):
-    return (isinstance(value,dict) and
-            'y1' in value and
-            _num_or_seq_of_num(value['y1']))
-
-def _fill_between_validator(value):
-    if _num_or_seq_of_num(value): return True
-    if _valid_fb_dict(value): return True
-    if _list_of_dict(value):
-        return all([_valid_fb_dict(v) for v in value])
-    return False
diff --git a/build/lib/mplfinance/_helpers.py b/build/lib/mplfinance/_helpers.py
deleted file mode 100644
index c10ddf92..00000000
--- a/build/lib/mplfinance/_helpers.py
+++ /dev/null
@@ -1,121 +0,0 @@
-"""
-Some helper functions for mplfinance.
-NOTE: This is the lowest level in mplfinance:
-      This file should have NO dependencies on
-      any other mplfinance files.
-"""
-
-import datetime
-import matplotlib.dates  as mdates
-import matplotlib.colors as mcolors
-import numpy as np
-
-def _adjust_color_brightness(color,amount=0.5):
-    
-    def _adjcb(c1, amount):
-        import matplotlib.colors as mc
-        import colorsys
-        # mc.is_color_like(value)
-        try:
-            c = mc.cnames[c1]
-        except:
-            c = c1
-        c = colorsys.rgb_to_hls(*mc.to_rgb(c))
-        return colorsys.hls_to_rgb(c[0], max(0, min(1, amount * c[1])), c[2])
-
-    if not isinstance(color,(list,tuple)):
-        return _adjcb(color,amount)
-        
-    cout = []
-    cadj = {}
-    for c1 in color:
-        if c1 in cadj:
-            cout.append(cadj[c1])
-        else:
-            newc = _adjcb(c1,amount)
-            cadj[c1] = newc
-            cout.append(cadj[c1])
-    return cout
-
-
-def _determine_format_string( dates, datetime_format=None ):
-    """
-    Determine the datetime format string based on the averge number
-    of days between data points, or if the user passed in kwarg
-    datetime_format, use that as an override.
-    """
-    avg_days_between_points = (dates[-1] - dates[0]) / float(len(dates))
-
-    if datetime_format is not None:
-        return datetime_format
-
-    # avgerage of 3 or more data points per day we will call intraday data:
-    if avg_days_between_points < 0.33:  # intraday
-        if mdates.num2date(dates[-1]).date() != mdates.num2date(dates[0]).date():
-            # intraday data for more than one day:
-            fmtstring = '%b %d, %H:%M'
-        else:  # intraday data for a single day
-            fmtstring = '%H:%M'
-    else:  # 'daily' data (or could be weekly, etc.)
-        if mdates.num2date(dates[-1]).date().year != mdates.num2date(dates[0]).date().year:
-           fmtstring = '%Y-%b-%d'
-        else:
-           fmtstring = '%b %d'
-    return fmtstring
-
-
-def _list_of_dict(x):
-    '''
-    Return True if x is a list of dict's
-    '''
-    return isinstance(x,list) and all([isinstance(item,dict) for item in x])
-
-def _num_or_seq_of_num(value):
-    return ( isinstance(value,(int,float,np.integer,np.floating))  or
-             (isinstance(value,(list,tuple,np.ndarray)) and
-             all([isinstance(v,(int,float,np.integer,np.floating)) for v in value]))
-           )
-
-def roundTime(dt=None, roundTo=60):
-   """Round a datetime object to any time lapse in seconds
-   dt : datetime.datetime object, default now.
-   roundTo : Closest number of seconds to round to, default 1 minute.
-   Author: Thierry Husson 2012 - Use it as you want but don't blame me.
-   """
-   if dt is None : dt = datetime.datetime.now()
-   seconds = (dt.replace(tzinfo=None) - dt.min).seconds
-   rounding = (seconds+roundTo/2) // roundTo * roundTo
-   return dt + datetime.timedelta(0,rounding-seconds,-dt.microsecond)
-
-
-def _is_uint8_rgb_or_rgba(tup):
-    """ Deterine if rgb or rgba is in (0-255) format:
-    Matplotlib expects rgb (and rgba) tuples to contain
-    three (or four) floats between 0.0 and 1.0 
-    
-    Some people express rgb as tuples of three integers
-    between 0 and 255.
-    (In rgba, alpha is still a float from 0.0 to 1.0)
-    """
-    if isinstance(tup,str):  return False
-    if not np.iterable(tup): return False
-    L = len(tup)
-    if L < 3 or L > 4: return False
-    if L == 4 and (tup[3] < 0 or tup[3] > 1): return False
-    return not any([not isinstance(v,(int,np.unsignedinteger)) or v<0 or v>255 for v in tup[0:3]])
-
-def _mpf_is_color_like(c):
-    """Determine if an object is a color.
-    
-    Identical to `matplotlib.colors.is_color_like()`
-    BUT ALSO considers int (0-255) rgb and rgba colors.
-    """
-    if mcolors.is_color_like(c): return True
-    return _is_uint8_rgb_or_rgba(c)
-    
-def _mpf_to_rgba(c, alpha=None):
-    cnew = c
-    if _is_uint8_rgb_or_rgba(c) and any(e>1 for e in c[:3]):
-        cnew = tuple([e/255. for e in c[:3]])
-        if len(c) == 4: cnew += c[3:]
-    return mcolors.to_rgba(cnew, alpha)
diff --git a/build/lib/mplfinance/_kwarg_help.py b/build/lib/mplfinance/_kwarg_help.py
deleted file mode 100644
index c4ea52b5..00000000
--- a/build/lib/mplfinance/_kwarg_help.py
+++ /dev/null
@@ -1,154 +0,0 @@
-import mplfinance as mpf
-import pandas as pd
-import textwrap
-
-def df_wrapcols(df,wrap_columns=None):
-
-    if wrap_columns is None: return df
-    if not isinstance(wrap_columns,dict):
-        raise TypeError('wrap_columns must be a dict of column_names and wrap_lengths')
-
-    for col in wrap_columns:
-        if col not in df.columns:
-            raise ValueError('column "'+str(col)+'" not found in df.columns')
-
-    index = []
-    column_data = {}
-    for col in df.columns:
-        column_data[col] = []
-  
-    for ix in df.index:
-        row = df.loc[ix,]
-        
-        row_data = {}
-        for col in row.index:
-            cstr = str(row[col])
-            if col in wrap_columns:
-                wlen = wrap_columns[col]
-                tw   = textwrap.wrap(cstr,wlen) if not cstr.isspace() else [' ']
-            else:
-                tw = [cstr]
-            row_data[col] = tw
-
-        cmax = max(row_data,key=lambda k: len(row_data[k]))
-        rlen = len(row_data[cmax])
-        for r in range(rlen):
-            for col in row.index:
-                extension = [' ']*(rlen - len(row_data[col]))
-                row_data[col].extend(extension)
-                column_data[col].append(row_data[col][r])
-            ixstr = str(ix)+'.'+str(r) if r > 0 else str(ix)
-            index.append(ixstr)
-
-    return pd.DataFrame(column_data,index=index)
-
-def make_left_formatter(maxwidth):
-    wm3 = maxwidth-3
-    w   = maxwidth
-    def left_formatter(value):
-        if not isinstance(value,str):
-            return f'{value:<}'
-        elif value[0:maxwidth] == '-'*maxwidth:
-            return f'{value:<{w}.{w}s}'
-        elif len(value) > maxwidth:
-            return f'{value:<{wm3}.{wm3}s}...'
-        else:
-            return f'{value:<{w}.{w}s}'
-    return left_formatter
-
-
-def kwarg_help( func_name=None, kwarg_names=None, sort=False ):
-
-    func_kwarg_map = {
-        'plot'              : mpf.plotting._valid_plot_kwargs,
-        'make_addplot'      : mpf.plotting._valid_addplot_kwargs,
-        'make_marketcolors' : mpf._styles._valid_make_marketcolors_kwargs,
-        'make_mpf_style'    : mpf._styles._valid_make_mpf_style_kwargs,
-        'renko_params'      : mpf._utils._valid_renko_kwargs,
-        'pnf_params'        : mpf._utils._valid_pnf_kwargs,
-        'lines'             : mpf._utils._valid_lines_kwargs,
-        'scale_width_adjustment': mpf._widths._valid_scale_width_kwargs,
-        'update_width_config': mpf._widths._valid_update_width_kwargs,
-    }
-
-    func_kwarg_aliases = {
-        'addplot'           : mpf.plotting._valid_addplot_kwargs,
-        'marketcolors'      : mpf._styles._valid_make_marketcolors_kwargs,
-        'mpf_style'         : mpf._styles._valid_make_mpf_style_kwargs,
-        'style'             : mpf._styles._valid_make_mpf_style_kwargs,
-        'renko'             : mpf._utils._valid_renko_kwargs,
-        'pnf'               : mpf._utils._valid_pnf_kwargs,
-        'hlines'            : mpf._utils._valid_lines_kwargs,
-        'alines'            : mpf._utils._valid_lines_kwargs,
-        'tlines'            : mpf._utils._valid_lines_kwargs,
-        'vlines'            : mpf._utils._valid_lines_kwargs,
-    }
-
-    if func_name is None:
-        print('\nUsage: `kwarg_help(func_name)` or `kwarg_help(func_name,kwarg_names)`')
-        print('        kwarg_help is available for the following func_names:')
-        s = str(list(func_kwarg_map.keys()))
-        text = textwrap.wrap(s,68)
-        for t in text:
-            print('           ',t)
-        print()
-        return
-
-    fkmap = {**func_kwarg_map, **func_kwarg_aliases}
-           
-    if func_name not in fkmap:
-        raise ValueError('Function name "'+func_name+'" NOT a valid function name')
-
-    if kwarg_names is not None and isinstance(kwarg_names,str):
-        kwarg_names = [ kwarg_names, ]
-
-    if ( kwarg_names is not None 
-         and (not isinstance(kwarg_names,(list,tuple)) 
-              or not all([isinstance(k,str) for k in kwarg_names])
-             ) 
-       ):
-        raise ValueError('kwarg_names must be a sequence (list,tuple) of strings')
-
-    vks = fkmap[func_name]()
-
-    df = (pd.DataFrame(vks).T).drop('Validator',axis=1)
-    df.index.name = 'Kwarg'
-    if sort: df.sort_index(inplace=True)
-    df.reset_index(inplace=True)
-
-    if kwarg_names is not None:
-        for k in kwarg_names:
-            if k not in df['Kwarg'].values:
-                print('   Warning: "'+k+'" is not a valid `kwarg_name` for `func_name` "'+func_name,'"')
-        df = df[ df['Kwarg'].isin(kwarg_names) ]
-        if len(df) < 1:
-            raise ValueError(' None of specified `kwarg_names` are valid for `func_name` "'+func_name,'"')
-
-    df['Default'] = ["'"+d+"'" if isinstance(d,str) else str(d) for d in df['Default']]
-        
-    klen = df['Kwarg'].str.len().max()+1
-    dlen = df['Default'].str.len().max()+1
-
-    wraplen = max( 40, 80-(klen+dlen) )
-    df = df_wrapcols(df,wrap_columns={'Description':wraplen})
-
-    dividers = []
-    for col in df.columns:
-        dividers.append('-'*int(df[col].str.len().max()))
-    dfd = pd.DataFrame(dividers).T
-    dfd.columns = df.columns
-    dfd.index = pd.Index(['---'])
-
-    df = dfd.append(df)
-
-    formatters = { 'Kwarg'       : make_left_formatter( klen ),
-                   'Default'     : make_left_formatter( dlen ),
-                   'Description' : make_left_formatter( wraplen ),
-                 }
-    
-    print('\n ','-'*78)
-    print('  Kwargs for func_name "'+func_name+'":')
-
-    s = df.to_string(formatters=formatters,index=False,justify='left')
-
-    print('\n ',s.replace('\n','\n  '))
diff --git a/build/lib/mplfinance/_mpf_warnings.py b/build/lib/mplfinance/_mpf_warnings.py
deleted file mode 100644
index dd687d02..00000000
--- a/build/lib/mplfinance/_mpf_warnings.py
+++ /dev/null
@@ -1,16 +0,0 @@
-import sys as __sys
-if not __sys.warnoptions:
-    import os as __os
-    import warnings as __warnings
-    __warnings.filterwarnings("default",category=DeprecationWarning,module='mplfinance') # Change the filter in this process
-    __os.environ["PYTHONWARNINGS"] = "default::DeprecationWarning:mplfinance"            # Also affect subprocesses
-
-if __sys.version_info <= (3, 6):
-    __warnings.filterwarnings("default",category=ImportWarning,module='mplfinance')   # Change the filter in this process
-    __os.environ["PYTHONWARNINGS"] = "default::ImportWarning:mplfinance"              # Also affect subprocesses
-    __warnings.warn('\n\n ================================================================= '+
-                    '\n\n    WARNING: `mplfinance` is NOT supported for Python versions '+
-                    '\n               less than 3.6'
-                    '\n\n ================================================================= ',
-                    category=ImportWarning)
-
diff --git a/build/lib/mplfinance/_mplrcputils.py b/build/lib/mplfinance/_mplrcputils.py
deleted file mode 100644
index ec39a05c..00000000
--- a/build/lib/mplfinance/_mplrcputils.py
+++ /dev/null
@@ -1,87 +0,0 @@
-#!/usr/bin/env python
-"""
-rcparams utilities 
-"""
-
-import pandas as pd
-import matplotlib.pyplot as plt
-import sys
-
-__author__ = "Daniel Goldfarb"
-__version__ = "0.1.0"
-__license__ = "MIT"
-
-def rcParams_to_df(rcp,name=None):
-    keys = []
-    vals = []
-    for item in rcp:
-        keys.append(item)
-        vals.append(rcp[item])
-    df = pd.DataFrame(vals,index=pd.Index(keys,name='rcParamsKey'))    
-    if name is not None:
-        df.columns = [name]
-    else:
-        df.columns = ['Value']
-    return df
-
-def compare_styles(s1,s2):
-    with plt.rc_context():
-         plt.style.use('default')
-         plt.style.use(s1)
-         df1 = rcParams_to_df(plt.rcParams,name=s1)
-
-    with plt.rc_context():
-         plt.style.use('default')
-         plt.style.use(s2)
-         df2 = rcParams_to_df(plt.rcParams,name=s2)
-    
-    df  = pd.concat([df1,df2],axis=1)
-    dif = df[df[s1] != df[s2]].dropna(how='all')
-    return (dif,df,df1,df2)
-
-def main():
-    """ Main entry point of the app """
-    def usage():
-        print('\n    Usage: rcparams <command> <arguments> \n')
-        print('    Available commands: ')
-        print('        rcparams find <findstring>')
-        print('        rcparams compare <style1> <style2>')
-        print('')
-        exit(1)
-    commands = ('find','compare')
-
-    if len(sys.argv) < 3 :
-        print('\n    Too few arguments!')
-        usage()
-
-    command  = sys.argv[1]
-    if command not in commands:
-        print('\n    Unrecognized command \"'+command+'\"')
-        usage()
-
-    if command == 'find':
-        findstr = sys.argv[2]
-        df = rcParams_to_df(plt.rcParams)
-        if findstr == '--all':
-            for key in df.index:
-                print(key+':',df.loc[key,'Value'])
-        else:
-            print(df[df.index.str.contains(findstr)])
-
-    elif command == 'compare':
-        if len(sys.argv) < 4 :
-            print('\n    Need two styles to compare!')
-            usage()
-        style1 = sys.argv[2]
-        style2 = sys.argv[3]
-        dif,df,df1,df2 = compare_styles(style1,style2)
-        print('\n==== dif ====\n',dif)
-
-    else:
-        print('\n    Unrecognized command \"'+command+'\"')
-        usage()
-
-
-if __name__ == "__main__":
-    """ This is executed when run from the command line """
-    main()
diff --git a/build/lib/mplfinance/_mplwraps.py b/build/lib/mplfinance/_mplwraps.py
deleted file mode 100644
index bad47fbb..00000000
--- a/build/lib/mplfinance/_mplwraps.py
+++ /dev/null
@@ -1,121 +0,0 @@
-import matplotlib.pyplot as plt
-import matplotlib.figure as mplfigure
-import matplotlib.axes   as mpl_axes
-from   mplfinance import _styles
-import numpy as np
-
-"""
-    This file contains:
-
-    (1) A wrapper of method `matplotlib.pyplot.figure()` that creates a 
-        `mplfinance.Mpf_Figure` which is derived from `matplotlib.figure.Figure`
-        The wrapper function is the same as `matplotlib.pyplot.figure()` except
-        that it additionally accepts kwarg `style=` to set the mplfinance style.
-
-    (2) Class `mplfinance.Mpf_Figure` derived from `matplotlib.figure.Figure`
-        which has the following overrides:
-        - Attribute `mpfstyle` indicating the mplfinance style used at Figure creation.
-        - Methods (listed below) which are identical to the same method in class
-          `matplotlib.figure.Figure` except that the `mplfinance.Mpf_Figure` versions:
-            - accept kwarg `style=` to set the mplfinance style of Subplot Axes, or
-            - if `style=` is not specified, then the attribute
-              `mplfinance.Mpf_Figure.mpfstyle` is used for the Subplot Axes style.
-          - Figure.add_subplot() 
-          - Figure.add_axes() 
-          - Figure.subplot()  (this is analogous to pyplot.subplot() which calls Figure.add_subplot())
-          - Figure.subplots() 
-
-     (3) A wrapper to matplot.pyplot.show(), because it happens often enough, when using mplfinance,
-         that sometimes one has to import matplotlib.pyplot *ONLY* for the purpose of calling .show()
-"""
-
-show = plt.show  # Not a true wrapper, rather an assignment.
-
-def _check_for_and_apply_style(kwargs):
-
-    if 'style' in kwargs:
-        style = kwargs['style']
-        del kwargs['style']
-    else:
-        style = 'default'
-
-    if not _styles._valid_mpf_style(style):
-        raise TypeError('Invalid mplfinance style')
-
-    if isinstance(style,str):
-        style = _styles._get_mpfstyle(style)
-
-    if isinstance(style,dict):
-        _styles._apply_mpfstyle(style)
-    else:
-        raise TypeError('style should be a `dict`; why is it not?')
-
-    return style
-
-
-def figure(*args,**kwargs):
-
-    style = _check_for_and_apply_style(kwargs)
-
-    f = plt.figure(FigureClass=Mpf_Figure,*args,**kwargs)
-    f.mpfstyle = style
-    return f
-
-
-class Mpf_Figure(mplfigure.Figure):
-
-    def add_subplot(self,*args,**kwargs):
-
-        if 'style' in kwargs or not hasattr(self,'mpfstyle'):
-            style = _check_for_and_apply_style(kwargs)
-        else:
-            style = _check_for_and_apply_style(dict(style=self.mpfstyle))
-
-        ax = mplfigure.Figure.add_subplot(self,*args,**kwargs)
-        ax.mpfstyle = style
-        return ax
-
-    def add_axes(self,*args,**kwargs):
-    
-        if 'style' in kwargs or not hasattr(self,'mpfstyle'):
-            style = _check_for_and_apply_style(kwargs)
-        else:
-            style = _check_for_and_apply_style(dict(style=self.mpfstyle))
-
-        ax = mplfigure.Figure.add_axes(self,*args,**kwargs)
-        ax.mpfstyle = style
-        return ax
-
-    def subplot(self,*args,**kwargs):
-    
-        plt.figure(self.number)  # make it the current Figure
-
-        if 'style' in kwargs or not hasattr(self,'mpfstyle'):
-            style = _check_for_and_apply_style(kwargs)
-        else:
-            style = _check_for_and_apply_style(dict(style=self.mpfstyle))
-
-        ax = plt.subplot(*args,**kwargs)
-        ax.mpfstyle = style
-        return ax
-
-
-    def subplots(self,*args,**kwargs):
-    
-        if 'style' in kwargs or not hasattr(self,'mpfstyle'):
-            style = _check_for_and_apply_style(kwargs)
-            self.mpfstyle = style
-        else:
-            style = _check_for_and_apply_style(dict(style=self.mpfstyle))
-    
-        axlist = mplfigure.Figure.subplots(self,*args,**kwargs)
-
-        if isinstance(axlist,mpl_axes.Axes):
-            axlist.mpfstyle = style
-        elif isinstance(axlist,np.ndarray):
-            for ax in axlist.flatten():
-                ax.mpfstyle = style
-        else:
-           raise TypeError('Unexpected type ('+str(type(axlist))+') '+
-                           'returned from "matplotlib.figure.Figure.subplots()"')
-        return axlist
diff --git a/build/lib/mplfinance/_panels.py b/build/lib/mplfinance/_panels.py
deleted file mode 100644
index 7d8524a2..00000000
--- a/build/lib/mplfinance/_panels.py
+++ /dev/null
@@ -1,232 +0,0 @@
-from mplfinance._helpers import _list_of_dict
-from mplfinance._arg_validators import _valid_panel_id
-import pandas as pd
-
-def _build_panels( figure, config ):
-    """
-    Create and return a DataFrame containing panel information
-    and Axes objects for each panel, etc.
-
-    We allow up to 32 panels, identified by their panel id (panid)
-    which is an integer 0 through 31.  
-
-    Parameters
-    ----------
-    figure       : pyplot.Figure
-        figure on which to create the Axes for the panels
-
-    config       : dict
-        config dict from `mplfinance.plot()`
-        
-    Config
-    ------
-    The following items are used from `config`:
-
-    num_panels   : integer (0-31) or None
-        number of panels to create
-
-    addplot      : dict or None
-        value for the `addplot=` kwarg passed into `mplfinance.plot()`
-
-    volume_panel : integer (0-31) or None
-        panel id (0-number_of_panels)
-
-    main_panel   : integer (0-31) or None
-        panel id (0-number_of_panels)
-
-    panel_ratios : sequence or None
-        sequence of relative sizes for the panels;
-
-        NOTE: If len(panel_ratios) == number of panels (regardless
-        of whether number of panels was specified or inferred),
-        then panel ratios are the relative sizes of each panel,
-        in panel id order, 0 through N (where N = number of panels).
-
-        If len(panel_ratios) != number of panels, then len(panel_ratios)
-        must equal 2, and panel_ratios[0] is the relative size for the 'main'
-        panel, and panel_ratios[1] is the relative size for all other panels.
-
-        If the number of panels == 1, the panel_ratios is ignored.
-
-    
-Returns
-    ----------
-    panels  : pandas.DataFrame
-        dataframe indexed by panel id (panid) and having the following columns:
-          axes           : tuple of matplotlib.Axes (primary and secondary) for each column.
-          used secondary : bool indicating whether or not the seconday Axes is in use.
-          relative size  : height of panel as proportion of sum of all relative sizes
-
-    """
-
-    num_panels   = config['num_panels']
-    addplot      = config['addplot']
-    volume       = config['volume']
-    volume_panel = config['volume_panel']
-    num_panels   = config['num_panels']
-    main_panel   = config['main_panel']
-    panel_ratios = config['panel_ratios']
-
-    if not _valid_panel_id(main_panel):
-        raise ValueError('main_panel id must be integer 0 to 31, but is '+str(main_panel))
-
-    if num_panels is None:  # then infer the number of panels:
-        pset = {0} # start with a set including only panel zero
-        if addplot is not None:
-            if isinstance(addplot,dict):
-                addplot = [addplot,]   # make list of dict to be consistent
-            elif not _list_of_dict(addplot):
-                raise TypeError('addplot must be `dict`, or `list of dict`, NOT '+str(type(addplot)))
-
-            backwards_panel_compatibility = {'main':0,'lower':1,'A':0,'B':1,'C':2}
-
-            for apdict in addplot:
-                panel = apdict['panel']
-                if panel in backwards_panel_compatibility:
-                    panel = backwards_panel_compatibility[panel]
-                if not _valid_panel_id(panel):
-                    raise ValueError('addplot panel must be integer 0 to 31, but is "'+str(panel)+'"')
-                pset.add(panel)
-
-        if volume is True:
-            if not _valid_panel_id(volume_panel):
-                raise ValueError('volume_panel must be integer 0 to 31, but is "'+str(volume_panel)+'"')
-            pset.add(volume_panel)
-
-        pset.add(main_panel)
-
-        pset = sorted(pset)
-        missing = [m for m in range(len(pset)) if m not in pset]
-        if len(missing) != 0:
-            raise ValueError('inferred panel list is missing panels: '+str(missing))
-
-    else:
-        if not isinstance(num_panels,int) or num_panels < 1 or num_panels > 32:
-            raise ValueError('num_panels must be integer 1 to 32, but is "'+str(volume_panel)+'"')
-        pset = range(0,num_panels)
-
-    _nones = [None]*len(pset)
-    panels = pd.DataFrame(dict(axes=_nones,
-                               relsize=_nones,
-                               lift=_nones,
-                               height=_nones,
-                               used2nd=[False]*len(pset),
-                               title=_nones,
-                               y_on_right=_nones),
-                          index=pset)
-    panels.index.name = 'panid'
-
-    # Now determine the height for each panel:
-    # ( figure, num_panels='infer', addplot=None, volume_panel=None, main_panel=0, panel_ratios=None ):
-
-    if panel_ratios is not None:
-        if not isinstance(panel_ratios,(list,tuple)):
-            raise TypeError('panel_ratios must be a list or tuple')
-        if len(panel_ratios) != len(panels) and not (len(panel_ratios)==2 and len(panels) > 2):
-            err  = 'len(panel_ratios) must be 2, or must be same as number of panels'
-            err += '\nlen(panel_ratios)='+str(len(panel_ratios))+'  num panels='+str(len(panels))
-            raise ValueError(err)
-        if len(panel_ratios) == 2 and len(panels) > 2:
-            pratios = [panel_ratios[1]]*len(panels)
-            pratios[main_panel] = panel_ratios[0]
-        else:
-            pratios = panel_ratios
-    else:
-        pratios = [2]*len(panels)
-        pratios[main_panel] = 5
-
-    panels['relsize'] = pratios
-    #print('len(panels)=',len(panels))
-    #print('len(pratios)=',len(pratios))
-
-    #print('pratios=')
-    #print(pratios)
-
-    #print('panels=')
-    #print(panels)
-
-    # TODO:  Throughout this section, right_pad is intentionally *less* 
-    #        than left_pad.  This assumes that the y-axis labels are on
-    #        the left, which is true for many mpf_styles, but *not* all.
-    #        Ideally need to determine which side has the axis labels.
-    #        And keep in mind, if secondary_y is in effect, then both
-    #        sides can have axis labels.
-
-    left_pad    = 0.18
-    right_pad   = 0.10
-    top_pad     = 0.12
-    bot_pad     = 0.18
-
-    scale_left = scale_right = scale_top = scale_bot = 1.0
-
-    scale_padding = config['scale_padding']
-    if isinstance(scale_padding,dict):
-        if 'left'   in scale_padding: scale_left  = scale_padding['left']
-        if 'right'  in scale_padding: scale_right = scale_padding['right']
-        if 'top'    in scale_padding: scale_top   = scale_padding['top']
-        if 'bottom' in scale_padding: scale_bot   = scale_padding['bottom']
-    else: # isinstance(scale_padding,(int,float):
-        scale_left = scale_right = scale_top = scale_bot = scale_padding
-        
-    if config['tight_layout']:
-        right_pad   *= 0.4
-        top_pad     *= 0.4
-        scale_left  *= 0.6
-        scale_right *= 0.6
-        scale_top   *= 0.6
-        scale_bot   *= 0.6
-
-    left_pad  *= scale_left
-    right_pad *= scale_right
-    top_pad   *= scale_top
-    bot_pad   *= scale_bot
-
-    plot_height = 1.0 - (bot_pad  + top_pad  )
-    plot_width  = 1.0 - (left_pad + right_pad)
-
-    #   print('scale_padding=',scale_padding)
-    #   print('left_pad =',left_pad)
-    #   print('right_pad=',right_pad)
-    #   print('top_pad  =',top_pad)
-    #   print('bot_pad  =',bot_pad)
-    #   print('plot_height =',plot_height)
-    #   print('plot_width  =',plot_width)
-        
-    psum = sum(pratios)
-    for panid,size in enumerate(pratios):
-        panels.at[panid,'height'] = plot_height * size / psum
-
-    # Now create the Axes:
-
-    for panid,row in panels.iterrows():
-        height = row.height
-        lift   = panels['height'].loc[panid+1:].sum()
-        panels.at[panid,'lift'] = lift
-        if panid == 0:
-            # rect = [left, bottom, width, height] 
-            ax0 = figure.add_axes( [left_pad, bot_pad+lift, plot_width, height] )
-        else:
-            ax0 = figure.add_axes( [left_pad, bot_pad+lift, plot_width, height], sharex=panels.at[0,'axes'][0] )
-        ax1 = ax0.twinx()
-        ax1.grid(False)
-        if config['saxbelow']:      # issue#115 issuecomment-639446764
-            ax0.set_axisbelow(True) # so grid does not show through plot data on any panel.
-        elif panid == volume_panel:
-            ax0.set_axisbelow(True) # so grid does not show through volume bars.
-        panels.at[panid,'axes'] = (ax0,ax1)
-
-    return panels
-    
-
-def _set_ticks_on_bottom_panel_only(panels,formatter,rotation=45):
-
-    bot = panels.index.values[-1]
-    ax  = panels.at[bot,'axes'][0]
-    ax.tick_params(axis='x',rotation=rotation)
-    ax.xaxis.set_major_formatter(formatter)
-
-    if len(panels) == 1: return
-
-    for panid in panels.index.values[::-1][1:]:
-        panels.at[panid,'axes'][0].tick_params(axis='x',labelbottom=False)
-
diff --git a/build/lib/mplfinance/_styledata/__init__.py b/build/lib/mplfinance/_styledata/__init__.py
deleted file mode 100644
index 0dcbf598..00000000
--- a/build/lib/mplfinance/_styledata/__init__.py
+++ /dev/null
@@ -1,45 +0,0 @@
-'''
-__init__ for mplfinance._styledata module
-'''
-
-from mplfinance._styledata import default
-from mplfinance._styledata import nightclouds
-from mplfinance._styledata import classic
-from mplfinance._styledata import mike
-from mplfinance._styledata import charles
-from mplfinance._styledata import blueskies
-from mplfinance._styledata import starsandstripes
-from mplfinance._styledata import sas
-from mplfinance._styledata import brasil
-from mplfinance._styledata import yahoo
-from mplfinance._styledata import checkers
-from mplfinance._styledata import binance
-from mplfinance._styledata import kenan
-from mplfinance._styledata import ibd
-
-_style_names = [n for n in dir() if not n.startswith('_')]
-
-_styles = {}
-for name in _style_names:
-    cmd = f'_styles.update({name} = {name}.style)'
-    eval(cmd)
-
-def _validate_style(style):
-    keys = ['base_mpl_style','marketcolors','mavcolors','y_on_right',
-            'gridcolor','gridstyle','facecolor','rc' ]
-    for key in keys:
-        if key not in style.keys():
-            err = f'Key "{key}" not found in style:\n\n    {style}'
-            raise ValueError(err)
-    
-    mktckeys = ['candle','edge','wick','ohlc','volume','alpha']
-    for key in mktckeys:
-        if key not in style['marketcolors'].keys():
-            err = f'Key "{key}" not found in marketcolors for style:\n\n    {style}'
-            raise ValueError(err)
-
-#print('type(_styles)=',type(_styles))
-#print('_styles=',_styles)
-for s in _styles.keys():
-    _validate_style(_styles[s])
-
diff --git a/build/lib/mplfinance/_styledata/binance.py b/build/lib/mplfinance/_styledata/binance.py
deleted file mode 100644
index 880096a8..00000000
--- a/build/lib/mplfinance/_styledata/binance.py
+++ /dev/null
@@ -1,29 +0,0 @@
-style = dict(style_name    = 'binance',
-             base_mpl_style= 'seaborn-darkgrid',
-             marketcolors  = {'candle'  : {'up':'#70a800', 'down':'#ea0070'},
-                              'edge'    : {'up':'#70a800', 'down':'#ea0070'},
-                              'wick'    : {'up':'#70a800', 'down':'#ea0070'},
-                              'ohlc'    : {'up':'#70a800', 'down':'#ea0070'},
-                              'volume'  : {'up':'#70a800', 'down':'#ea0070'},
-                              'vcedge'  : {'up':'#70a800', 'down':'#ea0070'},
-                              'vcdopcod': False,
-                              'alpha'   : 0.9,
-                             },
-             mavcolors     = ['#ffc201','#ff10ff','#cd0468','#1f77b4',
-                              '#ff7f0e','#2ca02c','#40e0d0'],
-             y_on_right    = False,
-             gridcolor     = '#d0d0d0',
-             gridstyle     = '--',
-             facecolor     = '#ffffff',
-             rc            = [ ('axes.edgecolor'  , '#e6e6e6' ),
-                               ('axes.linewidth'  ,  1.5      ),
-                               ('axes.labelsize'  , 'medium'  ),
-                               ('axes.labelweight', 'semibold'),
-                               ('lines.linewidth' ,  2.0      ),
-                               ('font.weight'     , 'medium'  ),
-                               ('font.size'       ,  12.0     ),
-                               ('figure.titlesize', 'x-large' ),
-                               ('figure.titleweight','semibold'),
-                             ],
-             base_mpf_style= 'binance'
-            )
diff --git a/build/lib/mplfinance/_styledata/blueskies.py b/build/lib/mplfinance/_styledata/blueskies.py
deleted file mode 100644
index 26985778..00000000
--- a/build/lib/mplfinance/_styledata/blueskies.py
+++ /dev/null
@@ -1,23 +0,0 @@
-style = dict(style_name    = 'blueskies',
-             base_mpl_style='fast', 
-             marketcolors  = {'candle'  : {'up':'w', 'down':'#0095ff'},
-                              'edge'    : {'up':'k', 'down':'#0095ff'},
-                              'wick'    : {'up':'k', 'down':'#0095ff'},
-                              'ohlc'    : {'up':'#0095ff', 'down':'#0095ff'},
-                              'volume'  : {'up':'w', 'down':'#0095ff'},
-                              'vcdopcod': False,
-                              'alpha'   : 1.0,
-                             },
-             mavcolors     = None,
-             y_on_right    = False,
-             facecolor     = '#dbf1ff',
-             gridcolor     = None,
-             gridstyle     = None,
-             rc            = [('patch.linewidth'      ,  1.0      ),
-                              ('patch.force_edgecolor', True      ),
-                              ('lines.linewidth'      ,  1.0      ),
-                              ('figure.titlesize'     , 'x-large' ),
-                              ('figure.titleweight'   , 'semibold'),
-                             ],
-             base_mpf_style='blueskies', 
-            )
diff --git a/build/lib/mplfinance/_styledata/brasil.py b/build/lib/mplfinance/_styledata/brasil.py
deleted file mode 100644
index f3e73e75..00000000
--- a/build/lib/mplfinance/_styledata/brasil.py
+++ /dev/null
@@ -1,25 +0,0 @@
-style = {'base_mpl_style': 'fast',
-         'marketcolors': {'candle': {'up': '#fedf00', 'down': '#002776'},
-                          'edge'  : {'up': '#fedf00', 'down': '#002776'},
-                          'wick'  : {'up': '#fedf00', 'down': '#002776'},
-                          'ohlc'  : {'up': '#fedf00', 'down': '#002776'},
-                          'volume': {'up': '#fedf00', 'down': '#002776'},
-                          'vcedge': {'up': '#1f77b4', 'down': '#1f77b4'},
-                          'vcdopcod': False,
-                          'alpha': 0.9},
-         'mavcolors' : None,
-         'facecolor' : None,
-         'gridcolor' : None,
-         'gridstyle' : None,
-         'y_on_right': True,
-         'rc': {'axes.grid'     :  True,
-                'axes.grid.axis': 'y',
-                'grid.color'    : '#fedf00',
-                'grid.linestyle': '--',
-                'axes.facecolor': '#009b3a',
-                'axes.edgecolor': '#002776',
-                'figure.titlesize'  : 'x-large',
-                'figure.titleweight': 'semibold',
-               },
-         'base_mpf_style': 'brasil'
-        }
diff --git a/build/lib/mplfinance/_styledata/charles.py b/build/lib/mplfinance/_styledata/charles.py
deleted file mode 100644
index 0347a605..00000000
--- a/build/lib/mplfinance/_styledata/charles.py
+++ /dev/null
@@ -1,30 +0,0 @@
-style = dict(style_name    = 'charles',
-             base_mpl_style= 'fast', 
-             marketcolors  = {'candle'  : {'up':'#006340', 'down':'#a02128'},
-                              'edge'    : {'up':'#006340', 'down':'#a02128'},
-                              'wick'    : {'up':'#006340', 'down':'#a02128'},
-                              'ohlc'    : {'up':'#006340', 'down':'#a02128'},
-                              'volume'  : {'up':'#007a00', 'down':'#d50d18'},
-                              'vcdopcod': True, # Volume Color Depends On Price Change On Day
-                              'alpha'   : 1.0,
-                             },
-             mavcolors     = ['#ef5714','#ef5714','#9f4878','#9f4878'],
-             y_on_right    = True,
-             gridcolor     = '#a0a0a0',
-             gridstyle     = '--',
-             facecolor     = 'w',
-             rc            = [ ('axes.edgecolor'  , 'white'   ),
-                               ('axes.linewidth'  ,  1.5      ),
-                               ('axes.labelsize'  , 'large'   ),
-                               ('axes.labelweight', 'semibold'),
-                               ('axes.grid'       ,  True     ),
-                               ('axes.grid.axis'  ,  'y'      ),
-                               ('grid.linewidth'  ,  0.4      ),
-                               ('lines.linewidth' ,  2.0      ),
-                               ('font.weight'     , 'medium'  ),
-                               ('font.size'       ,  10.0     ),
-                               ('figure.titlesize', 'x-large' ),
-                               ('figure.titleweight','semibold'),
-                             ],
-             base_mpf_style= 'charles'
-            )
diff --git a/build/lib/mplfinance/_styledata/checkers.py b/build/lib/mplfinance/_styledata/checkers.py
deleted file mode 100644
index f599758d..00000000
--- a/build/lib/mplfinance/_styledata/checkers.py
+++ /dev/null
@@ -1,26 +0,0 @@
-style = {'base_mpl_style': 'ggplot',
-         'marketcolors'  : {'candle': {'up': '#000000', 'down': '#ff0000'},
-                            'edge'  : {'up': '#000000', 'down': '#ff0000'},
-                            'wick'  : {'up': '#606060', 'down': '#606060'},
-                            'ohlc'  : {'up': '#000000', 'down': '#ff0000'},
-                            'volume': {'up': '#6f6f6f', 'down': '#ff4040'},
-                            'vcedge': {'up': '#1f77b4', 'down': '#1f77b4'},
-         'vcdopcod'      : False,
-         'alpha'         : 0.9},
-         'mavcolors'     : None,
-         'facecolor'     : 'w',
-         'gridcolor'     : '#c0c0c0',
-         'gridstyle'     : '-',
-         'y_on_right'    : True,
-         'rc'            : {'axes.grid.axis': 'both',
-                            'axes.grid'     : True,
-                            'axes.edgecolor': '#c0c0c0',
-                            'axes.labelcolor': 'k',
-                            'ytick.color'   : 'k',
-                            'xtick.color'   : 'k',
-                            'lines.markeredgecolor': 'k',
-                            'patch.force_edgecolor': True,
-                            'figure.titlesize'     : 'x-large',
-                            'figure.titleweight'   : 'semibold',
-                           },
-         'base_mpf_style': 'checkers'}
diff --git a/build/lib/mplfinance/_styledata/classic.py b/build/lib/mplfinance/_styledata/classic.py
deleted file mode 100644
index 0a2fe461..00000000
--- a/build/lib/mplfinance/_styledata/classic.py
+++ /dev/null
@@ -1,28 +0,0 @@
-style = dict(style_name    = 'classic',
-             base_mpl_style= 'fast', 
-             marketcolors  = {'candle'  : {'up':'w', 'down':'k'},
-                              'edge'    : {'up':'k', 'down':'k'},
-                              'wick'    : {'up':'k', 'down':'k'},
-                              'ohlc'    : {'up':'k', 'down':'k'},
-                              'volume'  : {'up':'#181818', 'down':'#181818'},
-                              'vcedge'  : {'up':'#181818', 'down':'#181818'},
-                              'vcdopcod': False, # Volume Color is Per Price Change On Day
-                              'alpha'   : 0.9,
-                             },
-             mavcolors     = ['#1a1a1a','#262626','#333333','#404040'],
-             y_on_right    = True,
-             gridcolor     = '#cccccc',
-             gridstyle     = '--',
-             facecolor     = 'w',
-             rc            = [ ('axes.edgecolor'  , 'black'   ),
-                               ('axes.linewidth'  ,  1.5      ),
-                               ('axes.labelsize'  , 'large'   ),
-                               ('axes.labelweight', 'semibold'),
-                               ('lines.linewidth' ,  2.0      ),
-                               ('font.weight'     , 'medium'  ),
-                               ('font.size'       ,  12.0     ),
-                               ('figure.titlesize', 'x-large' ),
-                               ('figure.titleweight','semibold'),
-                             ],
-             base_mpf_style= 'classic'
-            )
diff --git a/build/lib/mplfinance/_styledata/default.py b/build/lib/mplfinance/_styledata/default.py
deleted file mode 100644
index 7e2690ad..00000000
--- a/build/lib/mplfinance/_styledata/default.py
+++ /dev/null
@@ -1,29 +0,0 @@
-style = dict(style_name    = 'default',
-             base_mpl_style= 'seaborn-darkgrid', 
-             marketcolors  = {'candle'  : {'up':'w', 'down':'k'},
-                              'edge'    : {'up':'k', 'down':'k'},
-                              'wick'    : {'up':'k', 'down':'k'},
-                              'ohlc'    : {'up':'k', 'down':'k'},
-                              'volume'  : {'up':'#1f77b4', 'down':'#1f77b4'},
-                              'vcedge'  : {'up':'#1f77b4', 'down':'#1f77b4'},
-                              'vcdopcod': False, # Volume Color is Per Price Change On Day
-                              'alpha'   : 0.9,
-                             },
-             mavcolors     = ['#40e0d0','#ff00ff','#ffd700','#1f77b4',
-                              '#ff7f0e','#2ca02c','#e377c2'],
-             y_on_right    = False,
-             gridcolor     = None,
-             gridstyle     = None,
-             facecolor     = '#DCE3EF',
-             rc            = [ ('axes.edgecolor'  , 'black'   ),
-                               ('axes.linewidth'  ,  1.5      ),
-                               ('axes.labelsize'  , 'large'   ),
-                               ('axes.labelweight', 'semibold'),
-                               ('lines.linewidth' ,  2.0      ),
-                               ('font.weight'     , 'medium'  ),
-                               ('font.size'       ,  12.0     ),
-                               ('figure.titlesize', 'x-large' ),
-                               ('figure.titleweight','semibold'),
-                             ],
-             base_mpf_style= 'default'
-            )
diff --git a/build/lib/mplfinance/_styledata/ibd.py b/build/lib/mplfinance/_styledata/ibd.py
deleted file mode 100644
index c233f885..00000000
--- a/build/lib/mplfinance/_styledata/ibd.py
+++ /dev/null
@@ -1,38 +0,0 @@
-style = dict(style_name    = 'ibd',
-             base_mpl_style= 'fast', 
-             marketcolors  = {'candle'  : {'up':'#2A3FE5', 'down':'#DB39AD'},
-                              'edge'    : {'up':'#2A3FE5', 'down':'#DB39AD'},
-                              'wick'    : {'up':'#2A3FE5', 'down':'#DB39AD'},
-                              'ohlc'    : {'up':'#2A3FE5', 'down':'#DB39AD'},
-                              'volume'  : {'up':'#2A3FE5', 'down':'#DB39AD'},
-                              'vcedge'  : {'up':'#2A3FE5', 'down':'#DB39AD'},
-                              'vcdopcod': True, # Volume Color is Per Price Change On Day
-                              'alpha'   : 1.0,
-                             },
-             mavcolors     = ['green','red','black','blue'],
-             y_on_right    = True,
-             gridcolor     = None,
-             gridstyle     = None,
-             facecolor     = None,
-             rc            =  [     ('axes.titlesize',      8),
-                                    ('axes.labelsize',      8) , 
-                                    ('lines.linewidth',     3),
-                                    ('lines.markersize',    4),
-                                    ('ytick.left',          False),
-                                    ('ytick.right',         True),
-                                    ('ytick.labelleft',     False),   
-                                    ('ytick.labelright',    True), 
-                                    ('xtick.labelsize',     6),
-                                    ('ytick.labelsize',     7),
-                                    ('axes.linewidth',      0.8),
-                                    ('grid.alpha',          0.2), 
-                                    ('axes.grid'       ,  True     ),
-                                    ('axes.grid.axis'  ,  'y'      ),  
-                                    ('grid.color'      , '#b0b0b0' ),
-                                    ('grid.linestyle'  , 'solid'      ),
-                                    ('grid.linewidth'  ,  0.8      ),
-                                    ('figure.titlesize', 'x-large' ),
-                                    ('figure.titleweight','semibold'),
-                              ],
-             base_mpf_style= 'ibd'
-            )
diff --git a/build/lib/mplfinance/_styledata/kenan.py b/build/lib/mplfinance/_styledata/kenan.py
deleted file mode 100644
index 98ed0620..00000000
--- a/build/lib/mplfinance/_styledata/kenan.py
+++ /dev/null
@@ -1,33 +0,0 @@
-style = {   'style_name': 'kenan',
-            'base_mpl_style': 'seaborn-darkgrid',
-            'marketcolors': {   'candle': {'up': 'k', 'down': 'r'},
-                                'edge': {'up': 'k', 'down': 'r'},
-                                'wick': {'up': 'k', 'down': 'r'},
-                                'ohlc': {'up': 'k', 'down': 'k'},
-                                'volume': {'up': '#1f77b4', 'down': '#1f77b4'},
-                                'vcedge': {'up': '#1f77b4', 'down': '#1f77b4'},
-                                'vcdopcod': False,
-                                'alpha': 0.9,
-                                'hollow': 'w'},
-            'mavcolors': [   '#40e0d0',
-                             '#ff00ff',
-                             '#ffd700',
-                             '#1f77b4',
-                             '#ff7f0e',
-                             '#2ca02c',
-                             '#e377c2'],
-            'y_on_right': False,
-            'gridcolor': None,
-            'gridstyle': None,
-            'facecolor': '#DCE3EF',
-            'rc': [   ('axes.edgecolor', 'black'),
-                      ('axes.linewidth', 1.5),
-                      ('axes.labelsize', 'large'),
-                      ('axes.labelweight', 'semibold'),
-                      ('lines.linewidth', 2.0),
-                      ('font.weight', 'medium'),
-                      ('font.size', 12.0),
-                      ('figure.titlesize', 'x-large' ),
-                      ('figure.titleweight','semibold'),
-                  ],
-            'base_mpf_style': 'default'}
diff --git a/build/lib/mplfinance/_styledata/mike.py b/build/lib/mplfinance/_styledata/mike.py
deleted file mode 100644
index ef026e24..00000000
--- a/build/lib/mplfinance/_styledata/mike.py
+++ /dev/null
@@ -1,36 +0,0 @@
-style = dict(style_name    = 'mike',
-             base_mpl_style= 'dark_background', 
-             marketcolors  = {'candle'  : {'up':'#000000', 'down':'#0080ff'},
-                              'edge'    : {'up':'#ffffff', 'down':'#0080ff'},
-                              'wick'    : {'up':'#ffffff', 'down':'#ffffff'},
-                              'ohlc'    : {'up':'#ffffff', 'down':'#ffffff'},
-                              'volume'  : {'up':'#7189aa', 'down':'#7189aa'},
-                              'vcdopcod': False, # Volume Color Depends On Price Change On Day
-                              'alpha'   : 1.0,
-                             },
-             mavcolors     = ['#ec009c','#78ff8f','#fcf120'],
-             y_on_right    = True,
-             gridcolor     = None,
-             gridstyle     = None,
-             facecolor     = None,
-             rc            = [ ('axes.edgecolor'  , 'white'   ),
-                               ('axes.linewidth'  ,  1.5      ),
-                               ('axes.labelsize'  , 'large'   ),
-                               ('axes.labelweight', 'semibold'),
-                               ('axes.grid'       , True      ),
-                               ('axes.grid.axis'  , 'both'    ),
-                               ('axes.grid.which' , 'major'   ),
-                               ('grid.alpha'      ,  0.9      ),
-                               ('grid.color'      , '#b0b0b0' ),
-                               ('grid.linestyle'  , '--'      ),
-                               ('grid.linewidth'  ,  0.8      ),
-                               ('figure.facecolor', '#0a0a0a' ),
-                               ('patch.linewidth' ,  1.0      ),
-                               ('lines.linewidth' ,  1.0      ),
-                               ('font.weight'     , 'medium'  ),
-                               ('font.size'       ,  10.0     ),
-                               ('figure.titlesize', 'x-large' ),
-                               ('figure.titleweight','semibold'),
-                             ],
-             base_mpf_style= 'mike'
-            )
diff --git a/build/lib/mplfinance/_styledata/nightclouds.py b/build/lib/mplfinance/_styledata/nightclouds.py
deleted file mode 100644
index 2507d12e..00000000
--- a/build/lib/mplfinance/_styledata/nightclouds.py
+++ /dev/null
@@ -1,23 +0,0 @@
-style = dict(style_name    = 'nightclouds',
-             base_mpl_style='dark_background', 
-             marketcolors  = {'candle'  : {'up':'w', 'down':'#0095ff'},
-                              'edge'    : {'up':'w', 'down':'#0095ff'},
-                              'wick'    : {'up':'w', 'down':'w'},
-                              'ohlc'    : {'up':'w', 'down':'w'},
-                              'volume'  : {'up':'w', 'down':'#0095ff'},
-                              'vcdopcod': False,
-                              'alpha'   : 1.0,
-                             },
-             mavcolors     = ['#40e0d0','#ff00ff','#ffd700','#1f77b4',
-                              '#ff7f0e','#2ca02c','#e377c2'],
-             y_on_right    = False,
-             facecolor     = '#0b0b0b',
-             gridcolor     = '#999999',
-             gridstyle     = '--',
-             rc            = [('patch.linewidth' ,  1.0      ),
-                              ('lines.linewidth' ,  1.0      ),
-                              ('figure.titlesize', 'x-large' ),
-                              ('figure.titleweight','semibold'),
-                             ],
-             base_mpf_style='nightclouds', 
-            )
diff --git a/build/lib/mplfinance/_styledata/sas.py b/build/lib/mplfinance/_styledata/sas.py
deleted file mode 100644
index e88e310a..00000000
--- a/build/lib/mplfinance/_styledata/sas.py
+++ /dev/null
@@ -1,4 +0,0 @@
-# style sas is just an abbreviation for starsandstripes:
-
-from mplfinance._styledata import starsandstripes
-style = starsandstripes.style
diff --git a/build/lib/mplfinance/_styledata/starsandstripes.py b/build/lib/mplfinance/_styledata/starsandstripes.py
deleted file mode 100644
index 09120cd6..00000000
--- a/build/lib/mplfinance/_styledata/starsandstripes.py
+++ /dev/null
@@ -1,24 +0,0 @@
-style = {'base_mpl_style': 'fast',
-         'marketcolors': {'candle': {'up': '#082865', 'down': '#ae0019'},
-                          'edge'  : {'up': '#082865', 'down': '#ae0019'},
-                          'wick'  : {'up': '#082865', 'down': '#ae0019'},
-                          'ohlc'  : {'up': '#082865', 'down': '#ae0019'},
-                          'volume': {'up': '#082865', 'down': '#ae0019'},
-                          'vcedge': {'up': '#1f77b4', 'down': '#1f77b4'},
-                          'vcdopcod': False,
-                          'alpha': 0.9},
-         'mavcolors': None,
-         'facecolor': None,
-         'gridcolor': None,
-         'gridstyle': None,
-         'y_on_right': True,
-         'rc': {'axes.edgecolor': '#082865',
-                'axes.grid'     :  True,
-                'axes.grid.axis': 'y',
-                'grid.color'    : '#082865',
-                'grid.linestyle': '--',
-                'figure.titlesize'  :'x-large',
-                'figure.titleweight':'semibold',
-               },
-         'base_mpf_style': 'starsandstripes'
-        }
diff --git a/build/lib/mplfinance/_styledata/yahoo.py b/build/lib/mplfinance/_styledata/yahoo.py
deleted file mode 100644
index 85f1c576..00000000
--- a/build/lib/mplfinance/_styledata/yahoo.py
+++ /dev/null
@@ -1,23 +0,0 @@
-style = {'base_mpl_style': 'fast',
-         'marketcolors'  : {'candle': {'up': '#00b060', 'down': '#fe3032'},
-                            'edge'  : {'up': '#00b060', 'down': '#fe3032'},
-                            'wick'  : {'up': '#606060', 'down': '#606060'},
-                            'ohlc'  : {'up': '#00b060', 'down': '#fe3032'},
-                            'volume': {'up': '#4dc790', 'down': '#fd6b6c'},
-                            'vcedge': {'up': '#1f77b4', 'down': '#1f77b4'},
-         'vcdopcod'      : True,
-         'alpha'         : 0.9},
-         'mavcolors'     : None,
-         'facecolor'     : '#fafafa',
-         'gridcolor'     : '#d0d0d0',
-         'gridstyle'     : '-',
-         'y_on_right'    : True,
-         'rc'            : {'axes.labelcolor': '#101010',
-                            'axes.edgecolor' : 'f0f0f0',
-                            'axes.grid.axis' : 'y',
-                            'ytick.color'    : '#101010',
-                            'xtick.color'    : '#101010',
-                            'figure.titlesize': 'x-large',
-                            'figure.titleweight':'semibold',
-                           },
-         'base_mpf_style': 'yahoo'}
diff --git a/build/lib/mplfinance/_styles.py b/build/lib/mplfinance/_styles.py
deleted file mode 100644
index 15d0538b..00000000
--- a/build/lib/mplfinance/_styles.py
+++ /dev/null
@@ -1,382 +0,0 @@
-import matplotlib.pyplot as plt
-import copy
-import pprint
-import os.path as path
-
-from   mplfinance._arg_validators import _process_kwargs, _validate_vkwargs_dict
-from   mplfinance._styledata      import _styles
-from   mplfinance._helpers        import _mpf_is_color_like
-
-
-def _get_mpfstyle(style):
-    ''' 
-    Return a copy of the specified pre-defined mpfstyle.  We return
-    a copy, because returning the original will effectively return 
-    a pointer which allows style's definition to be modified.
-    '''
-    return copy.deepcopy(_styles[style])
-
-def _apply_mpfstyle(style):
-
-    plt.style.use('default')
-
-    if style['base_mpl_style'] is not None:
-        plt.style.use(style['base_mpl_style']) 
-
-    if style['rc'] is not None:
-        plt.rcParams.update(style['rc'])
-
-    if style['facecolor'] is not None:
-        plt.rcParams.update({'axes.facecolor' : style['facecolor'] })
-
-    if 'edgecolor' in style and style['edgecolor'] is not None:
-        plt.rcParams.update({'axes.edgecolor' : style['edgecolor'] })
-
-    if 'figcolor' in style and style['figcolor'] is not None:
-        plt.rcParams.update({'figure.facecolor' : style['figcolor'] })
-        plt.rcParams.update({'savefig.facecolor': style['figcolor'] })
-
-    explicit_grid = False
-    if style['gridcolor'] is not None:
-        explicit_grid = True
-        plt.rcParams.update({'grid.color' : style['gridcolor'] })
-
-    if style['gridstyle'] is not None:
-        explicit_grid = True
-        plt.rcParams.update({'grid.linestyle' : style['gridstyle'] })
-
-    plt.rcParams.update({'axes.grid.axis' : 'both' })
-    if 'gridaxis' in style and style['gridaxis'] is not None:
-        gax = style['gridaxis']
-        explicit_grid = True
-        if gax == 'horizontal'[0:len(gax)]:
-            plt.rcParams.update({'axes.grid.axis' : 'y' })
-        elif gax == 'vertical'[0:len(gax)]:
-            plt.rcParams.update({'axes.grid.axis' : 'x' })
-
-    if explicit_grid:
-        plt.rcParams.update({'axes.grid' : True })
-
-
-def _valid_make_mpf_style_kwargs():
-    vkwargs = {
-        'base_mpf_style': { 'Default'     : None,
-                            'Description' : 'mplfinance style to use as base of new mplfinance style',
-                            'Validator'   : lambda value: value in _styles.keys() },
-
-        'base_mpl_style': { 'Default'     : None,
-                            'Description' : 'matplotlib style to use as base of new mplfinance style',
-                            'Validator'   : lambda value: isinstance(value,(str,list))}, # and is in plt.style.available
-
-        'marketcolors'  : { 'Default'     : None,
-                            'Description' : 'market colors object, from `mpf.make_market_colors()`',
-                            'Validator'   : lambda value: isinstance(value,dict)  },
-
-        'mavcolors'     : { 'Default'     : None,
-                            'Description' : 'sequence of colors to use for moving averages',
-                            'Validator'   : lambda value: isinstance(value,list) },  # TODO: all([_mpf_is_color_like(v) for v in value.values()])
-
-
-        'facecolor'     : { 'Default'     : None,
-                            'Description' : 'background color for Axes',
-                            'Validator'   : lambda value: isinstance(value,str) },
-
-        'edgecolor'     : { 'Default'     : None,
-                            'Description' : 'edge color for Axes',
-                            'Validator'   : lambda value: isinstance(value,str) },
-
-        'figcolor'      : { 'Default'     : None,
-                            'Description' : 'background color for Figure.',
-                            'Validator'   : lambda value: isinstance(value,str) },
-
-        'gridcolor'     : { 'Default'     : None,
-                            'Description' : 'color for grid lines',
-                            'Validator'   : lambda value: isinstance(value,str) },
-
-        'gridstyle'     : { 'Default'     : None,
-                            'Description' : "grid line style ('-', '--', '-.', ':', '', offset, on-off-seq)."+
-                                            " (see also: https://matplotlib.org/stable/gallery/lines_bars_and_markers/linestyles.html)",
-                            'Validator'   : lambda value: isinstance(value,str) },
-
-        'gridaxis'      : { 'Default'     : None,
-                            'Description' : "grid lines 'vertical', 'horizontal', or 'both'",
-                            'Validator'   : lambda value: value in [ 'vertical'[0:len(value)], 'horizontal'[0:len(value)], 'both'[0:len(value)] ] },
-
-        'y_on_right'    : { 'Default'     : None,
-                            'Description' : 'True|False primary Axes y-ticks and labels on right.',
-                            'Validator'   : lambda value: isinstance(value,bool) },
-
-        'rc'            : { 'Default'     : None,
-                            'Description' : 'rcparams overrides (dict) (all other rcparams unchanged)',
-                            'Validator'   : lambda value: isinstance(value,dict) },
-
-        'legacy_rc'     : { 'Default'     : None,  # Just in case someone depended upon old behavior
-                            'Description' : 'rcparams to set (dict) (all other rcparams cleared)',
-                            'Validator'   : lambda value: isinstance(value,dict) },
-
-        'style_name'    : { 'Default'     : None,
-                            'Description' : 'name for this style; useful when calling `mpf.write_style_file(style,filename)`',
-                            'Validator'   : lambda value: isinstance(value,str) },
-
-    }
-
-    _validate_vkwargs_dict(vkwargs)
-
-    return vkwargs
-
-
-def available_styles():
-    return list(_styles.keys())
-
-def make_mpf_style( **kwargs ):
-    config = _process_kwargs(kwargs, _valid_make_mpf_style_kwargs())
-    if config['rc'] is not None and config['legacy_rc'] is not None:
-        raise ValueError('kwargs `rc` and `legacy_rc` may NOT be used together!')
-
-    # -----------
-    # March 2021: Found bug that if caller used `base_mpf_style` and `rc` at
-    #   the same time, then the caller's `rc` will completely replace the `rc` 
-    #   of `base_mpf_style`.  That was never the intention!  Rather it should be
-    #   that the caller's `rc` merely adds to and/or modifies the `rc` of the
-    #   `base_mpf_style`.  In order to provide a path to "backwards compatibility"
-    #   for users who may have depended on the bug behavior (callers `rc` replaces
-    #   `rc` of `base_mpf_style`) we provide a new kwarg `legacy_rc` which will
-    #   now behave the way that `rc` used to behave.
-    # -----------
-
-    if config['base_mpf_style'] is not None:
-        style  = _get_mpfstyle(config['base_mpf_style'])
-        # Have to handle 'rc' separately, so we don't wipe 
-        # out the 'rc' params in the `base_mpf_style` that
-        # are not specified in the `make_mpf_style` config:
-        if config['rc'] is not None:
-            rc = config['rc']
-            del config['rc']
-            if isinstance(style['rc'],list):
-                style['rc'] = dict(style['rc'])
-            if style['rc'] is None:
-                style['rc'] = {}
-            style['rc'].update(rc)
-        elif config['legacy_rc'] is not None:
-            config['rc'] = config['legacy_rc']
-            del config['legacy_rc']
-        update = [ (k,v) for k,v in config.items() if v is not None ]
-        style.update(update)
-    else:
-        style  = config
-
-    if style['marketcolors'] is None:
-        style['marketcolors'] = _styles['default']['marketcolors']
-
-    return style
-
-def _valid_mpf_color_spec(value):
-    'value must be a color, "inherit"-like, or dict of colors'
-    return ( _mpf_is_color_like(value) or 
-             ( isinstance(value,str) and value == 'inherit'[0:len(value)]) or
-             ( isinstance(value,dict) and
-               all([_mpf_is_color_like(v) for v in value.values()])
-             )
-           )
-
-def _valid_mpf_style(value):
-    if value in available_styles():
-        return True
-    if not isinstance(value,dict):
-        return False
-    if 'marketcolors' not in value:
-        return False
-    if not isinstance(value['marketcolors'],dict):
-        return False
-    # {'candle': {'up': 'b', 'down': 'g'},
-    #  'edge': {'up': 'k', 'down': 'k'},
-    #  'wick': {'up': 'k', 'down': 'k'},
-    #  'ohlc': {'up': 'k', 'down': 'k'},
-    #  'volume': {'up': '#1f77b4', 'down': '#1f77b4'},
-    #  'vcedge': {'up': '#1f77b4', 'down': '#1f77b4'},
-    #  'vcdopcod': False,
-    #  'alpha': 0.9}
-    for item in ('candle','edge','wick','ohlc','volume'):
-        if item not in value['marketcolors']:
-            return False
-        itemcolors = value['marketcolors'][item]
-        if not isinstance(itemcolors,dict):
-            return False
-        if 'up' not in itemcolors or 'down' not in itemcolors:
-            return False
-    return True
-
-
-def _valid_make_marketcolors_kwargs():
-    vkwargs = {
-        'up'            : { 'Default'     : None,
-                            'Description' : 'color to indicate up', 
-                            'Validator'   : lambda value: _mpf_is_color_like(value) },
-
-        'down'          : { 'Default'     : None,
-                            'Description' : 'color to indicate down', 
-                            'Validator'   : lambda value: _mpf_is_color_like(value) },
-
-        'hollow'        : { 'Default'     : None,
-                            'Description' : "color for hollow candles (for `type=hollow`)",
-                            'Validator'   : lambda value: _mpf_is_color_like(value) },
-
-        'alpha'         : { 'Default'     : None,
-                            'Description' : 'opacity 0.0 (transparent) to 1.0 (opaque);'+
-                                            ' applies to candles,renko,pnf (but not ohlc bars)',
-                            'Validator'   : lambda value: (isinstance(value,float)
-                                                           and 0.0 <= value and 1.0 >= value ) },
-
-        'edge'          : { 'Default'     : None,
-                            'Description' : 'color of candle edge; may also be "i" or "inherit"'+
-                                            ' to take color from base_mpf_style',
-                            'Validator'   : lambda value: _valid_mpf_color_spec(value) },
-
-        'wick'          : { 'Default'     : None,
-                            'Description' : "color of candle wick; may be single color,"+
-                                            " or may be dict with keys 'up' and 'down'",
-                            'Validator'   : lambda value: isinstance(value,dict)
-                                                          or isinstance(value,str)
-                                                          or _mpf_is_color_like(value) },
-
-        'ohlc'          : { 'Default'     : None,
-			    'Description' : "color of ohlc bars; may be single color,"+
-					    " or may be dict with keys 'up' and 'down'",
-                            'Validator'   : lambda value: isinstance(value,dict)
-                                                          or isinstance(value,str)
-                                                          or _mpf_is_color_like(value) },
-
-        'volume'        : { 'Default'   : None,
-			    'Description' : "color of volume bars; may be single color,"+
-					    " or may be dict with keys 'up' and 'down'",
-                            'Validator'   : lambda value: isinstance(value,dict)
-                                                          or isinstance(value,str)
-                                                          or _mpf_is_color_like(value) },
-
-        'vcdopcod'      : { 'Default'     : False,
-                            'Description' : 'True/False volume color depends on price change from previous day',
-                            'Validator'   : lambda value: isinstance(value,bool) },
-
-
-        'inherit'       : { 'Default'     : False,
-                            'Description' : 'inherit color from base_mpf_style for: edge,volume,ohlc,wick',
-                            'Validator'   : lambda value: isinstance(value,bool) },
-
-        'base_mpf_style': { 'Default'     : None,
-                            'Description' : 'mplfinance style market colors as basis for new market colors object',
-                            'Validator'   : lambda value: isinstance(value,str) },
-    }
-
-    _validate_vkwargs_dict(vkwargs)
-
-    return vkwargs
-
-
-def make_marketcolors(**kwargs):
-    '''
-    Create a 'marketcolors' dict that is structured as expected
-    by mplfinance._styles code:
-        up     = color for close >= open
-        down   = color for close  < open
-        edge   = color for edge of candlestick; if "inherit"
-                 then edge color will be same as up or down.
-        wick   = color for wick of candlestick; if "inherit"
-                 then wick color will be same as up or down.
-        alpha  = opacity, 0.0 to 1.0, of candlestick face.
-        ohlc   = color of ohlc bars when all the same color;
-                 if ohlc == "inherit" then use up/down colors.
-        volume = color of volume bars when all the same color;
-                 if volume == "inherit" then use up/down colors.
-    '''
-
-    config = _process_kwargs(kwargs, _valid_make_marketcolors_kwargs())
-
-    if config['base_mpf_style'] is not None:
-        style = _get_mpfstyle(config['base_mpf_style'])
-    else:
-        style = _get_mpfstyle('default')
-
-    marketcolors = style['marketcolors']
-
-    up   = config['up']
-    down = config['down']
-    if up is not None and down is not None:
-        marketcolors.update(candle=dict(up=up,down=down))
-    elif up is not None:
-        candle = marketcolors['candle']
-        candle.update(up=up)
-        marketcolors.update(candle=candle)
-    elif down is not None:
-        candle = marketcolors['candle']
-        candle.update(down=down)
-        marketcolors.update(down=down)
-
-    def _check_and_set_mktcolor(candle,**kwarg):
-        if len(kwarg) != 1:
-            raise ValueError('Expect only ONE kwarg')
-        key,value = kwarg.popitem()
-        if isinstance(value,(dict)):
-            colors = value
-        elif isinstance(value,str) and value == 'inherit'[0:len(value)]:
-            colors = candle
-        else:
-            colors = dict(up=value, down=value)
-        for updown in ['up','down']:
-            if not _mpf_is_color_like(colors[updown]):
-                err = f'NOT is_color_like() for {key}[\'{updown}\'] = {colors[updown]}'
-                raise ValueError(err)
-        return colors
-
-    candle = marketcolors['candle']
-
-    for kw in ['edge','volume','ohlc','wick']:
-        # `inherit=True` takes precedence:
-        if config[kw] is not None or config['inherit'] == True:
-            if config['inherit'] == True:
-                kwa = {kw:'i'}
-            else:
-                kwa = {kw:config[kw]}
-            c   = _check_and_set_mktcolor(candle,**kwa)
-            marketcolors.update([(kw,c)])
-
-    if config['hollow'] is not None:
-        marketcolors.update({'hollow':config['hollow']})
-
-    if config['alpha'] is not None:
-        marketcolors.update({'alpha':config['alpha']})
-
-    if config['vcdopcod'] is not None:
-        marketcolors.update({'vcdopcod':config['vcdopcod']})
-
-    return marketcolors
-
-def write_style_file(style,filename):
-    pp   = pprint.PrettyPrinter(indent=4,sort_dicts=False,compact=True)
-    strl = pp.pformat(style).splitlines()
-
-    if not isinstance(style,dict):
-        raise TypeError('Specified style must be in `dict` format')
-
-    if path.exists(filename):
-        print('"'+filename+'" exists.') 
-        answer = input(' Overwrite(Y/N)? ')
-        a = answer.lower()
-        if a != 'y' and a != 'yes':
-            raise FileExistsError
-
-    f = open(filename,'w')
-    f.write('style = '+strl[0].replace('{','dict(',1).replace("'","",2).replace(':',' =',1)+'\n')
-    for line in strl[1:-1]:
-        if "'" in line[0:5]:
-            f.write('            '+line.replace("'","",2).replace(':',' =',1)+'\n')
-        else:
-            f.write('            '+line+'\n')
-    line = strl[-1]
-    if "'" in line[0:5]:
-        line = line.replace("'","",2).replace(':',' =',1)[::-1]
-    else:
-        line = line[::-1]
-    f.write('            '+line.replace('}',')',1)[::-1]+'\n')
-    f.close()
-    print('Wrote style file "'+filename+'"')
-    return
diff --git a/build/lib/mplfinance/_utils.py b/build/lib/mplfinance/_utils.py
deleted file mode 100644
index a4f80dfc..00000000
--- a/build/lib/mplfinance/_utils.py
+++ /dev/null
@@ -1,1515 +0,0 @@
-"""
-A collection of utilities for analyzing and plotting financial data.
-"""
-
-import numpy  as np
-import pandas as pd
-import matplotlib.dates as mdates
-import datetime
-
-from itertools import cycle
-
-from matplotlib import colors as mcolors, pyplot as plt
-from matplotlib.patches     import Ellipse
-from matplotlib.collections import LineCollection, PolyCollection, PatchCollection
-
-from mplfinance._arg_validators import _process_kwargs, _validate_vkwargs_dict
-from mplfinance._arg_validators import _alines_validator, _bypass_kwarg_validation
-from mplfinance._arg_validators import _xlim_validator, _is_datelike
-from mplfinance._styles         import _get_mpfstyle
-from mplfinance._helpers        import _mpf_to_rgba
-
-from six.moves import zip
-
-def _check_input(opens, closes, highs, lows):
-    """Checks that *opens*, *highs*, *lows* and *closes* have the same length.
-    NOTE: this code assumes if any value open, high, low, close is
-    missing (*-1*) they all are missing
-
-    Parameters
-    ----------
-    opens : sequence
-        sequence of opening values
-    highs : sequence
-        sequence of high values
-    lows : sequence
-        sequence of low values
-    closes : sequence
-        sequence of closing values
-
-    Raises
-    ------
-    ValueError
-        if the input sequences don't have the same length
-        if the input sequences don't have NaN is same locations
-    """
-    same_length = len(opens) == len(highs) == len(lows) == len(closes)
-    if not same_length:
-        raise ValueError('O,H,L,C must have the same length!')
-
-    o = np.where(np.isnan(opens))[0]
-    h = np.where(np.isnan(highs))[0]
-    l = np.where(np.isnan(lows))[0]
-    c = np.where(np.isnan(closes))[0]
-
-    # First check that they have the same number of NaN:
-    same_numnans = len(o) == len(h) == len(l) == len(c)
-    if not same_numnans:
-        raise ValueError('O,H,L,C must have the same amount of missing data!')
-
-    same_missing = ((o == h).all() and
-                    (o == l).all() and
-                    (o == c).all()
-                   )
-    if not same_missing:
-        raise ValueError('O,H,L,C must have the same missing data!')
-
-
-def _check_and_convert_xlim_configuration(data, config):
-    '''
-    Check, if user entered `xlim` kwarg, if user entered dates
-    then we may need to convert them to iloc or matplotlib dates.
-    '''
-    if config['xlim'] is None:
-        return None
-
-    xlim = config['xlim']
-
-    if not _xlim_validator(xlim):
-        raise ValueError('Bad xlim configuration #1')
-
-    if all([_is_datelike(dt) for dt in xlim]):
-        if config['show_nontrading']:
-            xlim = [ _date_to_mdate(dt) for dt in xlim]
-        else:
-            xlim = [ _date_to_iloc_extrapolate(data.index.to_series(),dt) for dt in xlim]
-
-    return xlim
-
-
-def _construct_mpf_collections(ptype,dates,xdates,opens,highs,lows,closes,volumes,config,style):
-    collections = None
-    if ptype == 'candle' or ptype == 'candlestick':
-        collections = _construct_candlestick_collections(xdates, opens, highs, lows, closes,
-                                                         marketcolors=style['marketcolors'],config=config )
-
-    elif ptype =='hollow_and_filled':
-            collections = _construct_hollow_candlestick_collections(xdates, opens, highs, lows, closes,
-                                                         marketcolors=style['marketcolors'],config=config )
-
-    elif ptype == 'ohlc' or ptype == 'bars' or ptype == 'ohlc_bars':
-        collections = _construct_ohlc_collections(xdates, opens, highs, lows, closes,
-                                                  marketcolors=style['marketcolors'],config=config )
-    elif ptype == 'renko':
-        collections = _construct_renko_collections(
-            dates, highs, lows, volumes, config['renko_params'], closes, marketcolors=style['marketcolors'])
-
-    elif ptype == 'pnf':
-        collections = _construct_pointnfig_collections(
-            dates, highs, lows, volumes, config['pnf_params'], closes, marketcolors=style['marketcolors'])
-    else:
-        raise TypeError('Unknown ptype="',str(ptype),'"')
-
-    return collections
-
-
-def _calculate_atr(atr_length, highs, lows, closes):
-    """Calculate the average true range
-    atr_length : time period to calculate over
-    all_highs : list of highs
-    all_lows : list of lows
-    all_closes : list of closes
-    """
-    if atr_length < 1:
-        raise ValueError("Specified atr_length may not be less than 1")
-    elif atr_length >= len(closes):
-        raise ValueError("Specified atr_length is larger than the length of the dataset: " + str(len(closes)))
-    atr = 0
-    for i in range(len(highs)-atr_length, len(highs)):
-        high = highs[i]
-        low = lows[i]
-        close_prev = closes[i-1]
-        tr = max(abs(high-low), abs(high-close_prev), abs(low-close_prev))
-        atr += tr
-    return atr/atr_length
-
-def combine_adjacent(arr):
-    """Sum like signed adjacent elements
-    arr : starting array
-
-    Returns
-    -------
-    output: new summed array
-    indexes: indexes indicating the first
-             element summed for each group in arr
-    """
-    output, indexes = [], []
-    curr_i = 0
-    while len(arr) > 0:
-        curr_sign = arr[0]/abs(arr[0])
-        index = 0
-        while index < len(arr) and arr[index]/abs(arr[index]) == curr_sign:
-            index += 1
-        output.append(sum(arr[:index]))
-        indexes.append(curr_i)
-        curr_i += index
-
-        for _ in range(index):
-            arr.pop(0)
-    return output, indexes
-
-def coalesce_volume_dates(in_volumes, in_dates, indexes):
-    """Sums volumes between the indexes and ouputs
-    dates at the indexes
-    in_volumes : original volume list
-    in_dates : original dates list
-    indexes : list of indexes
-
-    Returns
-    -------
-    volumes: new volume array
-    dates: new dates array
-    """
-    volumes, dates = [], []
-    for i in range(len(indexes)):
-        dates.append(in_dates[indexes[i]])
-        to_sum_to = indexes[i+1] if i+1 < len(indexes) else len(in_volumes)
-        volumes.append(sum(in_volumes[indexes[i]:to_sum_to]))
-    return volumes, dates
-
-
-def _updown_colors(upcolor,downcolor,opens,closes,use_prev_close=False):
-    # -----------------------------------------------------
-    # Note that `nan` values result in `opn < cls` == False
-    # In other words, nans don't get plotted by collections
-    # but this function will choose DOWN COLOR for nans.
-    # -----------------------------------------------------
-    if upcolor == downcolor:
-        return [upcolor]*len(opens)
-    cmap = {True : upcolor, False : downcolor}
-    if not use_prev_close:
-        return [ cmap[opn < cls] for opn,cls in zip(opens,closes) ]
-    else:
-        first = cmap[opens[0] < closes[0]]
-        _list = [ cmap[pre < cls] for cls,pre in zip(closes[1:], closes) ]
-        return [first] + _list
-
-def _make_updown_color_list(key,marketcolors,opens,closes,overrides=None):
-    length = len(opens)
-    ups    = [marketcolors[key][ 'up' ]]*length
-    downs  = [marketcolors[key]['down']]*length
-    if overrides is not None:
-        for ix,mco in enumerate(overrides):
-            if mco is None: continue
-            if mcolors.is_color_like(mco):
-                ups[ix]   = mco
-                downs[ix] = mco
-            else: # assume it is correctly a marketcolors object (dict)
-                ups[ix]   = mco[key][ 'up' ]
-                downs[ix] = mco[key]['down']
-    return [ups[ix] if opens[ix] < closes[ix] else downs[ix] for ix in range(length)]
-
-
-def _updownhollow_colors(upcolor,downcolor,hollowcolor,opens,closes):
-    if upcolor == downcolor:
-        return upcolor
-    umap = {True : hollowcolor, False : upcolor  }
-    dmap = {True : hollowcolor, False : downcolor}
-    first = umap[closes[0] > opens[0]]
-    _list = [ umap[cls > opn] if cls > cls0 else dmap[cls > opn] for cls0,opn,cls in zip(closes[0:-1],opens[1:],closes[1:]) ]
-    return [first] + _list
-
-
-def _date_to_iloc(dtseries,date):
-    '''Convert a `date` to a location, given a date series w/a datetime index.
-       If `date` does not exactly match a date in the series then interpolate between two dates.
-       If `date` is outside the range of dates in the series, then raise an exception
-      .
-    '''
-    d1s = dtseries.loc[date:]
-    if len(d1s) < 1:
-        sdtrange = str(dtseries[0])+' to '+str(dtseries[-1])
-        raise ValueError('User specified line date "'+str(date)+'" is beyond (greater than) range of plotted data ('+sdtrange+').')
-    d1 = d1s.index[0]
-    d2s = dtseries.loc[:date]
-    if len(d2s) < 1:
-        sdtrange = str(dtseries[0])+' to '+str(dtseries[-1])
-        raise ValueError('User specified line date "'+str(date)+'" is before (less than) range of plotted data ('+sdtrange+').')
-    d2 = dtseries.loc[:date].index[-1]
-    # If there are duplicate dates in the series, for example in a renko plot
-    # then .get_loc(date) will return a slice containing all the dups, so:
-    loc1 = dtseries.index.get_loc(d1)
-    if isinstance(loc1,slice): loc1 = loc1.start
-    loc2 = dtseries.index.get_loc(d2)
-    if isinstance(loc2,slice): loc2 = loc2.stop - 1
-    return (loc1+loc2)/2.0
-
-def _date_to_iloc_linear(dtseries,date,trace=False):
-    '''Find the location of a date using linear extrapolation.
-       Use the endpoints of `dtseries` to calculate the slope
-       and yintercept for the line:
-           iloc = (slope)*(dtseries) + (yintercept)
-       Then use them to calculate the location of `date`
-    '''
-    d1 = _date_to_mdate(dtseries.index[0])
-    d2 = _date_to_mdate(dtseries.index[-1])
-
-    if trace: print('d1,d2=',d1,d2)
-    i1 = 0.0
-    i2 = len(dtseries) - 1.0
-    if trace: print('i1,i2=',i1,i2)
-
-    slope   = (i2 - i1) / (d2 - d1)
-    yitrcpt1 = i1 - (slope*d1)
-    if trace: print('slope,yitrcpt=',slope,yitrcpt1)
-    yitrcpt2 = i2 - (slope*d2)
-    if trace: print('slope,yitrcpt=',slope,yitrcpt2)
-    if yitrcpt1 != yitrcpt2:
-        print('WARNING: yintercepts NOT equal!!!(',yitrcpt1,yitrcpt2,')')
-        yitrcpt = (yitrcpt1 + yitrcpt2) / 2.0
-    else:
-        yitrcpt = yitrcpt1
-    return (slope * _date_to_mdate(date)) + yitrcpt
-
-def _date_to_iloc_5_7ths(dtseries,date,direction,trace=False):
-        first = _date_to_mdate(dtseries.index[0])
-        last  = _date_to_mdate(dtseries.index[-1])
-        avg_days_between_points = (last - first)/float(len(dtseries))
-        if avg_days_between_points < 0.33:  # intraday (not daily)
-            return None
-        if direction == 'forward':
-            delta       = _date_to_mdate(date) - _date_to_mdate(dtseries.index[-1])
-            loc_5_7ths  = len(dtseries) - 1 + (5/7.)*delta
-        elif direction == 'backward':
-            delta      = _date_to_mdate(dtseries.index[0]) - _date_to_mdate(date)
-            loc_5_7ths = - (5./7.)*delta
-        else:
-            raise ValueError('_date_to_iloc_5_7ths got BAD direction value='+str(direction))
-        return loc_5_7ths
-
-def _date_to_iloc_extrapolate(dtseries,date):
-    '''Convert a `date` to a location, given a date series w/a datetime index.
-       If `date` does not exactly match a date in the series then interpolate between two dates.
-       If `date` is outside the range of dates in the series, then extrapolate:
-       Extrapolation results in increased error as the distance of the extrapolation increases.
-       We have two methods to extrapolate:
-       (1) Determine a linear equation based on the data provided in `dtseries`,
-           and use that equation to calculate the location for the date.
-       (2) Multiply by 5/7 the number of days between the edge date of dtseries and the
-           date for which we are requesting a location.
-           THIS ASSUMES DAILY data AND a 5 DAY TRADING WEEK.
-       Empirical observation (scratch_pad/date_to_iloc_extrapolation.ipynb) shows that
-       the systematic error of these two methods tends to be in opposite directions:
-       taking the average of the two methods reduces systematic errorr: However,
-       since method (2) applies only to DAILY data, we take the average of the two
-       methods only for daily data.  For intraday data we use only method (1).
-    '''
-
-    d1s = dtseries.loc[date:]
-    if len(d1s) < 1:
-        # extrapolate forward:
-        loc_linear  = _date_to_iloc_linear(dtseries,date)
-        loc_5_7ths  = _date_to_iloc_5_7ths(dtseries,date,'forward')
-        if loc_5_7ths is not None:
-            return (loc_linear + loc_5_7ths)/2.0
-        else:
-            return loc_linear
-    d1 = d1s.index[0]
-    d2s = dtseries.loc[:date]
-    if len(d2s) < 1:
-        # extrapolate backward:
-        loc_linear = _date_to_iloc_linear(dtseries,date)
-        loc_5_7ths = _date_to_iloc_5_7ths(dtseries,date,'backward')
-        if loc_5_7ths is not None:
-            return (loc_linear + loc_5_7ths)/2.0
-        else:
-            return loc_linear
-    # Below here we *interpolate* (not extrapolate)
-    d2 = dtseries.loc[:date].index[-1]
-    # If there are duplicate dates in the series, for example in a renko plot
-    # then .get_loc(date) will return a slice containing all the dups, so:
-    loc1 = dtseries.index.get_loc(d1)
-    if isinstance(loc1,slice): loc1 = loc1.start
-    loc2 = dtseries.index.get_loc(d2)
-    if isinstance(loc2,slice): loc2 = loc2.stop - 1
-    return (loc1+loc2)/2.0
-
-
-def _date_to_mdate(date):
-    if isinstance(date,str):
-        pydt = pd.to_datetime(date).to_pydatetime()
-    elif isinstance(date,pd.Timestamp):
-        pydt = date.to_pydatetime()
-    elif isinstance(date,(datetime.datetime,datetime.date)):
-        pydt = date
-    else:
-        return None
-    return mdates.date2num(pydt)
-
-def _convert_segment_dates(segments,dtindex):
-    '''
-    Convert line segment dates to matplotlib dates
-    Inputted segment dates may be: pandas-parseable date-time string, pandas timestamp,
-                                   or a python datetime or date, or (if dtindex is not None) integer index
-    A "segment" is a "sequence of lines",
-        see: https://matplotlib.org/api/collections_api.html#matplotlib.collections.LineCollection
-    '''
-    #import pdb
-    #pdb.set_trace()
-    if dtindex is not None:
-        dtseries = dtindex.to_series()
-    converted = []
-    for line in segments:
-        new_line = []
-        for dt,value in line:
-            if dtindex is not None:
-                date = _date_to_iloc(dtseries,dt)
-            else:
-                date = _date_to_mdate(dt)
-            if date is None:
-                raise TypeError('NON-DATE in segment line='+str(line))
-            new_line.append((date,value))
-        converted.append(new_line)
-    return converted
-
-def _valid_renko_kwargs():
-    '''
-    Construct and return the "valid renko kwargs table" for the mplfinance.plot(type='renko')
-    function. A valid kwargs table is a `dict` of `dict`s. The keys of the outer dict are
-    the valid key-words for the function.  The value for each key is a dict containing 3
-    specific keys: "Default", "Description" and "Validator" with the following values:
-        "Default"      - The default value for the kwarg if none is specified.
-        "Description"  - The description for the kwarg.
-        "Validator"    - A function that takes the caller specified value for the kwarg,
-                         and validates that it is the correct type, and (for kwargs with
-                         a limited set of allowed values) may also validate that the
-                         kwarg value is one of the allowed values.
-    '''
-    vkwargs = {
-        'brick_size'  : { 'Default'     : 'atr',
-                          'Description' : 'size of each brick on y-axis (typically price).'+
-                                          ' specify a number, or specify "atr" for average true range.',
-                          'Validator'   : lambda value: isinstance(value,(float,int))
-                                                        or value == 'atr' },
-        'atr_length'  : { 'Default'     : 14,
-                          'Description' : 'number of periods for atr calculation (if brick size is "atr")',
-                          'Validator'   : lambda value: isinstance(value,int)
-                                                        or value == 'total' },
-    }
-
-    _validate_vkwargs_dict(vkwargs)
-
-    return vkwargs
-
-
-def _valid_pnf_kwargs():
-    '''
-    Construct and return the "valid pnf kwargs table" for the mplfinance.plot(type='pnf')
-    function. A valid kwargs table is a `dict` of `dict`s. The keys of the outer dict are
-    the valid key-words for the function.  The value for each key is a dict containing 3
-    specific keys: "Default", "Description" and "Validator" with the following values:
-        "Default"      - The default value for the kwarg if none is specified.
-        "Description"  - The description for the kwarg.
-        "Validator"    - A function that takes the caller specified value for the kwarg,
-                         and validates that it is the correct type, and (for kwargs with
-                         a limited set of allowed values) may also validate that the
-                         kwarg value is one of the allowed values.
-    '''
-    vkwargs = {
-        'box_size'    : { 'Default'     : 'atr',
-                          'Description' : 'size of each box on y-axis (typically price).'+
-                                          ' specify a number, or specify "atr" for average true range.',
-                          'Validator'   : lambda value: isinstance(value,(float,int))
-                                                        or value == 'atr' },
-        'atr_length'  : { 'Default'     : 14,
-                          'Description' : 'number of periods for atr calculation (if box size is "atr")',
-                          'Validator'   : lambda value: isinstance(value,int)
-                                                        or value == 'total' },
-
-        'reversal'    : { 'Default'     : 1,
-                          'Description' : 'number of boxes, in opposite direction, needed to reverse'+
-                                          ' a trend (i.e. to start a new column).',
-                          'Validator'   : lambda value: isinstance(value,int) },
-    }
-
-    _validate_vkwargs_dict(vkwargs)
-
-    return vkwargs
-
-
-def _valid_lines_kwargs():
-    '''
-    Construct and return the "valid lines (hlines,vlines,alines,tlines) kwargs table"
-    for the mplfinance.plot() `[h|v|a|t]lines=` kwarg functions.
-    A valid kwargs table is a `dict` of `dict`s. The keys of the outer dict are
-    the valid key-words for the function.  The value for each key is a dict containing 3
-    specific keys: "Default", "Description" and "Validator" with the following values:
-        "Default"      - The default value for the kwarg if none is specified.
-        "Description"  - The description for the kwarg.
-        "Validator"    - A function that takes the caller specified value for the kwarg,
-                         and validates that it is the correct type, and (for kwargs with
-                         a limited set of allowed values) may also validate that the
-                         kwarg value is one of the allowed values.
-    '''
-    valid_linestyles = ['-','solid','--','dashed','-.','dashdot',':','dotted',None,' ','']
-    vkwargs = {
-        'hlines'    : { 'Default'     : None,
-                        'Description' : 'Draw one or more HORIZONTAL LINES across entire plot, by'+
-                                        ' specifying a price, or sequence of prices.  May also be a dict'+
-                                        ' with key `hlines` specifying a price or sequence of prices, plus'+
-                                        ' one or more of the following keys: `colors`, `linestyle`,'+
-                                        ' `linewidths`, `alpha`.',
-                        'Validator'   : _bypass_kwarg_validation },
-
-        'vlines'    : { 'Default'     : None,
-                        'Description' : 'Draw one or more VERTICAL LINES across entire plot, by'+
-                                        ' specifying a date[time], or sequence of date[time].  May also'+
-                                        ' be a dict with key `vlines` specifying a date[time] or sequence'+
-                                        ' of date[time], plus one or more of the following keys:'+
-                                        ' `colors`, `linestyle`, `linewidths`, `alpha`.',
-                        'Validator'   : _bypass_kwarg_validation },
-
-        'alines'    : { 'Default'     : None,
-                        'Description' : 'Draw one or more ARBITRARY LINES anywhere on the plot, by'+
-                                        ' specifying a sequence of two or more date/price pairs, or by'+
-                                        ' specifying a sequence of sequences of two or more date/price pairs.'+
-                                        ' May also be a dict with key `alines` (as date/price pairs described above),'+
-                                        ' plus one or more of the following keys:'+
-                                        ' `colors`, `linestyle`, `linewidths`, `alpha`.',
-                        'Validator'   : _bypass_kwarg_validation },
-
-        'tlines'    : { 'Default'     : None,
-                        'Description' : 'Draw one or more TREND LINES by specifying one or more pairs of date[times]'+
-                                        ' between which each trend line should be drawn.  May also be a dict with key'+
-                                        ' `tlines` as just described, plus one or more of the following keys:'+
-                                        ' `colors`, `linestyle`, `linewidths`, `alpha`, `tline_use`,`tline_method`.',
-                        'Validator'   : _bypass_kwarg_validation },
-
-        'colors'    : { 'Default'     : None,
-                        'Description' : 'Color of [hvat]lines (or sequence of colors, if each line to be a different color)',
-                        'Validator'   : lambda value: value is None
-                                                      or mcolors.is_color_like(value)
-                                                      or (isinstance(value,(list,tuple))
-                                                          and all([mcolors.is_color_like(v) for v in value]) ) },
-
-        'linestyle' : { 'Default'     : '-',
-                        'Description' : 'line style of [hvat]lines (or sequence of line styles, if each line to have a different linestyle)',
-                        'Validator'   : lambda value: value is None or value in valid_linestyles or
-                                            all([v in valid_linestyles for v in value]) },
-
-        'linewidths': { 'Default'     : None,
-                        'Description' : 'line width of [hvat]lines (or sequence of line widths, if each line to have a different width)',
-                        'Validator'   : lambda value: value is None
-                                                      or isinstance(value,(float,int))
-                                                      or all([isinstance(v,(float,int)) for v in value]) },
-
-        'alpha': {'Default': 1.0,
-                  'Description': 'Opacity of [hvat]lines (or sequence of opacities,'
-                                 + 'if each line is to have a different opacity)'
-                                 + 'float from 0.0 to 1.0 ' + ' (1.0 means fully opaque; 0.0 means transparent.',
-                  'Validator': lambda value: isinstance(value, (float, int))
-                                             or all([isinstance(v, (float, int)) for v in value])},
-
-
-        'tline_use' : { 'Default'     : 'close',
-                        'Description' : 'value to use for TREND LINE ("open","high","low","close") or sequence of'+
-                                        ' any combination of "open", "high", "low", "close" to use a average of the'+
-                                        ' specified values to determine the trend line.',
-                        'Validator'   : lambda value: isinstance(value,str)
-                                                      or (isinstance(value,(list,tuple))
-                                                          and all([isinstance(v,str) for v in value]) ) },
-
-        'tline_method': { 'Default'     : 'point-to-point',
-                          'Description' : 'method for TREND LINE determination: "point-to-point" or "least-squares"',
-                          'Validator'   : lambda value: value in ['point-to-point','least-squares'] }
-    }
-
-    _validate_vkwargs_dict(vkwargs)
-
-    return vkwargs
-
-
-def _construct_ohlc_collections(dates, opens, highs, lows, closes, marketcolors=None, config=None):
-    """Represent the time, open, high, low, close as a vertical line
-    ranging from low to high.  The left tick is the open and the right
-    tick is the close.
-    *opens*, *highs*, *lows* and *closes* must have the same length.
-    NOTE: this code assumes if any value open, high, low, close is
-    missing (*-1*) they all are missing
-
-    Parameters
-    ----------
-    opens : sequence
-        sequence of opening values
-    highs : sequence
-        sequence of high values
-    lows : sequence
-        sequence of low values
-    closes : sequence
-        sequence of closing values
-    marketcolors : dict of colors: 'up', 'down'
-
-    Returns
-    -------
-    ret : list
-        a list or tuple of matplotlib collections to be added to the axes
-    """
-
-    _check_input(opens, highs, lows, closes)
-
-    if marketcolors is None:
-        mktcolors = _get_mpfstyle('classic')['marketcolors']['ohlc']
-    else:
-        mktcolors = marketcolors['ohlc']
-
-    rangeSegments = [((dt, low), (dt, high)) for dt, low, high in zip(dates, lows, highs)]
-
-    datalen = len(dates)
-
-    avg_dist_between_points = (dates[-1] - dates[0]) / float(datalen)
-
-    ticksize = config['_width_config']['ohlc_ticksize']
-
-    # the ticks will be from ticksize to 0 in points at the origin and
-    # we'll translate these to the date, open location
-    openSegments = [((dt-ticksize, op), (dt, op)) for dt, op in zip(dates, opens)]
-
-    # the ticks will be from 0 to ticksize in points at the origin and
-    # we'll translate these to the date, close location
-    closeSegments = [((dt, close), (dt+ticksize, close)) for dt, close in zip(dates, closes)]
-
-    if mktcolors['up'] == mktcolors['down'] and config['marketcolor_overrides'] is None:
-        colors = mktcolors['up']
-    else:
-        overrides = config['marketcolor_overrides']
-        colors    = _make_updown_color_list('ohlc',marketcolors,opens,closes,overrides)
-
-    lw = config['_width_config']['ohlc_linewidth']
-
-    rangeCollection = LineCollection(rangeSegments,
-                                     colors=colors,
-                                     linewidths=lw,
-                                     )
-
-    openCollection = LineCollection(openSegments,
-                                    colors=colors,
-                                    linewidths=lw,
-                                    )
-
-    closeCollection = LineCollection(closeSegments,
-                                     colors=colors,
-                                     linewidths=lw
-                                     )
-
-    return [rangeCollection, openCollection, closeCollection]
-
-
-def _construct_candlestick_collections(dates, opens, highs, lows, closes, marketcolors=None, config=None):
-    """Represent the open, close as a bar line and high low range as a
-    vertical line.
-
-    NOTE: this code assumes if any value open, low, high, close is
-    missing they all are missing
-
-
-    Parameters
-    ----------
-    opens : sequence
-        sequence of opening values
-    highs : sequence
-        sequence of high values
-    lows : sequence
-        sequence of low values
-    closes : sequence
-        sequence of closing values
-    marketcolors : dict of colors: up, down, edge, wick, alpha
-    alpha : float
-        bar transparency
-
-    Returns
-    -------
-    ret : list
-        (lineCollection, barCollection)
-    """
-
-    _check_input(opens, highs, lows, closes)
-
-    if marketcolors is None:
-        marketcolors = _get_mpfstyle('classic')['marketcolors']
-
-    datalen = len(dates)
-
-    avg_dist_between_points = (dates[-1] - dates[0]) / float(datalen)
-
-    delta = config['_width_config']['candle_width'] / 2.0
-
-    barVerts = [((date - delta, open),
-                 (date - delta, close),
-                 (date + delta, close),
-                 (date + delta, open))
-                for date, open, close in zip(dates, opens, closes)]
-
-    rangeSegLow   = [((date, low), (date, min(open,close)))
-                     for date, low, open, close in zip(dates, lows, opens, closes)]
-
-    rangeSegHigh  = [((date, high), (date, max(open,close)))
-                     for date, high, open, close in zip(dates, highs, opens, closes)]
-
-    rangeSegments = rangeSegLow + rangeSegHigh
-
-    alpha  = marketcolors['alpha']
-
-    overrides = config['marketcolor_overrides']
-    faceonly  = config['mco_faceonly']
-
-    colors    = _make_updown_color_list('candle',marketcolors,opens,closes,overrides)
-    colors    = [ _mpf_to_rgba(c,alpha) for c in colors ] # include alpha
-    if faceonly: overrides = None
-    edgecolor = _make_updown_color_list('edge',marketcolors,opens,closes,overrides)
-    wickcolor = _make_updown_color_list('wick',marketcolors,opens,closes,overrides)
-
-    lw = config['_width_config']['candle_linewidth']
-
-    rangeCollection = LineCollection(rangeSegments,
-                                     colors=wickcolor,
-                                     linewidths=lw,
-                                     )
-
-    barCollection = PolyCollection(barVerts,
-                                   facecolors=colors,
-                                   edgecolors=edgecolor,
-                                   linewidths=lw
-                                   )
-
-    return [rangeCollection, barCollection]
-
-
-def _construct_hollow_candlestick_collections(dates, opens, highs, lows, closes, marketcolors=None, config=None):
-    """Represent today's open to close as a "bar" line (candle body)
-    and high low range as a vertical line (candle wick)
-
-    If config['type']=='hollow_and_filled' (hollow and filled candles) then candle edge and
-    wick color depend on PREVIOUS close to today's close (up or down), and the center of the
-    candle body (hollow or filled) depends on the today's open to close (up or down).
-
-    NOTE: this code assumes if any value open, low, high, close is
-    missing they all are missing
-
-    Parameters
-    ----------
-    opens : sequence
-        sequence of opening values
-    highs : sequence
-        sequence of high values
-    lows : sequence
-        sequence of low values
-    closes : sequence
-        sequence of closing values
-    marketcolors : dict of colors: up, down, edge, wick, alpha
-    alpha : float
-        bar (candle body) transparency
-
-    Returns
-    -------
-    ret : list
-        (lineCollection, barCollection)
-    """
-
-    _check_input(opens, highs, lows, closes)
-
-    if marketcolors is None:
-        marketcolors = _get_mpfstyle('classic')['marketcolors']
-
-    datalen = len(dates)
-
-    avg_dist_between_points = (dates[-1] - dates[0]) / float(datalen)
-
-    delta = config['_width_config']['candle_width'] / 2.0
-
-    barVerts = [((date - delta, open),
-                 (date - delta, close),
-                 (date + delta, close),
-                 (date + delta, open))
-                for date, open, close in zip(dates, opens, closes)]
-
-    rangeSegLow   = [((date, low), (date, min(open,close)))
-                     for date, low, open, close in zip(dates, lows, opens, closes)]
-
-    rangeSegHigh  = [((date, high), (date, max(open,close)))
-                     for date, high, open, close in zip(dates, highs, opens, closes)]
-
-    rangeSegments = rangeSegLow + rangeSegHigh
-
-    alpha  = marketcolors['alpha']
-
-    uc     = mcolors.to_rgba(marketcolors['candle'][ 'up' ], alpha)
-    dc     = mcolors.to_rgba(marketcolors['candle']['down'], alpha)
-
-    hc = mcolors.to_rgba(marketcolors['hollow']) if 'hollow' in marketcolors else (0,0,0,0)
-
-    colors = _updownhollow_colors(uc, dc, hc, opens, closes)  # for candle body.
-
-    edgecolor = _updown_colors(uc, dc, opens, closes, use_prev_close=True)
-
-    wickcolor = _updown_colors(uc, dc, opens, closes, use_prev_close=True)
-
-    # For hollow candles, we scale the candle linewidth up a little:
-    lw = 1.25 * config['_width_config']['candle_linewidth']
-
-    rangeCollection = LineCollection(rangeSegments,
-                                     colors=wickcolor,
-                                     linewidths=lw,
-                                     )
-
-    barCollection = PolyCollection(barVerts,
-                                   facecolors=colors,
-                                   edgecolors=edgecolor,
-                                   linewidths=lw
-                                   )
-
-    return [rangeCollection, barCollection]
-
-
-def _construct_renko_collections(dates, highs, lows, volumes, config_renko_params, closes, marketcolors=None):
-    """Represent the price change with bricks
-
-    NOTE: this code assumes if any value open, low, high, close is
-    missing they all are missing
-
-    Algorithm Explanation
-    ---------------------
-    In the first part of the algorithm, we populate the cdiff array
-    along with adjusting the dates and volumes arrays into the new_dates and
-    new_volumes arrays. A single date includes a range from no bricks to many
-    bricks, if a date has no bricks it shall not be included in new_dates,
-    and if it has n bricks then it will be included n times. Volumes use a
-    volume cache to save volume amounts for dates that do not have any bricks
-    before adding the cache to the next date that has at least one brick.
-    We populate the cdiff array with each close values difference from the
-    previously created brick divided by the brick size.
-
-    In the second part of the algorithm, we iterate through the values in cdiff
-    and add 1s or -1s to the bricks array depending on whether the value is
-    positive or negative. Every time there is a trend change (ex. previous brick is
-    an upbrick, current brick is a down brick) we draw one less brick to account
-    for the price having to move the previous bricks amount before creating a
-    brick in the opposite direction.
-
-    In the final part of the algorithm, we enumerate through the bricks array and
-    assign up-colors or down-colors to the associated index in the color array and
-    populate the verts list with each bricks vertice to be used to create the matplotlib
-    PolyCollection.
-
-    Useful sources:
-    https://avilpage.com/2018/01/how-to-plot-renko-charts-with-python.html
-    https://school.stockcharts.com/doku.php?id=chart_analysis:renko
-
-    Parameters
-    ----------
-    dates : sequence
-        sequence of dates
-    highs : sequence
-        sequence of high values
-    lows : sequence
-        sequence of low values
-    config_renko_params : kwargs table (dictionary)
-        brick_size : size of each brick
-        atr_length : length of time used for calculating atr
-    closes : sequence
-        sequence of closing values
-    marketcolors : dict of colors: up, down, edge, wick, alpha
-
-    Returns
-    -------
-    ret : list
-        rectCollection
-    """
-    renko_params = _process_kwargs(config_renko_params, _valid_renko_kwargs())
-    if marketcolors is None:
-        marketcolors = _get_mpfstyle('classic')['marketcolors']
-
-    brick_size = renko_params['brick_size']
-    atr_length = renko_params['atr_length']
-
-
-    if brick_size == 'atr':
-        if atr_length == 'total':
-            brick_size = _calculate_atr(len(closes)-1, highs, lows, closes)
-        else:
-            brick_size = _calculate_atr(atr_length, highs, lows, closes)
-    else: # is an integer or float
-        upper_limit = (max(closes) - min(closes)) / 2
-        lower_limit = 0.01 * _calculate_atr(len(closes)-1, highs, lows, closes)
-        if brick_size > upper_limit:
-            raise ValueError("Specified brick_size may not be larger than (50% of the close price range of the dataset) which has value: "+ str(upper_limit))
-        elif brick_size < lower_limit:
-            raise ValueError("Specified brick_size may not be smaller than (0.01* the Average True Value of the dataset) which has value: "+ str(lower_limit))
-
-    alpha  = marketcolors['alpha']
-
-    uc     = mcolors.to_rgba(marketcolors['candle'][ 'up' ], alpha)
-    dc     = mcolors.to_rgba(marketcolors['candle']['down'], alpha)
-    euc    = mcolors.to_rgba(marketcolors['edge'][ 'up' ], 1.0)
-    edc    = mcolors.to_rgba(marketcolors['edge']['down'], 1.0)
-
-    cdiff = [] # holds the differences between each close and the previously created brick / the brick size
-    prev_close_brick = closes[0]
-    volume_cache = 0 # holds the volumes for the dates that were skipped
-    new_dates = [] # holds the dates corresponding with the index
-    new_volumes = [] # holds the volumes corresponding with the index.  If more than one index for the same day then they all have the same volume.
-
-    for i in range(len(closes)-1):
-        brick_diff = int((closes[i+1] - prev_close_brick) / brick_size)
-        if brick_diff == 0:
-            if volumes is not None:
-                volume_cache += volumes[i]
-            continue
-
-        cdiff.extend([int(brick_diff/abs(brick_diff))] * abs(brick_diff))
-        if volumes is not None:
-            new_volumes.extend([volumes[i] + volume_cache] * abs(brick_diff))
-            volume_cache = 0
-        new_dates.extend([dates[i]] * abs(brick_diff))
-        prev_close_brick += brick_diff *brick_size
-
-    bricks = [] # holds bricks, -1 for down bricks, 1 for up bricks
-    curr_price = closes[0]
-
-    last_diff_sign = 0 # direction the bricks were last going in -1 -> down, 1 -> up
-    dates_volumes_index = 0 # keeps track of the index of the current date/volume
-    for diff in cdiff:
-
-        curr_diff_sign = diff/abs(diff)
-        if last_diff_sign != 0 and curr_diff_sign != last_diff_sign:
-            last_diff_sign = curr_diff_sign
-            new_dates.pop(dates_volumes_index)
-            if volumes is not None:
-                if dates_volumes_index == len(new_volumes)-1:
-                    new_volumes[dates_volumes_index-1] += new_volumes[dates_volumes_index]
-                else:
-                    new_volumes[dates_volumes_index+1] += new_volumes[dates_volumes_index]
-                new_volumes.pop(dates_volumes_index)
-            continue
-        last_diff_sign = curr_diff_sign
-
-        if diff > 0:
-            bricks.extend([1]*abs(diff))
-        else:
-            bricks.extend([-1]*abs(diff))
-        dates_volumes_index += 1
-
-
-    verts = [] # holds the brick vertices
-    colors = [] # holds the facecolors for each brick
-    edge_colors = [] # holds the edgecolors for each brick
-    brick_values = [] # holds the brick values for each brick
-    for index, number in enumerate(bricks):
-        if number == 1: # up brick
-            colors.append(uc)
-            edge_colors.append(euc)
-        else: # down brick
-            colors.append(dc)
-            edge_colors.append(edc)
-
-        curr_price += (brick_size * number)
-        brick_values.append(curr_price)
-
-        x, y = index, curr_price
-
-        verts.append((
-            (x, y),
-            (x, y+brick_size),
-            (x+1, y+brick_size),
-            (x+1, y)))
-
-    useAA = 0,    # use tuple here
-    lw = None
-    rectCollection = PolyCollection(verts,
-                                    facecolors=colors,
-                                    antialiaseds=useAA,
-                                    edgecolors=edge_colors,
-                                    linewidths=lw
-                                    )
-    calculated_values = dict(dates=new_dates,volumes=new_volumes,
-                             values=brick_values,size=brick_size)
-    return [rectCollection,], calculated_values
-
-
-def _construct_pointnfig_collections(dates, highs, lows, volumes, config_pointnfig_params, closes, marketcolors=None):
-    """Represent the price change with Xs and Os
-
-    NOTE: this code assumes if any value open, low, high, close is
-    missing they all are missing
-
-    Algorithm Explanation
-    ---------------------
-    In the first part of the algorithm, we populate the boxes array
-    along with adjusting the dates and volumes arrays into the new_dates and
-    new_volumes arrays. A single date includes a range from no boxes to many
-    boxes, if a date has no boxes it shall not be included in new_dates,
-    and if it has n boxes then it will be included n times. Volumes use a
-    volume cache to save volume amounts for dates that do not have any boxes
-    before adding the cache to the next date that has at least one box.
-    We populate the boxes array with each close values difference from the
-    previously created brick divided by the box size.
-
-    The second part of the algorithm has a series of step. First we combine the
-    adjacent like signed values in the boxes array (ex. [-1, -2, 3, -4] -> [-3, 3, -4]).
-    Next we subtract 1 from the absolute value of each element in boxes except the
-    first to ensure every time there is a trend change (ex. previous box is
-    an X, current brick is a O) we draw one less box to account for the price
-    having to move the previous box's amount before creating a box in the
-    opposite direction. During this same step we also combine like signed elements
-    and associated volume/date data ignoring any zero values that are created by
-    subtracting 1 from the box value. Next we recreate the box array utilizing a
-    rolling_change and volume_cache to store and sum the changes that don't break
-    the reversal threshold.
-
-    Lastly, we enumerate through the boxes to populate the line_seg and circle_patches
-    arrays. line_seg holds the / and \ line segments that make up an X and
-    circle_patches holds matplotlib.patches Ellipse objects for each O. We start
-    by filling an x and y array each iteration which contain the x and y
-    coordinates for each box in the column. Then for each coordinate pair in
-    x, y we add to either the line_seg array or the circle_patches array
-    depending on the value of sign for the current column (1 indicates
-    line_seg, -1 indicates circle_patches). The height of the boxes take
-    into account padding which separates each box by a small margin in
-    order to increase readability.
-
-    Useful sources:
-    https://stackoverflow.com/questions/8750648/point-and-figure-chart-with-matplotlib
-    https://www.investopedia.com/articles/technical/03/081303.asp
-
-    Parameters
-    ----------
-    dates : sequence
-        sequence of dates
-    highs : sequence
-        sequence of high values
-    lows : sequence
-        sequence of low values
-    config_pointnfig_params : kwargs table (dictionary)
-        box_size : size of each box
-        atr_length : length of time used for calculating atr
-    closes : sequence
-        sequence of closing values
-    marketcolors : dict of colors: up, down, edge, wick, alpha
-
-    Returns
-    -------
-    ret : tuple
-        rectCollection
-    """
-    pointnfig_params = _process_kwargs(config_pointnfig_params, _valid_pnf_kwargs())
-    if marketcolors is None:
-        marketcolors = _get_mpfstyle('classic')['marketcolors']
-
-    box_size = pointnfig_params['box_size']
-    atr_length = pointnfig_params['atr_length']
-    reversal = pointnfig_params['reversal']
-
-    if box_size == 'atr':
-        if atr_length == 'total':
-            box_size = _calculate_atr(len(closes)-1, highs, lows, closes)
-        else:
-            box_size = _calculate_atr(atr_length, highs, lows, closes)
-    else: # is an integer or float
-        upper_limit = (max(closes) - min(closes)) / 2
-        lower_limit = 0.01 * _calculate_atr(len(closes)-1, highs, lows, closes)
-        if box_size > upper_limit:
-            raise ValueError("Specified box_size may not be larger than (50% of the close price range of the dataset) which has value: "+ str(upper_limit))
-        elif box_size < lower_limit:
-            raise ValueError("Specified box_size may not be smaller than (0.01* the Average True Value of the dataset) which has value: "+ str(lower_limit))
-
-    if reversal < 1 or reversal > 9:
-        raise ValueError("Specified reversal must be an integer in the range [1,9]")
-
-    alpha  = marketcolors['alpha']
-
-    uc     = mcolors.to_rgba(marketcolors['ohlc'][ 'up' ], alpha)
-    dc     = mcolors.to_rgba(marketcolors['ohlc']['down'], alpha)
-    tfc    = mcolors.to_rgba(marketcolors['edge']['down'], 0) # transparent face color
-
-    boxes = [] # each element in an integer representing the number of boxes to be drawn on that indexes column (negative numbers -> Os, positive numbers -> Xs)
-    prev_close_box = closes[0] # represents the value of the last box in the previous column
-    volume_cache = 0 # holds the volumes for the dates that were skipped
-    temp_volumes, temp_dates = [], [] # holds the temp adjusted volumes and dates respectively
-
-    for i in range(len(closes)-1):
-        box_diff = int((closes[i+1] - prev_close_box) / box_size)
-        if box_diff == 0:
-            if volumes is not None:
-                volume_cache += volumes[i]
-            continue
-
-        boxes.append(box_diff)
-        if volumes is not None:
-            temp_volumes.append(volumes[i] + volume_cache)
-            volume_cache = 0
-        temp_dates.append(dates[i])
-        prev_close_box += box_diff *box_size
-
-    # combine adjacent similarly signed differences
-    boxes, indexes = combine_adjacent(boxes)
-    new_volumes, new_dates = coalesce_volume_dates(temp_volumes, temp_dates, indexes)
-
-    adjusted_boxes = [boxes[0]]
-    temp_volumes, temp_dates = [new_volumes[0]], [new_dates[0]]
-    volume_cache = 0
-
-    # Clean data to subtract 1 from all box # not including the first boxes element and combine like signed adjacent values (after ignoring zeros)
-    for i in range(1, len(boxes)):
-        adjusted_value = boxes[i]- int((boxes[i]/abs(boxes[i])))
-
-        # not equal to 0 and different signs
-        if adjusted_value != 0 and adjusted_boxes[-1]*adjusted_value < 0:
-
-            # Append adjusted_value, volumes, and date to associated lists
-            adjusted_boxes.append(adjusted_value)
-            temp_volumes.append(new_volumes[i] + volume_cache)
-            temp_dates.append(new_dates[i])
-
-            # reset volume_cache once we use it
-            volume_cache = 0
-
-        # not equal to 0 and same signs
-        elif adjusted_value != 0 and adjusted_boxes[-1]*adjusted_value > 0:
-
-            # Add adjusted_value and volume values to last added elements
-            adjusted_boxes[-1] += adjusted_value
-            temp_volumes[-1] += new_volumes[i] + volume_cache
-
-            # reset volume_cache once we use it
-            volume_cache = 0
-
-        else: # adjusted_value == 0
-            volume_cache += new_volumes[i]
-
-    boxes = [adjusted_boxes[0]]
-    new_volumes = [temp_volumes[0]]
-    new_dates = [temp_dates[0]]
-
-    rolling_change = 0
-    volume_cache = 0
-    biggest_difference = 0 # only used for the last column
-
-    #Clean data to account for reversal size (added to allow overriding the default reversal of 1)
-    for i in range(1, len(adjusted_boxes)):
-
-        # Add to rolling_change and volume_cache which stores the box and volume values
-        rolling_change += adjusted_boxes[i]
-        volume_cache += temp_volumes[i]
-
-        # if rolling_change is the same sign as the previous box and the abs value is bigger than the
-        # abs value of biggest_difference then we should replace biggest_difference with rolling_change
-        if rolling_change*boxes[-1] > 0 and abs(rolling_change) > abs(biggest_difference):
-            biggest_difference = rolling_change
-
-        # Add to new list if the rolling change is >= the reversal
-        if abs(rolling_change) >= reversal:
-
-            # if rolling_change is the same sign as the previous # of boxes then combine
-            if rolling_change*boxes[-1] > 0:
-                boxes[-1] += rolling_change
-                new_volumes[-1] += volume_cache
-
-            # otherwise add new box
-            else: # < 0 (== 0 can't happen since neither rolling_change or boxes[-1] can be 0)
-                boxes.append(rolling_change)
-                new_volumes.append(volume_cache)
-                new_dates.append(temp_dates[i])
-
-            # reset rolling_change and volume_cache once we've used them
-            rolling_change = 0
-            volume_cache = 0
-
-            # reset biggest_difference as we start from the beginning every time there is a reversal
-            biggest_difference = 0
-
-    # Adjust the last box column if the left over rolling_change is the same sign as the column
-    boxes[-1] += biggest_difference
-    new_volumes[-1] += volume_cache
-
-    curr_price = closes[0]
-    box_values = [] # y values for the boxes
-    circle_patches = [] # list of circle patches to be used to create the cirCollection
-    line_seg = [] # line segments that make up the Xs
-
-    for index, difference in enumerate(boxes):
-        diff = abs(difference)
-
-        sign = (difference / abs(difference)) # -1 or 1
-        start_iteration = 0 if sign > 0 else 1
-
-        x = [index] * (diff)
-        y = [curr_price + (i * box_size * sign) for i in range(start_iteration, diff+start_iteration)]
-
-        curr_price += (box_size * sign * (diff))
-        box_values.append( y )
-
-        for i in range(len(x)): # x and y have the same length
-            height = box_size * 0.85
-            width = 0.6
-            if height < 0.5:
-                width = height
-
-            padding = (box_size * 0.075)
-            if sign == 1: # X
-                line_seg.append([(x[i]-width/2, y[i] + padding), (x[i]+width/2, y[i]+height + padding)]) # create / part of the X
-                line_seg.append([(x[i]-width/2, y[i]+height+padding), (x[i]+width/2, y[i]+padding)]) # create \ part of the X
-            else: # O
-                circle_patches.append(Ellipse((x[i], y[i]-(height/2) - padding), width, height))
-
-    useAA = 0,    # use tuple here
-    lw = 0.5
-
-    cirCollection = PatchCollection(circle_patches)
-    cirCollection.set_facecolor([tfc] * len(circle_patches))
-    cirCollection.set_edgecolor([dc] * len(circle_patches))
-
-    xCollection = LineCollection(line_seg,
-                                 colors=[uc] * len(line_seg),
-                                 linewidths=lw,
-                                 antialiaseds=useAA
-                                 )
-    calculated_values = dict(dates=new_dates,counts=boxes,values=box_values,
-                             volumes=new_volumes,size=box_size)
-    return [cirCollection, xCollection], calculated_values
-
-
-def _construct_aline_collections(alines, dtix=None):
-    """construct arbitrary line collections
-
-    Parameters
-    ----------
-    alines : sequence
-        sequences of segments, which are sequences of lines,
-        which are sequences of two or more points ( date[time], price ) or (x,y)
-
-        date[time] may be (a) pandas.to_datetime parseable string,
-                          (b) pandas Timestamp, or
-                          (c) python datetime.datetime or datetime.date
-
-    alines may also be a dict, containing
-    the following keys:
-
-        'alines'     : the same as defined above: sequence of price, or dates, or segments
-        'colors'     : colors for the above alines
-        'linestyle'  : line types for the above alines
-        'linewidths' : line widths for the above alines
-
-    dtix:  date index for the x-axis, used for converting the dates when
-           x-values are 'evenly spaced integers' (as when skipping non-trading days)
-
-    Returns
-    -------
-    ret : list
-        lines collections
-    """
-    if alines is None:
-        return None
-
-    if isinstance(alines,dict):
-        aconfig = _process_kwargs(alines, _valid_lines_kwargs())
-        alines = aconfig['alines']
-    else:
-        aconfig = _process_kwargs({}, _valid_lines_kwargs())
-
-    alines = _alines_validator(alines, returnStandardizedValue=True)
-    if alines is None:
-        raise ValueError('Unable to standardize alines value: '+str(alines))
-
-    alines = _convert_segment_dates(alines,dtix)
-
-    lw = aconfig['linewidths']
-    co = aconfig['colors']
-    ls = aconfig['linestyle']
-    al = aconfig['alpha']
-    lcollection = LineCollection(alines,colors=co,linewidths=lw,linestyles=ls,antialiaseds=(0,),alpha=al)
-    return lcollection
-
-
-def _construct_hline_collections(hlines,minx,maxx):
-    """Construct horizontal lines collection
-
-    Parameters
-    ----------
-    hlines : sequence
-        sequence of [price] values at which to draw horizontal lines
-
-    hlines may also be a dict, containing
-    the following keys:
-
-        'hlines'     : the same as defined above: sequence of price, or dates, or segments
-        'colors'     : colors for the above hlines
-        'linestyle'  : line types for the above hlines
-        'linewidths' : line widths for the above hlines
-
-    minx : the minimum value for x for the horizontal line, already converted to `xdates` format
-    maxx : the maximum value for x for the horizontal line, already converted to `xdates` format
-
-    Returns
-    -------
-    ret : list
-        lines collections
-    """
-
-    if hlines is None:
-        return None
-
-    #print('_construct_hline_collections() called:',
-    #      '\nhlines=',hlines,'\nminx,maxx=',minx,maxx)
-
-    # hlines do NOT require converting segment dates, because the dates
-    # are not user-specified, but are from already converted minxdt,maxxdt
-
-    if isinstance(hlines,dict):
-        hconfig = _process_kwargs(hlines, _valid_lines_kwargs())
-        hlines = hconfig['hlines']
-    else:
-        hconfig = _process_kwargs({}, _valid_lines_kwargs())
-
-    #print('hconfig=',hconfig)
-    #print('hlines=',hlines)
-
-    lines = []
-    if not isinstance(hlines,(list,tuple)):
-        hlines = [hlines,] # may be a single price value
-
-    for val in hlines:
-        lines.append( [(minx,val),(maxx,val)] )
-
-    lw = hconfig['linewidths']
-    co = hconfig['colors']
-    ls = hconfig['linestyle']
-    al = hconfig['alpha']
-    lcollection = LineCollection(lines,colors=co,linewidths=lw,linestyles=ls,antialiaseds=(0,),alpha=al)
-    return lcollection
-
-
-def _construct_vline_collections(vlines,dtix,miny,maxy):
-    """Construct vertical lines collection
-    Parameters
-    ----------
-    vlines : sequence
-        sequence of dates or datetimes at which to draw vertical lines
-        dates/datetimes may be (a) pandas.to_datetime parseable string,
-                               (b) pandas Timestamp
-                               (c) python datetime.datetime or datetime.date
-
-    vlines may also be a dict, containing
-    the following keys:
-
-        'vlines'     : the same as defined above: sequence of dates/datetimes
-        'colors'     : colors for the above vlines
-        'linestyle'  : line types for the above vlines
-        'linewidths' : line widths for the above vlines
-
-    dtix:  date index for the x-axis, used for converting the dates when
-           x-values are 'evenly spaced integers' (as when skipping non-trading days)
-
-    miny : minimum y-value for the vertical line
-
-    maxy : maximum y-value for the vertical line
-
-    Returns
-    -------
-    ret : list
-        lines collections
-    """
-
-    if vlines is None:
-        return None
-
-    #print('_construct_vline_collections() called:',
-    #      '\nvlines=',vlines,
-    #      '\ndtix=',dtix)
-    #print('miny,maxy=',miny,maxy)
-
-    if isinstance(vlines,dict):
-        vconfig = _process_kwargs(vlines, _valid_lines_kwargs())
-        vlines = vconfig['vlines']
-    else:
-        vconfig = _process_kwargs({}, _valid_lines_kwargs())
-
-    #print('vconfig=',vconfig)
-    #print('vlines=',vlines)
-
-    if not isinstance(vlines,(list,tuple)):
-        vlines = [vlines,]
-
-    lines = []
-    for val in vlines:
-        lines.append( [(val,miny),(val,maxy)] )
-
-    lines = _convert_segment_dates(lines,dtix)
-
-    lw = vconfig['linewidths']
-    co = vconfig['colors']
-    ls = vconfig['linestyle']
-    al = vconfig['alpha']
-    lcollection = LineCollection(lines,colors=co,linewidths=lw,linestyles=ls,antialiaseds=(0,),alpha=al)
-    return lcollection
-
-def _construct_tline_collections(tlines, dtix, dates, opens, highs, lows, closes):
-    """construct trend line collections
-
-    Parameters
-    ----------
-    tlines : sequence
-        sequences of pairs of date[time]s
-
-        date[time] may be (a) pandas.to_datetime parseable string,
-                          (b) pandas Timestamp, or
-                          (c) python datetime.datetime or datetime.date
-
-    tlines may also be a dict, containing
-    the following keys:
-
-        'tlines'     : the same as defined above: sequence of pairs of date[time]s
-        'colors'     : colors for the above tlines
-        'linestyle'  : line types for the above tlines
-        'linewidths' : line widths for the above tlines
-
-    dtix:  date index for the x-axis, used for converting the dates when
-           x-values are 'evenly spaced integers' (as when skipping non-trading days)
-
-    Returns
-    -------
-    ret : list
-        lines collections
-    """
-    if tlines is None:
-        return None
-
-    if isinstance(tlines,dict):
-        tconfig = _process_kwargs(tlines, _valid_lines_kwargs())
-        tlines  = tconfig['tlines']
-    else:
-        tconfig = _process_kwargs({}, _valid_lines_kwargs())
-
-    tline_use    = tconfig['tline_use']
-    tline_method = tconfig['tline_method']
-
-    #print('tconfig=',tconfig)
-    #print('tlines=',tlines)
-
-    # reconstruct the data frame:
-    df = pd.DataFrame({'open':opens,'high':highs,'low':lows,'close':closes},
-                      index=pd.DatetimeIndex(mdates.num2date(dates))   )
-    df.index = df.index.tz_localize(None)
-
-    # possible `tvalue`s : close,open,high,low,oc_avg,hl_avg,ohlc_avg,hilo
-    #          'hilo' means high on the up trend, low on the down trend.
-    # possible `tmethod`s: point-to-point, leastsquares
-
-    def _tline_point_to_point(dfslice,tline_use):
-        p1 = dfslice.iloc[ 0]
-        p2 = dfslice.iloc[-1]
-        x1 = p1.name
-        y1 = p1[tline_use].mean()
-        x2 = p2.name
-        y2 = p2[tline_use].mean()
-        return ((x1,y1),(x2,y2))
-
-    def _tline_lsq(dfslice,tline_use):
-        '''
-        This closed-form linear least squares algorithm was taken from:
-        https://mmas.github.io/least-squares-fitting-numpy-scipy
-        '''
-        si = dfslice[tline_use].mean(axis=1)
-        s  = si.dropna()
-        if len(s) < 2:
-            err = 'NOT enough data for Least Squares'
-            if (len(si) > 2):
-                err += ', due to presence of NaNs'
-            raise ValueError(err)
-        xs = mdates.date2num(s.index.to_pydatetime())
-        ys = s.values
-        a  = np.vstack([xs, np.ones(len(xs))]).T
-        m, b  = np.dot(np.linalg.inv(np.dot(a.T,a)), np.dot(a.T,ys))
-        x1, x2 = xs[0], xs[-1]
-        y1 = m*x1 + b
-        y2 = m*x2 + b
-        x1, x2 = mdates.num2date(x1).replace(tzinfo=None), mdates.num2date(x2).replace(tzinfo=None)
-        return ((x1,y1),(x2,y2))
-
-    if isinstance(tline_use,str):
-        tline_use = [tline_use,]
-    tline_use = [ u.lower() for u in tline_use ]
-
-    alines = []
-    for d1,d2 in tlines:
-        dfslice = df.loc[d1:d2]
-        if len(dfslice) < 2:
-            dfdr = '\ndf date range: ['+str(df.index[0])+' , '+str(df.index[-1])+']'
-            raise ValueError('\ntlines date pair ('+str(d1)+','+str(d2)+
-                             ') too close, or wrong order, or out of range!'+dfdr)
-        if tline_method == 'least squares' or tline_method == 'least-squares':
-            p1,p2 = _tline_lsq(dfslice,tline_use)
-        elif tline_method == 'point-to-point':
-            p1,p2 = _tline_point_to_point(dfslice,tline_use)
-        else:
-            raise ValueError('\nUnrecognized value for `tline_method` = "'+str(tline_method)+'"')
-
-        alines.append((p1,p2))
-
-    del tconfig['alines']
-    alines = dict(alines=alines,**tconfig)
-    alines['tlines'] = None
-
-    return _construct_aline_collections(alines, dtix)
-
-
-from matplotlib.ticker import Formatter
-class IntegerIndexDateTimeFormatter(Formatter):
-    """
-    Formatter for axis that is indexed by integer, where the integers
-    represent the index location of the datetime object that should be
-    formatted at that lcoation.  This formatter is used typically when
-    plotting datetime on an axis but the user does NOT want to see gaps
-    where days (or times) are missing.  To use: plot the data against
-    a range of integers equal in length to the array of datetimes that
-    you would otherwise plot on that axis.  Construct this formatter
-    by providing the arrange of datetimes (as matplotlib floats). When
-    the formatter receives an integer in the range, it will look up the
-    datetime and format it.
-
-    """
-    def __init__(self, dates, fmt='%b %d, %H:%M'):
-        self.dates = dates
-        self.len   = len(dates)
-        self.fmt   = fmt
-
-    def __call__(self, x, pos=0):
-        #import pdb; pdb.set_trace()
-        'Return label for time x at position pos'
-        # not sure what 'pos' is for: see
-        # https://matplotlib.org/gallery/ticks_and_spines/date_index_formatter.html
-        ix = int(np.round(x))
-
-        if ix >= self.len or ix < 0:
-            date = None
-            dateformat = ''
-        else:
-            date = self.dates[ix]
-            dateformat = mdates.num2date(date).strftime(self.fmt)
-        #print('x=',x,'pos=',pos,'dates[',ix,']=',date,'dateformat=',dateformat)
-        return dateformat
-
-def _mscatter(x,y,ax=None, m=None, **kw):
-    import matplotlib.markers as mmarkers
-    if not ax: ax=plt.gca()
-    sc = ax.scatter(x,y,**kw)
-    if (m is not None) and (len(m)==len(x)):
-        paths = []
-        for marker in m:
-            if isinstance(marker, mmarkers.MarkerStyle):
-                marker_obj = marker
-            else:
-                marker_obj = mmarkers.MarkerStyle(marker)
-            path = marker_obj.get_path().transformed(
-                        marker_obj.get_transform())
-            paths.append(path)
-        sc.set_paths(paths)
-    return sc
diff --git a/build/lib/mplfinance/_version.py b/build/lib/mplfinance/_version.py
deleted file mode 100644
index 44439d7d..00000000
--- a/build/lib/mplfinance/_version.py
+++ /dev/null
@@ -1,6 +0,0 @@
-version_info = (0, 12, 9, 'beta', 2)
-
-_specifier_ = {'alpha': 'a','beta': 'b','candidate': 'rc','final': ''}
-
-__version__ = '%s.%s.%s%s'%(version_info[0], version_info[1], version_info[2],
-  '' if version_info[3]=='final' else _specifier_[version_info[3]]+str(version_info[4]))
diff --git a/build/lib/mplfinance/_widths.py b/build/lib/mplfinance/_widths.py
deleted file mode 100644
index 3b6813c4..00000000
--- a/build/lib/mplfinance/_widths.py
+++ /dev/null
@@ -1,197 +0,0 @@
-import pandas as pd
-from mplfinance._arg_validators import _process_kwargs, _validate_vkwargs_dict
-
-def _get_widths_df():
-    '''
-    Provide a dataframe of width data that appropriate scales widths of
-    various aspects of the plot (candles,ohlc bars,volume bars) based on
-    the amount or density of data.  These numbers were arrived at by 
-    carefully testing many use-cases of plots with various styles, 
-    and observing which numbers gave the "best" appearance.
-    '''
-    numpoints = [n for n in range(30,241,30)]
-    volume_width     = (0.98, 0.96,  0.95,  0.925,  0.9,  0.9,  0.875, 0.825 )
-    volume_linewidth = tuple([0.65]*8)
-    candle_width     = (0.65, 0.575, 0.50, 0.445, 0.435, 0.425, 0.420, 0.415)
-    candle_linewidth = (1.00, 0.875, 0.75, 0.625, 0.500, 0.438, 0.435, 0.435)
-    ohlc_tickwidth   = tuple([0.35]*8)
-    ohlc_linewidth   = (1.50, 1.175, 0.85, 0.525, 0.525, 0.525, 0.525, 0.525)
-    line_width       = (2.25, 1.8, 1.3, 0.813, 0.807, 0.801, 0.796, 0.791)
-    widths = {}
-    widths['vw']  = volume_width
-    widths['vlw'] = volume_linewidth
-    widths['cw']  = candle_width
-    widths['clw'] = candle_linewidth
-    widths['ow']  = ohlc_tickwidth
-    widths['olw'] = ohlc_linewidth
-    widths['lw']  = line_width
-    return pd.DataFrame(widths,index=numpoints)
-
-_widths = _get_widths_df()
-
-
-def _valid_scale_width_kwargs():
-    vkwargs = {
-        'ohlc'             : { 'Default'     : None,
-                               'Description' : 'length of horizontal open/close tickmarks on ohlc bars',
-                               'Validator'   : lambda value: isinstance(value,(float,int)) },
-
-        'volume'           : { 'Default'     : None,
-                               'Description' : 'width of volume bars',
-                               'Validator'   : lambda value: isinstance(value,(float,int)) },
-
-        'candle'           : { 'Default'     : None,
-                               'Description' : 'width of candles',
-                               'Validator'   : lambda value: isinstance(value,(float,int)) },
-
-        'lines'            : { 'Default'     : None,
-                               'Description' : 'width of lines (for line plots and moving averages)',
-                               'Validator'   : lambda value: isinstance(value,(float,int)) },
-
-        'volume_linewidth' : { 'Default'     : None,
-                               'Description' : 'width of edges of volume bars',
-                               'Validator'   : lambda value: isinstance(value,(float,int)) },
-
-        'ohlc_linewidth'   : { 'Default'     : None,
-                               'Description' : 'width (thickness) of ohlc bars',
-                               'Validator'   : lambda value: isinstance(value,(float,int)) },
-
-        'candle_linewidth' : { 'Default'     : None,
-                               'Description' : 'width of candle edges and wicks',
-                               'Validator'   : lambda value: isinstance(value,(float,int)) },
-    }
-
-    _validate_vkwargs_dict(vkwargs)
-
-    return vkwargs
-
-
-def _valid_update_width_kwargs():
-    vkwargs = {
-
-        'ohlc_ticksize'    : { 'Default'     : None,
-                               'Description' : 'length of horizontal open/close tickmarks on ohlc bars',
-                               'Validator'   : lambda value: isinstance(value,(float,int)) },
-
-        'ohlc_linewidth'   : { 'Default'     : None,
-                               'Description' : 'width (thickness) of ohlc bars',
-                               'Validator'   : lambda value: isinstance(value,(float,int)) },
-
-        'volume_width'     : { 'Default'     : None,
-                               'Description' : 'width of volume bars',
-                               'Validator'   : lambda value: isinstance(value,(float,int)) },
-
-        'volume_linewidth' : { 'Default'     : None,
-                               'Description' : 'width of edges of volume bars',
-                               'Validator'   : lambda value: isinstance(value,(float,int)) },
-
-        'candle_width'     : { 'Default'     : None,
-                               'Description' : 'width of candles',
-                               'Validator'   : lambda value: isinstance(value,(float,int)) },
-
-        'candle_linewidth' : { 'Default'     : None,
-                               'Description' : 'width of candle edges and wicks',
-                               'Validator'   : lambda value: isinstance(value,(float,int)) },
-
-        'line_width'       : { 'Default'     : None,
-                               'Description' : 'width of lines (for line plots and moving averages)',
-                               'Validator'   : lambda value: isinstance(value,(float,int)) },
-    }
-
-    _validate_vkwargs_dict(vkwargs)
-
-    return vkwargs
-
-
-def _determine_width_config( xdates, config ):
-    '''
-    Given x-axis xdates, and `mpf.plot()` kwargs config,
-    determine the widths and linewidths for candles,
-    volume bars, ohlc bars, etc.
-    '''
-    datalen = len(xdates)
-    avg_dist_between_points = (xdates[-1] - xdates[0]) / float(datalen)
-
-    tweak  = 1.06 if datalen > 100 else 1.03
-
-    adjust = tweak*avg_dist_between_points if config['show_nontrading'] else 1.0
-
-    width_config = {}
-
-    if config['width_adjuster_version'] == 'v0':  # Behave like original version of code:
-
-        width_config['volume_width'    ] = 0.5*avg_dist_between_points
-        width_config['volume_linewidth'] = None
-        width_config['ohlc_ticksize'   ] = avg_dist_between_points / 2.5
-        width_config['ohlc_linewidth'  ] = None
-        width_config['candle_width'    ] = avg_dist_between_points / 2.0
-        width_config['candle_linewidth'] = None
-        width_config['line_width'      ] = None
-
-    else: # config['width_adjuster_version'] == 'v1'
-
-        width_config['volume_width'    ] = _dfinterpolate(_widths,datalen,'vw' ) * adjust
-        width_config['volume_linewidth'] = _dfinterpolate(_widths,datalen,'vlw')
-        width_config['ohlc_ticksize'   ] = _dfinterpolate(_widths,datalen,'ow' ) * adjust
-        width_config['ohlc_linewidth'  ] = _dfinterpolate(_widths,datalen,'olw')
-        width_config['candle_width'    ] = _dfinterpolate(_widths,datalen,'cw' ) * adjust
-        width_config['candle_linewidth'] = _dfinterpolate(_widths,datalen,'clw')
-        width_config['line_width'      ] = _dfinterpolate(_widths,datalen,'lw')
-
-    if config['scale_width_adjustment'] is not None:
-
-        scale = _process_kwargs(config['scale_width_adjustment'],_valid_scale_width_kwargs())
-        if scale['volume'] is not None:
-            width_config['volume_width']  *= scale['volume']
-        if scale['ohlc'] is not None:
-            width_config['ohlc_ticksize'] *= scale['ohlc']
-        if scale['candle'] is not None:
-            width_config['candle_width']  *= scale['candle']
-        if scale['lines'] is not None:
-            width_config['line_width']    *= scale['lines']
-        if scale['volume_linewidth'] is not None:
-            width_config['volume_linewidth']  *= scale['volume_linewidth']
-        if scale['ohlc_linewidth'] is not None: 
-            width_config['ohlc_linewidth'  ]  *= scale['ohlc_linewidth']
-        if scale['candle_linewidth'] is not None:
-            width_config['candle_linewidth']  *= scale['candle_linewidth']
-
-    if config['update_width_config'] is not None:
-     
-        update = _process_kwargs(config['update_width_config'],_valid_update_width_kwargs())
-        uplist = [ (k,v) for k,v in update.items() if v is not None ]
-        width_config.update(uplist)
-
-    return width_config
-
-
-def _dfinterpolate(df,key,column):
-    '''
-    Given a DataFrame, with all values and the Index as floats,
-    and given a float key, find the row that matches the key, or 
-    find the two rows surrounding that key, and return the interpolated
-    value for the specified column, based on where the key falls between
-    the two rows.  If they key is an exact match for a key in the index,
-    the return the exact value from the column.  If the key is less than
-    or greater than any key in the index, then return either the first
-    or last value for the column.
-    '''
-    s = df[column]
-    s1 = s.loc[:key]
-    if len(s1) < 1:
-        return s.iloc[0]
-    j1 = s1.index[-1]
-    v1 = s1.iloc[-1]
-    
-    s2 = s.loc[key:]
-    if len(s2) < 1:
-        return s.iloc[-1]
-    j2 = s2.index[0]
-    v2 = s2.iloc[0]
-
-    if j1 == j2:
-        return v1
-    delta   = j2 - j1
-    portion = (key - j1)/delta
-    ans = v1 + (v2-v1)*portion
-    return ans
diff --git a/build/lib/mplfinance/original_flavor.py b/build/lib/mplfinance/original_flavor.py
deleted file mode 100644
index f6963963..00000000
--- a/build/lib/mplfinance/original_flavor.py
+++ /dev/null
@@ -1,885 +0,0 @@
-"""
-A collection of functions for analyzing and plotting
-financial data.   User contributions welcome!
-
-"""
-from __future__ import (absolute_import, division, print_function,
-                        unicode_literals)
-
-import numpy as np
-from matplotlib import colors as mcolors
-from matplotlib.collections import LineCollection, PolyCollection
-from matplotlib.lines import TICKLEFT, TICKRIGHT, Line2D
-from matplotlib.patches import Rectangle
-from matplotlib.transforms import Affine2D
-
-from six.moves import xrange, zip
-
-
-def plot_day_summary_oclh(ax, quotes, ticksize=3,
-                          colorup='k', colordown='r'):
-    """Plots day summary
-
-        Represent the time, open, close, high, low as a vertical line
-        ranging from low to high.  The left tick is the open and the right
-        tick is the close.
-
-
-
-    Parameters
-    ----------
-    ax : `Axes`
-        an `Axes` instance to plot to
-    quotes : sequence of (time, open, close, high, low, ...) sequences
-        data to plot.  time must be in float date format - see date2num
-    ticksize : int
-        open/close tick marker in points
-    colorup : color
-        the color of the lines where close >= open
-    colordown : color
-        the color of the lines where close <  open
-
-    Returns
-    -------
-    lines : list
-        list of tuples of the lines added (one tuple per quote)
-    """
-    return _plot_day_summary(ax, quotes, ticksize=ticksize,
-                             colorup=colorup, colordown=colordown,
-                             ochl=True)
-
-
-def plot_day_summary_ohlc(ax, quotes, ticksize=3,
-                          colorup='k', colordown='r'):
-    """Plots day summary
-
-        Represent the time, open, high, low, close as a vertical line
-        ranging from low to high.  The left tick is the open and the right
-        tick is the close.
-
-
-
-    Parameters
-    ----------
-    ax : `Axes`
-        an `Axes` instance to plot to
-    quotes : sequence of (time, open, high, low, close, ...) sequences
-        data to plot.  time must be in float date format - see date2num
-    ticksize : int
-        open/close tick marker in points
-    colorup : color
-        the color of the lines where close >= open
-    colordown : color
-        the color of the lines where close <  open
-
-    Returns
-    -------
-    lines : list
-        list of tuples of the lines added (one tuple per quote)
-    """
-    return _plot_day_summary(ax, quotes, ticksize=ticksize,
-                             colorup=colorup, colordown=colordown,
-                             ochl=False)
-
-
-def _plot_day_summary(ax, quotes, ticksize=3,
-                      colorup='k', colordown='r',
-                      ochl=True):
-    """Plots day summary
-
-
-        Represent the time, open, high, low, close as a vertical line
-        ranging from low to high.  The left tick is the open and the right
-        tick is the close.
-
-
-
-    Parameters
-    ----------
-    ax : `Axes`
-        an `Axes` instance to plot to
-    quotes : sequence of quote sequences
-        data to plot.  time must be in float date format - see date2num
-        (time, open, high, low, close, ...) vs
-        (time, open, close, high, low, ...)
-        set by `ochl`
-    ticksize : int
-        open/close tick marker in points
-    colorup : color
-        the color of the lines where close >= open
-    colordown : color
-        the color of the lines where close <  open
-    ochl: bool
-        argument to select between ochl and ohlc ordering of quotes
-
-    Returns
-    -------
-    lines : list
-        list of tuples of the lines added (one tuple per quote)
-    """
-    # unfortunately this has a different return type than plot_day_summary2_*
-    lines = []
-    for q in quotes:
-        if ochl:
-            t, open, close, high, low = q[:5]
-        else:
-            t, open, high, low, close = q[:5]
-
-        if close >= open:
-            color = colorup
-        else:
-            color = colordown
-
-        vline = Line2D(xdata=(t, t), ydata=(low, high),
-                       color=color,
-                       antialiased=False,   # no need to antialias vert lines
-                       )
-
-        oline = Line2D(xdata=(t, t), ydata=(open, open),
-                       color=color,
-                       antialiased=False,
-                       marker=TICKLEFT,
-                       markersize=ticksize,
-                       )
-
-        cline = Line2D(xdata=(t, t), ydata=(close, close),
-                       color=color,
-                       antialiased=False,
-                       markersize=ticksize,
-                       marker=TICKRIGHT)
-
-        lines.extend((vline, oline, cline))
-        ax.add_line(vline)
-        ax.add_line(oline)
-        ax.add_line(cline)
-
-    ax.autoscale_view()
-
-    return lines
-
-
-def candlestick_ochl(ax, quotes, width=0.2, colorup='k', colordown='r',
-                     alpha=1.0):
-    """
-    Plot the time, open, close, high, low as a vertical line ranging
-    from low to high.  Use a rectangular bar to represent the
-    open-close span.  If close >= open, use colorup to color the bar,
-    otherwise use colordown
-
-    Parameters
-    ----------
-    ax : `Axes`
-        an Axes instance to plot to
-    quotes : sequence of (time, open, close, high, low, ...) sequences
-        As long as the first 5 elements are these values,
-        the record can be as long as you want (e.g., it may store volume).
-
-        time must be in float days format - see date2num
-
-    width : float
-        fraction of a day for the rectangle width
-    colorup : color
-        the color of the rectangle where close >= open
-    colordown : color
-         the color of the rectangle where close <  open
-    alpha : float
-        the rectangle alpha level
-
-    Returns
-    -------
-    ret : tuple
-        returns (lines, patches) where lines is a list of lines
-        added and patches is a list of the rectangle patches added
-
-    """
-    return _candlestick(ax, quotes, width=width, colorup=colorup,
-                        colordown=colordown,
-                        alpha=alpha, ochl=True)
-
-
-def candlestick_ohlc(ax, quotes, width=0.2, colorup='k', colordown='r',
-                     alpha=1.0):
-    """
-    Plot the time, open, high, low, close as a vertical line ranging
-    from low to high.  Use a rectangular bar to represent the
-    open-close span.  If close >= open, use colorup to color the bar,
-    otherwise use colordown
-
-    Parameters
-    ----------
-    ax : `Axes`
-        an Axes instance to plot to
-    quotes : sequence of (time, open, high, low, close, ...) sequences
-        As long as the first 5 elements are these values,
-        the record can be as long as you want (e.g., it may store volume).
-
-        time must be in float days format - see date2num
-
-    width : float
-        fraction of a day for the rectangle width
-    colorup : color
-        the color of the rectangle where close >= open
-    colordown : color
-         the color of the rectangle where close <  open
-    alpha : float
-        the rectangle alpha level
-
-    Returns
-    -------
-    ret : tuple
-        returns (lines, patches) where lines is a list of lines
-        added and patches is a list of the rectangle patches added
-
-    """
-    return _candlestick(ax, quotes, width=width, colorup=colorup,
-                        colordown=colordown,
-                        alpha=alpha, ochl=False)
-
-
-def _candlestick(ax, quotes, width=0.2, colorup='k', colordown='r',
-                 alpha=1.0, ochl=True):
-    """
-    Plot the time, open, high, low, close as a vertical line ranging
-    from low to high.  Use a rectangular bar to represent the
-    open-close span.  If close >= open, use colorup to color the bar,
-    otherwise use colordown
-
-    Parameters
-    ----------
-    ax : `Axes`
-        an Axes instance to plot to
-    quotes : sequence of quote sequences
-        data to plot.  time must be in float date format - see date2num
-        (time, open, high, low, close, ...) vs
-        (time, open, close, high, low, ...)
-        set by `ochl`
-    width : float
-        fraction of a day for the rectangle width
-    colorup : color
-        the color of the rectangle where close >= open
-    colordown : color
-         the color of the rectangle where close <  open
-    alpha : float
-        the rectangle alpha level
-    ochl: bool
-        argument to select between ochl and ohlc ordering of quotes
-
-    Returns
-    -------
-    ret : tuple
-        returns (lines, patches) where lines is a list of lines
-        added and patches is a list of the rectangle patches added
-
-    """
-
-    OFFSET = width / 2.0
-
-    lines = []
-    patches = []
-    for q in quotes:
-        if ochl:
-            t, open, close, high, low = q[:5]
-        else:
-            t, open, high, low, close = q[:5]
-
-        if close >= open:
-            color = colorup
-            lower = open
-            height = close - open
-        else:
-            color = colordown
-            lower = close
-            height = open - close
-
-        vline = Line2D(
-            xdata=(t, t), ydata=(low, high),
-            color=color,
-            linewidth=0.5,
-            antialiased=True,
-        )
-
-        rect = Rectangle(
-            xy=(t - OFFSET, lower),
-            width=width,
-            height=height,
-            facecolor=color,
-            edgecolor=color,
-        )
-        rect.set_alpha(alpha)
-
-        lines.append(vline)
-        patches.append(rect)
-        ax.add_line(vline)
-        ax.add_patch(rect)
-    ax.autoscale_view()
-
-    return lines, patches
-
-
-def _check_input(opens, closes, highs, lows, miss=-1):
-    """Checks that *opens*, *highs*, *lows* and *closes* have the same length.
-    NOTE: this code assumes if any value open, high, low, close is
-    missing (*-1*) they all are missing
-
-    Parameters
-    ----------
-    ax : `Axes`
-        an Axes instance to plot to
-    opens : sequence
-        sequence of opening values
-    highs : sequence
-        sequence of high values
-    lows : sequence
-        sequence of low values
-    closes : sequence
-        sequence of closing values
-    miss : int
-        identifier of the missing data
-
-    Raises
-    ------
-    ValueError
-        if the input sequences don't have the same length
-    """
-
-    def _missing(sequence, miss=-1):
-        """Returns the index in *sequence* of the missing data, identified by
-        *miss*
-
-        Parameters
-        ----------
-        sequence :
-            sequence to evaluate
-        miss :
-            identifier of the missing data
-
-        Returns
-        -------
-        where_miss: numpy.ndarray
-            indices of the missing data
-        """
-        return np.where(np.array(sequence) == miss)[0]
-
-    same_length = len(opens) == len(highs) == len(lows) == len(closes)
-    _missopens = _missing(opens)
-    same_missing = ((_missopens == _missing(highs)).all() and
-                    (_missopens == _missing(lows)).all() and
-                    (_missopens == _missing(closes)).all())
-
-    if not (same_length and same_missing):
-        msg = ("*opens*, *highs*, *lows* and *closes* must have the same"
-               " length. NOTE: this code assumes if any value open, high,"
-               " low, close is missing (*-1*) they all must be missing.")
-        raise ValueError(msg)
-
-
-def plot_day_summary2_ochl(ax, opens, closes, highs, lows, ticksize=4,
-                           colorup='k', colordown='r'):
-    """Represent the time, open, close, high, low,  as a vertical line
-    ranging from low to high.  The left tick is the open and the right
-    tick is the close.
-
-    Parameters
-    ----------
-    ax : `Axes`
-        an Axes instance to plot to
-    opens : sequence
-        sequence of opening values
-    closes : sequence
-        sequence of closing values
-    highs : sequence
-        sequence of high values
-    lows : sequence
-        sequence of low values
-    ticksize : int
-        size of open and close ticks in points
-    colorup : color
-        the color of the lines where close >= open
-    colordown : color
-         the color of the lines where close <  open
-
-    Returns
-    -------
-    ret : list
-        a list of lines added to the axes
-    """
-
-    return plot_day_summary2_ohlc(ax, opens, highs, lows, closes, ticksize,
-                                  colorup, colordown)
-
-
-def plot_day_summary2_ohlc(ax, opens, highs, lows, closes, ticksize=4,
-                           colorup='k', colordown='r'):
-    """Represent the time, open, high, low, close as a vertical line
-    ranging from low to high.  The left tick is the open and the right
-    tick is the close.
-    *opens*, *highs*, *lows* and *closes* must have the same length.
-    NOTE: this code assumes if any value open, high, low, close is
-    missing (*-1*) they all are missing
-
-    Parameters
-    ----------
-    ax : `Axes`
-        an Axes instance to plot to
-    opens : sequence
-        sequence of opening values
-    highs : sequence
-        sequence of high values
-    lows : sequence
-        sequence of low values
-    closes : sequence
-        sequence of closing values
-    ticksize : int
-        size of open and close ticks in points
-    colorup : color
-        the color of the lines where close >= open
-    colordown : color
-         the color of the lines where close <  open
-
-    Returns
-    -------
-    ret : list
-        a list of lines added to the axes
-    """
-
-    _check_input(opens, highs, lows, closes)
-
-    rangeSegments = [((i, low), (i, high)) for i, low, high in
-                     zip(xrange(len(lows)), lows, highs) if low != -1]
-
-    # the ticks will be from ticksize to 0 in points at the origin and
-    # we'll translate these to the i, close location
-    openSegments = [((-ticksize, 0), (0, 0))]
-
-    # the ticks will be from 0 to ticksize in points at the origin and
-    # we'll translate these to the i, close location
-    closeSegments = [((0, 0), (ticksize, 0))]
-
-    offsetsOpen = [(i, open) for i, open in
-                   zip(xrange(len(opens)), opens) if open != -1]
-
-    offsetsClose = [(i, close) for i, close in
-                    zip(xrange(len(closes)), closes) if close != -1]
-
-    scale = ax.figure.dpi * (1.0 / 72.0)
-
-    tickTransform = Affine2D().scale(scale, 0.0)
-
-    colorup = mcolors.to_rgba(colorup)
-    colordown = mcolors.to_rgba(colordown)
-    colord = {True: colorup, False: colordown}
-    colors = [colord[open < close] for open, close in
-              zip(opens, closes) if open != -1 and close != -1]
-
-    useAA = 0,   # use tuple here
-    lw = 1,      # and here
-    rangeCollection = LineCollection(rangeSegments,
-                                     colors=colors,
-                                     linewidths=lw,
-                                     antialiaseds=useAA,
-                                     )
-
-    openCollection = LineCollection(openSegments,
-                                    colors=colors,
-                                    antialiaseds=useAA,
-                                    linewidths=lw,
-                                    offsets=offsetsOpen,
-                                    transOffset=ax.transData,
-                                    )
-    openCollection.set_transform(tickTransform)
-
-    closeCollection = LineCollection(closeSegments,
-                                     colors=colors,
-                                     antialiaseds=useAA,
-                                     linewidths=lw,
-                                     offsets=offsetsClose,
-                                     transOffset=ax.transData,
-                                     )
-    closeCollection.set_transform(tickTransform)
-
-    minpy, maxx = (0, len(rangeSegments))
-    miny = min([low for low in lows if low != -1])
-    maxy = max([high for high in highs if high != -1])
-    corners = (minpy, miny), (maxx, maxy)
-    ax.update_datalim(corners)
-    ax.autoscale_view()
-
-    # add these last
-    ax.add_collection(rangeCollection)
-    ax.add_collection(openCollection)
-    ax.add_collection(closeCollection)
-    return rangeCollection, openCollection, closeCollection
-
-
-def candlestick2_ochl(ax, opens, closes, highs, lows, width=4,
-                      colorup='k', colordown='r',
-                      alpha=0.75):
-    """Represent the open, close as a bar line and high low range as a
-    vertical line.
-
-    Preserves the original argument order.
-
-
-    Parameters
-    ----------
-    ax : `Axes`
-        an Axes instance to plot to
-    opens : sequence
-        sequence of opening values
-    closes : sequence
-        sequence of closing values
-    highs : sequence
-        sequence of high values
-    lows : sequence
-        sequence of low values
-    width : int
-        size of open and close ticks in points
-    colorup : color
-        the color of the lines where close >= open
-    colordown : color
-        the color of the lines where close <  open
-    alpha : float
-        bar transparency
-
-    Returns
-    -------
-    ret : tuple
-        (lineCollection, barCollection)
-    """
-
-    return candlestick2_ohlc(ax, opens, highs, lows, closes, width=width,
-                             colorup=colorup, colordown=colordown,
-                             alpha=alpha)
-
-
-def candlestick2_ohlc(ax, opens, highs, lows, closes, width=4,
-                      colorup='k', colordown='r',
-                      alpha=0.75):
-    """Represent the open, close as a bar line and high low range as a
-    vertical line.
-
-    NOTE: this code assumes if any value open, low, high, close is
-    missing they all are missing
-
-
-    Parameters
-    ----------
-    ax : `Axes`
-        an Axes instance to plot to
-    opens : sequence
-        sequence of opening values
-    highs : sequence
-        sequence of high values
-    lows : sequence
-        sequence of low values
-    closes : sequence
-        sequence of closing values
-    width : float
-        size of open and close ticks in points
-    colorup : color
-        the color of the lines where close >= open
-    colordown : color
-        the color of the lines where close <  open
-    alpha : float
-        bar transparency
-
-    Returns
-    -------
-    ret : tuple
-        (lineCollection, barCollection)
-    """
-
-    _check_input(opens, highs, lows, closes)
-
-    delta = width / 2.
-    barVerts = [((i - delta, open),
-                 (i - delta, close),
-                 (i + delta, close),
-                 (i + delta, open))
-                for i, open, close in zip(xrange(len(opens)), opens, closes)
-                if open != -1 and close != -1]
-
-    rangeSegments = [((i, low), (i, high))
-                     for i, low, high in zip(xrange(len(lows)), lows, highs)
-                     if low != -1]
-
-    colorup = mcolors.to_rgba(colorup, alpha)
-    colordown = mcolors.to_rgba(colordown, alpha)
-    colord = {True: colorup, False: colordown}
-    colors = [colord[open < close]
-              for open, close in zip(opens, closes)
-              if open != -1 and close != -1]
-
-    useAA = 0,  # use tuple here
-    lw = 0.5,   # and here
-    rangeCollection = LineCollection(rangeSegments,
-                                     colors=colors,
-                                     linewidths=lw,
-                                     antialiaseds=useAA,
-                                     )
-
-    barCollection = PolyCollection(barVerts,
-                                   facecolors=colors,
-                                   edgecolors=colors,
-                                   antialiaseds=useAA,
-                                   linewidths=lw,
-                                   )
-
-    minx, maxx = 0, len(rangeSegments)
-    miny = min([low for low in lows if low != -1])
-    maxy = max([high for high in highs if high != -1])
-
-    corners = (minx, miny), (maxx, maxy)
-    ax.update_datalim(corners)
-    ax.autoscale_view()
-
-    # add these last
-    ax.add_collection(rangeCollection)
-    ax.add_collection(barCollection)
-    return rangeCollection, barCollection
-
-
-def volume_overlay(ax, opens, closes, volumes,
-                   colorup='k', colordown='r',
-                   width=4, alpha=1.0):
-    """Add a volume overlay to the current axes.  The opens and closes
-    are used to determine the color of the bar.  -1 is missing.  If a
-    value is missing on one it must be missing on all
-
-    Parameters
-    ----------
-    ax : `Axes`
-        an Axes instance to plot to
-    opens : sequence
-        a sequence of opens
-    closes : sequence
-        a sequence of closes
-    volumes : sequence
-        a sequence of volumes
-    width : int
-        the bar width in points
-    colorup : color
-        the color of the lines where close >= open
-    colordown : color
-        the color of the lines where close <  open
-    alpha : float
-        bar transparency
-
-    Returns
-    -------
-    ret : `barCollection`
-        The `barrCollection` added to the axes
-
-    """
-
-    colorup = mcolors.to_rgba(colorup, alpha)
-    colordown = mcolors.to_rgba(colordown, alpha)
-    colord = {True: colorup, False: colordown}
-    colors = [colord[open < close]
-              for open, close in zip(opens, closes)
-              if open != -1 and close != -1]
-
-    delta = width / 2.
-    bars = [((i - delta, 0), (i - delta, v), (i + delta, v), (i + delta, 0))
-            for i, v in enumerate(volumes)
-            if v != -1]
-
-    barCollection = PolyCollection(bars,
-                                   facecolors=colors,
-                                   edgecolors=((0, 0, 0, 1), ),
-                                   antialiaseds=(0,),
-                                   linewidths=(0.5,),
-                                   )
-
-    ax.add_collection(barCollection)
-    corners = (0, 0), (len(bars), max(volumes))
-    ax.update_datalim(corners)
-    ax.autoscale_view()
-
-    # add these last
-    return barCollection
-
-
-def volume_overlay2(ax, closes, volumes,
-                    colorup='k', colordown='r',
-                    width=4, alpha=1.0):
-    """
-    Add a volume overlay to the current axes.  The closes are used to
-    determine the color of the bar.  -1 is missing.  If a value is
-    missing on one it must be missing on all
-
-    nb: first point is not displayed - it is used only for choosing the
-    right color
-
-
-    Parameters
-    ----------
-    ax : `Axes`
-        an Axes instance to plot to
-    closes : sequence
-        a sequence of closes
-    volumes : sequence
-        a sequence of volumes
-    width : int
-        the bar width in points
-    colorup : color
-        the color of the lines where close >= open
-    colordown : color
-        the color of the lines where close <  open
-    alpha : float
-        bar transparency
-
-    Returns
-    -------
-    ret : `barCollection`
-        The `barrCollection` added to the axes
-
-    """
-
-    return volume_overlay(ax, closes[:-1], closes[1:], volumes[1:],
-                          colorup, colordown, width, alpha)
-
-
-def volume_overlay3(ax, quotes,
-                    colorup='k', colordown='r',
-                    width=4, alpha=1.0):
-    """Add a volume overlay to the current axes.  quotes is a list of (d,
-    open, high, low, close, volume) and close-open is used to
-    determine the color of the bar
-
-    Parameters
-    ----------
-    ax : `Axes`
-        an Axes instance to plot to
-    quotes : sequence of (time, open, high, low, close, ...) sequences
-        data to plot.  time must be in float date format - see date2num
-    width : int
-        the bar width in points
-    colorup : color
-        the color of the lines where close1 >= close0
-    colordown : color
-        the color of the lines where close1 <  close0
-    alpha : float
-         bar transparency
-
-    Returns
-    -------
-    ret : `barCollection`
-        The `barrCollection` added to the axes
-
-
-    """
-
-    colorup = mcolors.to_rgba(colorup, alpha)
-    colordown = mcolors.to_rgba(colordown, alpha)
-    colord = {True: colorup, False: colordown}
-
-    dates, opens, highs, lows, closes, volumes = list(zip(*quotes))
-    colors = [colord[close1 >= close0]
-              for close0, close1 in zip(closes[:-1], closes[1:])
-              if close0 != -1 and close1 != -1]
-    colors.insert(0, colord[closes[0] >= opens[0]])
-
-    right = width / 2.0
-    left = -width / 2.0
-
-    bars = [((left, 0), (left, volume), (right, volume), (right, 0))
-            for d, open, high, low, close, volume in quotes]
-
-    sx = ax.figure.dpi * (1.0 / 72.0)  # scale for points
-    sy = ax.bbox.height / ax.viewLim.height
-
-    barTransform = Affine2D().scale(sx, sy)
-
-    dates = [d for d, open, high, low, close, volume in quotes]
-    offsetsBars = [(d, 0) for d in dates]
-
-    useAA = 0,  # use tuple here
-    lw = 0.5,   # and here
-    barCollection = PolyCollection(bars,
-                                   facecolors=colors,
-                                   edgecolors=((0, 0, 0, 1),),
-                                   antialiaseds=useAA,
-                                   linewidths=lw,
-                                   offsets=offsetsBars,
-                                   transOffset=ax.transData,
-                                   )
-    barCollection.set_transform(barTransform)
-
-    minpy, maxx = (min(dates), max(dates))
-    miny = 0
-    maxy = max([volume for d, open, high, low, close, volume in quotes])
-    corners = (minpy, miny), (maxx, maxy)
-    ax.update_datalim(corners)
-    # print 'datalim', ax.dataLim.bounds
-    # print 'viewlim', ax.viewLim.bounds
-
-    ax.add_collection(barCollection)
-    ax.autoscale_view()
-
-    return barCollection
-
-
-def index_bar(ax, vals,
-              facecolor='b', edgecolor='l',
-              width=4, alpha=1.0, ):
-    """Add a bar collection graph with height vals (-1 is missing).
-
-    Parameters
-    ----------
-    ax : `Axes`
-        an Axes instance to plot to
-    vals : sequence
-        a sequence of values
-    facecolor : color
-        the color of the bar face
-    edgecolor : color
-        the color of the bar edges
-    width : int
-        the bar width in points
-    alpha : float
-       bar transparency
-
-    Returns
-    -------
-    ret : `barCollection`
-        The `barrCollection` added to the axes
-
-    """
-
-    facecolors = (mcolors.to_rgba(facecolor, alpha),)
-    edgecolors = (mcolors.to_rgba(edgecolor, alpha),)
-
-    right = width / 2.0
-    left = -width / 2.0
-
-    bars = [((left, 0), (left, v), (right, v), (right, 0))
-            for v in vals if v != -1]
-
-    sx = ax.figure.dpi * (1.0 / 72.0)  # scale for points
-    sy = ax.bbox.height / ax.viewLim.height
-
-    barTransform = Affine2D().scale(sx, sy)
-
-    offsetsBars = [(i, 0) for i, v in enumerate(vals) if v != -1]
-
-    barCollection = PolyCollection(bars,
-                                   facecolors=facecolors,
-                                   edgecolors=edgecolors,
-                                   antialiaseds=(0,),
-                                   linewidths=(0.5,),
-                                   offsets=offsetsBars,
-                                   transOffset=ax.transData,
-                                   )
-    barCollection.set_transform(barTransform)
-
-    minpy, maxx = (0, len(offsetsBars))
-    miny = 0
-    maxy = max([v for v in vals if v != -1])
-    corners = (minpy, miny), (maxx, maxy)
-    ax.update_datalim(corners)
-    ax.autoscale_view()
-
-    # add these last
-    ax.add_collection(barCollection)
-    return barCollection
diff --git a/build/lib/mplfinance/plotting.py b/build/lib/mplfinance/plotting.py
deleted file mode 100644
index 073864a0..00000000
--- a/build/lib/mplfinance/plotting.py
+++ /dev/null
@@ -1,1307 +0,0 @@
-import matplotlib.dates  as mdates
-import matplotlib.pyplot as plt
-import matplotlib.colors as mcolors
-import matplotlib.axes   as mpl_axes
-import matplotlib.figure as mpl_fig
-import pandas as pd
-import numpy  as np
-import copy
-import io
-import os
-import math
-import warnings
-import statistics as stat
-
-from itertools import cycle
-#from pandas.plotting import register_matplotlib_converters
-#register_matplotlib_converters()
-
-from mplfinance._utils import _construct_aline_collections
-from mplfinance._utils import _construct_hline_collections
-from mplfinance._utils import _construct_vline_collections
-from mplfinance._utils import _construct_tline_collections
-from mplfinance._utils import _construct_mpf_collections
-
-from mplfinance._widths import _determine_width_config
-
-from mplfinance._utils import _updown_colors
-from mplfinance._utils import IntegerIndexDateTimeFormatter
-from mplfinance._utils import _mscatter
-from mplfinance._utils import _check_and_convert_xlim_configuration
-
-from mplfinance import _styles
-
-from mplfinance._arg_validators import _check_and_prepare_data, _mav_validator
-from mplfinance._arg_validators import _get_valid_plot_types, _fill_between_validator
-from mplfinance._arg_validators import _process_kwargs, _validate_vkwargs_dict
-from mplfinance._arg_validators import _kwarg_not_implemented, _bypass_kwarg_validation
-from mplfinance._arg_validators import _hlines_validator, _vlines_validator
-from mplfinance._arg_validators import _alines_validator, _tlines_validator
-from mplfinance._arg_validators import _scale_padding_validator, _yscale_validator
-from mplfinance._arg_validators import _valid_panel_id, _check_for_external_axes
-from mplfinance._arg_validators import _xlim_validator, _mco_validator, _is_marketcolor_object
-
-from mplfinance._panels import _build_panels
-from mplfinance._panels import _set_ticks_on_bottom_panel_only
-
-from mplfinance._helpers import _determine_format_string
-from mplfinance._helpers import _list_of_dict
-from mplfinance._helpers import _num_or_seq_of_num
-from mplfinance._helpers import _adjust_color_brightness
-
-VALID_PMOVE_TYPES = ['renko', 'pnf']
-
-DEFAULT_FIGRATIO = (8.00,5.75)
-
-def with_rc_context(func):
-    '''
-    This decoractor creates an rcParams context around a function, so that any changes
-    the function makes to rcParams will be reversed when the decorated function returns
-    (therefore those changes have no effect outside of the decorated function).
-    '''
-    def decorator(*args, **kwargs):
-        with plt.rc_context():
-            return func(*args, **kwargs)
-    return decorator
-
-def _warn_no_xgaps_deprecated(value):
-    warnings.warn('\n\n ================================================================= '+
-                  '\n\n   WARNING: `no_xgaps` is /deprecated/:'+
-                  '\n     Default value is now `no_xgaps=True`'+
-                  '\n     However, to set `no_xgaps=False` and silence this warning,'+
-                  '\n     use instead: `show_nontrading=True`.'+
-                  '\n\n ================================================================ ',
-                  category=DeprecationWarning)
-    return isinstance(value,bool)
-
-def _warn_set_ylim_deprecated(value):
-    warnings.warn('\n\n ================================================================= '+
-                  '\n\n   WARNING: `set_ylim=(ymin,ymax)` kwarg '+
-                    '\n             has been replaced with: '+
-                    '\n            `ylim=(ymin,ymax)`.'+
-                  '\n\n ================================================================ ',
-                  category=DeprecationWarning)
-    return isinstance(value,bool)
-
-
-def _valid_plot_kwargs():
-    '''
-    Construct and return the "valid kwargs table" for the mplfinance.plot() function.
-    A valid kwargs table is a `dict` of `dict`s.  The keys of the outer dict are the
-    valid key-words for the function.  The value for each key is a dict containing
-    2 specific keys: "Default", and "Validator" with the following values:
-        "Default"      - The default value for the kwarg if none is specified.
-        "Validator"    - A function that takes the caller specified value for the kwarg,
-                         and validates that it is the correct type, and (for kwargs with 
-                         a limited set of allowed values) may also validate that the
-                         kwarg value is one of the allowed values.
-    '''
-
-    vkwargs = {
-        'columns'                   : { 'Default'     : None, # use default names: ('Open', 'High', 'Low', 'Close', 'Volume')
-                                        'Description' : ('Column names to be used when plotting the data.'+
-                                                         ' Default: ("Open", "High", "Low", "Close", "Volume")'),
-                                        'Validator'   : lambda value: isinstance(value, (tuple, list))
-                                                                   and len(value) == 5
-                                                                   and all(isinstance(c, str) for c in value) },
-        'type'                      : { 'Default'     : 'ohlc',
-                                        'Description' : 'Plot type: '+str(_get_valid_plot_types()),
-                                        'Validator'   : lambda value: value in _get_valid_plot_types() },
- 
-        'style'                     : { 'Default'     : None,
-                                        'Description' : 'plot style; see `mpf.available_styles()`',
-                                        'Validator'   : _styles._valid_mpf_style },
- 
-        'volume'                    : { 'Default'     : False,
-                                        'Description' : 'Plot volume: True, False, or set to Axes object on which to plot.',
-                                        'Validator'   : lambda value: isinstance(value,bool) or isinstance(value,mpl_axes.Axes) },
- 
-        'mav'                       : { 'Default'     : None,
-                                        'Description' : 'Moving Average window size(s); (int or tuple of ints)',
-                                        'Validator'   : _mav_validator },
-        
-        'renko_params'              : { 'Default'     : dict(),
-                                        'Description' : 'dict of renko parameters; call `mpf.kwarg_help("renko_params")`',
-                                        'Validator'   : lambda value: isinstance(value,dict) },
-
-        'pnf_params'                : { 'Default'     : dict(),
-                                        'Description' : 'dict of point-and-figure parameters; call `mpf.kwarg_help("pnf_params")`',
-                                        'Validator'   : lambda value: isinstance(value,dict) },
- 
-        'study'                     : { 'Default'     : None,
-                                        'Description' : 'kwarg not implemented',
-                                        'Validator'   : lambda value: _kwarg_not_implemented(value) }, 
- 
-        'marketcolor_overrides'     : { 'Default'     : None, 
-                                        'Description' : 'sequence of color objects to override market colors.'+
-                                                        'sequence must be same length as ohlc(v) DataFrame. Each'+
-                                                        'color object may be a color, marketcolor object, or None.',
-                                        'Validator'   : _mco_validator },
- 
-        'mco_faceonly'              : { 'Default'     : False, # If True: Override only the face of the candle
-                                        'Description' : 'True/False marketcolor_overrides only apply to face of candle.',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
- 
-        'no_xgaps'                  : { 'Default'     : True,  # None means follow default logic below:
-                                        'Description' : 'deprecated',
-                                        'Validator'   : lambda value: _warn_no_xgaps_deprecated(value) },
- 
-        'show_nontrading'           : { 'Default'     : False, 
-                                        'Description' : 'True/False show spaces for non-trading days/periods',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
- 
-        'figscale'                  : { 'Default'     : None, # scale base figure size up or down.
-                                        'Description' : 'Scale figure size up (if > 1) or down (if < 1)',
-                                        'Validator'   : lambda value: isinstance(value,float) or isinstance(value,int) },
- 
-        'figratio'                  : { 'Default'     : None, # aspect ratio; scaled to 8.0 height
-                                        'Description' : 'Aspect ratio of the figure. Default: (8.00,5.75)',
-                                        'Validator'   : lambda value: isinstance(value,(tuple,list))
-                                                                      and len(value) == 2
-                                                                      and isinstance(value[0],(float,int))
-                                                                      and isinstance(value[1],(float,int)) },
- 
-        'figsize'                   : { 'Default'     : None,  # figure size; overrides figratio and figscale
-                                        'Description' : ('Figure size: overrides both figscale and figratio,'+
-                                                        ' else defaults to figratio*figscale'),
-                                        'Validator'   : lambda value: isinstance(value,(tuple,list))
-                                                                      and len(value) == 2
-                                                                      and isinstance(value[0],(float,int))
-                                                                      and isinstance(value[1],(float,int)) },
-
-        'fontscale'                 : { 'Default'     : None, # scale all fonts up or down
-                                        'Description' : 'Scale font sizes up (if > 1) or down (if < 1)',
-                                        'Validator'   : lambda value: isinstance(value,float) or isinstance(value,int) },
- 
-        'linecolor'                 : { 'Default'     : None, # line color in line plot
-                                        'Description' : 'Line color for `type=line`',
-                                        'Validator'   : lambda value: mcolors.is_color_like(value) },
-
-        'title'                     : { 'Default'     : None, # Figure Title
-                                        'Description' : 'Figure Title (see also `axtitle`)',
-                                        'Validator'   : lambda value: isinstance(value,(str,dict)) },
- 
-        'axtitle'                   : { 'Default'     : None, # Axes Title (subplot title)
-                                        'Description' : 'Axes Title (subplot title)',
-                                        'Validator'   : lambda value: isinstance(value,(str,dict)) },
-                                        
-        'xlabel'                    : { 'Default'     : 'Date', # x-axis label
-                                        'Description' : 'label for x-axis of main plot',
-                                        'Validator'   : lambda value: isinstance(value,str) },
- 
-        'ylabel'                    : { 'Default'     : 'Price', # y-axis label
-                                        'Description' : 'label for y-axis of main plot',
-                                        'Validator'   : lambda value: isinstance(value,str) },
- 
-        'ylabel_lower'              : { 'Default'     : None, # y-axis label default logic below
-                                        'Description' : 'label for y-axis of volume',
-                                        'Validator'   : lambda value: isinstance(value,str) },
- 
-        'addplot'                   : { 'Default'     : None, 
-                                        'Description' : 'addplot object or sequence of addplot objects (from `mpf.make_addplot()`)',
-                                        'Validator'   : lambda value: isinstance(value,dict) or (isinstance(value,list) and all([isinstance(d,dict) for d in value])) },
- 
-        'savefig'                   : { 'Default'     : None, 
-                                        'Description' : 'file name, or BytesIO, or dict with key `fname` plus other keys allowed as '+
-                                                        ' kwargs to matplotlib `Figure.savefig()`',
-                                        'Validator'   : lambda value: isinstance(value,dict) or isinstance(value,str) or isinstance(value, io.BytesIO) or isinstance(value, os.PathLike) },
- 
-        'block'                     : { 'Default'     : None, 
-                                        'Description' : 'True/False wait for figure to be closed before returning',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
- 
-        'returnfig'                 : { 'Default'     : False, 
-                                        'Description' : 'return Figure and list of Axes objects created by mplfinance;'+
-                                                        ' user must display plot when ready, usually by calling `mpf.show()`',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
-
-        'return_calculated_values'  : { 'Default'     : None,
-                                        'Description' : 'set to a variable containing an empty dict; `mpf.plot()` will fill'+
-                                                        ' the dict with various mplfinance calculated values',
-                                        'Validator'   : lambda value: isinstance(value, dict) and len(value) == 0},
-
-        'set_ylim'                  : { 'Default'     : None,
-                                        'Description' : 'deprecated',
-                                        'Validator'   : lambda value: _warn_set_ylim_deprecated(value) },
- 
-        'ylim'                      : { 'Default'     : None,
-                                        'Description' : 'Limits for y-axis as tuple (min,max), i.e. (bottom,top)',
-                                        'Validator'   : lambda value: isinstance(value, (list,tuple)) and len(value) == 2 
-                                                                      and all([isinstance(v,(int,float)) for v in value])},
- 
-        'xlim'                      : { 'Default'     : None,
-                                        'Description' : 'Limits for x-axis as tuple (min,max), i.e. (left,right)',
-                                        'Validator'   : lambda value: _xlim_validator(value) },
- 
-        'set_ylim_panelB'           : { 'Default'     : None,
-                                        'Description' : 'deprecated',
-                                        'Validator'   : lambda value: _warn_set_ylim_deprecated(value) },
- 
-        'hlines'                    : { 'Default'     : None, 
-                                        'Description' : 'Draw one or more HORIZONTAL LINES across entire plot, by'+
-                                                        ' specifying a price, or sequence of prices.  May also be a dict'+
-                                                        ' with key `hlines` specifying a price or sequence of prices, plus'+
-                                                        ' one or more of the following keys: `colors`, `linestyle`,'+
-                                                        ' `linewidths`, `alpha`.',
-                                        'Validator'   : lambda value: _hlines_validator(value) },
- 
-        'vlines'                    : { 'Default'     : None, 
-                                        'Description' : 'Draw one or more VERTICAL LINES across entire plot, by'+
-                                                        ' specifying a date[time], or sequence of date[time].  May also'+
-                                                        ' be a dict with key `vlines` specifying a date[time] or sequence'+
-                                                        ' of date[time], plus one or more of the following keys:'+
-                                                        ' `colors`, `linestyle`, `linewidths`, `alpha`.',
-                                        'Validator'   : lambda value: _vlines_validator(value) },
-
-        'alines'                    : { 'Default'     : None, 
-                                        'Description' : 'Draw one or more ARBITRARY LINES anywhere on the plot, by'+
-                                                        ' specifying a sequence of two or more date/price pairs, or by'+
-                                                        ' specifying a sequence of sequences of two or more date/price pairs.'+
-                                                        ' May also be a dict with key `alines` (as date/price pairs described above),'+
-                                                        ' plus one or more of the following keys:'+
-                                                        ' `colors`, `linestyle`, `linewidths`, `alpha`.',
-                                        'Validator'   : lambda value: _alines_validator(value) },
- 
-        'tlines'                    : { 'Default'     : None, 
-                                        'Description' : 'Draw one or more TREND LINES by specifying one or more pairs of date[times]'+
-                                                        ' between which each trend line should be drawn.  May also be a dict with key'+
-                                                        ' `tlines` as just described, plus one or more of the following keys:'+
-                                                        ' `colors`, `linestyle`, `linewidths`, `alpha`, `tline_use`,`tline_method`.',
-                                        'Validator'   : lambda value: _tlines_validator(value) },
-       
-        'panel_ratios'              : { 'Default'     : None,
-                                        'Description' : 'sequence of numbers indicating relative sizes of panels; sequence len'+
-                                                        ' must be same as number of panels, or len 2 where first entry is for'+
-                                                        ' main panel, and second entry is for all other panels',
-                                        'Validator'   : lambda value: isinstance(value,(tuple,list)) and len(value) <= 32 and
-                                                                      all([isinstance(v,(int,float)) for v in value]) },
-
-        'main_panel'                : { 'Default'     : 0,
-                                        'Description' : 'integer - which panel is the main panel for `.plot()`',
-                                        'Validator'   : lambda value: _valid_panel_id(value) },
-
-        'volume_panel'              : { 'Default'     : 1,
-                                        'Description' : 'integer - which panel is the volume panel',
-                                        'Validator'   : lambda value: _valid_panel_id(value) },
-
-        'num_panels'                : { 'Default'     : None,
-                                        'Description' : 'total number of panels',
-                                        'Validator'   : lambda value: isinstance(value,int) and value in range(1,32+1) },
-
-        'datetime_format'           : { 'Default'     : None,
-                                        'Description' : 'x-axis tick format as valid `strftime()` format string',
-                                        'Validator'   : lambda value: isinstance(value,str) },
-
-        'xrotation'                 : { 'Default'     : 45,
-                                        'Description' : 'Angle (degrees) for x-axis tick labels; 90=vertical',
-                                        'Validator'   : lambda value: isinstance(value,(int,float)) },
-
-        'axisoff'                   : { 'Default'     : False,
-                                        'Description' : '`axisoff=True` means do NOT display any axis.',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
-
-        'closefig'                  : { 'Default'     : 'auto',
-                                        'Description' : 'True|False close the Figure before returning',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
-
-        'fill_between'              : { 'Default'     : None,
-                                        'Description' : 'fill between specification as y-value, or sequence of'+
-                                                        ' y-values, or dict containing key "y1" plus any additional'+
-                                                        ' kwargs for `fill_between()`',
-                                        'Validator'   : _fill_between_validator },
-
-        'tight_layout'              : { 'Default'     : False,
-                                        'Description' : 'True|False implement tight layout (minimal padding around Figure)'+
-                                                        ' (see also `scale_padding` kwarg)',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
-
-        'scale_padding'             : { 'Default'     : 1.0,   # Issue#193 
-                                        'Description' : 'Increase, > 1.0, or decrease, < 1.0, padding around figure.'+
-                                                        ' May also be a dict containing one or more of the following keys:'+
-                                                        ' "top", "bottom", "left", "right", to individual scale padding'+
-                                                        ' on each side of Figure.',
-                                        'Validator'   : lambda value: _scale_padding_validator(value) },
-
-        'width_adjuster_version'    : { 'Default'     : 'v1',
-                                        'Description' : 'specify version of object width adjustment algorithm: "v0" or "v1"'+
-                                                        ' (See also "widths" tutorial in mplfinance examples folder).',
-                                        'Validator'   : lambda value: value in ('v0', 'v1') },
-
-        'scale_width_adjustment'    : { 'Default'     : None,
-                                        'Description' : 'scale width of plot objects wider, > 1.0, or narrower, < 1.0'+
-                                                        ' may also be a dict to scale individual widths.'+
-                                                        ' (See also "widths" tutorial in mplfinance examples folder).',
-                                        'Validator'   : lambda value: isinstance(value,dict) and len(value) > 0 },
-
-        'update_width_config'       : { 'Default'     : None,
-                                        'Description' : 'dict - update individual items in width configuration.'+
-                                                        ' (See also "widths" tutorial in mplfinance examples folder).',
-                                        'Validator'   : lambda value: isinstance(value,dict) and len(value) > 0 },
-
-        'return_width_config'       : { 'Default'     : None,
-                                        'Description' : 'empty dict variable to be filled with width configuration settings.',
-                                        'Validator'   : lambda value: isinstance(value,dict) and len(value)==0 },
-
-        'saxbelow'                  : { 'Default'     : True,  # Issue#115 Comment#639446764
-                                        'Description' : 'set the volume Axes below (behind) all other Axes objects',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
-        
-        'ax'                        : { 'Default'     : None,
-                                        'Description' : 'Matplotlib Axes object on which to plot',
-                                        'Validator'   : lambda value: isinstance(value,mpl_axes.Axes) },
-
-        'volume_exponent'           : { 'Default'     : None,
-                                        'Description' : 'integer exponent on the volume axis'+
-                                                        ' (or set to "legacy" for old mplfinance style)',
-                                        'Validator'   : lambda value: isinstance(value,int) or value == 'legacy'},
-
-        'tz_localize'               : { 'Default'     : True,
-                                        'Description' : 'True|False localize the times in the DatetimeIndex',
-                                        'Validator'   : lambda value: isinstance(value,bool) },
-
-        'yscale'                    : { 'Default'     : None,
-                                        'Description' : 'y-axis scale: "linear", "log", "symlog", or "logit"',
-                                        'Validator'   : lambda value: _yscale_validator(value) },
-
-        'volume_yscale'             : { 'Default'     : None,
-                                        'Description' : 'Volume y-axis scale: "linear", "log", "symlog", or "logit"',
-                                        'Validator'   : lambda value: _yscale_validator(value) },
-
-        'volume_ylim'               : { 'Default'     : None,
-                                        'Description' : 'Volume y-axis limits as tuple (min,max), i.e. (bottom,top)',
-                                        'Validator'   : lambda value: isinstance(value, (list,tuple)) and len(value) == 2
-                                                        and all([isinstance(v,(int,float)) for v in value])},
-
-        'volume_alpha'              : { 'Default'     : 1,  # alpha of Volume bars
-                                        'Description' : 'opacity for Volume bar: 0.0 (transparent) to 1.0 (opaque)',
-                                        'Validator'   : lambda value: isinstance(value,(int,float)) or
-                                                        all([isinstance(v,(int,float)) for v in value]) },
-
-        'warn_too_much_data'        : { 'Default'     : 599,
-                                        'Description' : 'Tolerance for data amount in plot. Default=599 rows.'+
-                                                        ' Values greater than \'warn_too_much_data\' will trigger a warning.',
-                                        'Validator'   : lambda value: isinstance(value,int) },
-    }
-
-    _validate_vkwargs_dict(vkwargs)
-
-    return vkwargs
-
-###@with_rc_context
-def plot( data, **kwargs ):
-    """
-    Given a Pandas DataFrame containing columns Open,High,Low,Close and optionally Volume
-    with a DatetimeIndex, plot the data.
-    Available plots include ohlc bars, candlestick, and line plots.
-    Also provide visually analysis in the form of common technical studies, such as:
-    moving averages, renko, etc.
-    Also provide ability to plot trading signals, and/or addtional user-defined data.
-    """
-
-    config = _process_kwargs(kwargs, _valid_plot_kwargs())
-
-    # translate alias types:
-    config['type'] = _get_valid_plot_types(config['type'])
-    
-    dates,opens,highs,lows,closes,volumes = _check_and_prepare_data(data, config)
-
-    config['xlim'] = _check_and_convert_xlim_configuration(data, config)
-
-    if config['type'] in VALID_PMOVE_TYPES and config['addplot'] is not None:
-        err = "`addplot` is not supported for `type='" + config['type'] +"'`"
-        raise ValueError(err)
-
-    if config['marketcolor_overrides'] is not None:
-        if len(config['marketcolor_overrides']) != len(dates):
-            raise ValueError('`marketcolor_overrides` must be same length as dataframe.')
-
-    external_axes_mode = _check_for_external_axes(config)
-
-    if external_axes_mode:
-        if config['figscale'] is not None:
-            warnings.warn('\n\n ================================================================= '+
-                          '\n\n   WARNING: `figscale` has NO effect in External Axes Mode.'+
-                          '\n\n ================================================================ ',
-                          category=UserWarning)
-        if config['figratio'] is not None:
-            warnings.warn('\n\n ================================================================= '+
-                          '\n\n   WARNING: `figratio` has NO effect in External Axes Mode.'+
-                          '\n\n ================================================================ ',
-                          category=UserWarning)
-        if config['figsize'] is not None:
-            warnings.warn('\n\n ================================================================= '+
-                          '\n\n   WARNING: `figsize` has NO effect in External Axes Mode.'+
-                          '\n\n ================================================================ ',
-                          category=UserWarning)
-    else:
-        if config['figscale'] is None: config['figscale'] = 1.0
-        if config['figratio'] is None: config['figratio'] = DEFAULT_FIGRATIO
-
-    style = config['style']
-
-    if external_axes_mode and hasattr(config['ax'],'mpfstyle') and style is None:
-        style = config['ax'].mpfstyle
-    elif style is None:
-        style = 'default'
-
-    if isinstance(style,str):
-        style = _styles._get_mpfstyle(style)
-
-    config['style'] = style
-
-    if isinstance(style,dict):
-        if not external_axes_mode: _styles._apply_mpfstyle(style)
-    else:
-        raise TypeError('style should be a `dict`; why is it not?')
-
-    if not external_axes_mode:
-        fig = plt.figure()
-        _adjust_figsize(fig,config)
-    else:
-        fig = None
-
-    _adjust_fontsize(config)
-
-    if config['volume'] and volumes is None:
-        raise ValueError('Request for volume, but NO volume data.')
-
-    if external_axes_mode:
-        panels = None
-        axA1   = config['ax']
-        axA1.set_axisbelow(config['saxbelow'])
-        if config['volume']:
-            volumeAxes = config['volume']
-            volumeAxes.set_axisbelow(config['saxbelow'])
-    else:
-        panels = _build_panels(fig, config)
-        axA1 = panels.at[config['main_panel'],'axes'][0]
-        if config['volume']:
-            if config['volume_panel'] == config['main_panel']:
-                # ohlc and volume on same panel: move volume to secondary axes:
-                volumeAxes = panels.at[config['volume_panel'],'axes'][1]
-                volumeAxes.set_zorder(axA1.get_zorder()-0.1) # Make sure ohlc is above volume
-                axA1.patch.set_visible(False)                # Let volume show through
-                panels.at[config['main_panel'],'used2nd'] = True
-            else:
-                volumeAxes = panels.at[config['volume_panel'],'axes'][0]
-        else:
-            volumeAxes = None
-
-    fmtstring = _determine_format_string(dates, config['datetime_format'])
-
-    ptype = config['type'] 
-
-    if config['show_nontrading']:
-        formatter = mdates.DateFormatter(fmtstring)
-        xdates = dates
-    else:
-        formatter = IntegerIndexDateTimeFormatter(dates, fmtstring)
-        xdates = np.arange(len(dates))
-
-    # Will have to handle widths config separately for PMOVE types ??
-    config['_width_config'] = _determine_width_config(xdates, config)
-
-    rwc = config['return_width_config']
-    if isinstance(rwc,dict) and len(rwc)==0:
-        config['return_width_config'].update(config['_width_config'])
-
-    collections = None
-    if ptype == 'line':
-        lw = config['_width_config']['line_width']
-        axA1.plot(xdates, closes, color=config['linecolor'], linewidth=lw)
-    else:
-        collections =_construct_mpf_collections(ptype,dates,xdates,opens,highs,lows,closes,volumes,config,style)
-
-    if ptype in VALID_PMOVE_TYPES:
-        collections, calculated_values = collections
-        volumes       = calculated_values['volumes']
-        pmove_dates   = calculated_values['dates']
-        pmove_values  = calculated_values['values']
-        if all([isinstance(v,(list,tuple)) for v in pmove_values]):
-            pmove_avgvals = [sum(v)/len(v) for v in pmove_values]
-        else:
-            pmove_avgvals = pmove_values
-        pmove_size    = calculated_values['size']
-        pmove_counts  = calculated_values['counts'] if 'counts' in calculated_values else None
-        formatter = IntegerIndexDateTimeFormatter(pmove_dates, fmtstring)
-        xdates = np.arange(len(pmove_dates))
-
-    if collections is not None:
-        for collection in collections:
-            axA1.add_collection(collection)
-
-    if ptype in VALID_PMOVE_TYPES:
-        mavprices = _plot_mav(axA1,config,xdates,pmove_avgvals)
-    else:
-        mavprices = _plot_mav(axA1,config,xdates,closes)
-
-    avg_dist_between_points = (xdates[-1] - xdates[0]) / float(len(xdates))
-    if not config['tight_layout']:
-        minx = xdates[0]  - avg_dist_between_points
-        maxx = xdates[-1] + avg_dist_between_points
-    else:
-        minx = xdates[0]  - (0.45 * avg_dist_between_points)
-        maxx = xdates[-1] + (0.45 * avg_dist_between_points)
-
-    if len(xdates) == 1:  # kludge special case
-        minx = minx - 0.75
-        maxx = maxx + 0.75
-    if ptype not in VALID_PMOVE_TYPES:
-        _lows  = lows
-        _highs = highs
-    else:
-        _lows  = pmove_avgvals
-        _highs = [value+pmove_size for value in pmove_avgvals]
-
-    miny = np.nanmin(_lows)
-    maxy = np.nanmax(_highs)
-
-    if config['ylim'] is not None:
-        axA1.set_ylim(config['ylim'][0], config['ylim'][1])
-    elif config['tight_layout']:
-        ydelta = 0.01 * (maxy-miny)
-        if miny > 0.0:
-            # don't let it go negative:
-            setminy = max(0.9*miny,miny-ydelta)
-        else:
-            setminy = miny-ydelta
-        axA1.set_ylim(setminy,maxy+ydelta)
-
-    if config['xlim'] is not None:
-        axA1.set_xlim(config['xlim'][0], config['xlim'][1])
-    elif config['tight_layout']:
-        axA1.set_xlim(minx,maxx)
-
-    if (config['ylim'] is None and
-        config['xlim'] is None and
-        not config['tight_layout']):
-        corners = (minx, miny), (maxx, maxy)
-        axA1.update_datalim(corners)
-
-    if config['return_calculated_values'] is not None:
-        retdict = config['return_calculated_values']
-        if ptype == 'renko':
-            retdict['renko_bricks' ] = pmove_values
-            retdict['renko_dates'  ] = mdates.num2date(pmove_dates)
-            retdict['renko_size'   ] = pmove_size
-            retdict['renko_volumes'] = volumes if config['volume'] else None
-        elif ptype == 'pnf':
-            retdict['pnf_dates'    ] = mdates.num2date(pmove_dates)
-            retdict['pnf_counts'   ] = pmove_counts
-            retdict['pnf_values'   ] = pmove_values
-            retdict['pnf_avgvals'  ] = pmove_avgvals
-            retdict['pnf_size'     ] = pmove_size
-            retdict['pnf_volumes'  ] = volumes if config['volume'] else None
-        if config['mav'] is not None:
-            mav = config['mav']
-            if len(mav) != len(mavprices):
-                warnings.warn('len(mav)='+str(len(mav))+' BUT len(mavprices)='+str(len(mavprices)))
-            else:
-                for jj in range(0,len(mav)):     
-                    retdict['mav' + str(mav[jj])] = mavprices[jj]
-        retdict['minx'] = minx
-        retdict['maxx'] = maxx
-        retdict['miny'] = miny
-        retdict['maxy'] = maxy
-
-    # Note: these are NOT mutually exclusive, so the order of this
-    #       if/elif is important: VALID_PMOVE_TYPES must be first.
-    if ptype in VALID_PMOVE_TYPES:
-        dtix = pd.DatetimeIndex([dt for dt in mdates.num2date(pmove_dates)])
-    elif not config['show_nontrading']:
-        dtix = data.index
-    else:
-        dtix = None
-
-    line_collections = []
-    line_collections.append(_construct_aline_collections(config['alines'], dtix))
-    line_collections.append(_construct_hline_collections(config['hlines'], minx, maxx))
-    line_collections.append(_construct_vline_collections(config['vlines'], dtix, miny, maxy))
-    tlines = config['tlines']
-    if isinstance(tlines,(list,tuple)) and all([isinstance(item,dict) for item in tlines]):
-        pass
-    else:
-        tlines = [tlines,]
-    for tline_item in tlines:
-        line_collections.append(_construct_tline_collections(tline_item, dtix, dates, opens, highs, lows, closes))
-     
-    for collection in line_collections:
-        if collection is not None:
-            axA1.add_collection(collection)
-
-    datalen = len(xdates)
-    if config['volume']:
-        vup,vdown = style['marketcolors']['volume'].values()
-        #-- print('vup,vdown=',vup,vdown)
-        vcolors = _updown_colors(vup, vdown, opens, closes, use_prev_close=style['marketcolors']['vcdopcod'])
-        #-- print('len(vcolors),len(opens),len(closes)=',len(vcolors),len(opens),len(closes))
-        #-- print('vcolors=',vcolors)
-
-        w  = config['_width_config']['volume_width']
-        lw = config['_width_config']['volume_linewidth']
-
-        adjc = _adjust_color_brightness(vcolors,0.90)
-        valp = config['volume_alpha']
-        volumeAxes.bar(xdates,volumes,width=w,linewidth=lw,color=vcolors,ec=adjc,alpha=valp)
-        if config['volume_ylim'] is not None:
-            vymin = config['volume_ylim'][0]
-            vymax = config['volume_ylim'][1]
-        else:
-            vymin = 0.3 * np.nanmin(volumes)
-            vymax = 1.1 * np.nanmax(volumes)
-        volumeAxes.set_ylim(vymin,vymax)
-
-    xrotation = config['xrotation']
-    if not external_axes_mode:
-        _set_ticks_on_bottom_panel_only(panels,formatter,rotation=xrotation)
-    else:
-        axA1.tick_params(axis='x',rotation=xrotation)
-        axA1.xaxis.set_major_formatter(formatter)
-
-    ysd = config['yscale']
-    if isinstance(ysd,dict):
-        yscale = ysd['yscale']
-        del      ysd['yscale']
-        axA1.set_yscale(yscale,**ysd)
-    elif isinstance(ysd,str):
-        axA1.set_yscale(ysd)
- 
-
-    addplot = config['addplot']
-    if addplot is not None and ptype not in VALID_PMOVE_TYPES:
-        # NOTE: If in external_axes_mode, then all code relating
-        #       to panels and secondary_y becomes irrrelevant.
-        #       If the user wants something on a secondary_y then user should
-        #       determine that externally, and pass in the appropriate axes.
-
-        if not external_axes_mode:
-            # Calculate the Order of Magnitude Range ('mag')
-            # If addplot['secondary_y'] == 'auto', then: If the addplot['data']
-            # is out of the Order of Magnitude Range, then use secondary_y.
-
-            lo = math.log(max(math.fabs(np.nanmin(lows)),1e-7),10) - 0.5
-            hi = math.log(max(math.fabs(np.nanmax(highs)),1e-7),10) + 0.5
-
-            panels['mag'] = [None]*len(panels)  # create 'mag'nitude column
-
-            panels.at[config['main_panel'],'mag'] = {'lo':lo,'hi':hi} # update main panel magnitude range
-
-            if config['volume']:
-                lo = math.log(max(math.fabs(np.nanmin(volumes)),1e-7),10) - 0.5
-                hi = math.log(max(math.fabs(np.nanmax(volumes)),1e-7),10) + 0.5
-                panels.at[config['volume_panel'],'mag'] = {'lo':lo,'hi':hi}
-
-        if isinstance(addplot,dict):
-            addplot = [addplot,]   # make list of dict to be consistent
-
-        elif not _list_of_dict(addplot):
-            raise TypeError('addplot must be `dict`, or `list of dict`, NOT '+str(type(addplot)))
-
-        for apdict in addplot:
-
-            panid = apdict['panel'] 
-            if not external_axes_mode:
-                if   panid == 'main' : panid = 0  # for backwards compatibility
-                elif panid == 'lower': panid = 1  # for backwards compatibility
-                if apdict['y_on_right'] is not None:
-                    panels.at[panid,'y_on_right'] = apdict['y_on_right']
-
-            aptype = apdict['type']
-            if aptype == 'ohlc' or aptype == 'candle':
-                ax = _addplot_collections(panid,panels,apdict,xdates,config)
-                _addplot_apply_supplements(ax,apdict,xdates)
-            else:         
-                apdata = apdict['data']
-                if isinstance(apdata,list) and not isinstance(apdata[0],(float,int)):
-                    raise TypeError('apdata is list but NOT of float or int')
-                if isinstance(apdata,pd.DataFrame): 
-                    havedf = True
-                else:
-                    havedf = False      # must be a single series or array
-                    apdata = [apdata,]  # make it iterable
-                for column in apdata:
-                    ydata = apdata.loc[:,column] if havedf else column
-                    ax = _addplot_columns(panid,panels,ydata,apdict,xdates,config)
-                    _addplot_apply_supplements(ax,apdict,xdates)
-
-    # fill_between is NOT supported for external_axes_mode
-    # (caller can easily call ax.fill_between() themselves).
-    if config['fill_between'] is not None and not external_axes_mode:
-        fblist = copy.deepcopy(config['fill_between'])
-        if _num_or_seq_of_num(fblist):
-            fblist = [dict(y1=fblist),]
-        elif isinstance(fblist,dict):
-            fblist = [fblist,]
-        if not _list_of_dict(fblist):
-            raise TypeError('Bad type for `fill_between` specifier.')
-        for fb in fblist:
-            if 'x' in fb:
-                raise ValueError('fill_between dict may not contain `x`')
-            panid = config['main_panel']
-            if 'panel' in fb:
-                panid = fb['panel']
-                del fb['panel']
-            fb['x'] = xdates # add 'x' to caller's fb dict
-            ax = panels.at[panid,'axes'][0]
-            ax.fill_between(**fb)
-            
-    # put the primary axis on one side,
-    # and the twinx() on the "other" side:
-    if not external_axes_mode:
-        for panid,row in panels.iterrows():
-            ax = row['axes']
-            y_on_right = style['y_on_right'] if row['y_on_right'] is None else row['y_on_right']
-            _set_ylabels_side(ax[0],ax[1],y_on_right)
-    else:
-        y_on_right = style['y_on_right']
-        _set_ylabels_side(axA1,None,y_on_right)
-
-    # TODO: ================================================================
-    # TODO:  Investigate:
-    # TODO:  ===========
-    # TODO:  It appears to me that there may be some or significant overlap
-    # TODO:  between what the following functions actually do:
-    # TODO:  At the very least, all four of them appear to communicate 
-    # TODO:  to matplotlib that the xaxis should be treated as dates:
-    # TODO:   ->  'ax.autoscale_view()'
-    # TODO:   ->  'ax.xaxis_dates()'
-    # TODO:   ->  'plt.autofmt_xdates()'
-    # TODO:   ->  'fig.autofmt_xdate()'
-    # TODO: ================================================================
-    
-
-    #if config['autofmt_xdate']:
-        #print('CALLING fig.autofmt_xdate()')
-        #fig.autofmt_xdate()
-
-    axA1.autoscale_view()  # Is this really necessary??
-                           # It appears to me, based on experience coding types 'ohlc' and 'candle'
-                           # for `addplot`, that this IS necessary when the only thing done to the
-                           # the axes is .add_collection().  (However, if ax.plot() .scatter() or
-                           # .bar() was called, then possibly this is not necessary; not entirely
-                           # sure, but it definitely was necessary to get 'ohlc' and 'candle' 
-                           # working in `addplot`).
-
-    axA1.set_ylabel(config['ylabel'])
-    axA1.set_xlabel(config['xlabel'])
-
-    if config['volume']:
-        if external_axes_mode:
-            volumeAxes.tick_params(axis='x',rotation=xrotation)
-            volumeAxes.xaxis.set_major_formatter(formatter)
-
-        vscale = 'linear'
-        ysd = config['volume_yscale']
-        if isinstance(ysd,dict):
-            yscale = ysd['yscale']
-            del      ysd['yscale']
-            volumeAxes.set_yscale(yscale,**ysd)
-            vscale = yscale
-        elif isinstance(ysd,str):
-            volumeAxes.set_yscale(ysd)
-            vscale = ysd
-        offset = ''
-        if vscale == 'linear':
-            vxp = config['volume_exponent']
-            if vxp == 'legacy':
-                volumeAxes.figure.canvas.draw()  # This is needed to calculate offset
-                offset = volumeAxes.yaxis.get_major_formatter().get_offset()
-                if len(offset) > 0:
-                    offset = (' x '+offset)
-            elif isinstance(vxp,int) and vxp > 0:
-                volumeAxes.ticklabel_format(useOffset=False,scilimits=(vxp,vxp),axis='y')
-                offset = '  $10^{'+str(vxp)+'}$'
-            elif isinstance(vxp,int) and vxp == 0:
-                volumeAxes.ticklabel_format(useOffset=False,style='plain',axis='y')
-                offset = ''
-            else:
-                offset = ''
-                scilims = plt.rcParams['axes.formatter.limits']
-                if scilims[0] < scilims[1]:
-                    for power in (5,4,3,2,1):
-                        xp = scilims[1]*power
-                        if vymax >= 10.**xp:
-                            volumeAxes.ticklabel_format(useOffset=False,scilimits=(xp,xp),axis='y')
-                            offset = '  $10^{'+str(xp)+'}$'
-                            break
-                elif scilims[0] == scilims[1] and scilims[1] != 0:
-                    volumeAxes.ticklabel_format(useOffset=False,scilimits=scilims,axis='y')
-                    offset = ' $10^'+str(scilims[1])+'$'
-            volumeAxes.yaxis.offsetText.set_visible(False)
-
-        if config['ylabel_lower'] is None:
-            vol_label = 'Volume'+offset
-        else:
-            if len(offset) > 0:
-                offset = '\n'+offset
-            vol_label = config['ylabel_lower'] + offset
-        volumeAxes.set_ylabel(vol_label)
-    
-    if config['title'] is not None:
-        if config['tight_layout']:
-            # IMPORTANT: `y=0.89` is based on the top of the top panel
-            #            being at 0.18+0.7 = 0.88.  See _panels.py
-            # If the value changes there, then it needs to change here.
-            title_kwargs = dict(va='bottom', y=0.89)
-        else:
-            title_kwargs = dict(va='center')
-        if isinstance(config['title'],dict):
-            title_dict = config['title']
-            if 'title' not in title_dict:
-                raise ValueError('Must have "title" entry in title dict')
-            else:
-                title = title_dict['title']
-                del title_dict['title']
-            title_kwargs.update(title_dict)  # allows override default values set by mplfinance above
-        else:
-            title = config['title']      # config['title'] is a string
-        fig.suptitle(title,**title_kwargs)
-    
-    
-    if config['axtitle'] is not None:
-        axA1.set_title(config['axtitle'])
-
-    if not external_axes_mode:
-        for panid,row in panels.iterrows():
-            if not row['used2nd']:
-                row['axes'][1].set_visible(False)
-
-    if external_axes_mode:
-        return None
-
-    # Should we create a new kwarg to return a flattened axes list
-    # versus a list of tuples of primary and secondary axes?
-    # For now, for backwards compatibility, we flatten axes list:
-    axlist = [ax for axes in panels['axes'] for ax in axes]
-
-    if config['axisoff']:
-        for ax in axlist:
-            ax.set_axis_off()
-
-    if config['savefig'] is not None:
-        save = config['savefig']
-        if isinstance(save,dict):
-            if config['tight_layout'] and 'bbox_inches' not in save:
-                fig.savefig(**save,bbox_inches='tight')
-            else:
-                fig.savefig(**save)
-        else:
-            if config['tight_layout']:
-                fig.savefig(save,bbox_inches='tight')
-            else:
-                fig.savefig(save)
-        if config['closefig']: # True or 'auto'
-            plt.close(fig)
-    elif not config['returnfig']:
-        plt.show(block=config['block']) # https://stackoverflow.com/a/13361748/1639359
-        if config['closefig'] == True or (config['block'] and config['closefig']):
-            plt.close(fig)
-    
-    if config['returnfig']:
-        if config['closefig'] == True: plt.close(fig)
-        return (fig, axlist)
-
-    # rcp   = copy.deepcopy(plt.rcParams)
-    # rcpdf = rcParams_to_df(rcp)
-    # print('type(rcpdf)=',type(rcpdf))
-    # print('rcpdfhead(3)=',rcpdf.head(3))
-    # return # rcpdf
-
-def _adjust_figsize(fig,config):
-    if fig is None:
-        return
-    if config['figsize'] is None:
-        w,h = config['figratio']
-        r = float(w)/float(h)
-        if r < 0.20 or r > 5.0:
-            raise ValueError('"figratio" (aspect ratio)  must be between 0.20 and 5.0 (but is '+str(r)+')')
-        default_scale = DEFAULT_FIGRATIO[1]/h
-        h *= default_scale
-        w *= default_scale
-        base      = (w,h)
-        figscale  = config['figscale']
-        fsize     = [d*figscale for d in base]
-    else:
-        fsize = config['figsize']
-    fig.set_size_inches(fsize)
-
-def _adjust_fontsize(config):
-    if config['fontscale'] is None:
-        return
-    if not isinstance(plt.rcParams['font.size'],(float,int)):
-        warnings.warn('\n\n ================================================================= '+
-                      '\n\n   WARNING: Unable to scale fonts: plt.rcParams["font.size"] is NOT a float!'+
-                      '\n\n ================================================================ ',
-                      category=UserWarning)
-        return
-    plt.rcParams['font.size'] *= config['fontscale']
-    # --------------------------------------------
-    # From: matplotlib.font_manager.font_scalings:
-    #    font_scalings = {
-    #        'xx-small': 0.579,
-    #        'x-small':  0.694,
-    #        'small':    0.833,
-    #        'medium':   1.0,
-    #        'large':    1.200,
-    #        'x-large':  1.440,
-    #        'xx-large': 1.728,
-    #        'larger':   1.2,
-    #        'smaller':  0.833,
-    #        None:       1.0,
-    #    }
-    # --------------------------------------------
-    fontstuff = ['axes.labelsize','axes.titlesize', 'figure.titlesize','legend.fontsize',
-                 'legend.title_fontsize','xtick.labelsize','ytick.labelsize']
-    for item in fontstuff:
-        if isinstance(plt.rcParams[item],(float,int)):
-            plt.rcParams[item] *= config['fontscale']
-
-def _addplot_collections(panid,panels,apdict,xdates,config):
-
-    apdata = apdict['data']
-    aptype = apdict['type']
-    external_axes_mode = apdict['ax'] is not None
-   
-    #--------------------------------------------------------------#
-    # Note: _auto_secondary_y() sets the 'magnitude' column in the
-    #       `panels` dataframe, which is needed for automatically
-    #       determining if secondary_y is needed.  Therefore we call
-    #       _auto_secondary_y() for *all* addplots, even those that
-    #       are set to True or False (not 'auto') for secondary_y
-    #       because their magnitudes may be needed if *any* apdicts
-    #       contain secondary_y='auto'.
-    #       In theory we could first loop through all apdicts to see
-    #       if any have secondary_y='auto', but since that is the
-    #       default value, we will just assume we have at least one.
-
-    valid_apc_types = ['ohlc','candle']
-    if aptype not in valid_apc_types:
-        raise TypeError('Invalid aptype='+str(aptype)+'. Must be one of '+str(valid_apc_types))
-    if not isinstance(apdata,pd.DataFrame):
-        raise TypeError('addplot type "'+aptype+'" MUST be accompanied by addplot data of type `pd.DataFrame`')
-    d,o,h,l,c,v = _check_and_prepare_data(apdata,config)
-    
-    mc = apdict['marketcolors']
-    if _is_marketcolor_object(mc):
-        apstyle = config['style'].copy()
-        apstyle['marketcolors'] = mc
-    else:
-        apstyle = config['style']
-    
-    collections = _construct_mpf_collections(aptype,d,xdates,o,h,l,c,v,config,apstyle)
-
-    if not external_axes_mode:
-        lo = math.log(max(math.fabs(np.nanmin(l)),1e-7),10) - 0.5
-        hi = math.log(max(math.fabs(np.nanmax(h)),1e-7),10) + 0.5
-        secondary_y = _auto_secondary_y( panels, panid, lo, hi )
-        if 'auto' != apdict['secondary_y']:
-            secondary_y = apdict['secondary_y'] 
-        if secondary_y:
-            ax = panels.at[panid,'axes'][1] 
-            panels.at[panid,'used2nd'] = True
-        else: 
-            ax = panels.at[panid,'axes'][0]
-    else:
-        ax = apdict['ax']
-
-    for coll in collections:
-        ax.add_collection(coll)
-    if apdict['mav'] is not None:
-        apmavprices = _plot_mav(ax,config,xdates,c,apdict['mav'])
-    ax.autoscale_view()
-    return ax
-
-def _addplot_columns(panid,panels,ydata,apdict,xdates,config):
-    external_axes_mode = apdict['ax'] is not None
-    if not external_axes_mode:
-        secondary_y = False
-        if apdict['secondary_y'] == 'auto':
-            yd = [y for y in ydata if not math.isnan(y)]
-            ymhi = math.log(max(math.fabs(np.nanmax(yd)),1e-7),10)
-            ymlo = math.log(max(math.fabs(np.nanmin(yd)),1e-7),10)
-            secondary_y = _auto_secondary_y( panels, panid, ymlo, ymhi )
-        else:
-            secondary_y = apdict['secondary_y']
-            #print("apdict['secondary_y'] says secondary_y is",secondary_y)
-
-        if secondary_y:
-            ax = panels.at[panid,'axes'][1] 
-            panels.at[panid,'used2nd'] = True
-        else: 
-            ax = panels.at[panid,'axes'][0]
-    else:
-        ax = apdict['ax']
-
-    aptype = apdict['type']
-    if aptype == 'scatter':
-        size  = apdict['markersize']
-        mark  = apdict['marker']
-        color = apdict['color']
-        alpha = apdict['alpha']
-        edgecolors  = apdict['edgecolors']
-        linewidths = apdict['linewidths']
-
-        if isinstance(mark,(list,tuple,np.ndarray)):
-            _mscatter(xdates, ydata, ax=ax, m=mark, s=size, color=color, alpha=alpha, edgecolors=edgecolors, linewidths=linewidths)
-        else:
-            ax.scatter(xdates, ydata, s=size, marker=mark, color=color, alpha=alpha, edgecolors=edgecolors, linewidths=linewidths)
-    elif aptype == 'bar':
-        width  = 0.8 if apdict['width'] is None else apdict['width']
-        bottom = apdict['bottom']
-        color  = apdict['color']
-        alpha  = apdict['alpha']
-        ax.bar(xdates,ydata,width=width,bottom=bottom,color=color,alpha=alpha)
-    elif aptype == 'line':
-        ls     = apdict['linestyle']
-        color  = apdict['color']
-        width  = apdict['width'] if apdict['width'] is not None else 1.6*config['_width_config']['line_width']
-        alpha  = apdict['alpha']
-        ax.plot(xdates,ydata,linestyle=ls,color=color,linewidth=width,alpha=alpha)
-    elif aptype == 'step':
-        stepwhere = apdict['stepwhere']
-        ls = apdict['linestyle']
-        color  = apdict['color']
-        width  = apdict['width'] if apdict['width'] is not None else 1.6*config['_width_config']['line_width']
-        alpha  = apdict['alpha']
-        ax.step(xdates,ydata,where = stepwhere,linestyle=ls,color=color,linewidth=width,alpha=alpha)
-    else:
-        raise ValueError('addplot type "'+str(aptype)+'" NOT yet supported.')
-
-    if apdict['mav'] is not None:
-        apmavprices = _plot_mav(ax,config,xdates,ydata,apdict['mav'])
-
-    return ax
-
-def _addplot_apply_supplements(ax,apdict,xdates):
-    if (apdict['ylabel'] is not None):
-        ax.set_ylabel(apdict['ylabel'])
-    if (apdict['xlabel'] is not None):
-        ax.set_xlabel(apdict['xlabel'])
-    if apdict['ylim'] is not None:
-        ax.set_ylim(apdict['ylim'][0],apdict['ylim'][1])
-    if apdict['title'] is not None:
-        ax.set_title(apdict['title'])
-    ysd = apdict['yscale']
-    if isinstance(ysd,dict):
-        yscale = ysd['yscale']
-        del      ysd['yscale']
-        ax.set_yscale(yscale,**ysd)
-    elif isinstance(ysd,str):
-        ax.set_yscale(ysd)
-    # added by Wen
-    if "fill_between" in apdict and apdict['fill_between'] is not None:
-        # deep copy because mplfinance code sometimes modifies the fill_between dict
-        fblist = copy.deepcopy(apdict['fill_between'])
-        if isinstance(fblist,dict):
-            fblist = [fblist,]
-        if _list_of_dict(fblist):
-            for fb in fblist:
-                if 'x' in fb:
-                    raise ValueError('fill_between dict may not contain `x`')
-                fb['x'] = xdates # add 'x' to caller's fb dict
-                ax.fill_between(**fb)
-        else:
-            raise ValueError('Invalid addplot fill_between: must be `dict` or `list of dict`')
-
-def _set_ylabels_side(ax_pri,ax_sec,primary_on_right):
-    # put the primary axis on one side,
-    # and the twinx() on the "other" side:
-    if primary_on_right == True:
-        ax_pri.yaxis.set_label_position('right')
-        ax_pri.yaxis.tick_right()
-        if ax_sec is not None:
-            ax_sec.yaxis.set_label_position('left')
-            ax_sec.yaxis.tick_left()
-    else:  # treat non-True as False, whether False, None, or anything else.
-        ax_pri.yaxis.set_label_position('left')
-        ax_pri.yaxis.tick_left()
-        if ax_sec is not None:
-            ax_sec.yaxis.set_label_position('right')
-            ax_sec.yaxis.tick_right()
-
-def _plot_mav(ax,config,xdates,prices,apmav=None,apwidth=None):
-    style = config['style']
-    if apmav is not None:
-        mavgs = apmav
-    else:
-        mavgs = config['mav']
-    mavp_list = []
-    if mavgs is not None:
-        shift = None
-        if isinstance(mavgs,dict):
-            shift = mavgs['shift']
-            mavgs = mavgs['period']
-        if isinstance(mavgs,int):
-            mavgs = mavgs,      # convert to tuple
-        if len(mavgs) > 7:
-            mavgs = mavgs[0:7]  # take at most 7
-     
-        if style['mavcolors'] is not None:
-            mavc = cycle(style['mavcolors'])
-        else:
-            mavc = None
-
-        for idx,mav in enumerate(mavgs):
-            mean = pd.Series(prices).rolling(mav).mean()
-            if shift is not None:
-                mean = mean.shift(periods=shift[idx])
-            mavprices = mean.values
-            lw = config['_width_config']['line_width']
-            if mavc:
-                ax.plot(xdates, mavprices, linewidth=lw, color=next(mavc))
-            else:
-                ax.plot(xdates, mavprices, linewidth=lw)
-            mavp_list.append(mavprices)
-    return mavp_list
-
-def _auto_secondary_y( panels, panid, ylo, yhi ):
-    # If mag(nitude) for this panel is not yet set, then set it
-    # here, as this is the first ydata to be plotted on this panel:
-    # i.e. consider this to be the 'primary' axis for this panel.
-    secondary_y = False
-    p = panid,'mag'
-    if panels.at[p] is None:
-        panels.at[p] = {'lo':ylo,'hi':yhi}
-    elif ylo < panels.at[p]['lo'] or yhi > panels.at[p]['hi']:
-        secondary_y = True
-    #if secondary_y:
-    #    print('auto says USE secondary_y ... for panel',panid)
-    #else:
-    #    print('auto says do NOT use secondary_y ... for panel',panid)
-    return secondary_y
-
-def _valid_addplot_kwargs():
-
-    valid_linestyles = ('-','solid','--','dashed','-.','dashdot','.','dotted',None,' ','')
-    valid_types = ('line','scatter','bar', 'ohlc', 'candle','step')
-    valid_stepwheres = ('pre','post','mid')
-    valid_edgecolors = ('face', 'none', None)
-
-    vkwargs = {
-        'scatter'     : { 'Default'     : False,
-                          'Description' : "Deprecated.  (Use kwarg `type='scatter' instead.",
-                          'Validator'   : lambda value: isinstance(value,bool) },
-
-        'type'        : { 'Default'     : 'line',
-                          'Description' : 'addplot type: "line","scatter","bar", "ohlc", "candle","step"',
-                          'Validator'   : lambda value: value in valid_types },
-
-        'mav'         : { 'Default'     : None,
-                          'Description' : 'Moving Average window size(s); (int or tuple of ints)',
-                          'Validator'   : _mav_validator },
-        
-        'panel'       : { 'Default'     : 0, 
-                          'Description' : 'Panel (int 0-31) to use for this addplot',
-                          'Validator'   : lambda value: _valid_panel_id(value) },
-
-        'marker'      : { 'Default'     : 'o',
-                          'Description' : "marker for `type='scatter'` plot",
-                          'Validator'   : lambda value: _bypass_kwarg_validation(value)  },
-
-        'markersize'  : { 'Default'     : 18,
-                          'Description' : 'size of marker for `type="scatter"`; default=18',
-                          'Validator'   : lambda value: isinstance(value,(int,float)) },
-
-        'color'       : { 'Default'     : None,
-                          'Description' : 'color (or sequence of colors) of line(s), scatter marker(s), or bar(s).',
-                          'Validator'   : lambda value: mcolors.is_color_like(value) or
-                                         (isinstance(value,(list,tuple,np.ndarray)) and all([mcolors.is_color_like(v) for v in value])) },
-
-        'linestyle'   : { 'Default'     : None,
-                          'Description' : 'line style for `type=line` ('+str(valid_linestyles)+')',
-                          'Validator'   : lambda value: value in valid_linestyles },
-
-        'linewidths'  : { 'Default': None,
-                          'Description' : 'edge widths of scatter markers',
-                          'Validator'   : lambda value: isinstance(value,(int,float)) },
-
-        'edgecolors'  : { 'Default': None,
-                          'Description' : 'edgecolors of scatter markers',
-                          'Validator': lambda value: mcolors.is_color_like(value) or value in valid_edgecolors},
-
-        'width'       : { 'Default'     : None, # width of `bar` or `line`
-                          'Description' : 'width of bar or line for `type="bar"` or `type="line"',
-                          'Validator'   : lambda value: isinstance(value,(int,float)) or
-                                                        all([isinstance(v,(int,float)) for v in value]) },
-
-        'bottom'      : { 'Default'     : 0,  # bottom for `type=bar` plots
-                          'Description' : 'bottom value for `type=bar` bars. Default=0',
-                          'Validator'   : lambda value: isinstance(value,(int,float)) or
-                                                        all([isinstance(v,(int,float)) for v in value]) },
-        'alpha'       : { 'Default'     : 1,  # alpha of `bar`, `line`, or `scatter`
-                          'Description' : 'opacity for 0.0 (transparent) to 1.0 (opaque)',
-                          'Validator'   : lambda value: isinstance(value,(int,float)) or
-                                                        all([isinstance(v,(int,float)) for v in value]) },
-
-        'secondary_y' : { 'Default'     : 'auto',
-                          'Description' : "True|False|'auto' place the additional plot data on a"+
-                                          " secondary y-axis.  'auto' compares the magnitude or the"+
-                                          " addplot data, to data already on the axis, and if it appears"+
-                                          " they are of different magnitudes, then it uses a secondary y-axis."+
-                                          " True or False always override 'auto'.",
-                          'Validator'   : lambda value: isinstance(value,bool) or value == 'auto' },
-
-        'y_on_right'  : { 'Default'     : None,
-                          'Description' : 'True|False put y-axis tick labels on the right, for this addplot'+
-                                          ' regardless of what the mplfinance style says to to.',
-                          'Validator'   : lambda value: isinstance(value,bool) },
-
-        'ylabel'      : { 'Default'     : None,
-                          'Description' : 'label for y-axis (for this addplot)',
-                          'Validator'   : lambda value: isinstance(value,str) },
-
-        'ylim'        : {'Default'      : None,
-                         'Description' : 'Limits for addplot y-axis as tuple (min,max), i.e. (bottom,top)',
-                         'Validator'    : lambda value: isinstance(value, (list,tuple)) and len(value) == 2 
-                                                                      and all([isinstance(v,(int,float)) for v in value])},
-
-        'title'       : { 'Default'     : None,
-                          'Description' : 'Axes Title (subplot title) for this addplot.',
-                          'Validator'   : lambda value: isinstance(value,str) },
-
-        'ax'          : { 'Default'      : None,
-                          'Description' : 'Matplotlib Axes object on which to plot this addplot',
-                          'Validator'    : lambda value: isinstance(value,mpl_axes.Axes) },
-
-        'yscale'      : { 'Default'     : None,
-                          'Description' : 'addplot y-axis scale: "linear", "log", "symlog", or "logit"',
-                          'Validator'   : lambda value: _yscale_validator(value) },
-
-        'stepwhere'   : { 'Default'     : 'pre',
-                          'Description' : "'pre','post', or 'mid': where to place step relative"+
-                                          " to data for `type='step'`",
-                          'Validator'   : lambda value : value in valid_stepwheres },                  
-        
-        'marketcolors': { 'Default'     : None, # use 'style' for default, instead.
-                          'Description' : "marketcolors for this addplot (instead of the mplfinance"+
-                                          " style\'s marketcolors).  For addplot `type='ohlc'`"+
-                                          " and type='candle'",
-                          'Validator'   : lambda value: _is_marketcolor_object(value) },
-        'fill_between': { 'Default'     : None,    # added by Wen
-                          'Description' : " fill region",
-                          'Validator'   : _fill_between_validator },
-
-    }
-
-    _validate_vkwargs_dict(vkwargs)
-
-    return vkwargs
-
-
-def make_addplot(data, **kwargs):
-    '''
-    Take data (pd.Series, pd.DataFrame, np.ndarray of floats, list of floats), and
-    kwargs (see valid_addplot_kwargs_table) and construct a correctly structured dict
-    to be passed into plot() using kwarg `addplot`.  
-    NOTE WELL: len(data) here must match the len(data) passed into plot()
-    '''
-    if not isinstance(data, (pd.Series, pd.DataFrame, np.ndarray, list)):
-        raise TypeError('Wrong type for data, in make_addplot()')
-
-    config = _process_kwargs(kwargs, _valid_addplot_kwargs())
-
-    # kwarg `type` replaces kwarg `scatter`
-    if config['scatter'] == True and config['type'] == 'line':
-        config['type'] = 'scatter'
-
-    return dict( data=data, **config)
diff --git a/dist/mplfinance-0.12.9b2-py3.10.egg b/dist/mplfinance-0.12.9b2-py3.10.egg
deleted file mode 100644
index 9fbe8be5d35e48c7adbbf480c38e88f18bfc4191..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 148059
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
bO>j9$7+}8&c=ZSV(E{&Axb(pLJH-D1o8XLc


From 8d93bec6d29bad1ebd2887b9901c09b83a8965df Mon Sep 17 00:00:00 2001
From: andrewrgarcia <andrewrgarcia@ufl.edu>
Date: Mon, 24 Oct 2022 15:41:25 -0400
Subject: [PATCH 11/22] Revert "made suggested changes and tested new ema
 option against baseline"

This reverts commit 95f0e332daa3e7260dbfc31775ff77a4242eefdf.
---
 src/mplfinance/plotting.py     | 1348 +++++++++++++++-----------------
 tests/test_ema.py              |   85 --
 tests/test_images/test_ema.png |  Bin 57100 -> 0 bytes
 3 files changed, 639 insertions(+), 794 deletions(-)
 delete mode 100644 tests/test_ema.py
 delete mode 100644 tests/test_images/test_ema.png

diff --git a/src/mplfinance/plotting.py b/src/mplfinance/plotting.py
index a04e9c65..c8bcb406 100644
--- a/src/mplfinance/plotting.py
+++ b/src/mplfinance/plotting.py
@@ -1,10 +1,10 @@
-import matplotlib.dates as mdates
+import matplotlib.dates  as mdates
 import matplotlib.pyplot as plt
 import matplotlib.colors as mcolors
-import matplotlib.axes as mpl_axes
+import matplotlib.axes   as mpl_axes
 import matplotlib.figure as mpl_fig
 import pandas as pd
-import numpy as np
+import numpy  as np
 import copy
 import io
 import os
@@ -14,7 +14,7 @@
 
 from itertools import cycle
 #from pandas.plotting import register_matplotlib_converters
-# register_matplotlib_converters()
+#register_matplotlib_converters()
 
 from mplfinance._utils import _construct_aline_collections
 from mplfinance._utils import _construct_hline_collections
@@ -51,8 +51,7 @@
 
 VALID_PMOVE_TYPES = ['renko', 'pnf']
 
-DEFAULT_FIGRATIO = (8.00, 5.75)
-
+DEFAULT_FIGRATIO = (8.00,5.75)
 
 def with_rc_context(func):
     '''
@@ -65,26 +64,24 @@ def decorator(*args, **kwargs):
             return func(*args, **kwargs)
     return decorator
 
-
 def _warn_no_xgaps_deprecated(value):
-    warnings.warn('\n\n ================================================================= ' +
-                  '\n\n   WARNING: `no_xgaps` is /deprecated/:' +
-                  '\n     Default value is now `no_xgaps=True`' +
-                  '\n     However, to set `no_xgaps=False` and silence this warning,' +
-                  '\n     use instead: `show_nontrading=True`.' +
+    warnings.warn('\n\n ================================================================= '+
+                  '\n\n   WARNING: `no_xgaps` is /deprecated/:'+
+                  '\n     Default value is now `no_xgaps=True`'+
+                  '\n     However, to set `no_xgaps=False` and silence this warning,'+
+                  '\n     use instead: `show_nontrading=True`.'+
                   '\n\n ================================================================ ',
                   category=DeprecationWarning)
-    return isinstance(value, bool)
-
+    return isinstance(value,bool)
 
 def _warn_set_ylim_deprecated(value):
-    warnings.warn('\n\n ================================================================= ' +
-                  '\n\n   WARNING: `set_ylim=(ymin,ymax)` kwarg ' +
-                  '\n             has been replaced with: ' +
-                  '\n            `ylim=(ymin,ymax)`.' +
+    warnings.warn('\n\n ================================================================= '+
+                  '\n\n   WARNING: `set_ylim=(ymin,ymax)` kwarg '+
+                    '\n             has been replaced with: '+
+                    '\n            `ylim=(ymin,ymax)`.'+
                   '\n\n ================================================================ ',
                   category=DeprecationWarning)
-    return isinstance(value, bool)
+    return isinstance(value,bool)
 
 
 def _valid_plot_kwargs():
@@ -101,299 +98,297 @@ def _valid_plot_kwargs():
     '''
 
     vkwargs = {
-        'columns': {'Default': None,  # use default names: ('Open', 'High', 'Low', 'Close', 'Volume')
-                    'Description': ('Column names to be used when plotting the data.' +
-                                    ' Default: ("Open", "High", "Low", "Close", "Volume")'),
-                    'Validator': lambda value: isinstance(value, (tuple, list))
-                    and len(value) == 5
-                    and all(isinstance(c, str) for c in value)},
-        'type': {'Default': 'ohlc',
-                 'Description': 'Plot type: '+str(_get_valid_plot_types()),
-                 'Validator': lambda value: value in _get_valid_plot_types()},
-
-        'style': {'Default': None,
-                  'Description': 'plot style; see `mpf.available_styles()`',
-                  'Validator': _styles._valid_mpf_style},
-
-        'volume': {'Default': False,
-                   'Description': 'Plot volume: True, False, or set to Axes object on which to plot.',
-                   'Validator': lambda value: isinstance(value, bool) or isinstance(value, mpl_axes.Axes)},
-
-        'mav': {'Default': None,
-                'Description': 'Moving Average window size(s); (int or tuple of ints)',
-                'Validator': _mav_validator},
-
-        'ema': {'Default': None,
-                'Description': 'Exponential Moving Average window size(s); (int or tuple of ints)',
-                'Validator': _mav_validator},
-
-        'renko_params': {'Default': dict(),
-                         'Description': 'dict of renko parameters; call `mpf.kwarg_help("renko_params")`',
-                         'Validator': lambda value: isinstance(value, dict)},
-
-        'pnf_params': {'Default': dict(),
-                       'Description': 'dict of point-and-figure parameters; call `mpf.kwarg_help("pnf_params")`',
-                       'Validator': lambda value: isinstance(value, dict)},
-
-        'study': {'Default': None,
-                  'Description': 'kwarg not implemented',
-                  'Validator': lambda value: _kwarg_not_implemented(value)},
-
-        'marketcolor_overrides': {'Default': None,
-                                  'Description': 'sequence of color objects to override market colors.' +
-                                  'sequence must be same length as ohlc(v) DataFrame. Each' +
-                                  'color object may be a color, marketcolor object, or None.',
-                                  'Validator': _mco_validator},
-
-        'mco_faceonly': {'Default': False,  # If True: Override only the face of the candle
-                         'Description': 'True/False marketcolor_overrides only apply to face of candle.',
-                         'Validator': lambda value: isinstance(value, bool)},
-
-        'no_xgaps': {'Default': True,  # None means follow default logic below:
-                     'Description': 'deprecated',
-                     'Validator': lambda value: _warn_no_xgaps_deprecated(value)},
-
-        'show_nontrading': {'Default': False,
-                            'Description': 'True/False show spaces for non-trading days/periods',
-                            'Validator': lambda value: isinstance(value, bool)},
-
-        'figscale': {'Default': None,  # scale base figure size up or down.
-                     'Description': 'Scale figure size up (if > 1) or down (if < 1)',
-                     'Validator': lambda value: isinstance(value, float) or isinstance(value, int)},
-
-        'figratio': {'Default': None,  # aspect ratio; scaled to 8.0 height
-                     'Description': 'Aspect ratio of the figure. Default: (8.00,5.75)',
-                     'Validator': lambda value: isinstance(value, (tuple, list))
-                     and len(value) == 2
-                     and isinstance(value[0], (float, int))
-                     and isinstance(value[1], (float, int))},
-
-        'figsize': {'Default': None,  # figure size; overrides figratio and figscale
-                    'Description': ('Figure size: overrides both figscale and figratio,' +
-                                    ' else defaults to figratio*figscale'),
-                    'Validator': lambda value: isinstance(value, (tuple, list))
-                    and len(value) == 2
-                    and isinstance(value[0], (float, int))
-                    and isinstance(value[1], (float, int))},
-
-        'fontscale': {'Default': None,  # scale all fonts up or down
-                      'Description': 'Scale font sizes up (if > 1) or down (if < 1)',
-                      'Validator': lambda value: isinstance(value, float) or isinstance(value, int)},
-
-        'linecolor': {'Default': None,  # line color in line plot
-                      'Description': 'Line color for `type=line`',
-                      'Validator': lambda value: mcolors.is_color_like(value)},
-
-        'title': {'Default': None,  # Figure Title
-                  'Description': 'Figure Title (see also `axtitle`)',
-                  'Validator': lambda value: isinstance(value, (str, dict))},
-
-        'axtitle': {'Default': None,  # Axes Title (subplot title)
-                    'Description': 'Axes Title (subplot title)',
-                    'Validator': lambda value: isinstance(value, (str, dict))},
-
-        'ylabel': {'Default': 'Price',  # y-axis label
-                   'Description': 'label for y-axis of main plot',
-                   'Validator': lambda value: isinstance(value, str)},
-
-        'ylabel_lower': {'Default': None,  # y-axis label default logic below
-                         'Description': 'label for y-axis of volume',
-                         'Validator': lambda value: isinstance(value, str)},
-
-        'addplot': {'Default': None,
-                    'Description': 'addplot object or sequence of addplot objects (from `mpf.make_addplot()`)',
-                    'Validator': lambda value: isinstance(value, dict) or (isinstance(value, list) and all([isinstance(d, dict) for d in value]))},
-
-        'savefig': {'Default': None,
-                    'Description': 'file name, or BytesIO, or dict with key `fname` plus other keys allowed as ' +
-                    ' kwargs to matplotlib `Figure.savefig()`',
-                    'Validator': lambda value: isinstance(value, dict) or isinstance(value, str) or isinstance(value, io.BytesIO) or isinstance(value, os.PathLike)},
-
-        'block': {'Default': None,
-                  'Description': 'True/False wait for figure to be closed before returning',
-                  'Validator': lambda value: isinstance(value, bool)},
-
-        'returnfig': {'Default': False,
-                      'Description': 'return Figure and list of Axes objects created by mplfinance;' +
-                      ' user must display plot when ready, usually by calling `mpf.show()`',
-                      'Validator': lambda value: isinstance(value, bool)},
-
-        'return_calculated_values': {'Default': None,
-                                     'Description': 'set to a variable containing an empty dict; `mpf.plot()` will fill' +
-                                     ' the dict with various mplfinance calculated values',
-                                     'Validator': lambda value: isinstance(value, dict) and len(value) == 0},
-
-        'set_ylim': {'Default': None,
-                     'Description': 'deprecated',
-                     'Validator': lambda value: _warn_set_ylim_deprecated(value)},
-
-        'ylim': {'Default': None,
-                 'Description': 'Limits for y-axis as tuple (min,max), i.e. (bottom,top)',
-                 'Validator': lambda value: isinstance(value, (list, tuple)) and len(value) == 2
-                 and all([isinstance(v, (int, float)) for v in value])},
-
-        'xlim': {'Default': None,
-                 'Description': 'Limits for x-axis as tuple (min,max), i.e. (left,right)',
-                 'Validator': lambda value: _xlim_validator(value)},
-
-        'set_ylim_panelB': {'Default': None,
-                            'Description': 'deprecated',
-                            'Validator': lambda value: _warn_set_ylim_deprecated(value)},
-
-        'hlines': {'Default': None,
-                   'Description': 'Draw one or more HORIZONTAL LINES across entire plot, by' +
-                   ' specifying a price, or sequence of prices.  May also be a dict' +
-                   ' with key `hlines` specifying a price or sequence of prices, plus' +
-                   ' one or more of the following keys: `colors`, `linestyle`,' +
-                   ' `linewidths`, `alpha`.',
-                   'Validator': lambda value: _hlines_validator(value)},
-
-        'vlines': {'Default': None,
-                   'Description': 'Draw one or more VERTICAL LINES across entire plot, by' +
-                   ' specifying a date[time], or sequence of date[time].  May also' +
-                   ' be a dict with key `vlines` specifying a date[time] or sequence' +
-                   ' of date[time], plus one or more of the following keys:' +
-                   ' `colors`, `linestyle`, `linewidths`, `alpha`.',
-                   'Validator': lambda value: _vlines_validator(value)},
-
-        'alines': {'Default': None,
-                   'Description': 'Draw one or more ARBITRARY LINES anywhere on the plot, by' +
-                   ' specifying a sequence of two or more date/price pairs, or by' +
-                   ' specifying a sequence of sequences of two or more date/price pairs.' +
-                   ' May also be a dict with key `alines` (as date/price pairs described above),' +
-                   ' plus one or more of the following keys:' +
-                   ' `colors`, `linestyle`, `linewidths`, `alpha`.',
-                   'Validator': lambda value: _alines_validator(value)},
-
-        'tlines': {'Default': None,
-                   'Description': 'Draw one or more TREND LINES by specifying one or more pairs of date[times]' +
-                   ' between which each trend line should be drawn.  May also be a dict with key' +
-                   ' `tlines` as just described, plus one or more of the following keys:' +
-                   ' `colors`, `linestyle`, `linewidths`, `alpha`, `tline_use`,`tline_method`.',
-                   'Validator': lambda value: _tlines_validator(value)},
-
-        'panel_ratios': {'Default': None,
-                         'Description': 'sequence of numbers indicating relative sizes of panels; sequence len' +
-                         ' must be same as number of panels, or len 2 where first entry is for' +
-                         ' main panel, and second entry is for all other panels',
-                         'Validator': lambda value: isinstance(value, (tuple, list)) and len(value) <= 32 and
-                         all([isinstance(v, (int, float)) for v in value])},
-
-        'main_panel': {'Default': 0,
-                       'Description': 'integer - which panel is the main panel for `.plot()`',
-                       'Validator': lambda value: _valid_panel_id(value)},
-
-        'volume_panel': {'Default': 1,
-                         'Description': 'integer - which panel is the volume panel',
-                         'Validator': lambda value: _valid_panel_id(value)},
-
-        'num_panels': {'Default': None,
-                       'Description': 'total number of panels',
-                       'Validator': lambda value: isinstance(value, int) and value in range(1, 32+1)},
-
-        'datetime_format': {'Default': None,
-                            'Description': 'x-axis tick format as valid `strftime()` format string',
-                            'Validator': lambda value: isinstance(value, str)},
-
-        'xrotation': {'Default': 45,
-                      'Description': 'Angle (degrees) for x-axis tick labels; 90=vertical',
-                      'Validator': lambda value: isinstance(value, (int, float))},
-
-        'axisoff': {'Default': False,
-                    'Description': '`axisoff=True` means do NOT display any axis.',
-                    'Validator': lambda value: isinstance(value, bool)},
-
-        'closefig': {'Default': 'auto',
-                     'Description': 'True|False close the Figure before returning',
-                     'Validator': lambda value: isinstance(value, bool)},
-
-        'fill_between': {'Default': None,
-                         'Description': 'fill between specification as y-value, or sequence of' +
-                         ' y-values, or dict containing key "y1" plus any additional' +
-                         ' kwargs for `fill_between()`',
-                         'Validator': _fill_between_validator},
-
-        'tight_layout': {'Default': False,
-                         'Description': 'True|False implement tight layout (minimal padding around Figure)' +
-                         ' (see also `scale_padding` kwarg)',
-                         'Validator': lambda value: isinstance(value, bool)},
-
-        'scale_padding': {'Default': 1.0,   # Issue#193
-                          'Description': 'Increase, > 1.0, or decrease, < 1.0, padding around figure.' +
-                          ' May also be a dict containing one or more of the following keys:' +
-                          ' "top", "bottom", "left", "right", to individual scale padding' +
-                          ' on each side of Figure.',
-                          'Validator': lambda value: _scale_padding_validator(value)},
-
-        'width_adjuster_version': {'Default': 'v1',
-                                   'Description': 'specify version of object width adjustment algorithm: "v0" or "v1"' +
-                                   ' (See also "widths" tutorial in mplfinance examples folder).',
-                                   'Validator': lambda value: value in ('v0', 'v1')},
-
-        'scale_width_adjustment': {'Default': None,
-                                   'Description': 'scale width of plot objects wider, > 1.0, or narrower, < 1.0' +
-                                   ' may also be a dict to scale individual widths.' +
-                                   ' (See also "widths" tutorial in mplfinance examples folder).',
-                                   'Validator': lambda value: isinstance(value, dict) and len(value) > 0},
-
-        'update_width_config': {'Default': None,
-                                'Description': 'dict - update individual items in width configuration.' +
-                                ' (See also "widths" tutorial in mplfinance examples folder).',
-                                'Validator': lambda value: isinstance(value, dict) and len(value) > 0},
-
-        'return_width_config': {'Default': None,
-                                'Description': 'empty dict variable to be filled with width configuration settings.',
-                                'Validator': lambda value: isinstance(value, dict) and len(value) == 0},
-
-        'saxbelow': {'Default': True,  # Issue#115 Comment#639446764
-                     'Description': 'set the volume Axes below (behind) all other Axes objects',
-                     'Validator': lambda value: isinstance(value, bool)},
-
-        'ax': {'Default': None,
-               'Description': 'Matplotlib Axes object on which to plot',
-               'Validator': lambda value: isinstance(value, mpl_axes.Axes)},
-
-        'volume_exponent': {'Default': None,
-                            'Description': 'integer exponent on the volume axis' +
-                            ' (or set to "legacy" for old mplfinance style)',
-                            'Validator': lambda value: isinstance(value, int) or value == 'legacy'},
-
-        'tz_localize': {'Default': True,
-                        'Description': 'True|False localize the times in the DatetimeIndex',
-                        'Validator': lambda value: isinstance(value, bool)},
-
-        'yscale': {'Default': None,
-                   'Description': 'y-axis scale: "linear", "log", "symlog", or "logit"',
-                   'Validator': lambda value: _yscale_validator(value)},
-
-        'volume_yscale': {'Default': None,
-                          'Description': 'Volume y-axis scale: "linear", "log", "symlog", or "logit"',
-                          'Validator': lambda value: _yscale_validator(value)},
-
-        'volume_ylim': {'Default': None,
-                        'Description': 'Volume y-axis limits as tuple (min,max), i.e. (bottom,top)',
-                        'Validator': lambda value: isinstance(value, (list, tuple)) and len(value) == 2
-                        and all([isinstance(v, (int, float)) for v in value])},
-
-        'volume_alpha': {'Default': 1,  # alpha of Volume bars
-                         'Description': 'opacity for Volume bar: 0.0 (transparent) to 1.0 (opaque)',
-                         'Validator': lambda value: isinstance(value, (int, float)) or
-                         all([isinstance(v, (int, float)) for v in value])},
-
-        'warn_too_much_data': {'Default': 599,
-                               'Description': 'Tolerance for data amount in plot. Default=599 rows.' +
-                               ' Values greater than \'warn_too_much_data\' will trigger a warning.',
-                               'Validator': lambda value: isinstance(value, int)},
+        'columns'                   : { 'Default'     : None, # use default names: ('Open', 'High', 'Low', 'Close', 'Volume')
+                                        'Description' : ('Column names to be used when plotting the data.'+
+                                                         ' Default: ("Open", "High", "Low", "Close", "Volume")'),
+                                        'Validator'   : lambda value: isinstance(value, (tuple, list))
+                                                                   and len(value) == 5
+                                                                   and all(isinstance(c, str) for c in value) },
+        'type'                      : { 'Default'     : 'ohlc',
+                                        'Description' : 'Plot type: '+str(_get_valid_plot_types()),
+                                        'Validator'   : lambda value: value in _get_valid_plot_types() },
+ 
+        'style'                     : { 'Default'     : None,
+                                        'Description' : 'plot style; see `mpf.available_styles()`',
+                                        'Validator'   : _styles._valid_mpf_style },
+ 
+        'volume'                    : { 'Default'     : False,
+                                        'Description' : 'Plot volume: True, False, or set to Axes object on which to plot.',
+                                        'Validator'   : lambda value: isinstance(value,bool) or isinstance(value,mpl_axes.Axes) },
+ 
+        'mav'                       : { 'Default'     : None,
+                                        'Description' : 'Moving Average window size(s); (int or tuple of ints)',
+                                        'Validator'   : _mav_validator },
+
+        'ema'                       : { 'Default'     : None,
+                                        'Description' : 'Exponential Moving Average window size(s); (int or tuple of ints)',
+                                        'Validator'   : _mav_validator },
+        
+        'renko_params'              : { 'Default'     : dict(),
+                                        'Description' : 'dict of renko parameters; call `mpf.kwarg_help("renko_params")`',
+                                        'Validator'   : lambda value: isinstance(value,dict) },
+
+        'pnf_params'                : { 'Default'     : dict(),
+                                        'Description' : 'dict of point-and-figure parameters; call `mpf.kwarg_help("pnf_params")`',
+                                        'Validator'   : lambda value: isinstance(value,dict) },
+ 
+        'study'                     : { 'Default'     : None,
+                                        'Description' : 'kwarg not implemented',
+                                        'Validator'   : lambda value: _kwarg_not_implemented(value) }, 
+ 
+        'marketcolor_overrides'     : { 'Default'     : None, 
+                                        'Description' : 'sequence of color objects to override market colors.'+
+                                                        'sequence must be same length as ohlc(v) DataFrame. Each'+
+                                                        'color object may be a color, marketcolor object, or None.',
+                                        'Validator'   : _mco_validator },
+ 
+        'mco_faceonly'              : { 'Default'     : False, # If True: Override only the face of the candle
+                                        'Description' : 'True/False marketcolor_overrides only apply to face of candle.',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+ 
+        'no_xgaps'                  : { 'Default'     : True,  # None means follow default logic below:
+                                        'Description' : 'deprecated',
+                                        'Validator'   : lambda value: _warn_no_xgaps_deprecated(value) },
+ 
+        'show_nontrading'           : { 'Default'     : False, 
+                                        'Description' : 'True/False show spaces for non-trading days/periods',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+ 
+        'figscale'                  : { 'Default'     : None, # scale base figure size up or down.
+                                        'Description' : 'Scale figure size up (if > 1) or down (if < 1)',
+                                        'Validator'   : lambda value: isinstance(value,float) or isinstance(value,int) },
+ 
+        'figratio'                  : { 'Default'     : None, # aspect ratio; scaled to 8.0 height
+                                        'Description' : 'Aspect ratio of the figure. Default: (8.00,5.75)',
+                                        'Validator'   : lambda value: isinstance(value,(tuple,list))
+                                                                      and len(value) == 2
+                                                                      and isinstance(value[0],(float,int))
+                                                                      and isinstance(value[1],(float,int)) },
+ 
+        'figsize'                   : { 'Default'     : None,  # figure size; overrides figratio and figscale
+                                        'Description' : ('Figure size: overrides both figscale and figratio,'+
+                                                        ' else defaults to figratio*figscale'),
+                                        'Validator'   : lambda value: isinstance(value,(tuple,list))
+                                                                      and len(value) == 2
+                                                                      and isinstance(value[0],(float,int))
+                                                                      and isinstance(value[1],(float,int)) },
+
+        'fontscale'                 : { 'Default'     : None, # scale all fonts up or down
+                                        'Description' : 'Scale font sizes up (if > 1) or down (if < 1)',
+                                        'Validator'   : lambda value: isinstance(value,float) or isinstance(value,int) },
+ 
+        'linecolor'                 : { 'Default'     : None, # line color in line plot
+                                        'Description' : 'Line color for `type=line`',
+                                        'Validator'   : lambda value: mcolors.is_color_like(value) },
+
+        'title'                     : { 'Default'     : None, # Figure Title
+                                        'Description' : 'Figure Title (see also `axtitle`)',
+                                        'Validator'   : lambda value: isinstance(value,(str,dict)) },
+ 
+        'axtitle'                   : { 'Default'     : None, # Axes Title (subplot title)
+                                        'Description' : 'Axes Title (subplot title)',
+                                        'Validator'   : lambda value: isinstance(value,(str,dict)) },
+ 
+        'ylabel'                    : { 'Default'     : 'Price', # y-axis label
+                                        'Description' : 'label for y-axis of main plot',
+                                        'Validator'   : lambda value: isinstance(value,str) },
+ 
+        'ylabel_lower'              : { 'Default'     : None, # y-axis label default logic below
+                                        'Description' : 'label for y-axis of volume',
+                                        'Validator'   : lambda value: isinstance(value,str) },
+ 
+        'addplot'                   : { 'Default'     : None, 
+                                        'Description' : 'addplot object or sequence of addplot objects (from `mpf.make_addplot()`)',
+                                        'Validator'   : lambda value: isinstance(value,dict) or (isinstance(value,list) and all([isinstance(d,dict) for d in value])) },
+ 
+        'savefig'                   : { 'Default'     : None, 
+                                        'Description' : 'file name, or BytesIO, or dict with key `fname` plus other keys allowed as '+
+                                                        ' kwargs to matplotlib `Figure.savefig()`',
+                                        'Validator'   : lambda value: isinstance(value,dict) or isinstance(value,str) or isinstance(value, io.BytesIO) or isinstance(value, os.PathLike) },
+ 
+        'block'                     : { 'Default'     : None, 
+                                        'Description' : 'True/False wait for figure to be closed before returning',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+ 
+        'returnfig'                 : { 'Default'     : False, 
+                                        'Description' : 'return Figure and list of Axes objects created by mplfinance;'+
+                                                        ' user must display plot when ready, usually by calling `mpf.show()`',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+
+        'return_calculated_values'  : { 'Default'     : None,
+                                        'Description' : 'set to a variable containing an empty dict; `mpf.plot()` will fill'+
+                                                        ' the dict with various mplfinance calculated values',
+                                        'Validator'   : lambda value: isinstance(value, dict) and len(value) == 0},
+
+        'set_ylim'                  : { 'Default'     : None,
+                                        'Description' : 'deprecated',
+                                        'Validator'   : lambda value: _warn_set_ylim_deprecated(value) },
+ 
+        'ylim'                      : { 'Default'     : None,
+                                        'Description' : 'Limits for y-axis as tuple (min,max), i.e. (bottom,top)',
+                                        'Validator'   : lambda value: isinstance(value, (list,tuple)) and len(value) == 2 
+                                                                      and all([isinstance(v,(int,float)) for v in value])},
+ 
+        'xlim'                      : { 'Default'     : None,
+                                        'Description' : 'Limits for x-axis as tuple (min,max), i.e. (left,right)',
+                                        'Validator'   : lambda value: _xlim_validator(value) },
+ 
+        'set_ylim_panelB'           : { 'Default'     : None,
+                                        'Description' : 'deprecated',
+                                        'Validator'   : lambda value: _warn_set_ylim_deprecated(value) },
+ 
+        'hlines'                    : { 'Default'     : None, 
+                                        'Description' : 'Draw one or more HORIZONTAL LINES across entire plot, by'+
+                                                        ' specifying a price, or sequence of prices.  May also be a dict'+
+                                                        ' with key `hlines` specifying a price or sequence of prices, plus'+
+                                                        ' one or more of the following keys: `colors`, `linestyle`,'+
+                                                        ' `linewidths`, `alpha`.',
+                                        'Validator'   : lambda value: _hlines_validator(value) },
+ 
+        'vlines'                    : { 'Default'     : None, 
+                                        'Description' : 'Draw one or more VERTICAL LINES across entire plot, by'+
+                                                        ' specifying a date[time], or sequence of date[time].  May also'+
+                                                        ' be a dict with key `vlines` specifying a date[time] or sequence'+
+                                                        ' of date[time], plus one or more of the following keys:'+
+                                                        ' `colors`, `linestyle`, `linewidths`, `alpha`.',
+                                        'Validator'   : lambda value: _vlines_validator(value) },
+
+        'alines'                    : { 'Default'     : None, 
+                                        'Description' : 'Draw one or more ARBITRARY LINES anywhere on the plot, by'+
+                                                        ' specifying a sequence of two or more date/price pairs, or by'+
+                                                        ' specifying a sequence of sequences of two or more date/price pairs.'+
+                                                        ' May also be a dict with key `alines` (as date/price pairs described above),'+
+                                                        ' plus one or more of the following keys:'+
+                                                        ' `colors`, `linestyle`, `linewidths`, `alpha`.',
+                                        'Validator'   : lambda value: _alines_validator(value) },
+ 
+        'tlines'                    : { 'Default'     : None, 
+                                        'Description' : 'Draw one or more TREND LINES by specifying one or more pairs of date[times]'+
+                                                        ' between which each trend line should be drawn.  May also be a dict with key'+
+                                                        ' `tlines` as just described, plus one or more of the following keys:'+
+                                                        ' `colors`, `linestyle`, `linewidths`, `alpha`, `tline_use`,`tline_method`.',
+                                        'Validator'   : lambda value: _tlines_validator(value) },
+       
+        'panel_ratios'              : { 'Default'     : None,
+                                        'Description' : 'sequence of numbers indicating relative sizes of panels; sequence len'+
+                                                        ' must be same as number of panels, or len 2 where first entry is for'+
+                                                        ' main panel, and second entry is for all other panels',
+                                        'Validator'   : lambda value: isinstance(value,(tuple,list)) and len(value) <= 32 and
+                                                                      all([isinstance(v,(int,float)) for v in value]) },
+
+        'main_panel'                : { 'Default'     : 0,
+                                        'Description' : 'integer - which panel is the main panel for `.plot()`',
+                                        'Validator'   : lambda value: _valid_panel_id(value) },
+
+        'volume_panel'              : { 'Default'     : 1,
+                                        'Description' : 'integer - which panel is the volume panel',
+                                        'Validator'   : lambda value: _valid_panel_id(value) },
+
+        'num_panels'                : { 'Default'     : None,
+                                        'Description' : 'total number of panels',
+                                        'Validator'   : lambda value: isinstance(value,int) and value in range(1,32+1) },
+
+        'datetime_format'           : { 'Default'     : None,
+                                        'Description' : 'x-axis tick format as valid `strftime()` format string',
+                                        'Validator'   : lambda value: isinstance(value,str) },
+
+        'xrotation'                 : { 'Default'     : 45,
+                                        'Description' : 'Angle (degrees) for x-axis tick labels; 90=vertical',
+                                        'Validator'   : lambda value: isinstance(value,(int,float)) },
+
+        'axisoff'                   : { 'Default'     : False,
+                                        'Description' : '`axisoff=True` means do NOT display any axis.',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+
+        'closefig'                  : { 'Default'     : 'auto',
+                                        'Description' : 'True|False close the Figure before returning',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+
+        'fill_between'              : { 'Default'     : None,
+                                        'Description' : 'fill between specification as y-value, or sequence of'+
+                                                        ' y-values, or dict containing key "y1" plus any additional'+
+                                                        ' kwargs for `fill_between()`',
+                                        'Validator'   : _fill_between_validator },
+
+        'tight_layout'              : { 'Default'     : False,
+                                        'Description' : 'True|False implement tight layout (minimal padding around Figure)'+
+                                                        ' (see also `scale_padding` kwarg)',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+
+        'scale_padding'             : { 'Default'     : 1.0,   # Issue#193 
+                                        'Description' : 'Increase, > 1.0, or decrease, < 1.0, padding around figure.'+
+                                                        ' May also be a dict containing one or more of the following keys:'+
+                                                        ' "top", "bottom", "left", "right", to individual scale padding'+
+                                                        ' on each side of Figure.',
+                                        'Validator'   : lambda value: _scale_padding_validator(value) },
+
+        'width_adjuster_version'    : { 'Default'     : 'v1',
+                                        'Description' : 'specify version of object width adjustment algorithm: "v0" or "v1"'+
+                                                        ' (See also "widths" tutorial in mplfinance examples folder).',
+                                        'Validator'   : lambda value: value in ('v0', 'v1') },
+
+        'scale_width_adjustment'    : { 'Default'     : None,
+                                        'Description' : 'scale width of plot objects wider, > 1.0, or narrower, < 1.0'+
+                                                        ' may also be a dict to scale individual widths.'+
+                                                        ' (See also "widths" tutorial in mplfinance examples folder).',
+                                        'Validator'   : lambda value: isinstance(value,dict) and len(value) > 0 },
+
+        'update_width_config'       : { 'Default'     : None,
+                                        'Description' : 'dict - update individual items in width configuration.'+
+                                                        ' (See also "widths" tutorial in mplfinance examples folder).',
+                                        'Validator'   : lambda value: isinstance(value,dict) and len(value) > 0 },
+
+        'return_width_config'       : { 'Default'     : None,
+                                        'Description' : 'empty dict variable to be filled with width configuration settings.',
+                                        'Validator'   : lambda value: isinstance(value,dict) and len(value)==0 },
+
+        'saxbelow'                  : { 'Default'     : True,  # Issue#115 Comment#639446764
+                                        'Description' : 'set the volume Axes below (behind) all other Axes objects',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+        
+        'ax'                        : { 'Default'     : None,
+                                        'Description' : 'Matplotlib Axes object on which to plot',
+                                        'Validator'   : lambda value: isinstance(value,mpl_axes.Axes) },
+
+        'volume_exponent'           : { 'Default'     : None,
+                                        'Description' : 'integer exponent on the volume axis'+
+                                                        ' (or set to "legacy" for old mplfinance style)',
+                                        'Validator'   : lambda value: isinstance(value,int) or value == 'legacy'},
+
+        'tz_localize'               : { 'Default'     : True,
+                                        'Description' : 'True|False localize the times in the DatetimeIndex',
+                                        'Validator'   : lambda value: isinstance(value,bool) },
+
+        'yscale'                    : { 'Default'     : None,
+                                        'Description' : 'y-axis scale: "linear", "log", "symlog", or "logit"',
+                                        'Validator'   : lambda value: _yscale_validator(value) },
+
+        'volume_yscale'             : { 'Default'     : None,
+                                        'Description' : 'Volume y-axis scale: "linear", "log", "symlog", or "logit"',
+                                        'Validator'   : lambda value: _yscale_validator(value) },
+
+        'volume_ylim'               : { 'Default'     : None,
+                                        'Description' : 'Volume y-axis limits as tuple (min,max), i.e. (bottom,top)',
+                                        'Validator'   : lambda value: isinstance(value, (list,tuple)) and len(value) == 2
+                                                        and all([isinstance(v,(int,float)) for v in value])},
+
+        'volume_alpha'              : { 'Default'     : 1,  # alpha of Volume bars
+                                        'Description' : 'opacity for Volume bar: 0.0 (transparent) to 1.0 (opaque)',
+                                        'Validator'   : lambda value: isinstance(value,(int,float)) or
+                                                        all([isinstance(v,(int,float)) for v in value]) },
+
+        'warn_too_much_data'        : { 'Default'     : 599,
+                                        'Description' : 'Tolerance for data amount in plot. Default=599 rows.'+
+                                                        ' Values greater than \'warn_too_much_data\' will trigger a warning.',
+                                        'Validator'   : lambda value: isinstance(value,int) },
     }
 
     _validate_vkwargs_dict(vkwargs)
 
     return vkwargs
 
-# @with_rc_context
-
-
-def plot(data, **kwargs):
+###@with_rc_context
+def plot( data, **kwargs ):
     """
     Given a Pandas DataFrame containing columns Open,High,Low,Close and optionally Volume
     with a DatetimeIndex, plot the data.
@@ -407,66 +402,61 @@ def plot(data, **kwargs):
 
     # translate alias types:
     config['type'] = _get_valid_plot_types(config['type'])
-
-    dates, opens, highs, lows, closes, volumes = _check_and_prepare_data(
-        data, config)
+    
+    dates,opens,highs,lows,closes,volumes = _check_and_prepare_data(data, config)
 
     config['xlim'] = _check_and_convert_xlim_configuration(data, config)
 
     if config['type'] in VALID_PMOVE_TYPES and config['addplot'] is not None:
-        err = "`addplot` is not supported for `type='" + config['type'] + "'`"
+        err = "`addplot` is not supported for `type='" + config['type'] +"'`"
         raise ValueError(err)
 
     if config['marketcolor_overrides'] is not None:
         if len(config['marketcolor_overrides']) != len(dates):
-            raise ValueError(
-                '`marketcolor_overrides` must be same length as dataframe.')
+            raise ValueError('`marketcolor_overrides` must be same length as dataframe.')
 
     external_axes_mode = _check_for_external_axes(config)
 
     if external_axes_mode:
         if config['figscale'] is not None:
-            warnings.warn('\n\n ================================================================= ' +
-                          '\n\n   WARNING: `figscale` has NO effect in External Axes Mode.' +
+            warnings.warn('\n\n ================================================================= '+
+                          '\n\n   WARNING: `figscale` has NO effect in External Axes Mode.'+
                           '\n\n ================================================================ ',
                           category=UserWarning)
         if config['figratio'] is not None:
-            warnings.warn('\n\n ================================================================= ' +
-                          '\n\n   WARNING: `figratio` has NO effect in External Axes Mode.' +
+            warnings.warn('\n\n ================================================================= '+
+                          '\n\n   WARNING: `figratio` has NO effect in External Axes Mode.'+
                           '\n\n ================================================================ ',
                           category=UserWarning)
         if config['figsize'] is not None:
-            warnings.warn('\n\n ================================================================= ' +
-                          '\n\n   WARNING: `figsize` has NO effect in External Axes Mode.' +
+            warnings.warn('\n\n ================================================================= '+
+                          '\n\n   WARNING: `figsize` has NO effect in External Axes Mode.'+
                           '\n\n ================================================================ ',
                           category=UserWarning)
     else:
-        if config['figscale'] is None:
-            config['figscale'] = 1.0
-        if config['figratio'] is None:
-            config['figratio'] = DEFAULT_FIGRATIO
+        if config['figscale'] is None: config['figscale'] = 1.0
+        if config['figratio'] is None: config['figratio'] = DEFAULT_FIGRATIO
 
     style = config['style']
 
-    if external_axes_mode and hasattr(config['ax'], 'mpfstyle') and style is None:
+    if external_axes_mode and hasattr(config['ax'],'mpfstyle') and style is None:
         style = config['ax'].mpfstyle
     elif style is None:
         style = 'default'
 
-    if isinstance(style, str):
+    if isinstance(style,str):
         style = _styles._get_mpfstyle(style)
 
     config['style'] = style
 
-    if isinstance(style, dict):
-        if not external_axes_mode:
-            _styles._apply_mpfstyle(style)
+    if isinstance(style,dict):
+        if not external_axes_mode: _styles._apply_mpfstyle(style)
     else:
         raise TypeError('style should be a `dict`; why is it not?')
 
     if not external_axes_mode:
         fig = plt.figure()
-        _adjust_figsize(fig, config)
+        _adjust_figsize(fig,config)
     else:
         fig = None
 
@@ -477,31 +467,29 @@ def plot(data, **kwargs):
 
     if external_axes_mode:
         panels = None
-        axA1 = config['ax']
+        axA1   = config['ax']
         axA1.set_axisbelow(config['saxbelow'])
         if config['volume']:
             volumeAxes = config['volume']
             volumeAxes.set_axisbelow(config['saxbelow'])
     else:
         panels = _build_panels(fig, config)
-        axA1 = panels.at[config['main_panel'], 'axes'][0]
+        axA1 = panels.at[config['main_panel'],'axes'][0]
         if config['volume']:
             if config['volume_panel'] == config['main_panel']:
                 # ohlc and volume on same panel: move volume to secondary axes:
-                volumeAxes = panels.at[config['volume_panel'], 'axes'][1]
-                # Make sure ohlc is above volume
-                volumeAxes.set_zorder(axA1.get_zorder()-0.1)
-                # Let volume show through
-                axA1.patch.set_visible(False)
-                panels.at[config['main_panel'], 'used2nd'] = True
+                volumeAxes = panels.at[config['volume_panel'],'axes'][1]
+                volumeAxes.set_zorder(axA1.get_zorder()-0.1) # Make sure ohlc is above volume
+                axA1.patch.set_visible(False)                # Let volume show through
+                panels.at[config['main_panel'],'used2nd'] = True
             else:
-                volumeAxes = panels.at[config['volume_panel'], 'axes'][0]
+                volumeAxes = panels.at[config['volume_panel'],'axes'][0]
         else:
             volumeAxes = None
 
     fmtstring = _determine_format_string(dates, config['datetime_format'])
 
-    ptype = config['type']
+    ptype = config['type'] 
 
     if config['show_nontrading']:
         formatter = mdates.DateFormatter(fmtstring)
@@ -514,7 +502,7 @@ def plot(data, **kwargs):
     config['_width_config'] = _determine_width_config(xdates, config)
 
     rwc = config['return_width_config']
-    if isinstance(rwc, dict) and len(rwc) == 0:
+    if isinstance(rwc,dict) and len(rwc)==0:
         config['return_width_config'].update(config['_width_config'])
 
     collections = None
@@ -522,20 +510,19 @@ def plot(data, **kwargs):
         lw = config['_width_config']['line_width']
         axA1.plot(xdates, closes, color=config['linecolor'], linewidth=lw)
     else:
-        collections = _construct_mpf_collections(
-            ptype, dates, xdates, opens, highs, lows, closes, volumes, config, style)
+        collections =_construct_mpf_collections(ptype,dates,xdates,opens,highs,lows,closes,volumes,config,style)
 
     if ptype in VALID_PMOVE_TYPES:
         collections, calculated_values = collections
-        volumes = calculated_values['volumes']
-        pmove_dates = calculated_values['dates']
-        pmove_values = calculated_values['values']
-        if all([isinstance(v, (list, tuple)) for v in pmove_values]):
+        volumes       = calculated_values['volumes']
+        pmove_dates   = calculated_values['dates']
+        pmove_values  = calculated_values['values']
+        if all([isinstance(v,(list,tuple)) for v in pmove_values]):
             pmove_avgvals = [sum(v)/len(v) for v in pmove_values]
         else:
             pmove_avgvals = pmove_values
-        pmove_size = calculated_values['size']
-        pmove_counts = calculated_values['counts'] if 'counts' in calculated_values else None
+        pmove_size    = calculated_values['size']
+        pmove_counts  = calculated_values['counts'] if 'counts' in calculated_values else None
         formatter = IntegerIndexDateTimeFormatter(pmove_dates, fmtstring)
         xdates = np.arange(len(pmove_dates))
 
@@ -544,29 +531,26 @@ def plot(data, **kwargs):
             axA1.add_collection(collection)
 
     if ptype in VALID_PMOVE_TYPES:
-        mavprices = _plot_mav(axA1, config, xdates, pmove_avgvals)
-        emaprices = _plot_ema(axA1, config, xdates, pmove_avgvals)
-
+        mavprices = _plot_mav(axA1,config,xdates,pmove_avgvals)
     else:
-        mavprices = _plot_mav(axA1, config, xdates, closes)
-        emaprices = _plot_ema(axA1, config, xdates, closes)
+        mavprices = _plot_mav(axA1,config,xdates,closes)
 
     avg_dist_between_points = (xdates[-1] - xdates[0]) / float(len(xdates))
     if not config['tight_layout']:
-        minx = xdates[0] - avg_dist_between_points
+        minx = xdates[0]  - avg_dist_between_points
         maxx = xdates[-1] + avg_dist_between_points
     else:
-        minx = xdates[0] - (0.45 * avg_dist_between_points)
+        minx = xdates[0]  - (0.45 * avg_dist_between_points)
         maxx = xdates[-1] + (0.45 * avg_dist_between_points)
 
     if len(xdates) == 1:  # kludge special case
         minx = minx - 0.75
         maxx = maxx + 0.75
     if ptype not in VALID_PMOVE_TYPES:
-        _lows = lows
+        _lows  = lows
         _highs = highs
     else:
-        _lows = pmove_avgvals
+        _lows  = pmove_avgvals
         _highs = [value+pmove_size for value in pmove_avgvals]
 
     miny = np.nanmin(_lows)
@@ -578,54 +562,43 @@ def plot(data, **kwargs):
         ydelta = 0.01 * (maxy-miny)
         if miny > 0.0:
             # don't let it go negative:
-            setminy = max(0.9*miny, miny-ydelta)
+            setminy = max(0.9*miny,miny-ydelta)
         else:
             setminy = miny-ydelta
-        axA1.set_ylim(setminy, maxy+ydelta)
+        axA1.set_ylim(setminy,maxy+ydelta)
 
     if config['xlim'] is not None:
         axA1.set_xlim(config['xlim'][0], config['xlim'][1])
     elif config['tight_layout']:
-        axA1.set_xlim(minx, maxx)
+        axA1.set_xlim(minx,maxx)
 
     if (config['ylim'] is None and
         config['xlim'] is None and
-            not config['tight_layout']):
+        not config['tight_layout']):
         corners = (minx, miny), (maxx, maxy)
         axA1.update_datalim(corners)
 
     if config['return_calculated_values'] is not None:
         retdict = config['return_calculated_values']
         if ptype == 'renko':
-            retdict['renko_bricks'] = pmove_values
-            retdict['renko_dates'] = mdates.num2date(pmove_dates)
-            retdict['renko_size'] = pmove_size
+            retdict['renko_bricks' ] = pmove_values
+            retdict['renko_dates'  ] = mdates.num2date(pmove_dates)
+            retdict['renko_size'   ] = pmove_size
             retdict['renko_volumes'] = volumes if config['volume'] else None
         elif ptype == 'pnf':
-            retdict['pnf_dates'] = mdates.num2date(pmove_dates)
-            retdict['pnf_counts'] = pmove_counts
-            retdict['pnf_values'] = pmove_values
-            retdict['pnf_avgvals'] = pmove_avgvals
-            retdict['pnf_size'] = pmove_size
-            retdict['pnf_volumes'] = volumes if config['volume'] else None
+            retdict['pnf_dates'    ] = mdates.num2date(pmove_dates)
+            retdict['pnf_counts'   ] = pmove_counts
+            retdict['pnf_values'   ] = pmove_values
+            retdict['pnf_avgvals'  ] = pmove_avgvals
+            retdict['pnf_size'     ] = pmove_size
+            retdict['pnf_volumes'  ] = volumes if config['volume'] else None
         if config['mav'] is not None:
             mav = config['mav']
             if len(mav) != len(mavprices):
-                warnings.warn('len(mav)='+str(len(mav)) +
-                              ' BUT len(mavprices)='+str(len(mavprices)))
+                warnings.warn('len(mav)='+str(len(mav))+' BUT len(mavprices)='+str(len(mavprices)))
             else:
-                for jj in range(0, len(mav)):
+                for jj in range(0,len(mav)):     
                     retdict['mav' + str(mav[jj])] = mavprices[jj]
-
-        if config['ema'] is not None:
-            ema = config['ema']
-            if len(ema) != len(emaprices):
-                warnings.warn('len(ema)='+str(len(ema)) +
-                              ' BUT len(emaprices)='+str(len(emaprices)))
-            else:
-                for jj in range(0, len(ema)):
-                    retdict['ema' + str(ema[jj])] = emaprices[jj]
-
         retdict['minx'] = minx
         retdict['maxx'] = maxx
         retdict['miny'] = miny
@@ -641,63 +614,58 @@ def plot(data, **kwargs):
         dtix = None
 
     line_collections = []
-    line_collections.append(
-        _construct_aline_collections(config['alines'], dtix))
-    line_collections.append(
-        _construct_hline_collections(config['hlines'], minx, maxx))
-    line_collections.append(_construct_vline_collections(
-        config['vlines'], dtix, miny, maxy))
+    line_collections.append(_construct_aline_collections(config['alines'], dtix))
+    line_collections.append(_construct_hline_collections(config['hlines'], minx, maxx))
+    line_collections.append(_construct_vline_collections(config['vlines'], dtix, miny, maxy))
     tlines = config['tlines']
-    if isinstance(tlines, (list, tuple)) and all([isinstance(item, dict) for item in tlines]):
+    if isinstance(tlines,(list,tuple)) and all([isinstance(item,dict) for item in tlines]):
         pass
     else:
-        tlines = [tlines, ]
+        tlines = [tlines,]
     for tline_item in tlines:
-        line_collections.append(_construct_tline_collections(
-            tline_item, dtix, dates, opens, highs, lows, closes))
-
+        line_collections.append(_construct_tline_collections(tline_item, dtix, dates, opens, highs, lows, closes))
+     
     for collection in line_collections:
         if collection is not None:
             axA1.add_collection(collection)
 
     datalen = len(xdates)
     if config['volume']:
-        vup, vdown = style['marketcolors']['volume'].values()
+        vup,vdown = style['marketcolors']['volume'].values()
         #-- print('vup,vdown=',vup,vdown)
-        vcolors = _updown_colors(
-            vup, vdown, opens, closes, use_prev_close=style['marketcolors']['vcdopcod'])
+        vcolors = _updown_colors(vup, vdown, opens, closes, use_prev_close=style['marketcolors']['vcdopcod'])
         #-- print('len(vcolors),len(opens),len(closes)=',len(vcolors),len(opens),len(closes))
         #-- print('vcolors=',vcolors)
 
-        w = config['_width_config']['volume_width']
+        w  = config['_width_config']['volume_width']
         lw = config['_width_config']['volume_linewidth']
 
-        adjc = _adjust_color_brightness(vcolors, 0.90)
+        adjc = _adjust_color_brightness(vcolors,0.90)
         valp = config['volume_alpha']
-        volumeAxes.bar(xdates, volumes, width=w, linewidth=lw,
-                       color=vcolors, ec=adjc, alpha=valp)
+        volumeAxes.bar(xdates,volumes,width=w,linewidth=lw,color=vcolors,ec=adjc,alpha=valp)
         if config['volume_ylim'] is not None:
             vymin = config['volume_ylim'][0]
             vymax = config['volume_ylim'][1]
         else:
             vymin = 0.3 * np.nanmin(volumes)
             vymax = 1.1 * np.nanmax(volumes)
-        volumeAxes.set_ylim(vymin, vymax)
+        volumeAxes.set_ylim(vymin,vymax)
 
     xrotation = config['xrotation']
     if not external_axes_mode:
-        _set_ticks_on_bottom_panel_only(panels, formatter, rotation=xrotation)
+        _set_ticks_on_bottom_panel_only(panels,formatter,rotation=xrotation)
     else:
-        axA1.tick_params(axis='x', rotation=xrotation)
+        axA1.tick_params(axis='x',rotation=xrotation)
         axA1.xaxis.set_major_formatter(formatter)
 
     ysd = config['yscale']
-    if isinstance(ysd, dict):
+    if isinstance(ysd,dict):
         yscale = ysd['yscale']
-        del ysd['yscale']
-        axA1.set_yscale(yscale, **ysd)
-    elif isinstance(ysd, str):
+        del      ysd['yscale']
+        axA1.set_yscale(yscale,**ysd)
+    elif isinstance(ysd,str):
         axA1.set_yscale(ysd)
+ 
 
     addplot = config['addplot']
     if addplot is not None and ptype not in VALID_PMOVE_TYPES:
@@ -711,67 +679,59 @@ def plot(data, **kwargs):
             # If addplot['secondary_y'] == 'auto', then: If the addplot['data']
             # is out of the Order of Magnitude Range, then use secondary_y.
 
-            lo = math.log(max(math.fabs(np.nanmin(lows)), 1e-7), 10) - 0.5
-            hi = math.log(max(math.fabs(np.nanmax(highs)), 1e-7), 10) + 0.5
+            lo = math.log(max(math.fabs(np.nanmin(lows)),1e-7),10) - 0.5
+            hi = math.log(max(math.fabs(np.nanmax(highs)),1e-7),10) + 0.5
 
             panels['mag'] = [None]*len(panels)  # create 'mag'nitude column
 
-            panels.at[config['main_panel'], 'mag'] = {
-                'lo': lo, 'hi': hi}  # update main panel magnitude range
+            panels.at[config['main_panel'],'mag'] = {'lo':lo,'hi':hi} # update main panel magnitude range
 
             if config['volume']:
-                lo = math.log(
-                    max(math.fabs(np.nanmin(volumes)), 1e-7), 10) - 0.5
-                hi = math.log(
-                    max(math.fabs(np.nanmax(volumes)), 1e-7), 10) + 0.5
-                panels.at[config['volume_panel'], 'mag'] = {'lo': lo, 'hi': hi}
+                lo = math.log(max(math.fabs(np.nanmin(volumes)),1e-7),10) - 0.5
+                hi = math.log(max(math.fabs(np.nanmax(volumes)),1e-7),10) + 0.5
+                panels.at[config['volume_panel'],'mag'] = {'lo':lo,'hi':hi}
 
-        if isinstance(addplot, dict):
-            addplot = [addplot, ]   # make list of dict to be consistent
+        if isinstance(addplot,dict):
+            addplot = [addplot,]   # make list of dict to be consistent
 
         elif not _list_of_dict(addplot):
-            raise TypeError(
-                'addplot must be `dict`, or `list of dict`, NOT '+str(type(addplot)))
+            raise TypeError('addplot must be `dict`, or `list of dict`, NOT '+str(type(addplot)))
 
         for apdict in addplot:
 
-            panid = apdict['panel']
+            panid = apdict['panel'] 
             if not external_axes_mode:
-                if panid == 'main':
-                    panid = 0  # for backwards compatibility
-                elif panid == 'lower':
-                    panid = 1  # for backwards compatibility
+                if   panid == 'main' : panid = 0  # for backwards compatibility
+                elif panid == 'lower': panid = 1  # for backwards compatibility
                 if apdict['y_on_right'] is not None:
-                    panels.at[panid, 'y_on_right'] = apdict['y_on_right']
+                    panels.at[panid,'y_on_right'] = apdict['y_on_right']
 
             aptype = apdict['type']
             if aptype == 'ohlc' or aptype == 'candle':
-                ax = _addplot_collections(
-                    panid, panels, apdict, xdates, config)
-                _addplot_apply_supplements(ax, apdict, xdates)
-            else:
+                ax = _addplot_collections(panid,panels,apdict,xdates,config)
+                _addplot_apply_supplements(ax,apdict,xdates)
+            else:         
                 apdata = apdict['data']
-                if isinstance(apdata, list) and not isinstance(apdata[0], (float, int)):
+                if isinstance(apdata,list) and not isinstance(apdata[0],(float,int)):
                     raise TypeError('apdata is list but NOT of float or int')
-                if isinstance(apdata, pd.DataFrame):
+                if isinstance(apdata,pd.DataFrame): 
                     havedf = True
                 else:
                     havedf = False      # must be a single series or array
-                    apdata = [apdata, ]  # make it iterable
+                    apdata = [apdata,]  # make it iterable
                 for column in apdata:
-                    ydata = apdata.loc[:, column] if havedf else column
-                    ax = _addplot_columns(
-                        panid, panels, ydata, apdict, xdates, config)
-                    _addplot_apply_supplements(ax, apdict, xdates)
+                    ydata = apdata.loc[:,column] if havedf else column
+                    ax = _addplot_columns(panid,panels,ydata,apdict,xdates,config)
+                    _addplot_apply_supplements(ax,apdict,xdates)
 
     # fill_between is NOT supported for external_axes_mode
     # (caller can easily call ax.fill_between() themselves).
     if config['fill_between'] is not None and not external_axes_mode:
         fblist = copy.deepcopy(config['fill_between'])
         if _num_or_seq_of_num(fblist):
-            fblist = [dict(y1=fblist), ]
-        elif isinstance(fblist, dict):
-            fblist = [fblist, ]
+            fblist = [dict(y1=fblist),]
+        elif isinstance(fblist,dict):
+            fblist = [fblist,]
         if not _list_of_dict(fblist):
             raise TypeError('Bad type for `fill_between` specifier.')
         for fb in fblist:
@@ -781,61 +741,62 @@ def plot(data, **kwargs):
             if 'panel' in fb:
                 panid = fb['panel']
                 del fb['panel']
-            fb['x'] = xdates  # add 'x' to caller's fb dict
-            ax = panels.at[panid, 'axes'][0]
+            fb['x'] = xdates # add 'x' to caller's fb dict
+            ax = panels.at[panid,'axes'][0]
             ax.fill_between(**fb)
-
+            
     # put the primary axis on one side,
     # and the twinx() on the "other" side:
     if not external_axes_mode:
-        for panid, row in panels.iterrows():
+        for panid,row in panels.iterrows():
             ax = row['axes']
             y_on_right = style['y_on_right'] if row['y_on_right'] is None else row['y_on_right']
-            _set_ylabels_side(ax[0], ax[1], y_on_right)
+            _set_ylabels_side(ax[0],ax[1],y_on_right)
     else:
         y_on_right = style['y_on_right']
-        _set_ylabels_side(axA1, None, y_on_right)
+        _set_ylabels_side(axA1,None,y_on_right)
 
     # TODO: ================================================================
     # TODO:  Investigate:
     # TODO:  ===========
     # TODO:  It appears to me that there may be some or significant overlap
     # TODO:  between what the following functions actually do:
-    # TODO:  At the very least, all four of them appear to communicate
+    # TODO:  At the very least, all four of them appear to communicate 
     # TODO:  to matplotlib that the xaxis should be treated as dates:
     # TODO:   ->  'ax.autoscale_view()'
     # TODO:   ->  'ax.xaxis_dates()'
     # TODO:   ->  'plt.autofmt_xdates()'
     # TODO:   ->  'fig.autofmt_xdate()'
     # TODO: ================================================================
+    
 
-    # if config['autofmt_xdate']:
+    #if config['autofmt_xdate']:
         #print('CALLING fig.autofmt_xdate()')
-        # fig.autofmt_xdate()
+        #fig.autofmt_xdate()
 
     axA1.autoscale_view()  # Is this really necessary??
-    # It appears to me, based on experience coding types 'ohlc' and 'candle'
-    # for `addplot`, that this IS necessary when the only thing done to the
-    # the axes is .add_collection().  (However, if ax.plot() .scatter() or
-    # .bar() was called, then possibly this is not necessary; not entirely
-    # sure, but it definitely was necessary to get 'ohlc' and 'candle'
-    # working in `addplot`).
+                           # It appears to me, based on experience coding types 'ohlc' and 'candle'
+                           # for `addplot`, that this IS necessary when the only thing done to the
+                           # the axes is .add_collection().  (However, if ax.plot() .scatter() or
+                           # .bar() was called, then possibly this is not necessary; not entirely
+                           # sure, but it definitely was necessary to get 'ohlc' and 'candle' 
+                           # working in `addplot`).
 
     axA1.set_ylabel(config['ylabel'])
 
     if config['volume']:
         if external_axes_mode:
-            volumeAxes.tick_params(axis='x', rotation=xrotation)
+            volumeAxes.tick_params(axis='x',rotation=xrotation)
             volumeAxes.xaxis.set_major_formatter(formatter)
 
         vscale = 'linear'
         ysd = config['volume_yscale']
-        if isinstance(ysd, dict):
+        if isinstance(ysd,dict):
             yscale = ysd['yscale']
-            del ysd['yscale']
-            volumeAxes.set_yscale(yscale, **ysd)
+            del      ysd['yscale']
+            volumeAxes.set_yscale(yscale,**ysd)
             vscale = yscale
-        elif isinstance(ysd, str):
+        elif isinstance(ysd,str):
             volumeAxes.set_yscale(ysd)
             vscale = ysd
         offset = ''
@@ -846,28 +807,24 @@ def plot(data, **kwargs):
                 offset = volumeAxes.yaxis.get_major_formatter().get_offset()
                 if len(offset) > 0:
                     offset = (' x '+offset)
-            elif isinstance(vxp, int) and vxp > 0:
-                volumeAxes.ticklabel_format(
-                    useOffset=False, scilimits=(vxp, vxp), axis='y')
+            elif isinstance(vxp,int) and vxp > 0:
+                volumeAxes.ticklabel_format(useOffset=False,scilimits=(vxp,vxp),axis='y')
                 offset = '  $10^{'+str(vxp)+'}$'
-            elif isinstance(vxp, int) and vxp == 0:
-                volumeAxes.ticklabel_format(
-                    useOffset=False, style='plain', axis='y')
+            elif isinstance(vxp,int) and vxp == 0:
+                volumeAxes.ticklabel_format(useOffset=False,style='plain',axis='y')
                 offset = ''
             else:
                 offset = ''
                 scilims = plt.rcParams['axes.formatter.limits']
                 if scilims[0] < scilims[1]:
-                    for power in (5, 4, 3, 2, 1):
+                    for power in (5,4,3,2,1):
                         xp = scilims[1]*power
                         if vymax >= 10.**xp:
-                            volumeAxes.ticklabel_format(
-                                useOffset=False, scilimits=(xp, xp), axis='y')
+                            volumeAxes.ticklabel_format(useOffset=False,scilimits=(xp,xp),axis='y')
                             offset = '  $10^{'+str(xp)+'}$'
                             break
                 elif scilims[0] == scilims[1] and scilims[1] != 0:
-                    volumeAxes.ticklabel_format(
-                        useOffset=False, scilimits=scilims, axis='y')
+                    volumeAxes.ticklabel_format(useOffset=False,scilimits=scilims,axis='y')
                     offset = ' $10^'+str(scilims[1])+'$'
             volumeAxes.yaxis.offsetText.set_visible(False)
 
@@ -878,7 +835,7 @@ def plot(data, **kwargs):
                 offset = '\n'+offset
             vol_label = config['ylabel_lower'] + offset
         volumeAxes.set_ylabel(vol_label)
-
+    
     if config['title'] is not None:
         if config['tight_layout']:
             # IMPORTANT: `y=0.89` is based on the top of the top panel
@@ -887,24 +844,24 @@ def plot(data, **kwargs):
             title_kwargs = dict(va='bottom', y=0.89)
         else:
             title_kwargs = dict(va='center')
-        if isinstance(config['title'], dict):
+        if isinstance(config['title'],dict):
             title_dict = config['title']
             if 'title' not in title_dict:
                 raise ValueError('Must have "title" entry in title dict')
             else:
                 title = title_dict['title']
                 del title_dict['title']
-            # allows override default values set by mplfinance above
-            title_kwargs.update(title_dict)
+            title_kwargs.update(title_dict)  # allows override default values set by mplfinance above
         else:
             title = config['title']      # config['title'] is a string
-        fig.suptitle(title, **title_kwargs)
-
+        fig.suptitle(title,**title_kwargs)
+    
+    
     if config['axtitle'] is not None:
         axA1.set_title(config['axtitle'])
 
     if not external_axes_mode:
-        for panid, row in panels.iterrows():
+        for panid,row in panels.iterrows():
             if not row['used2nd']:
                 row['axes'][1].set_visible(False)
 
@@ -922,27 +879,25 @@ def plot(data, **kwargs):
 
     if config['savefig'] is not None:
         save = config['savefig']
-        if isinstance(save, dict):
+        if isinstance(save,dict):
             if config['tight_layout'] and 'bbox_inches' not in save:
-                fig.savefig(**save, bbox_inches='tight')
+                fig.savefig(**save,bbox_inches='tight')
             else:
                 fig.savefig(**save)
         else:
             if config['tight_layout']:
-                fig.savefig(save, bbox_inches='tight')
+                fig.savefig(save,bbox_inches='tight')
             else:
                 fig.savefig(save)
-        if config['closefig']:  # True or 'auto'
+        if config['closefig']: # True or 'auto'
             plt.close(fig)
     elif not config['returnfig']:
-        # https://stackoverflow.com/a/13361748/1639359
-        plt.show(block=config['block'])
+        plt.show(block=config['block']) # https://stackoverflow.com/a/13361748/1639359
         if config['closefig'] == True or (config['block'] and config['closefig']):
             plt.close(fig)
-
+    
     if config['returnfig']:
-        if config['closefig'] == True:
-            plt.close(fig)
+        if config['closefig'] == True: plt.close(fig)
         return (fig, axlist)
 
     # rcp   = copy.deepcopy(plt.rcParams)
@@ -951,33 +906,30 @@ def plot(data, **kwargs):
     # print('rcpdfhead(3)=',rcpdf.head(3))
     # return # rcpdf
 
-
-def _adjust_figsize(fig, config):
+def _adjust_figsize(fig,config):
     if fig is None:
         return
     if config['figsize'] is None:
-        w, h = config['figratio']
+        w,h = config['figratio']
         r = float(w)/float(h)
         if r < 0.20 or r > 5.0:
-            raise ValueError(
-                '"figratio" (aspect ratio)  must be between 0.20 and 5.0 (but is '+str(r)+')')
+            raise ValueError('"figratio" (aspect ratio)  must be between 0.20 and 5.0 (but is '+str(r)+')')
         default_scale = DEFAULT_FIGRATIO[1]/h
         h *= default_scale
         w *= default_scale
-        base = (w, h)
-        figscale = config['figscale']
-        fsize = [d*figscale for d in base]
+        base      = (w,h)
+        figscale  = config['figscale']
+        fsize     = [d*figscale for d in base]
     else:
         fsize = config['figsize']
     fig.set_size_inches(fsize)
 
-
 def _adjust_fontsize(config):
     if config['fontscale'] is None:
         return
-    if not isinstance(plt.rcParams['font.size'], (float, int)):
-        warnings.warn('\n\n ================================================================= ' +
-                      '\n\n   WARNING: Unable to scale fonts: plt.rcParams["font.size"] is NOT a float!' +
+    if not isinstance(plt.rcParams['font.size'],(float,int)):
+        warnings.warn('\n\n ================================================================= '+
+                      '\n\n   WARNING: Unable to scale fonts: plt.rcParams["font.size"] is NOT a float!'+
                       '\n\n ================================================================ ',
                       category=UserWarning)
         return
@@ -997,19 +949,18 @@ def _adjust_fontsize(config):
     #        None:       1.0,
     #    }
     # --------------------------------------------
-    fontstuff = ['axes.labelsize', 'axes.titlesize', 'figure.titlesize', 'legend.fontsize',
-                 'legend.title_fontsize', 'xtick.labelsize', 'ytick.labelsize']
+    fontstuff = ['axes.labelsize','axes.titlesize', 'figure.titlesize','legend.fontsize',
+                 'legend.title_fontsize','xtick.labelsize','ytick.labelsize']
     for item in fontstuff:
-        if isinstance(plt.rcParams[item], (float, int)):
+        if isinstance(plt.rcParams[item],(float,int)):
             plt.rcParams[item] *= config['fontscale']
 
-
-def _addplot_collections(panid, panels, apdict, xdates, config):
+def _addplot_collections(panid,panels,apdict,xdates,config):
 
     apdata = apdict['data']
     aptype = apdict['type']
     external_axes_mode = apdict['ax'] is not None
-
+   
     #--------------------------------------------------------------#
     # Note: _auto_secondary_y() sets the 'magnitude' column in the
     #       `panels` dataframe, which is needed for automatically
@@ -1022,152 +973,134 @@ def _addplot_collections(panid, panels, apdict, xdates, config):
     #       if any have secondary_y='auto', but since that is the
     #       default value, we will just assume we have at least one.
 
-    valid_apc_types = ['ohlc', 'candle']
+    valid_apc_types = ['ohlc','candle']
     if aptype not in valid_apc_types:
-        raise TypeError('Invalid aptype='+str(aptype) +
-                        '. Must be one of '+str(valid_apc_types))
-    if not isinstance(apdata, pd.DataFrame):
-        raise TypeError('addplot type "'+aptype +
-                        '" MUST be accompanied by addplot data of type `pd.DataFrame`')
-    d, o, h, l, c, v = _check_and_prepare_data(apdata, config)
-
+        raise TypeError('Invalid aptype='+str(aptype)+'. Must be one of '+str(valid_apc_types))
+    if not isinstance(apdata,pd.DataFrame):
+        raise TypeError('addplot type "'+aptype+'" MUST be accompanied by addplot data of type `pd.DataFrame`')
+    d,o,h,l,c,v = _check_and_prepare_data(apdata,config)
+    
     mc = apdict['marketcolors']
     if _is_marketcolor_object(mc):
         apstyle = config['style'].copy()
         apstyle['marketcolors'] = mc
     else:
         apstyle = config['style']
-
-    collections = _construct_mpf_collections(
-        aptype, d, xdates, o, h, l, c, v, config, apstyle)
+    
+    collections = _construct_mpf_collections(aptype,d,xdates,o,h,l,c,v,config,apstyle)
 
     if not external_axes_mode:
-        lo = math.log(max(math.fabs(np.nanmin(l)), 1e-7), 10) - 0.5
-        hi = math.log(max(math.fabs(np.nanmax(h)), 1e-7), 10) + 0.5
-        secondary_y = _auto_secondary_y(panels, panid, lo, hi)
+        lo = math.log(max(math.fabs(np.nanmin(l)),1e-7),10) - 0.5
+        hi = math.log(max(math.fabs(np.nanmax(h)),1e-7),10) + 0.5
+        secondary_y = _auto_secondary_y( panels, panid, lo, hi )
         if 'auto' != apdict['secondary_y']:
-            secondary_y = apdict['secondary_y']
+            secondary_y = apdict['secondary_y'] 
         if secondary_y:
-            ax = panels.at[panid, 'axes'][1]
-            panels.at[panid, 'used2nd'] = True
-        else:
-            ax = panels.at[panid, 'axes'][0]
+            ax = panels.at[panid,'axes'][1] 
+            panels.at[panid,'used2nd'] = True
+        else: 
+            ax = panels.at[panid,'axes'][0]
     else:
         ax = apdict['ax']
 
     for coll in collections:
         ax.add_collection(coll)
     if apdict['mav'] is not None:
-        apmavprices = _plot_mav(ax, config, xdates, c, apdict['mav'])
-    # if apdict['ema'] is not None:
-    #     apemaprices = _plot_ema(ax, config, xdates, c, apdict['ema'])
-
+        apmavprices = _plot_mav(ax,config,xdates,c,apdict['mav'])
     ax.autoscale_view()
     return ax
 
-
-def _addplot_columns(panid, panels, ydata, apdict, xdates, config):
+def _addplot_columns(panid,panels,ydata,apdict,xdates,config):
     external_axes_mode = apdict['ax'] is not None
     if not external_axes_mode:
         secondary_y = False
         if apdict['secondary_y'] == 'auto':
             yd = [y for y in ydata if not math.isnan(y)]
-            ymhi = math.log(max(math.fabs(np.nanmax(yd)), 1e-7), 10)
-            ymlo = math.log(max(math.fabs(np.nanmin(yd)), 1e-7), 10)
-            secondary_y = _auto_secondary_y(panels, panid, ymlo, ymhi)
+            ymhi = math.log(max(math.fabs(np.nanmax(yd)),1e-7),10)
+            ymlo = math.log(max(math.fabs(np.nanmin(yd)),1e-7),10)
+            secondary_y = _auto_secondary_y( panels, panid, ymlo, ymhi )
         else:
             secondary_y = apdict['secondary_y']
             #print("apdict['secondary_y'] says secondary_y is",secondary_y)
 
         if secondary_y:
-            ax = panels.at[panid, 'axes'][1]
-            panels.at[panid, 'used2nd'] = True
-        else:
-            ax = panels.at[panid, 'axes'][0]
+            ax = panels.at[panid,'axes'][1] 
+            panels.at[panid,'used2nd'] = True
+        else: 
+            ax = panels.at[panid,'axes'][0]
     else:
         ax = apdict['ax']
 
     aptype = apdict['type']
     if aptype == 'scatter':
-        size = apdict['markersize']
-        mark = apdict['marker']
+        size  = apdict['markersize']
+        mark  = apdict['marker']
         color = apdict['color']
         alpha = apdict['alpha']
-        edgecolors = apdict['edgecolors']
+        edgecolors  = apdict['edgecolors']
         linewidths = apdict['linewidths']
 
-        if isinstance(mark, (list, tuple, np.ndarray)):
-            _mscatter(xdates, ydata, ax=ax, m=mark, s=size, color=color,
-                      alpha=alpha, edgecolors=edgecolors, linewidths=linewidths)
+        if isinstance(mark,(list,tuple,np.ndarray)):
+            _mscatter(xdates, ydata, ax=ax, m=mark, s=size, color=color, alpha=alpha, edgecolors=edgecolors, linewidths=linewidths)
         else:
-            ax.scatter(xdates, ydata, s=size, marker=mark, color=color,
-                       alpha=alpha, edgecolors=edgecolors, linewidths=linewidths)
+            ax.scatter(xdates, ydata, s=size, marker=mark, color=color, alpha=alpha, edgecolors=edgecolors, linewidths=linewidths)
     elif aptype == 'bar':
-        width = 0.8 if apdict['width'] is None else apdict['width']
+        width  = 0.8 if apdict['width'] is None else apdict['width']
         bottom = apdict['bottom']
-        color = apdict['color']
-        alpha = apdict['alpha']
-        ax.bar(xdates, ydata, width=width,
-               bottom=bottom, color=color, alpha=alpha)
+        color  = apdict['color']
+        alpha  = apdict['alpha']
+        ax.bar(xdates,ydata,width=width,bottom=bottom,color=color,alpha=alpha)
     elif aptype == 'line':
-        ls = apdict['linestyle']
-        color = apdict['color']
-        width = apdict['width'] if apdict['width'] is not None else 1.6 * \
-            config['_width_config']['line_width']
-        alpha = apdict['alpha']
-        ax.plot(xdates, ydata, linestyle=ls, color=color,
-                linewidth=width, alpha=alpha)
+        ls     = apdict['linestyle']
+        color  = apdict['color']
+        width  = apdict['width'] if apdict['width'] is not None else 1.6*config['_width_config']['line_width']
+        alpha  = apdict['alpha']
+        ax.plot(xdates,ydata,linestyle=ls,color=color,linewidth=width,alpha=alpha)
     elif aptype == 'step':
         stepwhere = apdict['stepwhere']
         ls = apdict['linestyle']
-        color = apdict['color']
-        width = apdict['width'] if apdict['width'] is not None else 1.6 * \
-            config['_width_config']['line_width']
-        alpha = apdict['alpha']
-        ax.step(xdates, ydata, where=stepwhere, linestyle=ls,
-                color=color, linewidth=width, alpha=alpha)
+        color  = apdict['color']
+        width  = apdict['width'] if apdict['width'] is not None else 1.6*config['_width_config']['line_width']
+        alpha  = apdict['alpha']
+        ax.step(xdates,ydata,where = stepwhere,linestyle=ls,color=color,linewidth=width,alpha=alpha)
     else:
         raise ValueError('addplot type "'+str(aptype)+'" NOT yet supported.')
 
     if apdict['mav'] is not None:
-        apmavprices = _plot_mav(ax, config, xdates, ydata, apdict['mav'])
-    # if apdict['ema'] is not None:
-    #     apemaprices = _plot_ema(ax, config, xdates, ydata, apdict['ema'])
-    return ax
+        apmavprices = _plot_mav(ax,config,xdates,ydata,apdict['mav'])
 
+    return ax
 
-def _addplot_apply_supplements(ax, apdict, xdates):
+def _addplot_apply_supplements(ax,apdict,xdates):
     if (apdict['ylabel'] is not None):
         ax.set_ylabel(apdict['ylabel'])
     if apdict['ylim'] is not None:
-        ax.set_ylim(apdict['ylim'][0], apdict['ylim'][1])
+        ax.set_ylim(apdict['ylim'][0],apdict['ylim'][1])
     if apdict['title'] is not None:
         ax.set_title(apdict['title'])
     ysd = apdict['yscale']
-    if isinstance(ysd, dict):
+    if isinstance(ysd,dict):
         yscale = ysd['yscale']
-        del ysd['yscale']
-        ax.set_yscale(yscale, **ysd)
-    elif isinstance(ysd, str):
+        del      ysd['yscale']
+        ax.set_yscale(yscale,**ysd)
+    elif isinstance(ysd,str):
         ax.set_yscale(ysd)
     # added by Wen
     if "fill_between" in apdict and apdict['fill_between'] is not None:
         # deep copy because mplfinance code sometimes modifies the fill_between dict
         fblist = copy.deepcopy(apdict['fill_between'])
-        if isinstance(fblist, dict):
-            fblist = [fblist, ]
+        if isinstance(fblist,dict):
+            fblist = [fblist,]
         if _list_of_dict(fblist):
             for fb in fblist:
                 if 'x' in fb:
                     raise ValueError('fill_between dict may not contain `x`')
-                fb['x'] = xdates  # add 'x' to caller's fb dict
+                fb['x'] = xdates # add 'x' to caller's fb dict
                 ax.fill_between(**fb)
         else:
-            raise ValueError(
-                'Invalid addplot fill_between: must be `dict` or `list of dict`')
-
+            raise ValueError('Invalid addplot fill_between: must be `dict` or `list of dict`')
 
-def _set_ylabels_side(ax_pri, ax_sec, primary_on_right):
+def _set_ylabels_side(ax_pri,ax_sec,primary_on_right):
     # put the primary axis on one side,
     # and the twinx() on the "other" side:
     if primary_on_right == True:
@@ -1183,8 +1116,7 @@ def _set_ylabels_side(ax_pri, ax_sec, primary_on_right):
             ax_sec.yaxis.set_label_position('right')
             ax_sec.yaxis.tick_right()
 
-
-def _plot_mav(ax, config, xdates, prices, apmav=None, apwidth=None):
+def _plot_mav(ax,config,xdates,prices,apmav=None,apwidth=None):
     style = config['style']
     if apmav is not None:
         mavgs = apmav
@@ -1193,20 +1125,20 @@ def _plot_mav(ax, config, xdates, prices, apmav=None, apwidth=None):
     mavp_list = []
     if mavgs is not None:
         shift = None
-        if isinstance(mavgs, dict):
+        if isinstance(mavgs,dict):
             shift = mavgs['shift']
             mavgs = mavgs['period']
-        if isinstance(mavgs, int):
+        if isinstance(mavgs,int):
             mavgs = mavgs,      # convert to tuple
         if len(mavgs) > 7:
             mavgs = mavgs[0:7]  # take at most 7
-
+     
         if style['mavcolors'] is not None:
             mavc = cycle(style['mavcolors'])
         else:
             mavc = None
 
-        for idx, mav in enumerate(mavgs):
+        for idx,mav in enumerate(mavgs):
             mean = pd.Series(prices).rolling(mav).mean()
             if shift is not None:
                 mean = mean.shift(periods=shift[idx])
@@ -1220,7 +1152,7 @@ def _plot_mav(ax, config, xdates, prices, apmav=None, apwidth=None):
     return mavp_list
 
 
-def _plot_ema(ax, config, xdates, prices, apmav=None, apwidth=None):
+def _plot_ema(ax,config,xdates,prices,apmav=None,apwidth=None):
     '''ema: exponential moving average'''
     style = config['style']
     if apmav is not None:
@@ -1230,162 +1162,160 @@ def _plot_ema(ax, config, xdates, prices, apmav=None, apwidth=None):
     mavp_list = []
     if mavgs is not None:
         shift = None
-        if isinstance(mavgs, dict):
+        if isinstance(mavgs,dict):
             shift = mavgs['shift']
             mavgs = mavgs['period']
-        if isinstance(mavgs, int):
+        if isinstance(mavgs,int):
             mavgs = mavgs,      # convert to tuple
         if len(mavgs) > 7:
             mavgs = mavgs[0:7]  # take at most 7
-
+     
         if style['mavcolors'] is not None:
             mavc = cycle(style['mavcolors'])
         else:
             mavc = None
 
-        for idx, mav in enumerate(mavgs):
+        for idx,mav in enumerate(mavgs):
             # mean = pd.Series(prices).rolling(mav).mean()
-            mean = pd.Series(prices).ewm(span=mav, adjust=False).mean()
+            mean = pd.Series(prices).ewm(span=mav,adjust=False).mean()
             if shift is not None:
                 mean = mean.shift(periods=shift[idx])
-            emaprices = mean.values
+            mavprices = mean.values
             lw = config['_width_config']['line_width']
             if mavc:
-                ax.plot(xdates, emaprices, linewidth=lw, color=next(mavc))
+                ax.plot(xdates, mavprices, linewidth=lw, color=next(mavc))
             else:
-                ax.plot(xdates, emaprices, linewidth=lw)
-            mavp_list.append(emaprices)
+                ax.plot(xdates, mavprices, linewidth=lw)
+            mavp_list.append(mavprices)
     return mavp_list
 
 
-def _auto_secondary_y(panels, panid, ylo, yhi):
+def _auto_secondary_y( panels, panid, ylo, yhi ):
     # If mag(nitude) for this panel is not yet set, then set it
     # here, as this is the first ydata to be plotted on this panel:
     # i.e. consider this to be the 'primary' axis for this panel.
     secondary_y = False
-    p = panid, 'mag'
+    p = panid,'mag'
     if panels.at[p] is None:
-        panels.at[p] = {'lo': ylo, 'hi': yhi}
+        panels.at[p] = {'lo':ylo,'hi':yhi}
     elif ylo < panels.at[p]['lo'] or yhi > panels.at[p]['hi']:
         secondary_y = True
-    # if secondary_y:
+    #if secondary_y:
     #    print('auto says USE secondary_y ... for panel',panid)
-    # else:
+    #else:
     #    print('auto says do NOT use secondary_y ... for panel',panid)
     return secondary_y
 
-
 def _valid_addplot_kwargs():
 
-    valid_linestyles = ('-', 'solid', '--', 'dashed', '-.',
-                        'dashdot', '.', 'dotted', None, ' ', '')
-    valid_types = ('line', 'scatter', 'bar', 'ohlc', 'candle', 'step')
-    valid_stepwheres = ('pre', 'post', 'mid')
+    valid_linestyles = ('-','solid','--','dashed','-.','dashdot','.','dotted',None,' ','')
+    valid_types = ('line','scatter','bar', 'ohlc', 'candle','step')
+    valid_stepwheres = ('pre','post','mid')
     valid_edgecolors = ('face', 'none', None)
 
     vkwargs = {
-        'scatter': {'Default': False,
-                    'Description': "Deprecated.  (Use kwarg `type='scatter' instead.",
-                    'Validator': lambda value: isinstance(value, bool)},
-
-        'type': {'Default': 'line',
-                 'Description': 'addplot type: "line","scatter","bar", "ohlc", "candle","step"',
-                 'Validator': lambda value: value in valid_types},
-
-        'mav': {'Default': None,
-                'Description': 'Moving Average window size(s); (int or tuple of ints)',
-                'Validator': _mav_validator},
-
-        'panel': {'Default': 0,
-                  'Description': 'Panel (int 0-31) to use for this addplot',
-                  'Validator': lambda value: _valid_panel_id(value)},
-
-        'marker': {'Default': 'o',
-                   'Description': "marker for `type='scatter'` plot",
-                   'Validator': lambda value: _bypass_kwarg_validation(value)},
-
-        'markersize': {'Default': 18,
-                       'Description': 'size of marker for `type="scatter"`; default=18',
-                       'Validator': lambda value: isinstance(value, (int, float))},
-
-        'color': {'Default': None,
-                  'Description': 'color (or sequence of colors) of line(s), scatter marker(s), or bar(s).',
-                  'Validator': lambda value: mcolors.is_color_like(value) or
-                  (isinstance(value, (list, tuple, np.ndarray)) and all([mcolors.is_color_like(v) for v in value]))},
-
-        'linestyle': {'Default': None,
-                      'Description': 'line style for `type=line` ('+str(valid_linestyles)+')',
-                      'Validator': lambda value: value in valid_linestyles},
-
-        'linewidths': {'Default': None,
-                       'Description': 'edge widths of scatter markers',
-                       'Validator': lambda value: isinstance(value, (int, float))},
-
-        'edgecolors': {'Default': None,
-                       'Description': 'edgecolors of scatter markers',
-                       'Validator': lambda value: mcolors.is_color_like(value) or value in valid_edgecolors},
-
-        'width': {'Default': None,  # width of `bar` or `line`
-                  'Description': 'width of bar or line for `type="bar"` or `type="line"',
-                  'Validator': lambda value: isinstance(value, (int, float)) or
-                  all([isinstance(v, (int, float)) for v in value])},
-
-        'bottom': {'Default': 0,  # bottom for `type=bar` plots
-                   'Description': 'bottom value for `type=bar` bars. Default=0',
-                   'Validator': lambda value: isinstance(value, (int, float)) or
-                   all([isinstance(v, (int, float)) for v in value])},
-        'alpha': {'Default': 1,  # alpha of `bar`, `line`, or `scatter`
-                  'Description': 'opacity for 0.0 (transparent) to 1.0 (opaque)',
-                  'Validator': lambda value: isinstance(value, (int, float)) or
-                  all([isinstance(v, (int, float)) for v in value])},
-
-        'secondary_y': {'Default': 'auto',
-                        'Description': "True|False|'auto' place the additional plot data on a" +
-                        " secondary y-axis.  'auto' compares the magnitude or the" +
-                        " addplot data, to data already on the axis, and if it appears" +
-                        " they are of different magnitudes, then it uses a secondary y-axis." +
-                        " True or False always override 'auto'.",
-                        'Validator': lambda value: isinstance(value, bool) or value == 'auto'},
-
-        'y_on_right': {'Default': None,
-                       'Description': 'True|False put y-axis tick labels on the right, for this addplot' +
-                       ' regardless of what the mplfinance style says to to.',
-                       'Validator': lambda value: isinstance(value, bool)},
-
-        'ylabel': {'Default': None,
-                   'Description': 'label for y-axis (for this addplot)',
-                   'Validator': lambda value: isinstance(value, str)},
-
-        'ylim': {'Default': None,
-                 'Description': 'Limits for addplot y-axis as tuple (min,max), i.e. (bottom,top)',
-                 'Validator': lambda value: isinstance(value, (list, tuple)) and len(value) == 2
-                 and all([isinstance(v, (int, float)) for v in value])},
-
-        'title': {'Default': None,
-                  'Description': 'Axes Title (subplot title) for this addplot.',
-                  'Validator': lambda value: isinstance(value, str)},
-
-        'ax': {'Default': None,
-               'Description': 'Matplotlib Axes object on which to plot this addplot',
-               'Validator': lambda value: isinstance(value, mpl_axes.Axes)},
-
-        'yscale': {'Default': None,
-                   'Description': 'addplot y-axis scale: "linear", "log", "symlog", or "logit"',
-                   'Validator': lambda value: _yscale_validator(value)},
-
-        'stepwhere': {'Default': 'pre',
-                      'Description': "'pre','post', or 'mid': where to place step relative" +
-                      " to data for `type='step'`",
-                      'Validator': lambda value: value in valid_stepwheres},
-
-        'marketcolors': {'Default': None,  # use 'style' for default, instead.
-                         'Description': "marketcolors for this addplot (instead of the mplfinance" +
-                         " style\'s marketcolors).  For addplot `type='ohlc'`" +
-                         " and type='candle'",
-                         'Validator': lambda value: _is_marketcolor_object(value)},
-        'fill_between': {'Default': None,    # added by Wen
-                         'Description': " fill region",
-                         'Validator': _fill_between_validator},
+        'scatter'     : { 'Default'     : False,
+                          'Description' : "Deprecated.  (Use kwarg `type='scatter' instead.",
+                          'Validator'   : lambda value: isinstance(value,bool) },
+
+        'type'        : { 'Default'     : 'line',
+                          'Description' : 'addplot type: "line","scatter","bar", "ohlc", "candle","step"',
+                          'Validator'   : lambda value: value in valid_types },
+
+        'mav'         : { 'Default'     : None,
+                          'Description' : 'Moving Average window size(s); (int or tuple of ints)',
+                          'Validator'   : _mav_validator },
+        
+        'panel'       : { 'Default'     : 0, 
+                          'Description' : 'Panel (int 0-31) to use for this addplot',
+                          'Validator'   : lambda value: _valid_panel_id(value) },
+
+        'marker'      : { 'Default'     : 'o',
+                          'Description' : "marker for `type='scatter'` plot",
+                          'Validator'   : lambda value: _bypass_kwarg_validation(value)  },
+
+        'markersize'  : { 'Default'     : 18,
+                          'Description' : 'size of marker for `type="scatter"`; default=18',
+                          'Validator'   : lambda value: isinstance(value,(int,float)) },
+
+        'color'       : { 'Default'     : None,
+                          'Description' : 'color (or sequence of colors) of line(s), scatter marker(s), or bar(s).',
+                          'Validator'   : lambda value: mcolors.is_color_like(value) or
+                                         (isinstance(value,(list,tuple,np.ndarray)) and all([mcolors.is_color_like(v) for v in value])) },
+
+        'linestyle'   : { 'Default'     : None,
+                          'Description' : 'line style for `type=line` ('+str(valid_linestyles)+')',
+                          'Validator'   : lambda value: value in valid_linestyles },
+
+        'linewidths'  : { 'Default': None,
+                          'Description' : 'edge widths of scatter markers',
+                          'Validator'   : lambda value: isinstance(value,(int,float)) },
+
+        'edgecolors'  : { 'Default': None,
+                          'Description' : 'edgecolors of scatter markers',
+                          'Validator': lambda value: mcolors.is_color_like(value) or value in valid_edgecolors},
+
+        'width'       : { 'Default'     : None, # width of `bar` or `line`
+                          'Description' : 'width of bar or line for `type="bar"` or `type="line"',
+                          'Validator'   : lambda value: isinstance(value,(int,float)) or
+                                                        all([isinstance(v,(int,float)) for v in value]) },
+
+        'bottom'      : { 'Default'     : 0,  # bottom for `type=bar` plots
+                          'Description' : 'bottom value for `type=bar` bars. Default=0',
+                          'Validator'   : lambda value: isinstance(value,(int,float)) or
+                                                        all([isinstance(v,(int,float)) for v in value]) },
+        'alpha'       : { 'Default'     : 1,  # alpha of `bar`, `line`, or `scatter`
+                          'Description' : 'opacity for 0.0 (transparent) to 1.0 (opaque)',
+                          'Validator'   : lambda value: isinstance(value,(int,float)) or
+                                                        all([isinstance(v,(int,float)) for v in value]) },
+
+        'secondary_y' : { 'Default'     : 'auto',
+                          'Description' : "True|False|'auto' place the additional plot data on a"+
+                                          " secondary y-axis.  'auto' compares the magnitude or the"+
+                                          " addplot data, to data already on the axis, and if it appears"+
+                                          " they are of different magnitudes, then it uses a secondary y-axis."+
+                                          " True or False always override 'auto'.",
+                          'Validator'   : lambda value: isinstance(value,bool) or value == 'auto' },
+
+        'y_on_right'  : { 'Default'     : None,
+                          'Description' : 'True|False put y-axis tick labels on the right, for this addplot'+
+                                          ' regardless of what the mplfinance style says to to.',
+                          'Validator'   : lambda value: isinstance(value,bool) },
+
+        'ylabel'      : { 'Default'     : None,
+                          'Description' : 'label for y-axis (for this addplot)',
+                          'Validator'   : lambda value: isinstance(value,str) },
+
+        'ylim'        : {'Default'      : None,
+                         'Description' : 'Limits for addplot y-axis as tuple (min,max), i.e. (bottom,top)',
+                         'Validator'    : lambda value: isinstance(value, (list,tuple)) and len(value) == 2 
+                                                                      and all([isinstance(v,(int,float)) for v in value])},
+
+        'title'       : { 'Default'     : None,
+                          'Description' : 'Axes Title (subplot title) for this addplot.',
+                          'Validator'   : lambda value: isinstance(value,str) },
+
+        'ax'          : { 'Default'      : None,
+                          'Description' : 'Matplotlib Axes object on which to plot this addplot',
+                          'Validator'    : lambda value: isinstance(value,mpl_axes.Axes) },
+
+        'yscale'      : { 'Default'     : None,
+                          'Description' : 'addplot y-axis scale: "linear", "log", "symlog", or "logit"',
+                          'Validator'   : lambda value: _yscale_validator(value) },
+
+        'stepwhere'   : { 'Default'     : 'pre',
+                          'Description' : "'pre','post', or 'mid': where to place step relative"+
+                                          " to data for `type='step'`",
+                          'Validator'   : lambda value : value in valid_stepwheres },                  
+        
+        'marketcolors': { 'Default'     : None, # use 'style' for default, instead.
+                          'Description' : "marketcolors for this addplot (instead of the mplfinance"+
+                                          " style\'s marketcolors).  For addplot `type='ohlc'`"+
+                                          " and type='candle'",
+                          'Validator'   : lambda value: _is_marketcolor_object(value) },
+        'fill_between': { 'Default'     : None,    # added by Wen
+                          'Description' : " fill region",
+                          'Validator'   : _fill_between_validator },
 
     }
 
@@ -1410,4 +1340,4 @@ def make_addplot(data, **kwargs):
     if config['scatter'] == True and config['type'] == 'line':
         config['type'] = 'scatter'
 
-    return dict(data=data, **config)
+    return dict( data=data, **config)
diff --git a/tests/test_ema.py b/tests/test_ema.py
deleted file mode 100644
index 7fa3b519..00000000
--- a/tests/test_ema.py
+++ /dev/null
@@ -1,85 +0,0 @@
-
-import mplfinance as mpf
-import requests        # for making http requests to binance
-import json            # for parsing what binance sends back to us
-import pandas as pd    # for storing and manipulating the data we get back
-import numpy as np     # numerical python, i usually need this somewhere
-# and so i import by habit nowadays
-
-import matplotlib.pyplot as plt  # for charts and such
-import datetime as dt  # for dealing with times
-
-INTERVAL = '1d'
-
-
-def get_bars(quote, interval=INTERVAL):
-
-    root_url = 'https://api.binance.com/api/v1/klines'
-    url = root_url + '?symbol=' + quote + '&interval=' + interval
-    data = json.loads(requests.get(url).text)
-    df = pd.DataFrame(data)
-    df.columns = ['open_time',
-                  'o', 'h', 'l', 'c', 'v',
-                  'close_time', 'qav', 'num_trades',
-                  'taker_base_vol', 'taker_quote_vol', 'ignore']
-    df.index = [dt.datetime.fromtimestamp(x/1000.0) for x in df.close_time]
-
-    return df
-
-
-def coinpair(quote, interval='1d', base='USDT'):
-    '''returns ohlc data of the quote cryptocurrency with
-        the base currency (i.e. 'market'); base for alts must be either USDT or BTC'''
-
-    btcusd = 1 if quote == 'BTC' else \
-        get_bars('BTCUSDT', interval=interval)['c'].astype('float') \
-        if base == 'USDT' else 1
-
-    base0 = 'USDT' if quote == 'BTC' else 'BTC'
-
-    df = get_bars(quote + base0, interval=interval)
-
-    df['close'] = df['c'].astype('float')*btcusd
-    df['open'] = df['o'].astype('float')*btcusd
-    df['high'] = df['h'].astype('float')*btcusd
-    df['low'] = df['l'].astype('float')*btcusd
-
-    df.drop(['o', 'h', 'l', 'c'], axis=1, inplace=True)
-    print(quote, base, 'on {} candles'.format(interval))
-
-    return df
-
-
-def test_ema():
-
-    coin = 'BTC'
-    market = 'USDT'
-    candles = '1M'
-
-    df = coinpair(coin, interval=candles, base=market)
-
-    # mpf.plot(df,type='candle',figratio=(5,2),figscale=0.5,\
-    #          title=coin+market+" ({} candles)".format(candles),\
-    #          yscale='log'
-    #          )
-    #
-
-    ema25 = df['close'].ewm(span=25.0, adjust=False).mean()
-    mav25 = df['close'].rolling(window=25).mean()
-
-    # mpf.plot(df, type='ohlc', mav=25)
-
-    ap = [
-        mpf.make_addplot(df, panel=1, type='ohlc', color='c',
-                         ylabel='mpf mav', mav=25, secondary_y=False),
-        mpf.make_addplot(ema25, panel=2, type='line', width=2,  color='c',
-                         ylabel='calculated', secondary_y=False),
-        mpf.make_addplot(mav25, panel=2, type='line', width=2, color='blue',
-                         ylabel='calculated', secondary_y=False)
-
-    ]
-    mpf.plot(df, ylabel="mpf ema", type='ohlc',
-             ema=25, addplot=ap, panel_ratios=(1, 1))
-
-
-test_ema()
diff --git a/tests/test_images/test_ema.png b/tests/test_images/test_ema.png
deleted file mode 100644
index 0cc180b2537f8cd9b4e34ba152c41e74bb343bc3..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 57100
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


From 61a45b27cb3a6c6b3fbeba2bbde36b214fdb1d6c Mon Sep 17 00:00:00 2001
From: andrewrgarcia <andrewrgarcia@ufl.edu>
Date: Mon, 24 Oct 2022 16:11:13 -0400
Subject: [PATCH 12/22] make necessary changes after reversion

---
 src/mplfinance/plotting.py     |  17 +++++--
 tests/test_ema.py              |  79 +++++++++++++++++++++++++++++++++
 tests/test_images/test_ema.png | Bin 0 -> 57067 bytes
 3 files changed, 92 insertions(+), 4 deletions(-)
 create mode 100644 tests/test_ema.py
 create mode 100644 tests/test_images/test_ema.png

diff --git a/src/mplfinance/plotting.py b/src/mplfinance/plotting.py
index c8bcb406..09184bf7 100644
--- a/src/mplfinance/plotting.py
+++ b/src/mplfinance/plotting.py
@@ -532,8 +532,10 @@ def plot( data, **kwargs ):
 
     if ptype in VALID_PMOVE_TYPES:
         mavprices = _plot_mav(axA1,config,xdates,pmove_avgvals)
+        emaprices = _plot_ema(axA1, config, xdates, pmove_avgvals)
     else:
         mavprices = _plot_mav(axA1,config,xdates,closes)
+        emaprices = _plot_ema(axA1, config, xdates, closes)
 
     avg_dist_between_points = (xdates[-1] - xdates[0]) / float(len(xdates))
     if not config['tight_layout']:
@@ -599,6 +601,13 @@ def plot( data, **kwargs ):
             else:
                 for jj in range(0,len(mav)):     
                     retdict['mav' + str(mav[jj])] = mavprices[jj]
+        if config['ema'] is not None:
+            ema = config['ema']
+            if len(ema) != len(emaprices):
+                warnings.warn('len(ema)='+str(len(ema))+' BUT len(emaprices)='+str(len(emaprices)))
+            else:
+                for jj in range(0, len(ema)):
+                    retdict['ema' + str(ema[jj])] = emaprices[jj]
         retdict['minx'] = minx
         retdict['maxx'] = maxx
         retdict['miny'] = miny
@@ -1180,13 +1189,13 @@ def _plot_ema(ax,config,xdates,prices,apmav=None,apwidth=None):
             mean = pd.Series(prices).ewm(span=mav,adjust=False).mean()
             if shift is not None:
                 mean = mean.shift(periods=shift[idx])
-            mavprices = mean.values
+            emaprices = mean.values
             lw = config['_width_config']['line_width']
             if mavc:
-                ax.plot(xdates, mavprices, linewidth=lw, color=next(mavc))
+                ax.plot(xdates, emaprices, linewidth=lw, color=next(mavc))
             else:
-                ax.plot(xdates, mavprices, linewidth=lw)
-            mavp_list.append(mavprices)
+                ax.plot(xdates, emaprices, linewidth=lw)
+            mavp_list.append(emaprices)
     return mavp_list
 
 
diff --git a/tests/test_ema.py b/tests/test_ema.py
new file mode 100644
index 00000000..feba71ec
--- /dev/null
+++ b/tests/test_ema.py
@@ -0,0 +1,79 @@
+
+import mplfinance as mpf
+import requests        # for making http requests to binance
+import json            # for parsing what binance sends back to us
+import pandas as pd    # for storing and manipulating the data we get back
+import numpy as np     # numerical python, i usually need this somewhere
+# and so i import by habit nowadays
+
+import matplotlib.pyplot as plt  # for charts and such
+import datetime as dt  # for dealing with times
+
+INTERVAL = '1d'
+
+
+def get_bars(quote, interval=INTERVAL):
+
+    root_url = 'https://api.binance.com/api/v1/klines'
+    url = root_url + '?symbol=' + quote + '&interval=' + interval
+    data = json.loads(requests.get(url).text)
+    df = pd.DataFrame(data)
+    df.columns = ['open_time',
+                  'o', 'h', 'l', 'c', 'v',
+                  'close_time', 'qav', 'num_trades',
+                  'taker_base_vol', 'taker_quote_vol', 'ignore'
+    ]
+
+    df.index = [dt.datetime.fromtimestamp(x/1000.0) for x in df.close_time]
+
+    return df
+
+
+def coinpair(quote, interval='1d', base='USDT'):
+    '''returns ohlc data of the quote cryptocurrency with
+        the base currency (i.e. 'market'); base for alts must be either USDT or BTC'''
+
+    btcusd = 1 if quote == 'BTC' else \
+                            get_bars('BTCUSDT', interval=interval)['c'].astype('float') \
+                            if base == 'USDT' else 1
+
+    base0 = 'USDT' if quote == 'BTC' else 'BTC'
+
+    df = get_bars(quote + base0, interval=interval)
+
+    df['close'] = df['c'].astype('float')*btcusd
+    df['open' ] = df['o'].astype('float')*btcusd
+    df['high' ] = df['h'].astype('float')*btcusd
+    df['low'  ] = df['l'].astype('float')*btcusd
+
+    df.drop(['o', 'h', 'l', 'c'], axis=1, inplace=True)
+    print(quote, base, 'on {} candles'.format(interval))
+
+    return df
+
+
+def test_ema():
+
+    coin = 'BTC'
+    market = 'USDT'
+    candles = '1M'
+
+    df = coinpair(coin, interval=candles, base=market)
+
+    ema25 = df['close'].ewm(span=25.0, adjust=False).mean()
+    mav25 = df['close'].rolling(window=25).mean()
+
+    ap = [
+        mpf.make_addplot(df, panel=1, type='ohlc', color='c',
+                         ylabel='mpf mav', mav=25, secondary_y=False),
+        mpf.make_addplot(ema25, panel=2, type='line', width=2,  color='c',
+                         ylabel='calculated', secondary_y=False),
+        mpf.make_addplot(mav25, panel=2, type='line', width=2, color='blue',
+                         ylabel='calculated', secondary_y=False)
+    ]
+
+    mpf.plot(df, ylabel="mpf ema", type='ohlc',
+             ema=25, addplot=ap, panel_ratios=(1, 1))
+
+
+test_ema()
diff --git a/tests/test_images/test_ema.png b/tests/test_images/test_ema.png
new file mode 100644
index 0000000000000000000000000000000000000000..204a8f0a65d0131ffdd823becad5b11c1a3df011
GIT binary patch
literal 57067
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
SxRnI|F*I1He^qbw{{IJ_EL;Hq

literal 0
HcmV?d00001


From 4a38e07907146853b83e8c7e7811891b2c5aec66 Mon Sep 17 00:00:00 2001
From: andrewrgarcia <andrewrgarcia@ufl.edu>
Date: Mon, 24 Oct 2022 17:26:46 -0400
Subject: [PATCH 13/22] replace former example with csvread of google data;
 remove binance API call

---
 tests/test_ema.py              |  68 ++++-----------------------------
 tests/test_images/test_ema.png | Bin 57067 -> 49453 bytes
 2 files changed, 8 insertions(+), 60 deletions(-)

diff --git a/tests/test_ema.py b/tests/test_ema.py
index feba71ec..b0b25b5c 100644
--- a/tests/test_ema.py
+++ b/tests/test_ema.py
@@ -1,67 +1,15 @@
-
 import mplfinance as mpf
-import requests        # for making http requests to binance
-import json            # for parsing what binance sends back to us
-import pandas as pd    # for storing and manipulating the data we get back
-import numpy as np     # numerical python, i usually need this somewhere
-# and so i import by habit nowadays
-
-import matplotlib.pyplot as plt  # for charts and such
-import datetime as dt  # for dealing with times
-
-INTERVAL = '1d'
-
-
-def get_bars(quote, interval=INTERVAL):
-
-    root_url = 'https://api.binance.com/api/v1/klines'
-    url = root_url + '?symbol=' + quote + '&interval=' + interval
-    data = json.loads(requests.get(url).text)
-    df = pd.DataFrame(data)
-    df.columns = ['open_time',
-                  'o', 'h', 'l', 'c', 'v',
-                  'close_time', 'qav', 'num_trades',
-                  'taker_base_vol', 'taker_quote_vol', 'ignore'
-    ]
-
-    df.index = [dt.datetime.fromtimestamp(x/1000.0) for x in df.close_time]
-
-    return df
-
-
-def coinpair(quote, interval='1d', base='USDT'):
-    '''returns ohlc data of the quote cryptocurrency with
-        the base currency (i.e. 'market'); base for alts must be either USDT or BTC'''
-
-    btcusd = 1 if quote == 'BTC' else \
-                            get_bars('BTCUSDT', interval=interval)['c'].astype('float') \
-                            if base == 'USDT' else 1
-
-    base0 = 'USDT' if quote == 'BTC' else 'BTC'
-
-    df = get_bars(quote + base0, interval=interval)
-
-    df['close'] = df['c'].astype('float')*btcusd
-    df['open' ] = df['o'].astype('float')*btcusd
-    df['high' ] = df['h'].astype('float')*btcusd
-    df['low'  ] = df['l'].astype('float')*btcusd
-
-    df.drop(['o', 'h', 'l', 'c'], axis=1, inplace=True)
-    print(quote, base, 'on {} candles'.format(interval))
-
-    return df
-
+import pandas as pd   
 
 def test_ema():
 
-    coin = 'BTC'
-    market = 'USDT'
-    candles = '1M'
+    df = pd.read_csv('./examples/data/yahoofinance-GOOG-20040819-20180120.csv', parse_dates=True)
+    df.index = pd.DatetimeIndex(df['Date'])
 
-    df = coinpair(coin, interval=candles, base=market)
+    df = df[-50:]               # show last 50 data points only                     
 
-    ema25 = df['close'].ewm(span=25.0, adjust=False).mean()
-    mav25 = df['close'].rolling(window=25).mean()
+    ema25 = df['Close'].ewm(span=25.0, adjust=False).mean()       
+    mav25 = df['Close'].rolling(window=25).mean()
 
     ap = [
         mpf.make_addplot(df, panel=1, type='ohlc', color='c',
@@ -73,7 +21,7 @@ def test_ema():
     ]
 
     mpf.plot(df, ylabel="mpf ema", type='ohlc',
-             ema=25, addplot=ap, panel_ratios=(1, 1))
-
+             ema=25, addplot=ap, panel_ratios=(1, 1)
+    )
 
 test_ema()
diff --git a/tests/test_images/test_ema.png b/tests/test_images/test_ema.png
index 204a8f0a65d0131ffdd823becad5b11c1a3df011..e21f39215b9fc08f68160f142db8881dc81201dc 100644
GIT binary patch
literal 49453
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
JYUGSx{s**M`CtG5

literal 57067
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
SxRnI|F*I1He^qbw{{IJ_EL;Hq


From bd18e036bf71029d1b28bca0e6dc4af39805f565 Mon Sep 17 00:00:00 2001
From: andrewrgarcia <andrewrgarcia@ufl.edu>
Date: Mon, 24 Oct 2022 17:50:10 -0400
Subject: [PATCH 14/22] reference_image testing

---
 .../ema01.png}                                | Bin
 tests/test_ema.py                             |  42 +++++++++++++++++-
 2 files changed, 40 insertions(+), 2 deletions(-)
 rename tests/{test_images/test_ema.png => reference_images/ema01.png} (100%)

diff --git a/tests/test_images/test_ema.png b/tests/reference_images/ema01.png
similarity index 100%
rename from tests/test_images/test_ema.png
rename to tests/reference_images/ema01.png
diff --git a/tests/test_ema.py b/tests/test_ema.py
index b0b25b5c..497171d3 100644
--- a/tests/test_ema.py
+++ b/tests/test_ema.py
@@ -1,7 +1,23 @@
+import os
+import os.path
+import glob
 import mplfinance as mpf
 import pandas as pd   
+import matplotlib.pyplot as plt
+from   matplotlib.testing.compare import compare_images
 
-def test_ema():
+print('mpf.__version__ =',mpf.__version__)                 # for the record
+print('mpf.__file__ =',mpf.__file__)                       # for the record
+print("plt.rcParams['backend'] =",plt.rcParams['backend']) # for the record
+
+base='ema'
+tdir = os.path.join('tests','test_images')
+refd = os.path.join('tests','reference_images')
+
+IMGCOMP_TOLERANCE = 10.0  # this works fine for linux
+# IMGCOMP_TOLERANCE = 11.0  # required for a windows pass. (really 10.25 may do it).
+
+def create_ema_image(tname):
 
     df = pd.read_csv('./examples/data/yahoofinance-GOOG-20040819-20180120.csv', parse_dates=True)
     df.index = pd.DatetimeIndex(df['Date'])
@@ -20,8 +36,30 @@ def test_ema():
                          ylabel='calculated', secondary_y=False)
     ]
 
+    # plot and save in `tname` path
     mpf.plot(df, ylabel="mpf ema", type='ohlc',
-             ema=25, addplot=ap, panel_ratios=(1, 1)
+             ema=25, addplot=ap, panel_ratios=(1, 1), savefig=tname
     )
 
+
+def test_ema():
+
+    fname = base+'01.png'
+    tname = os.path.join(tdir,fname)
+    rname = os.path.join(refd,fname)
+
+    create_ema_image(tname)
+
+    tsize = os.path.getsize(tname)
+    print(glob.glob(tname),'[',tsize,'bytes',']')
+
+    rsize = os.path.getsize(rname)
+    print(glob.glob(rname),'[',rsize,'bytes',']')
+
+    result = compare_images(rname,tname,tol=IMGCOMP_TOLERANCE)
+    if result is not None:
+        print('result=',result)
+    assert result is None
+
+
 test_ema()

From 07adb02ecf6f2e386897672248437fa74f8ab969 Mon Sep 17 00:00:00 2001
From: Daniel Goldfarb <dgoldfarb.github@gmail.com>
Date: Thu, 27 Oct 2022 11:47:33 -0400
Subject: [PATCH 15/22] add tests;place mav color cycle into config

---
 src/mplfinance/plotting.py       |  25 +++++++----
 tests/reference_images/ema02.png | Bin 0 -> 73712 bytes
 tests/reference_images/ema03.png | Bin 0 -> 80038 bytes
 tests/test_ema.py                |  69 ++++++++++++++++++++++++++++---
 4 files changed, 80 insertions(+), 14 deletions(-)
 create mode 100644 tests/reference_images/ema02.png
 create mode 100644 tests/reference_images/ema03.png

diff --git a/src/mplfinance/plotting.py b/src/mplfinance/plotting.py
index 09184bf7..fbde618a 100644
--- a/src/mplfinance/plotting.py
+++ b/src/mplfinance/plotting.py
@@ -124,6 +124,12 @@ def _valid_plot_kwargs():
                                         'Description' : 'Exponential Moving Average window size(s); (int or tuple of ints)',
                                         'Validator'   : _mav_validator },
         
+        'mavcolors'                 : { 'Default'     : None,
+                                        'Description' : 'color cycle for moving averages (list or tuple of colors)'+
+                                                        '(overrides mpf style mavcolors).',
+                                        'Validator'   : lambda value: isinstance(value,(list,tuple)) and
+                                                                      all([mcolors.is_color_like(v) for v in value]) },
+
         'renko_params'              : { 'Default'     : dict(),
                                         'Description' : 'dict of renko parameters; call `mpf.kwarg_help("renko_params")`',
                                         'Validator'   : lambda value: isinstance(value,dict) },
@@ -454,6 +460,13 @@ def plot( data, **kwargs ):
     else:
         raise TypeError('style should be a `dict`; why is it not?')
 
+    if config['mavcolors'] is not None:
+        config['_ma_color_cycle'] = cycle(config['mavcolors'])
+    elif style['mavcolors'] is not None:
+        config['_ma_color_cycle'] = cycle(style['mavcolors'])
+    else:
+        config['_ma_color_cycle'] = None
+
     if not external_axes_mode:
         fig = plt.figure()
         _adjust_figsize(fig,config)
@@ -1142,10 +1155,7 @@ def _plot_mav(ax,config,xdates,prices,apmav=None,apwidth=None):
         if len(mavgs) > 7:
             mavgs = mavgs[0:7]  # take at most 7
      
-        if style['mavcolors'] is not None:
-            mavc = cycle(style['mavcolors'])
-        else:
-            mavc = None
+        mavc = config['_ma_color_cycle']
 
         for idx,mav in enumerate(mavgs):
             mean = pd.Series(prices).rolling(mav).mean()
@@ -1178,11 +1188,8 @@ def _plot_ema(ax,config,xdates,prices,apmav=None,apwidth=None):
             mavgs = mavgs,      # convert to tuple
         if len(mavgs) > 7:
             mavgs = mavgs[0:7]  # take at most 7
-     
-        if style['mavcolors'] is not None:
-            mavc = cycle(style['mavcolors'])
-        else:
-            mavc = None
+
+        mavc = config['_ma_color_cycle']
 
         for idx,mav in enumerate(mavgs):
             # mean = pd.Series(prices).rolling(mav).mean()
diff --git a/tests/reference_images/ema02.png b/tests/reference_images/ema02.png
new file mode 100644
index 0000000000000000000000000000000000000000..5b8807f5614c4d471d3823203ef1245e32a0face
GIT binary patch
literal 73712
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

literal 0
HcmV?d00001

diff --git a/tests/reference_images/ema03.png b/tests/reference_images/ema03.png
new file mode 100644
index 0000000000000000000000000000000000000000..561b02d203a271660cf8e9d507be4ddf1d33de04
GIT binary patch
literal 80038
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
O9aq;mnt8<h&VK<*+bXvJ

literal 0
HcmV?d00001

diff --git a/tests/test_ema.py b/tests/test_ema.py
index 497171d3..f691e4fd 100644
--- a/tests/test_ema.py
+++ b/tests/test_ema.py
@@ -14,14 +14,29 @@
 tdir = os.path.join('tests','test_images')
 refd = os.path.join('tests','reference_images')
 
+globpattern  = os.path.join(tdir,base+'*.png')
+oldtestfiles = glob.glob(globpattern)
+for fn in oldtestfiles:
+    try:
+        os.remove(fn)
+    except:
+        print('Error removing file "'+fn+'"')
+
 IMGCOMP_TOLERANCE = 10.0  # this works fine for linux
 # IMGCOMP_TOLERANCE = 11.0  # required for a windows pass. (really 10.25 may do it).
 
-def create_ema_image(tname):
+_df = pd.DataFrame()
+def get_ema_data():
+    global _df
+    if len(_df) == 0:
+        _df = pd.read_csv('./examples/data/yahoofinance-GOOG-20040819-20180120.csv',
+                          index_col='Date',parse_dates=True)
+    return _df
+    
 
-    df = pd.read_csv('./examples/data/yahoofinance-GOOG-20040819-20180120.csv', parse_dates=True)
-    df.index = pd.DatetimeIndex(df['Date'])
+def create_ema_image(tname):
 
+    df = get_ema_data()
     df = df[-50:]               # show last 50 data points only                     
 
     ema25 = df['Close'].ewm(span=25.0, adjust=False).mean()       
@@ -42,7 +57,7 @@ def create_ema_image(tname):
     )
 
 
-def test_ema():
+def test_ema01():
 
     fname = base+'01.png'
     tname = os.path.join(tdir,fname)
@@ -61,5 +76,49 @@ def test_ema():
         print('result=',result)
     assert result is None
 
+def test_ema02():
+    fname = base+'02.png'
+    tname = os.path.join(tdir,fname)
+    rname = os.path.join(refd,fname)
+
+    df = get_ema_data()
+    df = df[-125:-35]
+
+    mpf.plot(df, type='candle', ema=(5,15,25), mav=(5,15,25), savefig=tname)
+
+    tsize = os.path.getsize(tname)
+    print(glob.glob(tname),'[',tsize,'bytes',']')
+
+    rsize = os.path.getsize(rname)
+    print(glob.glob(rname),'[',rsize,'bytes',']')
+
+    result = compare_images(rname,tname,tol=IMGCOMP_TOLERANCE)
+    if result is not None:
+        print('result=',result)
+    assert result is None
+
+def test_ema03():
+    fname = base+'03.png'
+    tname = os.path.join(tdir,fname)
+    rname = os.path.join(refd,fname)
+
+    df = get_ema_data()
+    df = df[-125:-35]
+
+    mac = ['red','orange','yellow','green','blue','purple']
+
+    mpf.plot(df, type='candle', ema=(5,10,15,25), mav=(5,15,25),
+             mavcolors=mac, savefig=tname)
+
+
+    tsize = os.path.getsize(tname)
+    print(glob.glob(tname),'[',tsize,'bytes',']')
+
+    rsize = os.path.getsize(rname)
+    print(glob.glob(rname),'[',rsize,'bytes',']')
+
+    result = compare_images(rname,tname,tol=IMGCOMP_TOLERANCE)
+    if result is not None:
+        print('result=',result)
+    assert result is None
 
-test_ema()

From f7843632767cd06fca1fd90faa3b90f6c79b99d6 Mon Sep 17 00:00:00 2001
From: Daniel Goldfarb <dgoldfarb.github@gmail.com>
Date: Thu, 27 Oct 2022 14:42:47 -0400
Subject: [PATCH 16/22] bump version

---
 src/mplfinance/_version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/mplfinance/_version.py b/src/mplfinance/_version.py
index 44439d7d..ff6c7f0b 100644
--- a/src/mplfinance/_version.py
+++ b/src/mplfinance/_version.py
@@ -1,4 +1,4 @@
-version_info = (0, 12, 9, 'beta', 2)
+version_info = (0, 12, 9, 'beta', 3)
 
 _specifier_ = {'alpha': 'a','beta': 'b','candidate': 'rc','final': ''}
 

From 67e33889d93277c5aad9b146e9e330696b38489f Mon Sep 17 00:00:00 2001
From: Daniel Goldfarb <dgoldfarb.github@gmail.com>
Date: Mon, 31 Oct 2022 16:37:38 -0400
Subject: [PATCH 17/22] fix xlabel functionality

---
 src/mplfinance/_panels.py  |  9 ++++++++-
 src/mplfinance/plotting.py | 21 ++++++++++++++++-----
 2 files changed, 24 insertions(+), 6 deletions(-)

diff --git a/src/mplfinance/_panels.py b/src/mplfinance/_panels.py
index 7d8524a2..c1b8bef1 100644
--- a/src/mplfinance/_panels.py
+++ b/src/mplfinance/_panels.py
@@ -218,15 +218,22 @@ def _build_panels( figure, config ):
     return panels
     
 
-def _set_ticks_on_bottom_panel_only(panels,formatter,rotation=45):
+def _set_ticks_on_bottom_panel_only(panels,formatter,rotation=45,xlabel=None):
 
     bot = panels.index.values[-1]
     ax  = panels.at[bot,'axes'][0]
     ax.tick_params(axis='x',rotation=rotation)
     ax.xaxis.set_major_formatter(formatter)
 
+    if xlabel is not None:
+        ax.set_xlabel(xlabel)
+
     if len(panels) == 1: return
 
+    # [::-1] reverses the order of the panel id's
+    # [1:] all but the first element, which, since the array
+    #      is reversed, means we take all but the LAST panel id.
+    # Thus, only the last (bottom) panel id gets tick labels:
     for panid in panels.index.values[::-1][1:]:
         panels.at[panid,'axes'][0].tick_params(axis='x',labelbottom=False)
 
diff --git a/src/mplfinance/plotting.py b/src/mplfinance/plotting.py
index 073864a0..72468b74 100644
--- a/src/mplfinance/plotting.py
+++ b/src/mplfinance/plotting.py
@@ -185,8 +185,8 @@ def _valid_plot_kwargs():
                                         'Description' : 'Axes Title (subplot title)',
                                         'Validator'   : lambda value: isinstance(value,(str,dict)) },
                                         
-        'xlabel'                    : { 'Default'     : 'Date', # x-axis label
-                                        'Description' : 'label for x-axis of main plot',
+        'xlabel'                    : { 'Default'     : None,   # x-axis label
+                                        'Description' : 'label for x-axis of plot',
                                         'Validator'   : lambda value: isinstance(value,str) },
  
         'ylabel'                    : { 'Default'     : 'Price', # y-axis label
@@ -653,10 +653,12 @@ def plot( data, **kwargs ):
 
     xrotation = config['xrotation']
     if not external_axes_mode:
-        _set_ticks_on_bottom_panel_only(panels,formatter,rotation=xrotation)
+        _set_ticks_on_bottom_panel_only(panels,formatter,rotation=xrotation,
+                                        xlabel=config['xlabel'])
     else:
         axA1.tick_params(axis='x',rotation=xrotation)
         axA1.xaxis.set_major_formatter(formatter)
+        axA1.set_xlabel(config['xlabel'])
 
     ysd = config['yscale']
     if isinstance(ysd,dict):
@@ -705,7 +707,13 @@ def plot( data, **kwargs ):
                 elif panid == 'lower': panid = 1  # for backwards compatibility
                 if apdict['y_on_right'] is not None:
                     panels.at[panid,'y_on_right'] = apdict['y_on_right']
-
+                if apdict['xlabel'] is not None:
+                    apdict['xlabel'] = None # set to None so `_addplot_apply_supplements()` won't apply it.
+                    warnings.warn('\n\n ================================================================= '+
+                                  '\n\n     WARNING: make_addplot `xlabel` IGNORED in Panels mode.'+
+                                  '\n              Use `mpf.plot(...,xlabel=)` instead.'+
+                                  '\n\n ================================================================ ',
+                                  category=UserWarning)
             aptype = apdict['type']
             if aptype == 'ohlc' or aptype == 'candle':
                 ax = _addplot_collections(panid,panels,apdict,xdates,config)
@@ -783,7 +791,6 @@ def plot( data, **kwargs ):
                            # working in `addplot`).
 
     axA1.set_ylabel(config['ylabel'])
-    axA1.set_xlabel(config['xlabel'])
 
     if config['volume']:
         if external_axes_mode:
@@ -1250,6 +1257,10 @@ def _valid_addplot_kwargs():
                           'Description' : 'label for y-axis (for this addplot)',
                           'Validator'   : lambda value: isinstance(value,str) },
 
+        'xlabel'      : { 'Default'     : None, # x-axis label
+                          'Description' : 'x-axis label (for addplot ONLY when in external axes mode)',
+                          'Validator'   : lambda value: isinstance(value,str) },
+
         'ylim'        : {'Default'      : None,
                          'Description' : 'Limits for addplot y-axis as tuple (min,max), i.e. (bottom,top)',
                          'Validator'    : lambda value: isinstance(value, (list,tuple)) and len(value) == 2 

From 5f039a814e32a779eb73481d3cbe6daa45585659 Mon Sep 17 00:00:00 2001
From: Daniel Goldfarb <dgoldfarb.github@gmail.com>
Date: Mon, 31 Oct 2022 16:48:06 -0400
Subject: [PATCH 18/22] no addplot xlabel support; bump vers; example

---
 examples/plot_customizations.ipynb | 23 ++++++++++++-----------
 src/mplfinance/_version.py         |  2 +-
 src/mplfinance/plotting.py         | 18 +++++-------------
 3 files changed, 18 insertions(+), 25 deletions(-)

diff --git a/examples/plot_customizations.ipynb b/examples/plot_customizations.ipynb
index dc1642c1..e51b45a8 100644
--- a/examples/plot_customizations.ipynb
+++ b/examples/plot_customizations.ipynb
@@ -223,7 +223,7 @@
     {
      "data": {
       "text/plain": [
-       "'0.12.9b0'"
+       "'0.12.9b3'"
       ]
      },
      "execution_count": 4,
@@ -359,9 +359,16 @@
     "\n",
     "---\n",
     "\n",
-    "#### Setting the Figure Title and the Y-axis Label:"
+    "#### Setting the Figure Title, the Y-axis Label, and the X-axis Label:"
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  },
   {
    "cell_type": "code",
    "execution_count": 7,
@@ -369,7 +376,7 @@
    "outputs": [
     {
      "data": {
-      "image/png": "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OZf4woULKCoqAgDcvHlTcZ22traKgAYAjRs3VoxQFxQU4PLlyxpra+fOnRXti4iIwJMnT1R6vlQqxfHjxzF58mT06NED3t7e8PHxwdtvv42NGzfi5cuXSuXff/99tGjRAi1atMD7779fZp2HDx9WlGnVqhVevHhRYRtcXFzw5ptv4s0338R7772ndKzktBqZTIaEhAQA1Xu9u3fvjmPHjmHixImV/qUhJycH9+/fV3zt7++vdHz06NGKz69fv17ptRKRdjAUE1G12djYKD5PS0srd17nm2++icGDB8Pb27vcUU75lIqYmBhkZmbi0aNHCAoKUgSFsua8qsLIyEipvTk5OdWqrzx3795VfN6sWTOlYx4eHorAn5GRgcePHwMonoMs5+npWarOkjcZRkVFaaytNjY2ijne+fn5+L//+78qPzcrKwuTJk3Cxx9/jPPnz+P58+coLCxERkYGbt++jU2bNmHIkCFKbz5Kzrv+888/kZWVVareX375RfF5jx490KBBgwrbsXTpUqxZswZr1qxBr169lI7FxsYqfW1iYgJA/dd70qRJ2LFjB1xcXCpsk1xmZqbS169eS+PGjWFkZAQAiulGRKR7DMVEVG3t2rVThDyg+IangQMHYuXKlThz5oxiNK4q+vfvD6A4nI0fPx7+/v7466+/YGBggM8//1ylqQ5lycvLQ2pqquLrska1K/L333/jgw8+UMwF9vf3R2hoaKlgJ59OAii/aQCKg7m1tbXia/nIZckR2lefAyiHKXmQ1oTs7GxMmzYNZmZmAICjR48qBcaKLFy4EJcuXQJQHDanTJmCr7/+Gp999hns7e0BFN88+dFHHynmVw8YMEARAgsLC0vd5Jabm6uoEwDeeustta+tsLBQaQ66paUl3N3dAaj/ele2esqrXr1J79Wfh/z8fEgkEsXX8u8HItIthmIiqrbmzZvj3XffVXosPj4e4eHhmDp1Knr06IGBAwfiyy+/xL179yqsKycnRxGYbt++DYlEgs6dO+PHH3/E2LFjq93WPXv2oOSiO6+OKlZm3bp1OHfuHJ49e4aCggLExsbi66+/xjvvvKM0TSAjI0PxuTxsllRymS95oC45oljWMmBlPUcTCgsL4ejoiMDAQADF0yFWr15d6fPu3LmDkydPKr5etmwZZs2aBT8/PwQGBmLfvn2Ka3/27Bn27t0LoHhq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f+Dh4aFYYoyIiFTDOcVEREREJHicPkFEREREgsdQTERERESCx1BMRERERILHUExEREREgsdQTERERESCx1BMRERERILHUExEREREgsdQTERERESCx1BMRERERILHUExEREREgsdQTERERESCx1BMRERERILHUExEREREgsdQTERERESCx1BMRERERILHUExEREREgsdQTERERESCx1BMRERERILHUExEREREgsdQTERERESCx1BMRERERILHUExEREREgsdQTERERESCx1BMRERERILHUExEREREgsdQTERERESCx1BMRERERILHUExEREREgsdQTERERESCZ6jvBpBuSKVSPH/+HABgbm4OkUik5xYRERERaZdMJkNOTg4AwM7ODmJx+ePBDMUC8fz5czg6Ouq7GURERER6kZycDAcHh3KPc/oEEREREQkeR4oFwtzcXPH51Rv3lb6ubUQiwK2xDeKS0iCT6bs1pAvsc+FhnwsT+114tN3nOTk56Nq+OQBUmn0YigWi5Bxic3NzmJtb6LE11SMSARYWFjA3L+QvTYFgnwsP+1yY2O/Co8s+r+x+Kk6fICIiIiLBYygmIiIiIsFjKCYiIiIiwWMoJiIiIiLBYygmIiIiIsFjKCYiIiIiwWMoJiIiIiLBYygmIiIiIsFjKCYiIiIiwWMoJiIiIiLBYygmIiIiIsEz1HcDiIiIiKi0+LgYZGVllXksNfUFTp04ioGD34KtbYMyy1haWqKpm4c2m1inMBQTERER1TDxcTHo79up0nL79u6s8PiZC9cYjKuIoZiIiIiohpGPEO/ctQteXi1Vfn509F0EBgSUO9JMpTEUExEREdVQXl4t0aFDB303QxB4ox0RERERCR5DMREREREJHkMxEREREQkeQzERERERCR5DMREREREJHkMxEREREQkeQzERERERlZKS/BTr161CSvJTfTdFJxiKiYiIiKiUlJRkbAwNQUpKsr6bohMMxUREREQkeAzFRERERCR4DMVEREREJHgMxUREREQkeIb6bgARERER6Ud8XAyysrLKPBbz4L7Sv2WxtLREUzcPrbRN1xiKiYiIiAQoPi4G/X07VVpu9ozJFR4/c+FanQjGDMVEREREAiQfIba2rgcDA9UjYVGRBBkZ6eWONNc2DMVEREREAmZgYAgjIyN9N0PveKMdEREREQkeR4qJ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BYiLi8OtW7cwf/58tG3bFv369QMADBgwAC1btsScOXNw69YtxMbGYv78+SgsLERQUBAAwNHREWPGjMGGDRtw9uxZJCYmYuvWrYiMjCxzFz0iIiIiqhjnFGvQ9OnT8ccffyi+fvr0KX799VcAwMqVKzFixAjs3LkTISEhGDp0KExNTeHn54d58+ZBLC5+f2JoaIhvv/0WK1euxMSJE1FQUID27dsjIiICDRs2VNQ9f/58WFpaYsmSJUhNTYWbmxtCQ0MVo8lEREREVHUMxRoUERFRaZnWrVtj9+7dFZaxs7PD2rVrKyxjaGiI4OBgjgwTERERaQCnTxARERGR4DEUExEREZHgMRQTERERkeAxFBMRERGR4DEUExEREZHgMRQTERERkeAxFBMRERGR4DEUExEREZHgMRQTERERkeAxFBMRERGR4FVrm+e0tDQcOXIEgYGBAICCggIsX74cf/31Fxo0aIApU6agW7du5T7/zz//VPvcPj4+aj+XiIiIiKgktUPx8+fPMWbMGCQkJGDUqFEwMTHBjBkzcP78echkMsTExODGjRs4dOgQPD09y6zjvffeg0gkUvncIpEIUVFR6jadiIiIiEiJ2tMntm3bhkePHsHExARpaWm4d+8ezp07BwBo3749mjZtisLCQoSHh1dYj0wmU+uDiIiIiEhT1B4pPnv2LEQiEXbt2gVHR0ccOXIEAODi4oLvvvsOT58+RZ8+fXDt2rVy65g2bVqpx65fv44rV66gdevWaN++PerVq4eXL1/ir7/+wt27dzF48GB06dJF3WYTEREREZWidihOTk6Gubk52rRpA6A4zIpEIvTq1QsA0LBhQ1hYWCA5ObncOl4NxRcuXMCWLVuwaNEijB07tlT57du3Y926dRg1apS6zSYiIiIiKkXt6RNmZmYoLCwEUDwF4u+//wYAtGvXTlGmsLAQRkZGVa5zw4YNMDAwwOjRo8s8HhAQAJFIhA0bNqjbbCIiIiKiUtQeKXZ2dsbt27exefNmFBYWIi0tDSKRCJ07dwYAXL16FQUFBWjSpEmV6/z3339RWFiIxMREuLi4lDqemJiIwsJC3LlzR91mExERERGVonYoHjZsGP755x9s3LgRQPGKEJ06dYKjoyMePHiASZMmQSQSoU+fPlWu09raGs+fP8eECRMwceJEeHt7w9raGhkZGbh9+za+/fZbAICxsbG6zSYiIiIiKkXtUPyf//wH58+fx4ULFwAAjRs3xvLlywEAtra2KCwshKurKyZMmFDlOt944w2Eh4fj8ePHWLp0aZllRCIRBgwYoG6ziYiIiIhKUTsUGxsbIywsDLGxscjJyUGLFi0U84dtbW0xe/Zs/Oc//4GNjU2V65w1axYePnyIyMjIcst07doVc+fOVbfZRERERESlVGtHOwBwd3cv8/FJkyapXJepqSm2bNmCa9euITIyEnFxccjJyYG5uTlcXV3h6+tb4Q55JV27dg22traK9u3Zswd79+5FUlISnJycMHbs2HJv6CMiItKncd9E4kV2nlbP0cDCFLs/8NPqOYhqk2qH4pMnT+LYsWO4e/cuXr58qViFYvny5fjoo49ga2urcp2dOnVCp06dqtWuJUuWYOHChXB3d8eePXuwZs0aBAQEwN3dHXFxcVi7di2kUmmZS78RERHp04vsPBQYW2v5HBlarZ+otlE7FBcUFGDatGm4ePEigOJl2eRbNufk5GD37t24cuUK9u7dq9IUCqB4DeSTJ08qgnZYWBgA4JdffsHrr79epToePXqkWMFi//79+PzzzzF8+HDF8RYtWmD9+vUMxURERESk/jrFYWFhuHDhAmQyGdzd3WFo+L98nZWVBQMDA8TFxSlWjKiqrVu3on///ggJCcGRI0cUobugoADTp0/HjBkzqrTNs4WFBV6+fAkASElJQcuWLZWOt2rVCk+ePFGpbURERERUN6kdio8dOwaRSISQkBAcP34clpaWimMODg7Yvn07ZDIZfvnllyrXeeTIEaxduxaFhYWlgq884P7yyy/Yu3dvpXX17t0be/bsAQB06dIFJ0+eVDp+4sQJNG3atMptIyIiIqK6S+1QnJSUBBMTEwwdOrTM4126dIGZmVmF2zy/KiIiAiKRCKNGjcKVK1eUpl3Y29tj1qxZkMlkOHDgQKV1zZ49G3/++SfGjBmDhg0bIjw8HGPGjMGiRYswbtw4bNq0CR9//HGV20ZEREREdZfaodjc3Bz5+fl48eJFmcejo6ORm5sLExOTKtcZExMDQ0NDLFiwoNQNemKxGB988AFMTU3x6NGjSuuyt7fHoUOH0KlTJ8U0j1u3buHy5ctwdHTEd999h969e1e5bURERERUd6l9o127du1w4cIFTJ48GYGBgZBIJACA8+fP4969e4pR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EREREQkeQzERERERCR5DMREREREJHkMxEREREQkeQzERERERCR5DMREREREJHkMxEREREQkeQzERERERCR5DMREREREJHkMxEREREQkeQzERERERCR5DMREREREJHkMxEREREQkeQzERERERCR5DMREREREJnqG+G0C6IZPJFJ/n5OTosSVlkxbmQQpjrdYPgOfgOWrdOeTnERXk8Rw8B8+hx3MAtf/3ia7OkZOTXeXyIhGQnW2EnJxslIgqGlMy88gqOYFIVlkJqhNSUlLg6Oio72YQERER6UVycjIcHBzKPc7pE0REREQkeBwpFgipVIrnz58DAMzNzSESifTcIiIiIiLtkslkiikUdnZ2EIvLHw9mKCYiIiIiweP0CSIiIiISPIZiIiIiIhI8hmIiIiIiEjyGYiKqs3jLBFHdx59z0hSGYiKqs+SrrEilUj23hLQtJycHJ0+eREFBgb6bQnrCn3OqLu5oR3WWVCqFVCqFoSG/zYUkJycHhw8fRmJiIho0aIA33ngDjo6OkEqlFS7FQ7VXVlYW+vXrhxEjRsDf31/fzSEdyM3NxZ49e/D48WNYWlpi9OjRcHJy4s85VQuXZKM6KScnB3PmzMHw4cPh6+sLIyMjfTeJdCArKwtvv/027O3tkZKSguzsbDg6OmLr1q1o0KCBvptHWpCVlYW33noLrVu3xvr16/XdHNKBrKwsvPPOO2jQoAHS0tLw7NkzyGQy7N+/H02aNNF386gW49spqpN27dqFM2fOYO3atfj9999RVFSk7yaRlhUUFGDKlCnw9vbGN998gxMnTmDGjBl4+vQpbty4oSjHcYC6IysrC2+++Sa8vb0Vgbisn3X2ed1RWFiITz75BM2bN0dYWBgOHz6MFStWwMLCAmvXrkVhYaG+m0i1GEMx1UnJycno3LkzbGxsMG/ePPz222+QSCT6bhZpUVRUFNLS0vDhhx/CwsIChoaGGD58OOrVqweg+K8Hubm5EIlEDEl1QF5eHgYPHozWrVtjw4YNAIrfGBkYGAAAUlNTkZSUhKysLPZ5HfL06VM8fvwYb7/9NszMzGBgYIC+ffuiW7duiI6O5rxiqhaGYqqTXrx4gb59+2L16tVwdHTEZ599hqtXrzIY12FPnz7Fw4cPlUYKpVIpCgoK8O2332LIkCF49913cf36dYhEIv7nWcvdvXsXL1++hIGB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\n",
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAsUAAAJGCAYAAACz7/huAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMSwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/YYfK9AAAACXBIWXMAAA9hAAAPYQGoP6dpAACDzklEQVR4nO3deXhN1+L/8ffJJDJJQxJzJNRQY5GaKoqWUr2G9raK0po6GZoOhmqLXi2uki9aWkrNHc1FtYoqOimlxlYEESSIkEFkOr8/8su5jgwynyT783oeT0/2Xnvttc9KTj9ZWXttk9lsNiMiIiIiYmB2tm6AiIiIiIitKRSLiIiIiOEpFIuIiIiI4SkUi4iIiIjhKRSLiIiIiOEpFIuIiIiI4SkUi4iIiIjhKRSLiIiIiOEpFIuIiIiI4SkUi4iIiIjhKRSLiIiIiOEpFIuIiIiI4SkUi4iIiIjhKRSLiIiIiOEpFIuIiIiI4SkUi4iIiIjhKRSLiIiIiOEpFIuIiIiI4SkUi4iIiIjhKRSLiIiIiOEpFIuIiIiI4SkUi4iIiIjhKRSLiIiIiOEpFIuIiIiI4SkUi4iIiIjhKRSLiIiIiOEpFIuIiIiI4SkUi4iIiIjhKRSLiIiIiOEpFIuIiIiI4SkUi4iIiIjhKRSLiIiIiOEpFIuIiIiI4SkUi4iIiIjhKRSLiIiIiOEpFIuIiIiI4SkUi4iIiIjhOdi6ASJSdsTFxbF69Wp27tzJyZMnuXbtGqmpqbi5uVGtWjVatmzJk08+Se3atXOs58KFC8yZM4c9e/YQHR2Nt7c3TZs2ZeTIkTkeW69evWz32dnZ4eHhQZ06dejcuTNPPvkkrq6uubquTp06ERERccdys2bN4pFHHrHadu7cORYtWsTPP//MhQsXcHZ25p577uHpp5+mU6dOWdaTlJTE119/zdq1azl79iyJiYlUr16dbt26MXToUJydnXPV7pysWbOG8ePHW76uXr06W7ZswcnJKcey9913H8uXLy/w+YvKjz/+yOeff86hQ4eIiYmhXLly1KpVi06dOjFo0CDc3d0zHVOQ9/uHH35g4sSJXLp0CYDevXszbdq0bMtv376dL7/8kr/++otr167h5uZGo0aN6N+/Px07diz4GyAi+WYym81mWzdCREq/w4cP8/zzz1vCQXYcHBx45513eOyxx7Lcf/nyZXr16pVlPeXKlWPlypU0btw4y2NzCsW3q169OosXL8bPz++OZfMbio8fP87AgQO5du1aluVffvllXnjhBattSUlJvPTSS+zatSvLY+655x5WrFiR60CfndtDMcD48eN55plncixbkkPx1KlTWbJkSbb7q1evzooVK6hSpYplW37f75iYGP7zn//wzTffWG3PKRS//fbbfPHFF9m2b/jw4bz66qvZ7heRoqWRYhEpsBs3bvDSSy9Zgmz16tXp27cv/v7+mM1mjh07xqpVq7h69SopKSm8/fbbtGjRglq1amWqa8WKFZZ6+vTpw4MPPsgff/zBokWLuHnzJvPmzWP+/Pl3bNOTTz7Jww8/bPn62rVr/PHHH3z++eckJydz7tw5RowYwbp167C3t8/1tY4dO5b69etnua9u3bqW12azmddee80SiLt27cqjjz5KeHg4c+fOJSEhgdmzZ3P//fdbhfylS5daAlq1atV46aWXKF++PJ988glHjhzh6NGjhISE8Oabb+a6zbk1f/58HnvssSxHU0u6H374wSoQP/HEE3To0IHIyEjmzZvH5cuXOXfuHG+//TYLFy60lMvP+717927Gjh3L5cuXgfS/QqSlpeXYvq+//toqEPfq1YtOnTrx559/8umnn2I2m1mwYAGBgYEEBQUVxlsiInmkUCwiBfbjjz9y8eJFID0grFq1Cl9fX8v+hx56iO7du9OrVy+Sk5NJSUnh66+/5rXXXstU15EjR4D0YP3ee+9hMpno3Lkzu3fv5sSJE4SFheWqTX5+frRt29ZqW7du3ahfvz4TJkwA4O+//2b37t106NAh19fasGFDWrVqdcdyO3bs4J9//gHA39+fkJAQS/hOTExk9uzZmM1mlixZwsyZMwFITk62CnYzZsygRYsWADRr1ozOnTuTlpbGF198wcsvv4ybm1uu250bMTExfPTRR7z++uuFWm9xWLlypeV1hw4d+M9//mP52tPTk1deeQWAn376iejoaLy8vPL9fn/zzTdcvnyZ8uXLM3LkSI4fP86GDRtybN/SpUstrx944AGmT58OpP+yZG9vbwnqH330kUKxiI3oRjsRKbCzZ89aXnt4eFgF4gx16tRh6tSphISEsHr1ap5//vks68qY0+rh4YHJZAIgISHBMip365++86Nnz55WI8OHDh0qUH3Z+eGHHyyvO3bsaHXOW+cS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/6Z27dqWJcZERCRvNKdYRERERAxP0ydERERExPAUikVERETE8BSKRURERMTwFIpFRERExPAUikVERETE8BSKRURERMTwFIpFRERExPAUikVERETE8BSKRURERMTwFIpFRERExPAUikVERETE8BSKRURERMTwFIpFRERExPAUikVERETE8BSKRURERMTwFIpFRERExPAUikVERETE8BSKRURERMTwFIpFRERExPAUikVERETE8BSKRURERMTwFIpFRERExPAUikVERETE8BSKRURERMTwFIpFRERExPAUikVERETE8BSKRURERMTwFIpFRERExPAUikVERETE8BSKRURERMTwHGzdACkeaWlpXL58GQAXFxdMJpONWyQiIiJStMxmMwkJCQBUqlQJO7vsx4MVig3i8uXL+Pr62roZIiIiIjYRGRmJj49Ptvs1fUJEREREDE8jxQbh4uJief3Lgb+tvi5tTCbwr+pJ2PkYzGZbt0aKg/rceNTnxqR+N56i7vOEhARa31sX4I7ZR6HYIG6dQ+zi4oKLi6sNW1MwJhO4urri4pKsD02DUJ8bj/rcmNTvxlOcfX6n+6k0fUJEREREDE+hWEREREQMT6FYRERERAxPoVhEREREDE+hWEREREQMT6FYRERERAxPoVhEREREDE+hWEREREQMT6FYRERERAxPoVhEREREDE+hWERERKSUiYq8yOxZ04iKvGjrppQZDrZugIiIiIhkdjoslLi4uCz3hZ78m7kh06nlX5vadepmWcbNzY1a/rWLsollikKxiIiISAlzOiyUB4Na3rHcq6OG57h/2659Csa5pFAsIiIiUsJkjBAvXbaM+vUb5Pn448ePMWjgwGxHmiUzhWIRERGREqp+/QY0b97c1s0wBN1oJyIiIiKGp1AsIiIiIoanUCwiIiIihqdQLCIiIiKGp1AsIiIiIoanUCwiIiIimRjtqXkKxSIiIiKSSVRUJHNDphMVFWnrphQLhWIRERERMTyFYhERERExPIViERERETE8hWIRERERMTyFYhERERExPAdbN0BEREREbON0WChxcXFZ7gs9+bfVf7Pi5uZGLf/aRdK24qZQLCIiImJAp8NCeTCo5R3LvTpqeI77t+3aVyaCsUKxiIiIiAFljBB7eFTA3j7vkTA1NYXr169lO9Jc2igUi4iIiBiYvb0Djo6Otm6G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8PDg+vXrHD58mE8++QQAJyen/DZbRERERCSTfIfif//73/z444/s2rULgKpVqzJlyhQAvLy8SE5Oxs/Pj8GDB+e6zkceeYQlS5Zw7tw5Jk+enGUZk8lEly5d8ttsEREREZFM8h2KnZycWLBgAadOnSIhIYF69epZ5g97eXnx6quv8u9//xtPT89c1/nyyy9z5swZduzYkW2Z1q1bM3bs2Pw2W0REREQkkwI90Q4gICAgy+3Dhg3Lc13Ozs7Mnz+fffv2sWPHDsLCwkhISMDFxQU/Pz+CgoJyfELerfbt24eXl5elfStXrmTVqlWcP3+eatWq0b9//2xv6BMREbGlAR/v4Ep8YpGeo6KrMyue61ik5xApTQocirds2cLGjRs5duwYV69etaxCMWXKFF588UW8vLzyXGfLli1p2bJlgdo1adIk3nzzTQICAli5ciXvv/8+AwcOJCAggLCwMGbOnElaWlqWS7+JiIjY0pX4RJKcPIr4HNeLtH6R0ibfoTgpKYkRI0bw008/AenLsmU8sjkhIYEVK1awd+9eVq1alacpFJC+BvKWLVssQXvBggUAfP/99zz00EO5quPs2bOWFSy++uor3n77bXr37m3ZX69ePWbPnq1QLCIiIiL5X6d4wYIF7Nq1C7PZTEBAAA4O/8vXcXFx2NvbExYWZlkxIrcWLlzIgw8+yPTp01m/fr0ldCclJTFy5EhGjRqVq8c8u7q6cvXqVQCioqJo0KCB1f6GDRty4cKFPLVNRERERMqmfIfijRs3YjKZmD59Ops2bcLNzc2yz8fHh8WLF2M2m/n+++9zXef69euZOXMmycnJmYJvRsD9/vvvWbVq1R3r6tChAytXrgSgVatWbNmyxWr/5s2bqVWrVq7bJiIiIiJlV75D8fnz5ylXrhw9e/bMcn+rVq0oX758jo95vt3y5csxmUz07duXvXv3Wk278Pb25uWXX8ZsNrN69eo71vXqq6/y+++/069fPypXrsySJUvo168fb731FgMGDOCDDz7glVdeyXXbRERERKTsyncodnFx4ebNm1y5ciXL/cePH+fGjRuUK1cu13WGhobi4ODAhAkTMt2gZ2dnx3PPPYezszNnz569Y13e3t6sXbuWli1bWqZ5HDp0iD179uDr68tnn31Ghw4dct02ERERESm78n2jXbNmzdi1axfDhw9n0KBBpKSkAPDjjz9y4sQJy6hv48aNc12nyWTKcb7w1atXuXnzpuWGvjtxd3fnlVde0YiwiIiIiOQo3yPFQ4cOxWQycfToUcaOHUt8fDwAzz//PCEhIVy6dAmTycSQIUNyXWfdunVJTU1l0qRJVtMubty4wZ9//sno0aMxm83UqVMnv80WEREREckk3yPFgYGBTJ06lcmTJ5OQkJBpf/ny5XnzzTdz/bANgMcff5w///yTNWvWsGbNGsv25s2bW16bTCYee+yx/DabxMRE/vzzT06fPs316+lrNHp4eFCrVi2aNWuGs7NzvusWERERkdKpQA/v6NmzJx07duT777/n77//Jj4+Hjc3N+rVq0enTp2oUKFCnup7/PHHOXToEF9++aVl2+1TKnr37k3fvn3z3NZr164REhLC+vXrSUzM+ilBzs7O9OrVi5dffjnPbRcRERGR0itfoTg1NZWNGzcC8OijjxZo5PZ277zzDg8//DDr16/PFLQfeeQR7r///jzXef36dZ566ilOnTpF+fLladu2LbVq1bIsIxcXF8fp06fZv38/n332Gb/++itffPEF7u7uhXZdIiIiIlJy5SsU29nZ8eabb+Lo6EivXr0KuUnQtm1b2rZtW2j1ffDBB5w6dYpnnnmGkSNH4urqmmW5+Ph45syZw9KlS/nwww8ZN25cobVBREREREqufN1oZzKZuOeee0hMTMzTOsS2sm3bNlq3bs24ceOyDcSQ/hS88ePHc9999/Hdd98VYwtFRERExJbyPad42rRpvP766wwbNoxXXnmFJk2aZFpb+E5uf/RybmWsepFbly5dokePHrku36xZMw4cOJCfpomIiIhIKZTvUPziiy+SnJzM+fPneeGFF7Itl1OAzWlN4sLk6elJWFhYrsuHhoZaPU1PRERERMq2fIfi06dP3/FhG3cSGBiYadv169c5ceIETk5OBAQEUKFCBa5evcqpU6dITU2lefPmVK5cOU/nuf/++1m3bh0rV66kf//+OZZdsWIF27dvp3fv3nk6h4iIiIiUXgVap7igli9fbvX16dOnGTBgAP/617+YMGGC1bJo0dHRTJ48mcOHDzNjxow8nefll1/mxx9/ZMqUKXz66ae0a9cOf39/q9UnwsLC2LNnDxEREVSsWJHRo0cX+PpEREREpHTIdyi+PdAWhqlTpxITE8PkyZMpX7681T4vLy/e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7hSKevXqZftvzZo1hXYeETEe3WgnIiK5kpqaanldrlw5y+uM0FupUiVatmxp2d6tWzeOHj3K77//TmRkJL6+vgVuQ06rT9zaJhGRvFIoFhGRXDl37pzldUbAjY2NZceOHQBcvnyZBg0aZDouLS2Nb775hiFDhhS4DVp9QkSKiqZPiIhIruzatcvy+r777gPS1yK+fSWKrGgVChEp6TRSLCIid/Tbb7/x448/AlC3bl0aN24M/C/sli9fnkWLFmFvb2913KpVq1i/fj3Hjx/nn3/+4e677y7ehouI5JJCsYiIZOvmzZts2bKFKVOmYDabcXBw4N133wXSl2b7/fffAbj//vtp0aJFpuOTkpIsT7rbsGEDr776avE1XkQkDxSKRUTEyosvvoiDQ/r/HmJjYy032Lm7uzNt2jSaNGkCpIdcs9kMYFmX+HYtW7akYsWKXLlyhW+++YZXXnnF6lHOeZXxpL3svP322zzyyCP5rl9EjEuhWERErMTFxVleu7u7U61aNTp16kTfvn2tVpDYuHEjAI6OjnTs2DHLuuzs7HjwwQf54osvOH/+PPv27SMwMDDfbYuJiclx/82bN/Ndt4gYm8mc8Wu+iIiIiIhBafUJERERETE8hWIRERERMTyFYhERERExPIViERERETE8hWIRERERMTyFYhERERExPIViERERETE8hWIRERERMTyFYhERERExPIViERERETE8hWIRERERMTyFYhERERExPIViERERETG8/wdai0pgFyjqLwAAAABJRU5ErkJggg==\n",
       "text/plain": [
        "<Figure size 800x575 with 4 Axes>"
       ]
@@ -382,16 +389,10 @@
     "mpf.plot(daily,type='candle',volume=True,\n",
     "         title='\\nS&P 500, Nov 2019',\n",
     "         ylabel='OHLC Candles',\n",
-    "         ylabel_lower='Shares\\nTraded')"
+    "         ylabel_lower='Shares\\nTraded',\n",
+    "         xlabel='DATE')"
    ]
   },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
-  },
   {
    "cell_type": "markdown",
    "metadata": {},
diff --git a/src/mplfinance/_version.py b/src/mplfinance/_version.py
index 44439d7d..ff6c7f0b 100644
--- a/src/mplfinance/_version.py
+++ b/src/mplfinance/_version.py
@@ -1,4 +1,4 @@
-version_info = (0, 12, 9, 'beta', 2)
+version_info = (0, 12, 9, 'beta', 3)
 
 _specifier_ = {'alpha': 'a','beta': 'b','candidate': 'rc','final': ''}
 
diff --git a/src/mplfinance/plotting.py b/src/mplfinance/plotting.py
index 72468b74..17c97e7c 100644
--- a/src/mplfinance/plotting.py
+++ b/src/mplfinance/plotting.py
@@ -707,13 +707,6 @@ def plot( data, **kwargs ):
                 elif panid == 'lower': panid = 1  # for backwards compatibility
                 if apdict['y_on_right'] is not None:
                     panels.at[panid,'y_on_right'] = apdict['y_on_right']
-                if apdict['xlabel'] is not None:
-                    apdict['xlabel'] = None # set to None so `_addplot_apply_supplements()` won't apply it.
-                    warnings.warn('\n\n ================================================================= '+
-                                  '\n\n     WARNING: make_addplot `xlabel` IGNORED in Panels mode.'+
-                                  '\n              Use `mpf.plot(...,xlabel=)` instead.'+
-                                  '\n\n ================================================================ ',
-                                  category=UserWarning)
             aptype = apdict['type']
             if aptype == 'ohlc' or aptype == 'candle':
                 ax = _addplot_collections(panid,panels,apdict,xdates,config)
@@ -1082,8 +1075,11 @@ def _addplot_columns(panid,panels,ydata,apdict,xdates,config):
 def _addplot_apply_supplements(ax,apdict,xdates):
     if (apdict['ylabel'] is not None):
         ax.set_ylabel(apdict['ylabel'])
-    if (apdict['xlabel'] is not None):
-        ax.set_xlabel(apdict['xlabel'])
+    # Note that xlabel is NOT supported for addplot.  This is because
+    # in Panels Mode, there is only one xlabel (on the bottom axes)
+    # which is handled by the `xlabel` kwarg of `mpf.plot()`,
+    # whereas in External Axes Mode, users can call `Axes.set_xlabel()` on
+    # the axes object of their choice.
     if apdict['ylim'] is not None:
         ax.set_ylim(apdict['ylim'][0],apdict['ylim'][1])
     if apdict['title'] is not None:
@@ -1257,10 +1253,6 @@ def _valid_addplot_kwargs():
                           'Description' : 'label for y-axis (for this addplot)',
                           'Validator'   : lambda value: isinstance(value,str) },
 
-        'xlabel'      : { 'Default'     : None, # x-axis label
-                          'Description' : 'x-axis label (for addplot ONLY when in external axes mode)',
-                          'Validator'   : lambda value: isinstance(value,str) },
-
         'ylim'        : {'Default'      : None,
                          'Description' : 'Limits for addplot y-axis as tuple (min,max), i.e. (bottom,top)',
                          'Validator'    : lambda value: isinstance(value, (list,tuple)) and len(value) == 2 

From ac8aef25fce5f1bee385eea5ab660c9c78b1b56c Mon Sep 17 00:00:00 2001
From: Daniel Goldfarb <dgoldfarb.github@gmail.com>
Date: Mon, 31 Oct 2022 16:51:29 -0400
Subject: [PATCH 19/22] tweak version

---
 src/mplfinance/_version.py | 2 +-
 src/mplfinance/plotting.py | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/mplfinance/_version.py b/src/mplfinance/_version.py
index ff6c7f0b..e16ebafe 100644
--- a/src/mplfinance/_version.py
+++ b/src/mplfinance/_version.py
@@ -1,4 +1,4 @@
-version_info = (0, 12, 9, 'beta', 3)
+version_info = (0, 12, 9, 'beta', 4)
 
 _specifier_ = {'alpha': 'a','beta': 'b','candidate': 'rc','final': ''}
 
diff --git a/src/mplfinance/plotting.py b/src/mplfinance/plotting.py
index 17c97e7c..1fa55ac1 100644
--- a/src/mplfinance/plotting.py
+++ b/src/mplfinance/plotting.py
@@ -708,6 +708,7 @@ def plot( data, **kwargs ):
                 if apdict['y_on_right'] is not None:
                     panels.at[panid,'y_on_right'] = apdict['y_on_right']
             aptype = apdict['type']
+
             if aptype == 'ohlc' or aptype == 'candle':
                 ax = _addplot_collections(panid,panels,apdict,xdates,config)
                 _addplot_apply_supplements(ax,apdict,xdates)

From 2ea49e4fdc6dc017686f1b29190cefa7398a512e Mon Sep 17 00:00:00 2001
From: Daniel Goldfarb <dgoldfarb.github@gmail.com>
Date: Mon, 31 Oct 2022 20:41:27 -0400
Subject: [PATCH 20/22] check for whitespace when column not found; Issue #496

---
 src/mplfinance/_arg_validators.py | 55 ++++++++++++++++++++-----------
 1 file changed, 36 insertions(+), 19 deletions(-)

diff --git a/src/mplfinance/_arg_validators.py b/src/mplfinance/_arg_validators.py
index d7398232..e3782fe9 100644
--- a/src/mplfinance/_arg_validators.py
+++ b/src/mplfinance/_arg_validators.py
@@ -30,21 +30,6 @@ def _check_and_prepare_data(data, config):
     if not isinstance(data.index,pd.core.indexes.datetimes.DatetimeIndex):
         raise TypeError('Expect data.index as DatetimeIndex')
 
-    if (len(data.index) > config['warn_too_much_data'] and
-        (config['type']=='candle' or config['type']=='ohlc' or config['type']=='hollow_and_filled')
-       ):
-        warnings.warn('\n\n ================================================================= '+
-                      '\n\n   WARNING: YOU ARE PLOTTING SO MUCH DATA THAT IT MAY NOT BE'+
-                        '\n            POSSIBLE TO SEE DETAILS (Candles, Ohlc-Bars, Etc.)'+
-                        '\n   For more information see:'+
-                        '\n   - https://github.com/matplotlib/mplfinance/wiki/Plotting-Too-Much-Data'+
-                        '\n   '+
-                        '\n   TO SILENCE THIS WARNING, set `type=\'line\'` in `mpf.plot()`'+
-                        '\n   OR set kwarg `warn_too_much_data=N` where N is an integer '+
-                        '\n   LARGER than the number of data points you want to plot.'+
-                      '\n\n ================================================================ ',
-                  category=UserWarning)
-
     # We will not be fully case-insensitive (since Pandas columns as NOT case-insensitive)
     # but because so many people have requested it, for the default column names we will
     # try both Capitalized and lower case:
@@ -57,10 +42,22 @@ def _check_and_prepare_data(data, config):
     o, h, l, c, v = columns
     cols = [o, h, l, c]
 
-    if config['tz_localize']:
-        dates   = mdates.date2num(data.index.tz_localize(None).to_pydatetime())
-    else:  # Just in case someone was depending on this bug (Issue 236)
-        dates   = mdates.date2num(data.index.to_pydatetime())
+    if config['volume'] != False:
+        expect_cols = columns
+    else:
+        expect_cols = cols
+    
+    for c in expect_cols:
+        if c not in data.columns:
+            for dc in data.columns:
+                if dc.strip() != dc:
+                    warnings.warn('\n ================================================================= '+
+                                  '\n   Input DataFrame column name "'+dc+'" '+
+                                  '\n   contains leading and/or trailing whitespace.',category=UserWarning)
+            raise ValueError('Column "'+c+'" NOT FOUND in Input DataFrame!'+
+                             '\n            CHECK that your column names are correct AND/OR'+
+                             '\n            CHECK for leading or trailing blanks in your column names.')
+
     opens   = data[o].values
     highs   = data[h].values
     lows    = data[l].values
@@ -75,6 +72,26 @@ def _check_and_prepare_data(data, config):
         if not all( isinstance(v,(float,int)) for v in data[col] ):
             raise ValueError('Data for column "'+str(col)+'" must be ALL float or int.')
 
+    if config['tz_localize']:
+        dates   = mdates.date2num(data.index.tz_localize(None).to_pydatetime())
+    else:  # Just in case someone was depending on this bug (Issue 236)
+        dates   = mdates.date2num(data.index.to_pydatetime())
+
+    if (len(data.index) > config['warn_too_much_data'] and
+        (config['type']=='candle' or config['type']=='ohlc' or config['type']=='hollow_and_filled')
+       ):
+        warnings.warn('\n\n ================================================================= '+
+                      '\n\n   WARNING: YOU ARE PLOTTING SO MUCH DATA THAT IT MAY NOT BE'+
+                        '\n            POSSIBLE TO SEE DETAILS (Candles, Ohlc-Bars, Etc.)'+
+                        '\n   For more information see:'+
+                        '\n   - https://github.com/matplotlib/mplfinance/wiki/Plotting-Too-Much-Data'+
+                        '\n   '+
+                        '\n   TO SILENCE THIS WARNING, set `type=\'line\'` in `mpf.plot()`'+
+                        '\n   OR set kwarg `warn_too_much_data=N` where N is an integer '+
+                        '\n   LARGER than the number of data points you want to plot.'+
+                      '\n\n ================================================================ ',
+                  category=UserWarning)
+
     return dates, opens, highs, lows, closes, volumes
 
 def _get_valid_plot_types(plottype=None):

From d63f27f312783c9a695daf07593409fcc0e3582c Mon Sep 17 00:00:00 2001
From: Daniel Goldfarb <dgoldfarb.github@gmail.com>
Date: Mon, 31 Oct 2022 21:10:12 -0400
Subject: [PATCH 21/22] fix bug that was trashing "Close" values

---
 src/mplfinance/_arg_validators.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/mplfinance/_arg_validators.py b/src/mplfinance/_arg_validators.py
index e3782fe9..55c320b3 100644
--- a/src/mplfinance/_arg_validators.py
+++ b/src/mplfinance/_arg_validators.py
@@ -46,15 +46,15 @@ def _check_and_prepare_data(data, config):
         expect_cols = columns
     else:
         expect_cols = cols
-    
-    for c in expect_cols:
-        if c not in data.columns:
+     
+    for col in expect_cols:
+        if col not in data.columns:
             for dc in data.columns:
                 if dc.strip() != dc:
                     warnings.warn('\n ================================================================= '+
                                   '\n   Input DataFrame column name "'+dc+'" '+
                                   '\n   contains leading and/or trailing whitespace.',category=UserWarning)
-            raise ValueError('Column "'+c+'" NOT FOUND in Input DataFrame!'+
+            raise ValueError('Column "'+col+'" NOT FOUND in Input DataFrame!'+
                              '\n            CHECK that your column names are correct AND/OR'+
                              '\n            CHECK for leading or trailing blanks in your column names.')
 

From c7005ab66259df4341d4b8719b31a30fd79fb96f Mon Sep 17 00:00:00 2001
From: Daniel Goldfarb <dgoldfarb.github@gmail.com>
Date: Mon, 31 Oct 2022 21:11:54 -0400
Subject: [PATCH 22/22] bump version

---
 src/mplfinance/_version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/mplfinance/_version.py b/src/mplfinance/_version.py
index e16ebafe..52221d42 100644
--- a/src/mplfinance/_version.py
+++ b/src/mplfinance/_version.py
@@ -1,4 +1,4 @@
-version_info = (0, 12, 9, 'beta', 4)
+version_info = (0, 12, 9, 'beta', 5)
 
 _specifier_ = {'alpha': 'a','beta': 'b','candidate': 'rc','final': ''}