From f7766d305b73d01ee90d7f45bfca5bbee30dfefd Mon Sep 17 00:00:00 2001
From: Matthias <xmatthias@outlook.com>
Date: Mon, 27 May 2019 19:42:12 +0200
Subject: [PATCH] Improve plotting documentation

---
 docs/plotting.md | 55 +++++++++++++++++++++++++++++++-----------------
 1 file changed, 36 insertions(+), 19 deletions(-)

diff --git a/docs/plotting.md b/docs/plotting.md
index 60c642ab3..20183ab9c 100644
--- a/docs/plotting.md
+++ b/docs/plotting.md
@@ -1,63 +1,79 @@
 # Plotting
+
 This page explains how to plot prices, indicator, profits.
 
 ## Installation
 
 Plotting scripts use Plotly library. Install/upgrade it with:
 
-```
-pip install --upgrade plotly
+``` bash
+pip install -U -r requirements-plot.txt
 ```
 
 At least version 2.3.0 is required.
 
 ## Plot price and indicators
+
 Usage for the price plotter:
 
-```
-script/plot_dataframe.py [-h] [-p pairs] [--live]
+``` bash
+python3 script/plot_dataframe.py [-h] [-p pairs] [--live]
 ```
 
 Example
-```
-python scripts/plot_dataframe.py -p BTC/ETH
+
+``` bash
+python3 scripts/plot_dataframe.py -p BTC/ETH
 ```
 
 The `-p` pairs argument, can be used to specify
 pairs you would like to plot.
 
-**Advanced use**
+### Advanced use
 
 To plot multiple pairs, separate them with a comma:
-```
-python scripts/plot_dataframe.py -p BTC/ETH,XRP/ETH
+
+``` bash
+python3 scripts/plot_dataframe.py -p BTC/ETH,XRP/ETH
 ```
 
 To plot the current live price use the `--live` flag:
-```
-python scripts/plot_dataframe.py -p BTC/ETH --live
+
+``` bash
+python3 scripts/plot_dataframe.py -p BTC/ETH --live
 ```
 
 To plot a timerange (to zoom in):
+
+``` bash
+python3 scripts/plot_dataframe.py -p BTC/ETH --timerange=100-200
 ```
-python scripts/plot_dataframe.py -p BTC/ETH --timerange=100-200
-```
+
 Timerange doesn't work with live data.
 
 To plot trades stored in a database use `--db-url` argument:
+
+``` bash
+python3 scripts/plot_dataframe.py --db-url sqlite:///tradesv3.dry_run.sqlite -p BTC/ETH
 ```
-python scripts/plot_dataframe.py --db-url sqlite:///tradesv3.dry_run.sqlite -p BTC/ETH
+
+To polt trades from a backtesting result, use `--export-filename <filename>`
+
+``` bash
+python3 scripts/plot_dataframe.py --export-filename user_data/backtest_data/backtest-result.json -p BTC/ETH
 ```
 
 To plot a test strategy the strategy should have first be backtested.
 The results may then be plotted with the -s argument:
-```
-python scripts/plot_dataframe.py -s Strategy_Name -p BTC/ETH --datadir user_data/data/<exchange_name>/
+
+``` bash
+python3 scripts/plot_dataframe.py -s Strategy_Name -p BTC/ETH --datadir user_data/data/<exchange_name>/
 ```
 
 ## Plot profit
 
 The profit plotter show a picture with three plots:
+
 1) Average closing price for all pairs
 2) The summarized profit made by backtesting.
    Note that this is not the real-world profit, but
@@ -76,13 +92,14 @@ that makes profit spikes.
 
 Usage for the profit plotter:
 
-```
-script/plot_profit.py [-h] [-p pair] [--datadir directory] [--ticker_interval num]
+``` bash
+python3 script/plot_profit.py [-h] [-p pair] [--datadir directory] [--ticker_interval num]
 ```
 
 The `-p` pair argument, can be used to plot a single pair
 
 Example
-```
+
+``` bash
 python3 scripts/plot_profit.py --datadir ../freqtrade/freqtrade/tests/testdata-20171221/ -p LTC/BTC
 ```