ENH: Add parameter Backtest.plot(plot_trades=)

Closes #647

Author: kernc

backtesting/_plotting.py

@@ -166,7 +166,7 @@ def plot(*, results: pd.Series,
          indicators: List[_Indicator],
          filename='', plot_width=None,
          plot_equity=True, plot_return=False, plot_pl=True,
-         plot_volume=True, plot_drawdown=False,
+         plot_volume=True, plot_drawdown=False, plot_trades=True,
          smooth_equity=False, relative_equity=True,
          superimpose=True, resample=True,
          reverse_indicators=True,
@@ -609,7 +609,8 @@ def __eq__(self, other):
         _plot_superimposed_ohlc()
 
     ohlc_bars = _plot_ohlc()
-    _plot_ohlc_trades()
+    if plot_trades:
+        _plot_ohlc_trades()
     indicator_figs = _plot_indicators()
     if reverse_indicators:
         indicator_figs = indicator_figs[::-1]

backtesting/backtesting.py

@@ -1554,7 +1554,7 @@ def _mp_task(backtest_uuid, batch_index):
 
     def plot(self, *, results: pd.Series = None, filename=None, plot_width=None,
              plot_equity=True, plot_return=False, plot_pl=True,
-             plot_volume=True, plot_drawdown=False,
+             plot_volume=True, plot_drawdown=False, plot_trades=True,
              smooth_equity=False, relative_equity=True,
              superimpose: Union[bool, str] = True,
              resample=True, reverse_indicators=False,
@@ -1593,6 +1593,9 @@ def plot(self, *, results: pd.Series = None, filename=None, plot_width=None,
         If `plot_drawdown` is `True`, the resulting plot will contain
         a separate drawdown graph section.
 
+        If `plot_trades` is `True`, the stretches between trade entries
+        and trade exits are marked by hash-marked tractor beams.
+
         If `smooth_equity` is `True`, the equity graph will be
         interpolated between fixed points at trade closing times,
         unaffected by any interim asset volatility.
@@ -1651,6 +1654,7 @@ def plot(self, *, results: pd.Series = None, filename=None, plot_width=None,
             plot_pl=plot_pl,
             plot_volume=plot_volume,
             plot_drawdown=plot_drawdown,
+            plot_trades=plot_trades,
             smooth_equity=smooth_equity,
             relative_equity=relative_equity,
             superimpose=superimpose,

backtesting/test/_test.py

@@ -650,6 +650,7 @@ def test_params(self):
                           plot_return=True,
                           plot_pl=False,
                           plot_drawdown=True,
+                          plot_trades=False,
                           superimpose=False,
                           resample='1W',
                           smooth_equity=False,