stable/docs/plotting.md

82 lines
1.9 KiB
Markdown
Raw Normal View History

2018-01-12 10:49:50 +00:00
# Plotting
This page explains how to plot prices, indicator, profits.
## Table of Contents
- [Plot price and indicators](#plot-price-and-indicators)
2018-01-12 09:55:49 +00:00
- [Plot profit](#plot-profit)
2018-01-12 10:49:50 +00:00
2018-01-28 10:53:52 +00:00
## Installation
Plotting scripts use Plotly library. Install/upgrade it with:
```
pip install --upgrade plotly
```
At least version 2.3.0 is required.
2018-01-12 10:49:50 +00:00
## Plot price and indicators
Usage for the price plotter:
2018-01-28 10:53:52 +00:00
```
script/plot_dataframe.py [-h] [-p pair] [--live]
```
2018-01-12 10:49:50 +00:00
Example
```
2018-01-30 14:29:18 +00:00
python scripts/plot_dataframe.py -p BTC_ETH
2018-01-12 10:49:50 +00:00
```
2018-01-28 10:53:52 +00:00
The `-p` pair argument, can be used to specify what
2018-01-12 10:49:50 +00:00
pair you would like to plot.
**Advanced use**
2018-01-28 10:53:52 +00:00
To plot the current live price use the `--live` flag:
```
python scripts/plot_dataframe.py -p BTC_ETH --live
```
To plot a timerange (to zoom in):
```
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:
```
python scripts/plot_dataframe.py --db-url tradesv3.dry_run.sqlite -p BTC_ETH
```
2018-01-12 09:55:49 +00:00
## 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
more of an estimate.
3) Each pair individually profit
The first graph is good to get a grip of how the overall market
progresses.
The second graph will show how you algorithm works or doesnt.
Perhaps you want an algorithm that steadily makes small profits,
or one that acts less seldom, but makes big swings.
The third graph can be useful to spot outliers, events in pairs
that makes profit spikes.
Usage for the profit plotter:
2018-01-28 10:53:52 +00:00
```
2018-01-12 09:55:49 +00:00
script/plot_profit.py [-h] [-p pair] [--datadir directory] [--ticker_interval num]
2018-01-28 10:53:52 +00:00
```
2018-01-12 09:55:49 +00:00
2018-01-28 10:53:52 +00:00
The `-p` pair argument, can be used to plot a single pair
2018-01-12 09:55:49 +00:00
Example
```
python3 scripts/plot_profit.py --datadir ../freqtrade/freqtrade/tests/testdata-20171221/ -p BTC_LTC
2018-01-12 09:55:49 +00:00
```